Memcached 是高效能分散式記憶體快取系統,廣泛用於減輕資料庫負載、加速動態網站。PHP 透過 Memcached 擴充套件(非舊版 Memcache)操作。
# Ubuntu/Debian
sudo apt install php-memcached memcached
# CentOS/RHEL
sudo yum install php-pecl-memcached memcached
# 啟動 Memcached 服務
sudo systemctl enable --now memcached
# 驗證
php -m | grep memcached
memcached -h
<?php
$mem = new Memcached();
$mem->addServer('127.0.0.1', 11211);
// 選項設定(建議)
$mem->setOption(Memcached::OPT_BINARY_PROTOCOL, true); // 二進位協定,效能較好
$mem->setOption(Memcached::OPT_TCP_NODELAY, true); // 關閉 Nagle 演算法
$mem->setOption(Memcached::OPT_NO_BLOCK, true); // 非阻塞 I/O
$mem->setOption(Memcached::OPT_CONNECT_TIMEOUT, 2000); // 2 秒連線逾時
$mem->setOption(Memcached::OPT_RETRY_TIMEOUT, 2); // 重試間隔
// 基本操作
$mem->set('site:name', 'My Site', 3600); // 存入,過期 1 小時
$mem->set('counter', 0, 0); // 永不過期
echo $mem->get('site:name'); // 讀取
$mem->increment('counter'); // 原子遞增
$mem->decrement('counter'); // 原子遞減
$mem->add('only_once', 'value'); // 只有不存在時才設定
$mem->replace('existing_key', 'new_val'); // 只有存在時才更新
$mem->delete('old_key'); // 刪除
$mem->flush(); // 清空所有(謹慎使用)
// 多鍵批次讀取(效能最佳)
$keys = ['key1', 'key2', 'key3'];
$values = $mem->getMulti($keys);
print_r($values);
<?php
// 陣列/物件自動序列化(預設使用 igbinary 或 php 序列化)
$user = ['id' => 1001, 'name' => 'John', 'roles' => ['admin', 'editor']];
$mem->set('user:1001', $user, 1800);
$cached = $mem->get('user:1001');
// 自訂序列化器(需安裝 igbinary 擴充套件,效能更好)
$mem->setOption(Memcached::OPT_SERIALIZER, Memcached::SERIALIZER_IGBINARY);
// 手動 JSON 序列化(跨語言相容)
$mem->set('api:data', json_encode($data), 3600);
$data = json_decode($mem->get('api:data'), true);
<?php
$mem = new Memcached();
// 新增多台伺服器,第三參數為權重
$mem->addServer('10.0.1.10', 11211, 20); // 權重 20
$mem->addServer('10.0.1.11', 11211, 20);
$mem->addServer('10.0.1.12', 11211, 10); // 權重 10
// 開啟一致性雜湊分佈(libmemcached 1.0.0+)
$mem->setOption(Memcached::OPT_DISTRIBUTION, Memcached::DISTRIBUTION_CONSISTENT);
$mem->setOption(Memcached::OPT_LIBKETAMA_COMPATIBLE, true); // 相容 ketama 演算法
// 查看伺服器清單
print_r($mem->getServerList());
print_r($mem->getStats());
; php.ini 或 php-fpm pool.d/www.conf
session.save_handler = memcached
session.save_path = "127.0.0.1:11211"
; 多台: "10.0.1.10:11211, 10.0.1.11:11211"
<?php
$stats = $mem->getStats();
foreach ($stats as $server => $stat) {
echo "伺服器: $server\n";
echo " 當前連線: {$stat['curr_connections']}\n";
echo " 總連線數: {$stat['total_connections']}\n";
echo " 命中率: " . round($stat['get_hits'] / max($stat['cmd_get'], 1) * 100, 2) . "%\n";
echo " 記憶體使用: " . round($stat['bytes'] / 1024 / 1024, 2) . " MB\n";
echo " 限制記憶體: " . round($stat['limit_maxbytes'] / 1024 / 1024, 2) . " MB\n";
echo " 回收項目: {$stat['evictions']}\n";
}
// 即時監控工具
// memcached-tool 127.0.0.1:11211 stats
// memcached-tool 127.0.0.1:11211 display # 顯示 slab 分配
app:v1:user:1001),避免衝突、方便清理。