安装MongoDB扩展需严格匹配PHP版本、架构（x64/x86）和线程安全模式（TS/NTS），下载对应php_mongodb.dll放入phpEnv指定ext目录，修改php.ini添加extension=php_mongodb.dll，重启后用php -m或var_dump(extension_loaded('mongodb'))验证。
phpEnv 本身不提供 MongoDB 扩展安装功能，它只是 Windows 下的 PHP 多版本管理工具；MongoDB 扩展必须手动下载 DLL、匹配 PHP 版本和线程安全模型（TS/NTS）、修改 php.ini，否则 php -m 看不到 mongodb，new MongoDB\Driver\Manager() 会报类未找到。
确认 phpEnv 当前 PHP 版本与编译环境
在 phpEnv 控制台或命令行中执行：
php -v<br>php --ri openssl
重点看三处：
- PHP 主版本号（如
8.1、8.2） - 架构（
x64还是x86）——phpEnv 默认用 x64 - 线程安全（
Thread Safety => enabled表示 TS，disabled表示 NTS）——phpEnv 默认为 NTS
这三项必须和你要下载的 php_mongodb.dll 完全一致，错一个就加载失败。
立即学习“PHP免费学习笔记（深入）”；
下载并放置正确的 mongodb.dll
去官方扩展发布页获取对应 DLL：https://www.php.cn/link/51d3a6f35b8dfe611ff24214c8ef79d1
选包原则：
- 版本号 ≥ PHP 8.1 推荐用
1.19.x及以上（兼容 PHP 8.3） - 文件名含
ts→ 用于 TS 版本；含nts→ 用于 NTS 版本 - 解压后只取
php_mongodb.dll，放进 phpEnv 对应 PHP 的ext目录，例如：C:\phpenv\versions\8.2.12\ext\
别放错目录——phpEnv 的 ext 不在系统 PHP 安装路径下，而在它自己管理的 versions\{version} 子目录里。
修改 php.ini 启用扩展
用 phpEnv 切换到目标版本后，执行：phpenv config path 查出当前生效的 php.ini 路径（通常是 C:\phpenv\versions\8.2.12\php.ini）
在该文件末尾追加一行：
extension=php_mongodb.dll
注意：extension_dir 不用改——phpEnv 默认已设为 ext 目录；但如果你之前手动改过，要确保它指向的是当前版本的 ext 文件夹。
验证是否生效：
php -m | findstr mongodb<br>php -r "var_dump(extension_loaded('mongodb'));"
输出 bool(true) 才算成功。
常见失败原因与绕过技巧
即使 DLL 放对、ini 写对，仍可能报 PHP Startup: Unable to load dynamic library 'php_mongodb.dll'，多半是依赖缺失：
- 缺少
vcruntime140.dll或msvcp140.dll→ 安装 Microsoft Visual C++ 2015–2022 Redistributable (x64) - PHP 是 VS16 编译（phpEnv 8.1+ 多为 VS17），DLL 却是旧版 VS16 编译 → 必须严格按 phpinfo() 中的
Compiler字段匹配 DLL 构建版本 - 扩展名写成
extension=mongodb（漏了php_前缀）→ Windows 下必须带完整文件名
最省事的验证方式：启动一个最小 PHP 脚本，直接 new Manager，不要依赖框架或 Composer 自动加载：
<?php<br>$manager = new MongoDB\Driver\Manager("mongodb://127.0.0.1:27017");<br>var_dump($manager);
能过这一关，说明扩展真正就位了。其他问题（比如连接不上 MongoDB 服务）属于运行时配置范畴，和 phpEnv 扩展加载无关。
