在 Windows 開發環境安裝 Memcached 服務並整合 PHP,需注意服務安裝權限、Telnet Client 啟用、PHP 擴充模組版本對應。本文提供從下載到驗證的完整圖文步驟。
memcached.exe -d installmemcached.exe -d start若出現 "failed to install service",確認以管理員權限執行 cmd,且路徑無中文/特殊字元。
Win7 預設未安裝 Telnet Client:
測試連線:
> telnet 127.0.0.1 11211
Trying 127.0.0.1...
Connected to 127.0.0.1.
Escape character is '^]'.
stats
STAT pid 1234
STAT version 1.4.4
...
quit
php -i | findstr "Thread Safety\|Compiler\|Architecture"
# Thread Safety => enabled (TS) / disabled (NTS)
# Compiler => MSVC15 (Visual C++ 2017) 等
# Architecture => x64 / x86
選擇對應版本:`php_memcache-<版本>-
extension=php_memcache.dll (或 `extension=memcache` PHP 7.2+)<?php
// mem_test.php
$mem = new Memcache;
$connected = @$mem->connect('127.0.0.1', 11211);
if (!$connected) {
die("連線失敗: 請確認 memcached 服務已啟動\n");
}
echo "連線成功,版本: " . $mem->getVersion() . "\n";
// 基本操作測試
$mem->set('test_key', 'Hello Memcached!', 0, 60); // 過期 60 秒
$val = $mem->get('test_key');
echo "讀取測試: $val\n";
$mem->set('counter', 0);
for ($i = 0; $i < 5; $i++) {
echo "遞增: " . $mem->increment('counter') . "\n";
}
$mem->close();
| 現象 | 原因/解決 |
|---|---|
| telnet 連不上 | 服務未啟動、防火牆阻擋 11211、IPv6 vs IPv4 (試 `telnet ::1 11211`) |
| PHP Fatal error: Class 'Memcache' not found | DLL 版本不符 (TS/NTS、x86/x64、PHP 版本)、php.ini 未啟用、未重啟 Web 服務 |
| 儲存中文亂碼 | Memcache 存二進位安全,確保 PHP 檔案 UTF-8 無 BOM、資料庫連線編碼一致 |
| 資料莫名消失 | 記憶體不足觸發 LRU 淘汰、過期時間到、重啟服務導致記憶體清空 |
Windows 開發環境跑通 Memcached 流程,能讓本地開發貼近生產架構,提早發現快取邏輯問題。