阿里雲 ACE 平台提供的 Memcache 服務是面向開發者的 分布式緩存服務,以 Key-Value 形式緩存小數據,實現跨實例共享、重啟不丟失、毫秒級讀寫,有效減輕後端存儲 (MySQL/RDS) 壓力。本文涵蓋系統架構、核心 API、完整代碼示例、進階用法與避坑指南。
| 方法 | 簽名 | 說明 |
|---|---|---|
| init | bool Memcache::init() | 初始化連接 (內部自動發現 Agent 位址) |
| get | array Memcache::get(array $keys [, array &$flags]) | 批量獲取多個 Key,返回關聯陣列 |
| set | bool Memcache::set(string $key, mixed $var [, int $flag [, int $expire]]) | 寫入/覆蓋 Key,flag 自定義標記,expire 過期秒數 (0=永久) |
| add | bool add(string $key, mixed $var [, int $flag [, int $expire]]) | 僅當 Key 不存在時寫入 (原子性) |
| replace | bool replace(string $key, mixed $var [, int $flag [, int $expire]]) | 僅當 Key 存在時覆蓋 (原子性) |
| increment | bool increment(string $key [, int $value=1]) | 數值原子遞增 (計數器場景) |
| decrement | bool decrement(string $key [, int $value=1]) | 數值原子遞減 |
| delete | bool delete(string $key [, int $timeout=0]) | 刪除 Key,timeout 秒內禁止重新添加 |
| close | bool close() | 關閉連接,釋放資源 |
以下標準 Memcache 介面在 ACE 環境中 為空實現或直接返回 false,請勿使用:
addServer, connect, flush, pconnect, setServerParams
原因:連接管理由平台 Agent 統一代理,開發者無需/無法手動管理連接池。
<?php
// 1. 建立連接
$mem = new Memcache();
$mem->init(); // 必須調用,內部自動獲取叢集地址
// 2. 基礎寫讀
$mem->set('key6', 'hello', 0, 120); // 過期 120 秒
$val = $mem->get('key6');
echo "Get key6 value: $val\n";
// 3. add 僅當不存在
$mem->add('key7', 'welcome you', 0, 120);
$val = $mem->get('key7');
echo "Get add key7 value: $val\n";
// 4. replace 僅當存在
$mem->set('key7', 'welcome', 0, 120); // 先確保存在
$mem->replace('key7', 'welcome updated', 0, 120);
$val = $mem->get('key7');
echo "Get replace key7 value: $val\n";
// 5. 計數器原子操作
$mem->set('counter', 0, 0, 0);
$mem->increment('counter', 5); // 5
$mem->decrement('counter', 2); // 3
echo "Counter: " . $mem->get('counter') . "\n";
// 6. 刪除與驗證
$mem->delete('key6');
$val = $mem->get('key6');
echo "Get key6 after delete: " . ($val === false ? 'false' : $val) . "\n";
// 7. 關閉連接
$mem->close();
?>
$key = 'user:' . $uid;
$data = $mem->get($key);
if ($data === false) {
// 雙重檢查鎖定模式防止並發穿透
$lock = $mem->add('lock:' . $key, 1, 0, 10); // 10秒鎖
if ($lock) {
$data = $db->query("SELECT * FROM users WHERE id=$uid");
$mem->set($key, $data ? $data : 'NULL_CACHE', 0, 300); // 空值也緩存 5 分鐘
$mem->delete('lock:' . $key);
} else {
usleep(50000); // 等待 50ms 重試
$data = $mem->get($key);
}
}
if ($data === 'NULL_CACHE') $data = null;
ini_set('session.save_handler', 'memcache');
ini_set('session.save_path', 'tcp://localhost:11211'); // ACE 環境無需指定,init() 自動處理
session_start();
注意:ACE 已內建 Session 服務 (見《阿里雲 Session》文檔),優先使用平台提供的 session_start() 即可。
# 批量獲取 (單次網路往返)
$keys = ['user:1', 'user:2', 'user:3', 'product:100'];
$result = $mem->get($keys); // 返回 ['user:1'=>..., 'user:2'=>...]
# 批量設定 (需循環,無原生 mset)
foreach ($data as $k => $v) {
$mem->set($k, $v, 0, 3600);
}
| 錯誤現象 | 原因 | 解決 |
|---|---|---|
| get 返回 false 但鍵確實存在 | 值為 false/0/空字串/空陣列 | 使用 === false 嚴格判斷,或用 isset($result[$key]) |
| set 返回 true 但 get 拿不到 | expire=0 但平台策略定期清理 / 記憶體淘汰 | 設定合理 expire (如 3600),監控命中率 |
| increment 返回 false | 值非純數字字串 / 鍵不存在 | 先 set 數字字串,或用 add 初始化 |
| 連接超時 / 間歇性失敗 | Agent 未就緒 / 網路抖動 / 緩存節點遷移 | init() 重試邏輯 / 指數退避 / 熔斷降級 |
| 儲存大對象失敗 | 單 Key 限制 (通常 1MB) | 序列化壓縮 / 拆分多 Key / 改用 Storage/OSS |
get_hits / (get_hits + get_misses) 目標 > 95%addServer/connect 調用,改用 init()memcached.conf、連接池參數ACE Memcache 以「零運維、共享一致、彈性擴展」三大特性,成為雲原生應用緩存層的首選組件。合理使用原子操作、批量介面、空值緩存等模式,可最大化發揮其效能優勢。