XAMPP配置MongoDB：在PHP环境中安装mongodb扩展并实现连接-php教程-PHP中文网

必须写 extension=mongodb——php加载扩展时只认模块名，不认dll文件名；写成extension=php_mongodb.dll或extension=mongodb.dll均会触发“unable to load dynamic library”错误；配置须加在php.ini中;extension=openssl附近，改完必须重启apache才生效。

xampp配置mongodb：在php环境中安装mongodb扩展并实现连接

extension=mongodb 还是 extension=php_mongodb.dll？

必须写 extension=mongodb —— PHP 加载扩展时只认模块名，不认 DLL 文件名。写成 extension=php_mongodb.dll 或 extension=mongodb.dll 都会触发 Unable to load dynamic library 错误，日志里反复出现 tried: \xampp\php\ext\php_mongodb.dll (The specified module could not be found)。

下载的压缩包里可能是 php_mongodb-1.20.0-8.2-ts-vc17-x64.dll，但 php.ini 里只写 extension=mongodb
这条配置要加在 php.ini 的 ;extension=openssl 附近，别插在注释块中间或末尾空白处
改完必须重启 Apache（不是刷新页面），否则修改不生效

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（位数不匹配）或静默崩溃。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

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？改用底层驱动：$manager = new MongoDB\Driver\Manager('mongodb://127.0.0.1:27017');，它不依赖外部包
旧写法 MongoClient（无命名空间）已废弃，PHP 7.0+ 完全不可用

真正卡住人的地方往往不是扩展装不上，而是以为“扩展加载成功=数据库连得上”，结果连 mongod 进程都没手动启动过。服务、驱动、客户端库，三者缺一不可，且各自独立。