騰訊 CMEM PHP 擴展編譯安裝全流程指南

什麼是 CMEM？

CMEM (Cloud Memory) 是騰訊雲提供的高性能內存級持久化存儲服務，基於 Key-Value 模型，適用於數據量小、訪問極高、強一致性要求場景（如 Session 存儲、配置中心、計數器）。

核心差異：為什麼不直接用 Memcached？

危險場景：標準 Memcached 客戶端收到 NO_DATA 時無法判斷是「Key 不存在」還是「網絡故障」。若直接執行 InitData() 會導致用戶數據被誤初始化覆蓋。

編譯安裝步驟

1. 環境準備

• PHP 5.3+ (示例用 5.3.6)
• 已安裝 phpize、php-config
• GCC、make、autoconf

2. 下載源碼

cd /home/src
wget https://cmem.googlecode.com/files/cmem-2.2.6.tar.gz
tar zxvf cmem-2.2.6.tar.gz
cd cmem-2.2.6

3. 編譯配置

/usr/local/webserver/php/bin/phpize
./configure --with-php-config=/usr/local/webserver/php/bin/php-config
make

4. 安裝擴展

# 複製 .so 到擴展目錄（路徑視 PHP 版本而定）
cp modules/cmem.so /usr/local/webserver/php/lib/php/extensions/no-debug-non-zts-20090626/

5. 配置 php.ini

; 在 [PHP] 區塊添加
extension = "cmem.so"

6. 重啟 PHP-FPM / Apache

service php-fpm restart
# 或
service httpd restart

驗證安裝

cat > /tmp/cmemtest.php <<'EOF'
<?php
if (!class_exists('CMEM')) {
    echo "CMEM NOT FOUND!\n";
} else {
    echo "CMEM IS OK\n";
}
EOF

/usr/local/webserver/php/bin/php -f /tmp/cmemtest.php

輸出 CMEM IS OK 即成功。

基本使用範例

<?php
$mem = new CMEM();
$mem->addServer('10.0.0.1', 11211); // CMEM 代理地址

// 寫入
$mem->set('user:1001', ['name'=>'張三', 'vip'=>true], 0, 3600);

// 讀取（擴展協議可區分錯誤）
$result = $mem->get_ext('user:1001');
if ($result === false) {
    // 真正的 NOT_FOUND，可安全初始化
    $data = initUserData(1001);
    $mem->set('user:1001', $data);
} elseif ($result === CMEM::ERROR) {
    // 網絡/服務異常，走降級邏輯
    $data = getFromFallback(1001);
} else {
    $data = $result;
}

常見問題排查

生產環境建議

1. 連接池：配合 PHP-FPM 工作進程模型，每進程復用連接
2. 錯碼處理：務必區分 NOT_FOUND 與 ERROR，避免雪崩
3. 監控告警：接入 Prometheus 監控命中率、延遲、錯誤率
4. 版本鎖定：composer.json 鎖定擴展版本，防止升級不兼容