添加php_mongodb.dll后模块未找到，求PHP MongoDB驱动安装方法

一、先排查"模块未找到"的核心原因 #

• 版本不匹配：这是最常见的问题，你下载的php_mongodb.dll必须和PHP版本、位数（x86/x64）、线程安全（TS/NTS）完全对应。比如用XAMPP的PHP 8.1 x64 TS版本，就得下载对应参数的驱动，否则系统识别不到。
• 配置或路径错误：确认php_mongodb.dll确实在C:\xampp\php\ext目录下，且php.ini里的配置是extension=mongodb（新版本驱动已简化为短名，无需写php_mongodb.dll后缀）。
• 依赖缺失：部分新版本驱动依赖对应版本的Visual C++运行库，比如PHP 7.4+需要VC15/VC16，没装的话也会提示模块找不到。

二、正确的驱动安装步骤（Windows环境） #

1. 确认PHP环境参数
   运行php -i命令，记下这些关键信息：

   • PHP版本（如7.4.33）
   • 架构（x86或x64）
   • 线程安全状态（Thread Safety => enabled为TS，否则是NTS）
   • 编译器版本（如Compiler => MSVC15）

2. 下载匹配的驱动
   找对应参数的php_mongodb.dll，注意：

   • 驱动版本要和PHP版本兼容，比如PHP 8.0对应驱动1.11+，PHP 8.1对应1.13+，PHP 8.2对应1.15+
   • 若要适配mongodb/mongodb 1.17.0，驱动版本至少要1.17.0，需确保PHP版本支持该驱动（如PHP 7.4+）

3. 配置并验证

   • 将php_mongodb.dll放入C:\xampp\php\ext目录
   • 打开php.ini，添加或修改：extension=mongodb
   • 重启Apache，运行php -m，输出里出现mongodb即说明加载成功

4. 适配Composer包版本
   如果PHP或驱动版本较低，无法安装最新包，可指定兼容版本：

   composer require mongodb/mongodb:^1.13.0
   

   替换版本号为你的驱动对应的兼容包版本即可。

三、更便捷的安装方式（推荐） #

• 用PECL自动安装
  确保XAMPP自带的pecl命令可用（需将PHP目录加入系统环境变量），以管理员身份运行命令行，执行：

  pecl install mongodb
  

  该命令会自动下载匹配PHP环境的驱动，还会自动配置php.ini，省去手动操作的麻烦。

• XAMPP扩展管理工具
  打开XAMPP控制面板，点击Apache的Config -> PHP (php.ini)，或直接用XAMPP自带的扩展管理工具（部分版本支持），找到mongodb扩展勾选后重启Apache即可。

内容的提问来源于stack exchange，提问作者alecnazzy