先确认phpEnv当前PHP版本及php.ini路径，再用对应版本pecl安装mongodb扩展并配置extension=mongodb，最后验证MongoDB\Driver\Manager类是否存在。
phpEnv 里装 mongodb 扩展，先确认它用的是哪个 PHP 版本
phpEnv 是多版本 PHP 环境管理工具，它不会自动为所有已安装的 PHP 版本启用扩展。你得先明确当前 php 命令指向哪个版本：php -v 和 php --ini 必须一起看——后者显示实际加载的 php.ini 路径，这个路径才是你要改的地方。
常见坑点：
- 你在 phpEnv 中切换了 PHP 版本（比如
phpenv local 8.1），但php --ini仍显示旧版本的配置路径，说明 shell 环境没刷新，需重新打开终端或执行source $HOME/.phpenv/completions/phpenv.bash - phpEnv 默认不生成
php.ini，首次使用时可能只有php.ini-development或php.ini-production，你要复制一份并重命名为php.ini，再在其中添加扩展配置 - 扩展名必须写
extension=mongodb（不是mongodb.so或php_mongodb.dll），phpEnv 下的 PHP 8.0+ 已支持短名称自动解析
pecl install mongodb 在 phpEnv 环境下容易失败的三个原因
直接运行 pecl install mongodb 很可能报错，不是缺权限，而是缺上下文。phpEnv 每个 PHP 版本都有独立的 pecl 可执行文件，必须用对应版本的命令：
- 先定位到目标版本的 pecl：例如 PHP 8.2 安装在
~/.phpenv/versions/8.2.12/bin/pecl，就该用这个全路径执行，而不是全局pecl - 缺少编译依赖：Ubuntu/Debian 需提前装
sudo apt-get install php-dev pkg-config libssl-dev autoconf；macOS（Homebrew）需brew install autoconf pkg-config openssl@3 - SSL 库链接失败时，加参数强制指定：
yes '' | ~/.phpenv/versions/8.2.12/bin/pecl install --configureoptions='with-mongodb-system-libs="yes"' mongodb
连接字符串写错，MongoDB\Client 不报错但后续操作全挂
这是最隐蔽的问题：$client = new MongoDB\Client('127.0.0.1:27017') 看似简洁，但会触发 MongoDB\Driver\Exception\InvalidArgumentException：URI 必须以 mongodb:// 开头。不报错只发生在连接对象创建阶段，因为连接是 lazy 的；真正出错要等到第一次 find() 或 insertOne()。
立即学习“PHP免费学习笔记（深入）”；
正确写法只有两种：
- 本地无认证：
mongodb://127.0.0.1:27017 - 带用户密码（注意 URL 编码）：
mongodb://myuser:mypass%40123@127.0.0.1:27017/mydb?authSource=admin
别漏掉 authSource 参数——MongoDB 6+ 默认把用户建在 admin 库，不显式指定就会连上但鉴权失败。
用 composer require mongodb/mongodb 之前，得先有扩展
Composer 安装的 mongodb/mongodb 是高级封装库，它底层完全依赖 mongodb PHP 扩展（即 ext-mongodb）。没有这个扩展，new MongoDB\Client() 会直接抛出 Class 'MongoDB\Driver\Manager' not found。
验证是否真就绪，别只看 composer show，要跑这行：
php -r "var_dump(class_exists('MongoDB\Driver\Manager'));"
返回 bool(true) 才算过关。如果返回 false，说明扩展没加载成功，Composer 包再全也没用。
顺带一提：phpEnv 下多个 PHP 版本共存时，composer require 装的包默认只对当前 CLI 版本生效；Web 环境（如 Nginx + PHP-FPM）若用的是另一个版本，还得单独给那个版本也装一遍 Composer 依赖，并确保其 vendor/autoload.php 被正确引入。
