pecl命令本身不感知PHP版本，需通过phpenv local等切换目标版本并验证which php/pecl和php -v一致后执行安装，确保php.ini、ext_dir、php-config等五者全部对齐。
pecl 命令本身不感知 PHP 版本，它只认当前 shell 环境下的 php 和 phpize 可执行文件 —— 所以“指定 PHP 版本”的本质，是确保这些命令指向你要的那个版本。
phpenv 环境下：用 phpenv local 或 phpenv shell 切换后再运行 pecl install
phpEnv 会自动将 pecl 绑定到当前激活的 PHP 版本（通过 wrapper 脚本重定向），这是最干净、最推荐的方式：
- 先确认目标版本已激活：
phpenv local 8.1.25或phpenv shell 7.4.33 - 验证是否生效：
which php和which pecl应指向 phpenv 的 shims 目录，php -v输出应为对应版本 - 直接运行：
pecl install mongodb—— 此时编译和生成的.so文件天然适配当前 PHP ABI（如 PHP 8.1 对应的20210902模块号） - 安装后检查：
php --ri mongodb，若报错“not found”，说明没加载，需确认php --ini显示的Loaded Configuration File路径，并在对应php.ini末尾加extension=mongodb.so
系统多 PHP 共存（非 phpenv）：必须显式配置 pecl 的 php_ini 和 ext_dir
Ubuntu/Debian 用 update-alternatives 切换 php，但 pecl 仍可能缓存旧配置。此时不能只改 php，还得手动同步 pecl 的内部设置：
- 先切 PHP：
sudo update-alternatives --set php /usr/bin/php8.1 - 再同步 pecl 配置：
pecl config-set php_ini /etc/php/8.1/cli/php.ini - 关键一步：设置扩展目录：
pecl config-set ext_dir /usr/lib/php/20210902（这个数字是 PHP 8.1 的 ABI ID，可通过php-config --extension-dir查） - 验证：
pecl config-show | grep -E "(php_ini|ext_dir|php_bin)"，三项都应匹配目标版本 - 否则即使
pecl install成功，生成的.so也可能被装进 PHP 7.x 的ext_dir，导致php --modules看不见
安装指定版本扩展：用 pecl install extname-version 或直链下载
默认 pecl install redis 总是拉最新版，但新版不一定兼容老 PHP。比如 PHP 7.2 上装 redis-6.0.0 会失败，得回退到 redis-5.3.7：
立即学习“PHP免费学习笔记（深入）”；
- 查版本页：https://www.php.cn/link/0ed3f657a3ad5a1fa47d89ae2aaad6e4，找对应 PHP 版本支持的最后可用版
- 两种写法等效：
pecl install redis-5.3.7或pecl install https://pecl.php.net/get/redis-5.3.7.tgz - Docker 中更简单：
docker-php-ext-enable redis可跳过手动改php.ini，但前提是扩展已编译好且在默认ext_dir - 注意：如果之前装过其他版本，
pecl list可能显示冲突；pecl uninstall redis再重装更稳妥，避免extension=redis.so多次写入或 .so 文件残留
常见错误：extension already loaded / Module compiled with different PHP API
这类报错基本锁定两个原因：
-
php.ini里重复写了extension=xxx.so（尤其 CLI 和 FPM 配置分离时，容易在cli/php.ini和fpm/php.ini里都加） - 扩展是用 PHP 8.0 编译的，但你用 PHP 8.1 运行 —— ABI 不兼容，
php --modules会静默跳过，php --ri xxx报 “Module compiled with module API=20201009, current version=20210902” - 解决办法：删掉旧
.so文件（路径见php-config --extension-dir），重新pecl install；或者用phpenv local切对版本再装 - 额外坑点：某些扩展（如
xdebug）在 CLI 和 Web 场景下需不同配置，zend_extension和extension指令不能混用，否则启动就报错
真正麻烦的不是命令怎么敲，而是搞清当前 php、phpize、pecl、php.ini、ext_dir 这五者是否全部对齐 —— 少一个，扩展就可能装错地方、加载失败、或运行崩溃。
