phpenv不内置memcached服务或扩展，必须手动为当前激活php版本编译安装memcached.so、配置php.ini，并独立启动memcached服务端，否则将出现“class 'memcached' not found”或缓存读写异常。
phpEnv 本身不内置 Memcached 服务或扩展，必须手动安装并启用 —— 这是所有“Class 'Memcached' not found”和“缓存写入成功但读不到”的根本原因。
确认 phpEnv 当前 PHP 版本与扩展路径
phpEnv 是多版本 PHP 环境管理工具，每个 PHP 实例独立配置。你不能假设 php-memcached 已装进当前激活的版本里。
- 先运行
phpenv version查看当前激活的 PHP 版本（如8.1.28） - 再执行
phpenv which php得到该版本 PHP 可执行文件路径（如~/.phpenv/versions/8.1.28/bin/php） - 用它查扩展目录：
~/.phpenv/versions/8.1.28/bin/php -r "echo ini_get('extension_dir');"，记下结果（如/home/user/.phpenv/versions/8.1.28/lib/php/extensions/no-debug-zts-20210902） - 检查该目录下是否存在
memcached.so；若无，说明扩展未编译安装
在 phpEnv 中编译安装 memcached.so 扩展
phpEnv 下不能直接 apt install php-memcached（那是系统级包，不作用于 phpEnv 的私有环境），必须源码编译。
- 确保已安装
libmemcached-dev（Ubuntu/Debian）或libmemcached-devel（CentOS/RHEL），否则编译会失败 - 进入 phpEnv 对应 PHP 源码目录（通常在
~/.phpenv/sources/<version>/</version>），或用pecl install memcached（需先用phpenv rehash确保pecl指向当前版本） - 若
pecl install报错找不到libmemcached，加参数指定路径：pecl install -D LIBMEMCACHED_DIR=/usr（Linux 常见路径）或/opt/homebrew/opt/libmemcached（macOS Homebrew） - 安装成功后，
memcached.so会落到上一步查到的extension_dir中 - 在当前 PHP 版本的
php.ini（路径类似~/.phpenv/versions/8.1.28/etc/php.ini）末尾添加：extension=memcached.so
启动 Memcached 服务并测试连接
phpEnv 只管 PHP，不管 Memcached 服务端 —— 你得自己装、自己启、自己配端口。
- 用系统包管理器安装服务端：
sudo apt install memcached（Ubuntu）或brew install memcached（macOS） - 检查是否监听预期地址：
ss -tlnp | grep :11211；若只看到127.0.0.1:11211，说明仅本地可连，符合 phpEnv 开发场景 - 写一段最小验证脚本：
<?php $mc = new Memcached();
$mc->addServer('127.0.0.1', 11211);
var_dump($mc->getStats()); // 应返回数组，含 uptime、cmd_get 等字段
?>
- 如果
getStats()返回空数组或false，大概率是addServer()失败（网络不通、端口被占、防火墙拦截） - 不要跳过这步：
$mc->set('test', 'ok', 5)后立刻get('test')，确认读写通路闭环
set() 过期时间传参陷阱与序列化风险
在 phpEnv 环境中，set() 第三个参数 $expiration 的行为极易误判，尤其当你从其他框架或旧代码复制逻辑时。
- 传
3600是 1 小时后过期；但传time() + 3600是时间戳，一旦系统时间不准或跨时区，缓存可能永久不更新 - phpEnv 默认使用
igbinary序列化（若已装），而生产环境常为php_serialize或NONE；混用会导致get()返回false或乱码 - 强制统一序列化方式：
$mc->setOption(Memcached::OPT_SERIALIZER, Memcached::SERIALIZER_PHP);（PHP 原生）或Memcached::SERIALIZER_IGBINARY（需扩展支持） - 别依赖
set()返回true就认为写入成功 —— 调用$mc->getResultCode() === Memcached::RES_SUCCESS才算真正落库
最常被忽略的是：phpEnv 每次切换 PHP 版本，都得重新编译 memcached.so 并重配 php.ini；而本地 memcached 服务默认没开 SASL 认证，但一旦你后续接入云 Memcached（如阿里云、AWS ElastiCache），addServer() 就得换 addServers() 配用户名密码，协议层就不是直连了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
