PHP操作Memcached需启用memcached扩展并确保服务端运行，连接失败、读不到数据等问题多源于扩展未启用或服务不可达；应使用getResultCode()判断操作结果而非返回值真假。
PHP 操作 Memcached 需要 Memcached 扩展（不是过时的 memcache），且服务端必须运行 memcached 进程。直接连接失败、读不到刚写入的数据、超时或序列化异常，基本都出在这几个环节。
确认扩展已启用且服务可达
先验证 PHP 是否加载了正确的扩展，并能连上服务：
-
php -m | grep memcached—— 必须输出memcached（不是memcache） -
php -r "var_dump(class_exists('Memcached'));"—— 应返回bool(true) - 检查
memcached服务是否在监听：运行netstat -tlnp | grep :11211或ss -tlnp | grep :11211 - 如果服务在远程主机，确保防火墙放行
11211端口，且 PHP 客户端连接地址/端口配置正确
实例化与基础写入（set()）
Memcached 默认使用二进制协议和无压缩方式，写入前建议显式设置选项以避免隐式行为差异：
$mc = new Memcached();
$mc->addServer('127.0.0.1', 11211);
// 推荐设置：禁用自动序列化（除非你真需要存数组/对象）
$mc->setOption(Memcached::OPT_SERIALIZER, Memcached::SERIALIZER_PHP);
// 更安全的写法是关闭自动序列化，自己控制
$mc->setOption(Memcached::OPT_SERIALIZER, Memcached::SERIALIZER_NONE);
// 写入字符串（无需序列化）
$mc->set('user:1001', '{"name":"Alice","role":"admin"}', 300); // 5分钟过期
// 写入整数（注意：SERIALIZER_NONE 下只能存字符串或数字，不能存数组）
$mc->set('counter:login', 42, 60);
⚠️ 常见坑：set() 返回 false 不一定代表失败——它可能只是因 key 已存在而跳过（取决于 OPT_COMPRESSION 和序列化设置）。用 $mc->getResultCode() === Memcached::RES_SUCCESS 判断更可靠。
立即学习“PHP免费学习笔记（深入）”；
安全读取与空值处理（get()）
get() 在 key 不存在、过期、或网络中断时都返回 false，无法区分“没找到”和“存了 false”。必须配合 getResultCode() 判断：
$mc = new Memcached();
$mc->addServer('127.0.0.1', 11211);
$value = $mc->get('user:1001');
if ($mc->getResultCode() === Memcached::RES_NOTFOUND) {
// key 不存在，应触发回源查询并 set()
} elseif ($mc->getResultCode() === Memcached::RES_SUCCESS) {
// 成功读到数据，可直接用 $value
} else {
// 其他错误：RES_CONNECTION_FAILURE、RES_TIMEOUT 等
error_log('Memcached read failed: ' . $mc->getResultMessage());
}
别依赖 empty($value) 或 !$value 判定缺失——如果缓存里存的是 "0"、"" 或 false 字符串，逻辑会出错。
批量操作与原子性限制
getMulti() 和 setMulti() 支持批量，但要注意：
-
setMulti()是“尽力而为”，部分 key 失败不会抛异常，需遍历getResultCode()逐个检查 - 没有事务，不支持 CAS（compare-and-swap）以外的原子操作；如需计数器自增，用
increment()/decrement()，但它们只对数字有效 - 大体积值（>1MB）可能被服务端截断，
memcached默认最大 item 大小是 1MB，可通过启动参数-I调整，但不推荐
真正难搞的是缓存穿透和并发写冲突——这些得靠业务层加锁或布隆过滤器，Memcached 本身不提供解决方案。
