PHP连不上Memcached的主因是libmemcached未安装或路径错误，导致addServer()返回false且无报错；需按系统安装对应开发包，确保PHP能正确链接该C库。
PHP 连不上 Memcached，八成是 libmemcached 没装或路径错
Memcached 扩展（memcached）不是纯 PHP 实现，它必须通过 libmemcached 这个 C 库和服务器通信。没装这个库，或者装了但 PHP 找不到，new Memcached() 能创建对象，但 addServer() 会返回 false，且不报错——这是最常被忽略的底层原因。
常见现象：var_dump($m->addServer('127.0.0.1', 11211)) 输出 bool(false)，$m->getVersion() 报 Warning: Memcached::getVersion(): no servers added。
- Linux（Debian/Ubuntu）：运行
sudo apt install libmemcached-dev（开发头文件必须）；CentOS/RHEL：用sudo yum install libmemcached-devel或dnf install libmemcached-devel - macOS：先
brew install libmemcached，再pecl install memcached；若 pecl 提示找不到库，加LIBMEMCACHED_DIR=/opt/homebrew/opt/libmemcached（Apple Silicon）或/usr/local/opt/libmemcached（Intel） - 手动编译时，
./configure必须显式指定路径，例如：--with-libmemcached-dir=/usr/local/libmemcached；路径错一个字符，make可能成功，但运行时连接失败
php-memcached 扩展加载了，但 new Memcached() 报 Class not found
这不是代码问题，是扩展根本没进 PHP 运行时。注意：memcached 扩展 ≠ memcache 扩展，名字差一个字母，API 和依赖完全不同。装错就白忙。
验证步骤必须按顺序做：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -m | grep memcached—— 输出必须是memcached（不含e的memcache是旧版，不支持 CAS、SASL、二进制协议等关键特性） - 检查
php.ini中是否启用：extension=memcached.so（不是.dll，不是memcache.so，也不是拼错成memcacached.so） - Windows 用户确认 DLL 文件名和 PHP 版本严格匹配：TS/NTS、VC15/VC16、PHP 8.1/8.2/8.3 —— 错一个就
Class 'Memcached' not found
addServer() 返回 true，但 set() 不生效、get() 返回 false
连接看似成功，实际写入失败。这通常不是网络问题，而是 key 或 value 的合法性陷阱。
-
set()的$key必须是合法字符串：不能含空格、\0、控制字符、大括号{}、竖线|；建议统一用sprintf('%s:%d', $prefix, $id)或md5($raw_key)规范化 -
$expiration参数单位是秒，传字符串如'300'或负数如-1会导致静默失败（返回false），必须传整型300或0 - 值默认会被 PHP 序列化；如果存的是资源、闭包或含循环引用的对象，
set()会失败且不提示；简单类型（string/int/array）最安全 - 批量操作别用循环调
set()，改用setMulti()—— 单次网络请求完成多 key 写入，性能差 5–10 倍
PHP-FPM 下连接复用导致 get() 返回过期数据
Memcached 客户端在 PHP-FPM worker 生命周期内复用连接，但不会自动感知服务端重启或配置变更。更隐蔽的问题是：addServer() 后没设 setOption()，客户端可能缓存旧的 server list 或 failover 行为异常。
- 每次请求都新建
Memcached实例并addServer()是安全做法，但有开销；高频场景建议复用，但必须显式设置关键选项： -
$m->setOption(Memcached::OPT_BINARY_PROTOCOL, true)（提升兼容性与性能） -
$m->setOption(Memcached::OPT_CONNECT_TIMEOUT, 1000)（毫秒级超时，防阻塞） -
$m->setOption(Memcached::OPT_RETRY_TIMEOUT, 2)（连接失败后重试间隔） - 不要依赖
getServerList()返回结果判断“是否连上”——它只反映 addServer() 调用记录，不验证实际连通性
真正麻烦的从来不是安装步骤，而是那些不报错、不抛异常、只默默返回 false 的地方。尤其是 key 格式、过期时间类型、libmemcached 路径这三处，修起来快，但第一次踩中几乎没人能直觉定位。
