PHP 连 Memcached 需安装 memcached 扩展(非 memcache),依赖 libmemcached 库;Linux 用 apt 安装,macOS 用 brew + pecl,Windows 下载 dll;需启用 extension=memcached.so 并调用 addServer() 显式连接,key 必须为合法字符串,值默认序列化,注意超时、重试及缓存失效策略。
PHP 本身不自带 Memcached 客户端,必须安装 memcached 扩展(注意不是 memcache,后者是旧版、功能更少)。它依赖系统级的 libmemcached 库,所以不能只用 pecl install memcache 混淆。
sudo apt install php-memcached,然后确认 extension=memcached.so 在 php.ini 中已启用brew install libmemcached → pecl install memcached → 检查 php.ini 是否加载了 extension=memcached.so
php_memcached.dll,放进 ext/ 目录并配置 php.ini
php -m | grep memcached 或 phpinfo() 查看是否加载成功;若报 Class 'Memcached' not found,说明扩展没启或版本不匹配Memcached 构造后默认不自动连接,得显式调用 addServer() 或 addServers()。直接 $m->set() 会静默失败,不报错但返回 false,这是最容易踩的坑。
systemctl status memcached(Linux)或 brew services list | grep memcached(macOS)addServer('127.0.0.1', 11211) 是默认组合;若改过配置(比如监听 0.0.0.0 或非 11211 端口),这里必须同步localhost(可能走 IPv6 或解析慢),改用 127.0.0.1
getServerList() 和 getStats() 能快速验证连通性,比如:var_dump($m->getServerList(), $m->getStats());
Memcached::set() 默认对值做 serialize(),但如果你之前用过 memcache 扩展或别的客户端,可能误设了 OPT_SERIALIZER,导致取出来是乱码或 false。

md5() 或 sprintf('%s:%s', $prefix, $id) 规范化__sleep()/__wakeup()
0 表示永不过期,但实际受服务器最大 TTL 限制,通常 30 天);传入负数或字符串会静默失败setMulti()/getMulti(),比循环单条快得多,也减少网络往返Memcached 实例在 PHP-FPM worker 进程内是常驻的,但每次请求都是新实例——除非你手动持久化。盲目用 new Memcached() 在每次请求里创建,开销不大,但若频繁重建连接(比如没调 addServer 就 set),反而更慢。
addServer 提到初始化阶段pconnect(PHP 不支持 Memcached 的持久连接),所谓“长连接”靠的是 FPM worker 复用同一进程内的 Memcached 对象getResultCode() 和 getResultMessage(),出错时不光看返回值,还得查这些,比如 getResultCode() === Memcached::RES_NOTFOUND 是 key 不存在,不是连接失败setOptions(['MEMCACHED_OPT_CONNECT_TIMEOUT' => 1000]) 控制毫秒级连接超时