PHP如何连接并操作Memcached协议的数据库_使用memcached扩展

本篇文章给大家分享《PHP如何连接并操作Memcached协议的数据库_使用memcached扩展》，覆盖了文章的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

必须先确认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如何连接并操作Memcached协议的数据库_使用memcached扩展》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！