phpEnv下安装Redis扩展必须针对当前激活版本单独编译：先确认版本及架构，用对应phpize和php-config编译安装redis.so，再在该版本php.ini中添加extension=redis.so并验证。
phpEnv 环境下装 Redis 扩展，不能直接套用系统级 PECL 或 apt 安装命令 —— 因为 phpEnv 是独立管理多版本 PHP 的工具，所有扩展必须针对其内部 PHP 实例单独编译安装，否则 php -m 看不到 redis，new Redis() 会报类未定义。
确认 phpEnv 当前激活的 PHP 版本和架构
phpEnv 的每个 PHP 版本（如 7.4.33、8.1.25）都自带独立的 bin/、lib/ 和 etc/ 目录。扩展必须装进对应版本路径里，否则白忙活。
- 运行
phpenv version查看当前 shell 激活的 PHP 版本（例如输出8.1.25） - 执行
php -v和php -i | grep -E "(Thread Safety|Architecture)"，确认是NTS还是TS、x64还是x86—— 这直接影响你后续下载或编译的扩展兼容性 - 用
php-config --extension-dir获取该版本真实的扩展目录路径（典型如~/.phpenv/versions/8.1.25/lib/php/extensions/no-debug-non-zts-20210902/），别硬写ext/
用 pecl install redis（仅限 phpEnv 自带的 PHP 已含 pear/pecl）
部分 phpEnv 构建的 PHP 默认没启用 pear，需先检查：which pecl。若无输出，说明该版本 PHP 未编译 pear 支持，跳过此法，改用源码编译。
- 确保已安装构建依赖：
sudo apt install php-dev build-essential autoconf（Ubuntu/Debian）或sudo yum install php-devel gcc make autoconf（CentOS/RHEL） - 切换到目标 PHP 版本：
phpenv local 8.1.25 - 运行
pecl install redis—— 注意观察最后输出的redis.so路径是否落在php-config --extension-dir返回的目录里 - 编辑该 PHP 版本专属的配置文件：
~/.phpenv/versions/8.1.25/etc/php.ini，添加extension=redis.so（不是extension=php_redis.dll，Windows 才用 dll） - 验证：
php -m | grep redis应有输出；php --ri redis应显示扩展信息
手动编译安装（更可靠，推荐用于 phpEnv）
当 pecl install 失败、或 phpEnv 的 PHP 编译时禁用了 pear，就只能源码编译。核心是让 phpize 指向当前 phpEnv 版本的二进制。
立即学习“PHP免费学习笔记（深入）”；
- 下载对应版本源码：
wget https://pecl.php.net/get/redis-5.3.7.tgz（PHP 8.0+ 必须用 5.3.7+；PHP 7.4 用 5.3.6；别用 6.x，尚未稳定） - 解压后进入目录：
tar -xzf redis-5.3.7.tgz && cd redis-5.3.7 - 关键一步：用当前 phpEnv 版本的
phpize初始化：~/.phpenv/versions/8.1.25/bin/phpize - 配置时指定当前 PHP 的
configure路径：./configure --with-php-config=~/.phpenv/versions/8.1.25/bin/php-config - 编译安装：
make && make install—— 成功后会提示Installing shared extensions: .../no-debug-non-zts-20210902/ - 同样编辑
~/.phpenv/versions/8.1.25/etc/php.ini，加extension=redis.so
连接测试要避开三个典型陷阱
扩展装完 ≠ 能连 Redis。本地开发常见失败不是代码问题，而是环境错位。
-
redis-server必须已运行：phpEnv 不管服务端，你得自己启 ——redis-server &或用brew services start redis（macOS）、sudo systemctl start redis（Linux） - 默认只监听
127.0.0.1:6379，但某些 phpEnv 配置下 PHP CLI 可能走 IPv6，导致 connect timeout；显式用$redis->connect('127.0.0.1', 6379)，别用localhost - Redis 配置里
bind若写成127.0.0.1 ::1，而你的 phpEnv PHP 启动时 DNS 解析localhost到::1，就会连不上；测试时一律用127.0.0.1 - 最简验证脚本：
<?php $redis = new Redis(); if ($redis->connect('127.0.0.1', 6379, 1)) { echo $redis->ping() === 'PONG' ? "OK" : "Redis 响应异常"; } else { echo "连接失败，请检查 redis-server 是否运行、端口是否被占、防火墙是否放行"; }
phpEnv 的本质是隔离，所以每个 PHP 版本的扩展路径、ini 文件、甚至 phpize 都不共享。最容易漏掉的是：改了 ~/.phpenv/versions/8.1.25/etc/php.ini，却用 phpenv global 7.4.33 运行测试 —— 结果当然没加载。务必确认 php -i | grep "Loaded Configuration File" 输出的路径和你编辑的是同一个。
