phpenv不负责安装MongoDB扩展，需手动为每个PHP版本单独执行pecl install mongodb、修改对应php.ini、重启服务并验证；扩展与Composer库mongodb/mongodb不等价，须分别安装。
phpenv 本身不支持、也不负责安装 MongoDB 扩展。它只管理 PHP 版本切换，所有扩展（包括 mongodb）必须由你手动安装并启用。
phpenv 环境下装 mongodb 扩展为什么总失败
常见错误现象：php --ri mongodb 报错“Extension 'mongodb' not present”，或 extension_loaded('mongodb') 返回 false。
根本原因不是 phpenv 有问题，而是它不会自动帮你运行 pecl install mongodb，也不会修改你的当前 PHP 版本对应的 php.ini。
- phpenv 切换版本后，
pecl命令仍可能指向系统默认 PHP 或旧版本的 bin 目录 - 即使
pecl install mongodb成功，生成的mongodb.so会被装到当前 active PHP 的 extension_dir 下，但php.ini文件未必被自动修改 - 你用
phpenv global 8.1切了版本，但没重新执行pecl install mongodb，旧扩展对新 PHP 版本无效
在 phpenv 中正确安装 mongodb 扩展的步骤
关键点：每切换一次 PHP 版本，就得重走一遍安装流程，且必须确认路径和配置文件归属当前版本。
立即学习“PHP免费学习笔记（深入）”；
- 先用
phpenv version确认当前激活的 PHP 版本（如8.1.25） - 确保该版本已安装
php-dev和php-pear（Ubuntu/Debian：运行sudo apt install php8.1-dev php8.1-pear；CentOS/RHEL：对应php81-php-devel等） - 用当前版本的
pecl安装：phpenv which pecl查路径，然后运行$(phpenv which pecl) install mongodb - 查找该 PHP 版本的
php.ini：php --ini | grep "Loaded Configuration File"，编辑它，在末尾加extension=mongodb（注意：不是.so后缀，新版 PHP 自动补全） - 重启 Web 服务或 PHP-FPM（如
sudo systemctl restart php8.1-fpm），否则改动不生效
验证 mongodb 是否真在当前 phpenv 版本里可用
别只跑 php -m | grep mongo —— 这可能查的是 CLI 的 PHP，而 Web 请求走的是 FPM，两者配置文件不同。
- 写个
info.php放 Web 根目录：<?php phpinfo(); ?>，浏览器访问，搜mongodb，看是否显示“enabled”及版本号 - CLI 下执行：
php -r "var_dump(extension_loaded('mongodb'));"，必须返回bool(true) - 运行
php --ri mongodb，检查输出中是否有Version => 1.19.3（或你装的版本）和mongodb.default_host => localhost等字段 - 如果连接报
Class 'MongoDB\Client' not found，说明扩展装了但 Composer 包没装 ——mongodb/mongodb是纯 PHP 封装库，和扩展不等价，需另装：composer require mongodb/mongodb
最容易被忽略的一点：phpenv 不会帮你维护多个 PHP 版本各自的 php.ini 和扩展状态。你切到 8.2 后，之前 8.1 装好的 mongodb 对 8.2 完全无效，必须重新编译安装——哪怕只是版本号差一个小数点。
