pecl install mongodb在phpEnv下常失败，因phpEnv默认不提供phpize、php-config等编译工具及开发头文件；需先安装autoconf、build-essential等依赖，并用对应PHP版本路径调用pecl，再将extension=mongodb.so添加至该版本php.ini（通过php --ini确认路径），最后分CLI和FPM场景验证加载。
phpEnv 是一个 PHP 多版本管理工具，类似 pyenv 或 nvm，但它本身不内置扩展安装逻辑——mongodb 扩展必须针对每个激活的 PHP 版本单独编译安装，且不能靠全局配置一劳永逸。
pecl install mongodb 在 phpEnv 环境下为什么经常失败
因为 phpEnv 安装的 PHP 通常不带 phpize、php-config 或开发头文件，而 pecl install 本质是源码编译，依赖这些工具链。常见报错包括：
Cannot find autoconfphpize command not foundconfigure: error: Cannot find php-configmake: *** No rule to make target 'install'
解决路径很明确：先补全构建环境，再指定 phpEnv 当前版本的工具路径。
以当前激活的 phpEnv 版本（比如 8.2.10）为例：
立即学习“PHP免费学习笔记（深入）”；
- 确认 PHP 安装路径：
phpenv which php→ 得到类似/home/user/.phpenv/versions/8.2.10/bin/php - 安装构建依赖（Ubuntu/Debian）：
sudo apt-get install autoconf build-essential pkg-config libssl-dev - 确保
phpize可用：/home/user/.phpenv/versions/8.2.10/bin/phpize（若报错，说明 php-dev 未随 phpEnv 一起安装，需手动补） - 用对应路径调用 pecl：
PHP_PREFIX=/home/user/.phpenv/versions/8.2.10 /home/user/.phpenv/versions/8.2.10/bin/pecl install mongodb
extension=mongodb.so 要加在哪个 php.ini 里
phpEnv 下每个 PHP 版本有独立的 php.ini，不是系统级或 Apache 共享的那个。错误地改了 /etc/php/*/cli/php.ini 对 phpEnv 环境完全无效。
正确做法：
- 运行
php --ini，看输出中的Loaded Configuration File路径，例如：/home/user/.phpenv/versions/8.2.10/etc/php.ini - 编辑该文件，在末尾添加：
extension=mongodb.so - 注意：如果
extension_dir未显式设置，PECL 安装时会提示 so 文件实际存放路径（如/home/user/.phpenv/versions/8.2.10/lib/php/extensions/no-debug-non-zts-20220829/），此时应补上：extension_dir = "/home/user/.phpenv/versions/8.2.10/lib/php/extensions/no-debug-non-zts-20220829/"
验证是否真正生效，别只信 php -m
php -m | grep mongodb 成功只代表 CLI 模式加载了，但 Web 服务器（如 Nginx + PHP-FPM）跑的是另一个 PHP 实例，它用的是自己那一套 phpEnv 切换后的配置。
务必分场景验证：
- CLI 场景：运行
php -r "var_dump(extension_loaded('mongodb'));"→ 输出bool(true) - FPM 场景：创建
info.php，内容为<?php phpinfo(); ?>，用浏览器访问，搜索MongoDB，确认模块存在且版本号正确 - 关键点：FPM 的 php.ini 路径可能和 CLI 不同，运行
php-fpm -i | grep "Loaded Configuration"查证
如果 FPM 没加载，常见原因是没重启 php-fpm 服务，或 phpEnv 切换版本后，FPM 进程仍挂着旧版本的二进制和配置。
Composer 的 mongodb/mongodb 包和 PECL 扩展不是一回事
很多人装完 composer require mongodb/mongodb 就以为能连 MongoDB，结果运行时报 Class 'MongoDB\Client' not found 或更隐蔽的 Call to undefined function mongodb\driver\libmongoc_version() —— 这是因为 Composer 包只是高级封装库，底层强依赖 PECL mongodb 扩展提供的 C 驱动。
换句话说：
- 没有
extension=mongodb.so，new MongoDB\Client()直接 fatal error -
composer require mongodb/mongodb只是提供 PHP 层 API，不替代扩展 - 两者必须共存：PECL 扩展负责网络通信与 BSON 编解码，Composer 包负责语法糖、类型提示和高阶抽象
最容易被忽略的是：phpEnv 切换 PHP 版本后，之前用 Composer 安装的 vendor 目录不会自动重装，但如果你换了 PHP 大版本（如从 7.4 切到 8.2），最好也重新 composer install，避免 opcache 或反射兼容性问题。
