PHP Session 儲存至 Memcached/Memcached 完整配置指南：兩大擴展差異與最佳實踐

前言：memcache vs memcached 擴展，傻傻分不清？

PHP 有兩個 Memcached 客戶端擴展，**名稱極易混淆**，配置方式完全不同。本文徹底釐清差異，提供標準化配置模板。

兩大擴展對比表

配置模板：memcache 擴展 (舊專案維護)

php.ini 全域

extension=memcache.so
session.save_handler = memcache
session.save_path = "tcp://127.0.0.1:11211?persistent=1&weight=2&timeout=1&retry_interval=15"
; 多伺服器用逗號分隔
; session.save_path = "tcp://10.0.1.10:11211?persistent=1, tcp://10.0.1.11:11211?persistent=1"

運行時動態

ini_set('session.save_handler', 'memcache');
ini_set('session.save_path', 'tcp://127.0.0.1:11211?persistent=1&weight=2');
session_start();

配置模板：memcached 擴展 (新專案首選)

php.ini 全域

extension=memcached.so
session.save_handler = memcached
session.save_path = "127.0.0.1:11211"
; 多伺服器
; session.save_path = "10.0.1.10:11211, 10.0.0.11:11211"
; 帶權重 (memcached 3.0+)
; session.save_path = "10.0.1.10:11211:10, 10.0.1.11:11211:20"

; 關鍵調優
memcached.sess_prefix = "myapp_"        ; Key 前綴，防衝突
memcached.sess_binary_protocol = On     ; 二進制協議 (效能更好)
memcached.sess_consistent_hash = On     ; 一致性雜湊 (擴容不遷移)
memcached.sess_locking = On             ; Session 鎖 (防併發競態)
memcached.sess_lock_wait = 150000       ; 鎖等待微秒 (150ms)
memcached.sess_lock_max_wait = 0        ; 最大等待 (0=不限制)
memcached.sess_lock_retries = 5         ; 重試次數

運行時動態

ini_set('session.save_handler', 'memcached');
ini_set('session.save_path', '127.0.0.1:11211');
// 進階選項需 php.ini 或 Memcached 物件設定
$memcached = new Memcached();
$memcached->setOption(Memcached::OPT_BINARY_PROTOCOL, true);
$memcached->setOption(Memcached::OPT_LIBKETAMA_COMPATIBLE, true); // 一致性雜湊
// 注意：Session handler 使用內部連接池，無法直接注入 $memcached

框架整合配置

Laravel (config/session.php)

'driver' => 'memcached',
'connection' => 'session',

// config/database.php
'memcached' => [
    'session' => [
        'host' => env('MEMCACHED_HOST', '127.0.0.1'),
        'port' => env('MEMCACHED_PORT', 11211),
        'weight' => 100,
        'persistent_id' => 'session_pool',
        'options' => [
            Memcached::OPT_BINARY_PROTOCOL => true,
            Memcached::OPT_LIBKETAMA_COMPATIBLE => true,
            Memcached::OPT_TCP_NODELAY => true,
            Memcached::OPT_CONNECT_TIMEOUT => 2000,
            Memcached::OPT_POLL_TIMEOUT => 2000,
        ],
    ],
],

Symfony (framework.yaml)

framework:
    session:
        handler_id: session.handler.memcached
        cookie_secure: true
        cookie_httponly: true
        gc_probability: 0 # 交給 memcached 過期

services:
    memcached.session:
        class: Memcached
        calls:
            - [setOption, [OPT_BINARY_PROTOCOL, true]]
            - [setOption, [OPT_LIBKETAMA_COMPATIBLE, true]]
            - [addServer, ['%env(MEMCACHED_HOST)%', '%env(int:MEMCACHED_PORT)%', 100]]
    
    session.handler.memcached:
        class: Symfony\Component\HttpFoundation\Session\Storage\Handler\MemcachedSessionHandler
        arguments: ['@memcached.session', { prefix: 'sf_sess_' }]

驗證與調試

# 1. 檢查 Session 是否寫入
telnet 127.0.0.1 11211
get memc.sess.key.  # memcache 前綴
get myapp_          # memcached 自定義前綴

# 2. PHP 代碼驗證
addServer('127.0.0.1', 11211);
$key = 'myapp_' . $sessionId; // 依前綴調整
var_dump($mem->get($key));

關鍵調優參數深度解析 (memcached 擴展)

避坑指南

• 混用兩個擴展：專案中**只能安裝/啟用一個**，否則 `session.save_handler` 衝突
• save_path 格式錯誤：memcache 用 `tcp://`，memcached **不帶協議前綴**
• Session 鎖導致請求阻塞：長耗時請求調用 `session_write_close()` 釋放鎖
• Key 過期時間與 gc_maxlifetime 不一致：確保 `session.gc_maxlifetime` ≤ Memcached 過期設定
• 防火牆/安全組未放行 11211**應用伺服器需能 TCP 連接 Memcached 端口