phpEnv不提供Memcached扩展，需手动编译安装：先确保memcached服务端运行、libmemcached开发库已装、phpEnv当前PHP路径明确；再用pecl下载源码，通过phpize和configure（指定php-config及libmemcached路径）编译安装；最后将生成的memcached.so绝对路径写入对应php.ini并验证。
phpEnv 本身不提供 Memcached 扩展，它只是 PHP 版本管理工具；开启 Memcached 需手动编译安装扩展，并确保底层 memcached 服务端已运行。
确认 phpEnv 环境与依赖是否就绪
phpEnv 只负责切换 PHP 二进制和配置，不自动装扩展。你得自己处理三件事：
- 系统已安装
memcached服务端（不是扩展），监听127.0.0.1:11211（用netstat -tlnp | grep :11211验证） - 已安装
libmemcached开发库（Ubuntu/Debian：运行sudo apt install libmemcached-dev；CentOS/RHEL：sudo yum install libmemcached-devel） - 当前 phpEnv 激活的 PHP 版本路径明确，比如
~/.phpenv/versions/8.2.12，后续要用到它的bin/php-config
用 pecl 为 phpEnv 当前版本安装 memcached 扩展
别用系统包管理器（如 apt install php-memcached），它装的是系统默认 PHP 的扩展，对 phpEnv 无效。必须用 pecl 针对当前版本编译：
先确保 pecl 可用：~/.phpenv/versions/8.2.12/bin/php -m | grep pecl（若无输出，说明未启用 pear，需先运行 ~/.phpenv/versions/8.2.12/bin/php ~/pear/install-pear-nozlib.phar）
立即学习“PHP免费学习笔记（深入）”；
然后执行：
cd /tmp pecl download memcached tar xzf memcached-*.tgz cd memcached-* ~/.phpenv/versions/8.2.12/bin/phpize ./configure --with-php-config=~/.phpenv/versions/8.2.12/bin/php-config --with-libmemcached-dir=/usr make && make install
成功后会输出类似：Installing '/home/xxx/.phpenv/versions/8.2.12/lib/php/extensions/no-debug-non-zts-20220829/memcached.so'
把这个路径记下来，下一步要写进 php.ini。
把扩展注入 phpEnv 当前 PHP 的 php.ini
phpEnv 每个版本的配置文件位置固定：~/.phpenv/versions/8.2.12/etc/php.ini（若不存在，可复制一份默认模板，或运行 ~/.phpenv/versions/8.2.12/bin/php --ini 确认加载路径）
在该 php.ini 文件末尾添加：
extension="/home/xxx/.phpenv/versions/8.2.12/lib/php/extensions/no-debug-non-zts-20220829/memcached.so"
注意替换 /home/xxx 为你的真实家目录路径；不要用相对路径，extension=memcached 这种写法会失败。
验证是否生效：
~/.phpenv/versions/8.2.12/bin/php -m | grep memcached
应输出 memcached；再运行：
~/.phpenv/versions/8.2.12/bin/php -r "var_dump(class_exists('Memcached'));"应返回 bool(true)。
连接失败时优先检查这三点
即使扩展加载成功，new Memcached() 后 addServer() 返回 false 或 getVersion() 报错，大概率是以下问题：
-
memcached服务没跑起来，或监听地址不是127.0.0.1:11211（查ps aux | grep memcached和启动参数） - SELinux 或 firewalld 拦了本地回环连接（CentOS/RHEL 上临时关 SELinux 测试：
sudo setenforce 0） - phpEnv 切换后，CLI 和 Web SAPI 使用的不是同一份
php.ini（Web 端需额外确认 Apache/Nginx 加载的 ini 路径，可用phpinfo()页面查看）
最易被忽略的是：phpEnv 管理的 CLI 环境和 Web 服务器（如 Nginx + PHP-FPM）根本不在同一个 PHP 实例里——你在 CLI 装好了，Web 端可能还在用系统 PHP 或另一个 phpEnv 版本，得分别验证。
