必须先确认php的memcached扩展已安装并启用，否则new memcached()会报class 'memcached' not found；实例化后需显式调用addserver()添加服务器，构造函数不支持传参连接，且set()/get()失败默认静默返回false，须用getresultcode()校验。
PHP连接Memcached服务前必须确认扩展已加载
直接调用 new Memcached() 报错 Class 'Memcached' not found，基本等于扩展没装或没启用。不是写法问题，是环境缺失。
检查方式很简单：php -m | grep memcached（命令行）
或在 Web 环境中输出 phpinfo()，搜索 “memcached” 模块是否列出、版本是否 ≥ 2.0.0（旧版如 1.x 不支持 SASL、部分选项会失效）。
- Ubuntu/Debian：装
php-memcached包（注意不是php-memcache，后者是另一个更老的扩展） - macOS（Homebrew + PHP 8.x）：用
pecl install memcached，确保libmemcached已安装且版本 ≥ 1.0.18 - Windows：下载对应 PHP 版本和线程安全（TS/NTS）的
php_memcached.dll，加到extension_dir并在php.ini中添加extension=php_memcached.dll
new Memcached() 后必须手动 addServer，不能靠构造函数自动连
Memcached 类的构造函数不接受地址参数，传了也忽略。常见错误是写成 new Memcached('127.0.0.1', 11211)，这不会报错但实际没连上任何服务器——后续所有 set()、get() 都静默失败或返回 false。
正确流程是两步：实例化 → 显式添加节点：
$mc = new Memcached();
$mc->addServer('127.0.0.1', 11211); // 可多次调用加多个节点
// 注意：addServer 不校验连通性，失败只在第一次操作时暴露
- 如果服务不可达，
get()返回false，set()返回false，但不会抛异常 - 用
$mc->getServerList()确认节点已注册；用$mc->getStats()查看各节点状态（返回数组，键为host:port，值为统计信息或false） - 生产环境建议加简单连通性兜底，比如
if (!$mc->getVersion()) { throw new RuntimeException('Memcached server unreachable'); }
set() 和 get() 的第三个参数决定数据是否过期，别依赖默认行为
set($key, $value, $expiration) 的 $expiration 参数不是“秒数”那么简单：小于等于 30 天（2592000 秒）按秒算；大于则按 Unix 时间戳解释。这个隐式切换极易导致缓存长期不更新或秒级就失效。
例如：$mc->set('foo', 'bar', 3600) 是 1 小时后过期；但 $mc->set('foo', 'bar', 1717027200)（2024-05-30 时间戳）会被当成绝对时间，若当前时间已超，缓存立刻失效。
- 推荐统一用相对时间，且显式写清楚单位：
$mc->set('key', $val, 600)表示 10 分钟 -
get()没有超时参数，只负责读；不存在的 key 直接返回false，无法区分“key 不存在”和“key 存在但值就是 false”——需要业务层约定空值兜底（如存null时改存'__NULL__'字符串） - 批量操作用
setMulti()/getMulti()，它们的过期时间参数是统一的整数值，不支持 per-key 过期
多服务器部署时，一致性哈希和故障转移需手动配置
默认情况下 Memcached 扩展使用标准哈希（CRC32），节点增减会导致大量 key 重分布、缓存雪崩。它不自动启用一致性哈希，也不自动踢掉宕机节点。
开启一致性哈希只需一行：$mc->setOption(Memcached::OPT_LIBKETAMA_COMPATIBLE, true)。之后新增或下线一个节点，只有约 1/N 的 key 会迁移（N 为节点数）。
- 故障节点不会自动剔除：即使
addServer()加了 3 个节点，其中一个挂了，set()仍可能路由过去并失败。要用$mc->setOption(Memcached::OPT_AUTO_EJECT_HOSTS, true)启用自动摘除，并配合Memcached::OPT_SERVER_FAILURE_LIMIT和Memcached::OPT_RETRY_TIMEOUT控制摘除策略 - 所有 setOption 必须在
addServer()之后、首次操作之前调用，否则无效 - 一致性哈希开启后，
getServerByKey($key)可查某个 key 当前路由到哪个节点，方便排查分片问题
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
