php 使用 memcached 扩展前必须安装 libmemcached 库并启用 memcached.so；需用 php -m 验证加载、addserver() 显式连接、set() 用相对秒数过期、序列化统一为 none 避免跨语言乱码。
PHP 无法直接用 Memcached 扩展缓存数据，除非你已安装并正确配置了 memcached.so 扩展和 libmemcached 库 —— 这是绝大多数“缓存不生效”“类未找到”问题的根源。
确认 PHP 真的加载了 memcached 扩展
很多教程跳过这步，直接写 new Memcached()，结果报错 Class 'Memcached' not found。这不是代码问题，是环境没配好。
- 运行
php -m | grep memcached，有输出才表示扩展已启用；若无，需检查php.ini中是否包含extension=memcached.so - 注意区分
memcache（旧版，类名Memcache）和memcached（新版，类名Memcached），二者不兼容 - Linux 下常见缺失依赖：未安装
libmemcached-dev（Ubuntu/Debian）或libmemcached-devel（CentOS/RHEL），导致编译扩展失败 - 使用 Docker 时，
docker-php-ext-install memcached前必须先apt-get install libmemcached-dev
连接池与服务器列表必须显式设置
Memcached 类默认不自动连接任何服务器，new 之后不调用 addServer() 或 addServers()，后续所有 set()/get() 都会静默失败（返回 false，不抛异常）。
- 单机部署常用：
$mc->addServer('127.0.0.1', 11211)；生产环境建议用addServers([['10.0.1.5', 11211], ['10.0.1.6', 11211]])实现负载分散 - 不要复用全局
Memcached实例做长连接 —— 它本身不是线程安全的，CLI 模式下没问题，但 PHP-FPM 多进程场景中，子进程 fork 后可能继承损坏的 socket 状态 - 推荐每次请求新建实例，或用连接池管理器（如
php-pm或自建static单例 +reset()清理）
set() 的第三个参数 $expiration 不是“秒数”而是“Unix 时间戳”（当 > 30 天时）
这是最隐蔽的坑：传 3600 表示 1 小时后过期，但传 1717027200（2024-05-31 的时间戳）也会被接受 —— Memcached 内部判断逻辑是 “如果值 > 30*24*3600，则当作时间戳，否则当作相对秒数”。一旦误传未来时间戳，缓存将长期不更新。
- 统一用相对秒数：如
$mc->set('key', $value, 3600)，避免跨时区或系统时间误差干扰 - 若需精确到某时刻失效（如配合定时任务清缓存），应自己计算差值：
$expire = max(0, strtotime('tomorrow') - time()) -
set()返回true仅表示协议层面接收成功，不代表数据已落盘；可用$mc->getResultCode() === Memcached::RES_SUCCESS二次校验
序列化方式影响跨语言/跨版本兼容性
PHP Memcached 默认用 igbinary（如果启用）或 php_serialize，而 Python/Node.js 客户端通常只认原始字符串或 JSON —— 直接导致其他服务写入的数据 PHP 读出来是乱码或 false。
- 查看当前序列化协议：
var_dump($mc->getOptions()[Memcached::OPT_SERIALIZER])；默认值通常是Memcached::SERIALIZER_PHP - 如需与其他语言互通，强制设为
Memcached::SERIALIZER_NONE，自行json_encode()/json_decode() - 注意：开启
igbinary可提升性能，但要求所有客户端都支持，且 PHP 扩展必须编译时带上--enable-igbinary
真正卡住人的从来不是 API 怎么写，而是扩展有没有装对、服务器连没连上、过期时间算没算错、序列化格式协不协调 —— 这些地方一错，get() 返回 false 你都看不出哪出的问题。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
