phpenv 不负责启用 PHP 扩展，Redis 扩展需为每个 PHP 版本单独编译安装并确保 Redis 服务运行；须确认当前 phpenv 版本及对应 php.ini 路径，用 pecl install redis 在指定版本上下文中安装，配置 extension=redis.so 后重启服务，并验证 Redis 连通性与配置细节。
phpenv 本身不负责启用 PHP 扩展，它只管理 PHP 版本切换；Redis 扩展必须针对每个 PHP 版本单独编译安装，并确保 Redis 服务正在运行。
确认当前 phpenv 管理的 PHP 版本和路径
先搞清你实际在用哪个 PHP：运行 phpenv version 查看当前激活版本（如 8.3.13），再用 which php 或 php -i | grep "Configuration File" 找到它对应的 php.ini 路径。不同版本的 PHP 有各自独立的配置文件和扩展目录，混用会导致“明明装了却报 Class not found”。
常见误区：
- 在系统全局
/etc/php/8.3/cli/php.ini里加extension=redis.so，但phpenv下的 PHP 实际加载的是~/.phpenv/versions/8.3.13/etc/php.ini - 用
pecl install redis时没指定 PHP SAPI，结果扩展被装到了 CLI 版本，而 FPM 模式下仍不可用
为当前 phpenv 版本安装 redis 扩展
必须进入该版本的构建上下文安装，否则扩展不会出现在正确位置：
立即学习“PHP免费学习笔记（深入）”；
- 执行
phpenv shell 8.3.13（替换成你的目标版本） - 确保已安装编译依赖：
sudo apt install php-dev build-essential（Ubuntu/Debian）或brew install autoconf automake libtool（macOS） - 运行
pecl install redis—— 它会自动检测当前phpize路径并编译进对应版本的ext/目录 - 编辑该版本的
php.ini（路径类似~/.phpenv/versions/8.3.13/etc/php.ini），添加extension=redis.so - 重启 Web 服务（如 Nginx + php-fpm）或重新加载终端，再运行
php -m | grep redis验证
注意：pecl install 在 phpenv 环境下默认使用当前 shell 版本的 phpize，但如果失败，可手动指定：~/.phpenv/versions/8.3.13/bin/phpize && ./configure --with-php-config=~/.phpenv/versions/8.3.13/bin/php-config && make && sudo make install
连接 Redis 服务前必须确认服务端就绪
phpenv 不管 Redis 服务是否存在，它只管 PHP。很多人卡在这步：PHP 扩展装好了，new Redis() 却抛出 Connection refused。
- 检查 Redis 是否运行：
redis-cli ping应返回PONG；若报错，先启动服务：redis-server /usr/local/etc/redis.conf（macOS brew 安装）或sudo systemctl start redis（Linux systemd） - 确认端口未被占用：
lsof -i :6379或netstat -tuln | grep 6379 - 若用 Docker，确保容器网络互通，host 不能写
localhost，得用host.docker.internal（macOS/Windows）或宿主机 IP（Linux） - 密码认证要显式调用
$redis->auth('your_password')，connect()不自动处理
缓存配置中容易忽略的序列化与超时细节
扩展装好、服务通了，但缓存读写异常，往往栽在默认行为上：
-
set()存数组或对象时，默认用serialize()，但 PHP 8.1+ 对DateTime等内置类反序列化更严格；若跨版本部署，建议统一用json_encode/json_decode手动处理 -
connect()第三个参数是超时（秒），设0会阻塞，生产环境建议2.5左右；pconnect()在 php-fpm 下易引发连接泄漏，别用 - 会话缓存需额外配置：
session.save_handler = redis和session.save_path = "tcp://127.0.0.1:6379?auth=your_password&database=1"，注意&是 HTML 实体，在 ini 文件里要写成&
最常被跳过的一步：没验证连接是否真通。写个最小测试脚本，ping() 返回 +PONG 再往下走，比直接 set() 出错后查日志快得多。
