无法在XAMPP环境中安装PHP的MongoDB驱动

1. 确保驱动版本完全匹配 #

• 必须下载**PHP 8.2 x64 Thread Safe（TS）**版本的MongoDB驱动，XAMPP默认使用线程安全版PHP，NTS版本会直接导致加载失败。
• 解压后将php_mongodb.dll放入C:\xampp\php\ext\目录，保持文件名不变，不要随意重命名。

2. 修正php.ini配置项 #

• 打开XAMPP对应的php.ini文件（路径一般为C:\xampp\php\php.ini），找到动态扩展区域，添加：

  extension=php_mongodb.dll
  

• 不要仅写extension=mongodb，XAMPP环境下明确指定完整.dll文件名更可靠。
• 检查extension_dir配置，确保设置正确：

  extension_dir = "ext"
  

  或使用绝对路径：

  extension_dir = "C:\xampp\php\ext"
  

  这里单/双反斜杠都可正常识别，无需纠结格式问题。

3. 安装必要的依赖库 #

• PHP 8.2基于VC16编译，MongoDB驱动依赖VC16 x64运行库。如果系统未安装该组件，会导致驱动无法加载，直接安装VC16 x64版本的运行库即可。

4. 验证安装结果 #

• 修改配置后完全重启Apache，不要仅重载配置。
• 创建phpinfo.php文件，内容如下：

  <?php phpinfo(); ?>
  

• 访问该文件，搜索mongodb，若出现对应模块信息，说明安装成功。

5. 日志路径异常的原因 #

• 你看到的日志错误C:\xampp\php\ext\mongodb缺少.dll后缀，这是因为配置中未指定完整文件名，PHP尝试加载名为mongodb的文件而非mongodb.dll，修正配置项即可解决。

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