; php.ini
session.save_handler = memcached
; 多台 Memcached 伺服器用逗號分隔,支援權重、持久連線、超時等參數
session.save_path = "tcp://10.0.1.11:11211?persistent=1&weight=2, tcp://10.0.1.12:11211?persistent=1&weight=1"
# .htaccess
php_value session.save_handler "memcached"
php_value session.save_path "tcp://127.0.0.1:11211?persistent=1"
<?php
// 必須在 session_start() 之前呼叫
ini_set('session.save_handler', 'memcached');
ini_set('session.save_path', 'tcp://10.0.1.11:11211?persistent=1&weight=2,tcp://10.0.1.12:11211?persistent=1&weight=1');
// 區分 memcache (舊擴展) 與 memcached (新擴展,基於 libmemcached)
// 兩者 save_handler 名稱不同,save_path 格式也不同!
// memcache (舊): tcp://host:port
// memcached (新): host:port (無 tcp:// 前綴)
if (extension_loaded('memcached')) {
ini_set('session.save_handler', 'memcached');
ini_set('session.save_path', '10.0.1.11:11211,10.0.1.12:11211');
} elseif (extension_loaded('memcache')) {
ini_set('session.save_handler', 'memcache');
ini_set('session.save_path', 'tcp://10.0.1.11:11211,tcp://10.0.1.12:11211');
}
session_start();
?>
# 基礎啟動(開發環境)
memcached -d -m 128 -p 11211 -l 127.0.0.1 -u www-data
# 生產環境推薦參數
memcached -d \
-m 2048 \ # 分配 2GB 記憶體
-c 10240 \ # 最大並發連線數
-t 4 \ # 工作執行緒數(CPU 核心數)
-l 10.0.1.11 \ # 綁定內網 IP,勿暴露公網
-p 11211 \
-u www-data \ # 非 root 權限運行
-P /var/run/memcached.pid \
-vv >> /var/log/memcached.log 2>&1 # 詳細日誌
<?php
// test_write.php
session_start();
if (!isset($_SESSION['test'])) {
$_SESSION['test'] = time();
}
$_SESSION['test3'] = time();
$_SESSION['user'] = ['id' => 123, 'name' => '張三', 'roles' => ['admin', 'editor']];
echo "Session ID: " . session_id() . "
";
echo "TEST: " . $_SESSION['test'] . "
";
echo "TEST3: " . $_SESSION['test3'] . "
";
print_r($_SESSION['user']);
?>
<?php
// test_verify.php
$mem = new Memcached();
$mem->addServer('127.0.0.1', 11211);
// Session ID 格式:memc.sess.key.
$sessionId = 'memc.sess.key.' . 'abc123...'; // 從上一步獲取
$data = $mem->get($sessionId);
echo "Raw data:\n";
var_dump($data);
/*
輸出範例:
string(87) "test|i:1701234567;test3|i:1701234568;user|a:3:{i:0;i:123;s:4:\"name\";s:6:\"張三\";s:5:\"roles\";a:2:{i:0;s:5:\"admin\";i:1;s:6:\"editor\";}}"
*/
?>
# 安裝 memcached-tool (通常隨 memcached 套件提供)
# 查看所有 keys
memcached-tool 10.0.1.11:11211 dump | grep memc.sess.key
# 查看特定 key 內容
echo "get memc.sess.key.abc123" | nc 10.0.1.11 11211
# 統計資訊
memcached-tool 10.0.1.11:11211 stats
PHP Session 預設啟用鎖(`session.use_strict_mode=1`),防止同一 Session 並發請求導致資料競爭。Memcached 透過 `GET`/`SET` 原子操作實現分散式鎖。
<?php
// 關鍵配置:鎖超時與重試
ini_set('session.memcached.lock_wait', '1500000'); // 微秒,預設 1.5s
ini_set('session.memcached.lock_max_wait', '30000000'); // 最大等待 30s
ini_set('session.memcached.lock_retry', '100000'); // 重試間隔 0.1s
?>
<?php
// 使用一致性哈希分發(memcached 擴展預設支援)
ini_set('session.save_path',
'10.0.1.11:11211?weight=3,' . // 主節點權重高
'10.0.1.12:11211?weight=2,' . // 備用節點
'10.0.1.13:11211?weight=1' // 新節點低權重平滑遷移
);
// 啟用一致性哈希(需 memcached 3.0+)
$mem = new Memcached();
$mem->setOption(Memcached::OPT_DISTRIBUTION, Memcached::DISTRIBUTION_CONSISTENT);
$mem->setOption(Memcached::OPT_LIBKETAMA_COMPATIBLE, true);
?>
Memcached 重啟會導致 Session 全部遺失。關鍵業務建議:
| 現象 | 可能原因 | 解決方案 |
|---|---|---|
| Session 頻繁失效 | session.gc_maxlifetime < save_path TTL | 確保 php.ini `session.gc_maxlifetime` >= Memcached 實際 TTL |
| 「Session ID 衝突」錯誤 | 多專案共用 Memcached 未隔離前綴 | 設定 `session.memcached.prefix = "app1:"` |
| 並發請求卡住 | Session 鎖等待超時 | 調大 `lock_max_wait`、優化慢查詢、避免長時間持有 Session |
| 資料不一致 | 多資料中心無同步 | 改用 Redis Cluster 或跨區域同步方案 |
將 Session 遷移至 Memcached 是 **無狀態水平擴展** 的關鍵步驟。核心要點: