XAMPP配置MongoDB：在PHP环境中安装mongodb扩展并实现连接

先说几个核心判断：配置MongoDB扩展，最折磨人的往往不是技术有多难，而是细节上那些“你以为你知道，其实你并不知道”的地方。很多人在XAMPP里折腾了大半天，最后发现其实就卡在一个命名规则上，或者一个版本参数没对齐。下面把这些坑一个个讲清楚。

extension=mongodb 还是 extension=php_mongodb.dll？

最坑的是，这一关还偏偏卡在一个最不起眼的细节上。PHP加载扩展时，只认模块名，不认DLL文件名。你拿到手的压缩包里可能是 php_mongodb-1.20.0-8.2-ts-vc17-x64.dll 这么一串，但你在php.ini里写的时候，就必须写成 extension=mongodb。写成了 extension=php_mongodb.dll 或 extension=mongodb.dll？对不起，Apache马上给你扔个 Unable to load dynamic library 错误，日志里还会反复出现 tried: xampp\php\ext\php_mongodb.dll (The specified module could not be found)。

• 注意：这条配置一定要加在 php.ini 的 ;extension=openssl 附近，别插在注释块中间或者末尾的空白处，否则读不到。
• 改完必须重启Apache，不是刷新页面就行的。记住，是重启服务，不是F5。

PHP 版本、TS/NTS、VC 编译器、架构——四参数全对了吗？

这么说吧，90%的扩展加载失败，根源就是这四个参数没对齐。别光看操作系统位数，也别信XAMPP安装包的名字——最靠谱的办法，是直接查 phpinfo() 页面。

• PHP version：比如显示 8.2.12，就下载对应 -8.2- 的DLL。
• Compiler：XAMPP现在主流是 MSVC17，也就是 vc17。
• Thread Safety：必须是 enabled，那就选带 ts 的版本。
• Architecture：看 Architecture 这行，x64 就下 x64，x86 就下 x86。

错一个参数，Apache启动就失败。错误提示可能是 %1 is not a valid Win32 application（这是位数不匹配），也可能什么提示都没有，直接静默崩溃。那才叫一个摸不着头脑。

phpinfo() 显示 mongodb ≠ MongoDB 服务在运行

看到 mongodb 模块出现在 phpinfo() 页面，这只是代表驱动加载成功了。但如果你 new MongoDB\Client() 依然报连接超时，那大概率是 mongod 这个服务根本没跑起来。这里有个常见误区：很多人以为扩展加载成功，数据库就连得上。

• 怎么验证服务状态？打开命令行，跑 netstat -ano | findstr :27017，如果有输出，说明端口被监听了。
• 如果没输出，先检查 mongod --dbpath "C:\data\db" 是否执行成功，看看日志里有没有 Permission denied 或 data directory not found。
• 记住，MongoDB 是一个独立进程，跟XAMPP控制面板没有半毛钱关系。别在面板里找“MongoDB 启动按钮”，那不存在的。

new MongoDB\Client() 报 Class not found 怎么办？

这个坑也很常见。这个类并不属于PHP内置，也不属于mongodb扩展本身，它来自Composer包 mongodb/mongodb。你只装了个DLL，但没装这个包，那肯定报错。

• 标准做法：在项目根目录下运行 composer require mongodb/mongodb，确保有 vendor/ 目录。
• PHP脚本开头必须加一句：require_once __DIR__ . '/vendor/autoload.php';，否则Composer不会自动加载。
• 如果你不想用Composer，也有备选方案：改用底层驱动 $manager = new MongoDB\Driver\Manager('mongodb://127.0.0.1:27017');，这个不依赖外部包。
• 旧写法 MongoClient（无命名空间）已经废弃了，PHP 7.0+ 完全不可用，别再用。

真正的痛点往往不是扩展装不上，而是以为“扩展加载成功=数据库连得上”，结果连 mongod 进程都没手动启动过。说到底，服务、驱动、客户端库——这三样东西，缺一不可，而且各自独立。把它们之间的关系理清楚了，剩下的也就是照着步骤走一遍的事儿。