XAMPP配置MongoDB扩展教程 XAMPP本地运行NoSQL数据库-php教程-PHP中文网

xampp不支持mongodb一键集成，需手动部署服务并配置php mongodb扩展；必须严格匹配php版本、编译器、线程安全性和架构四参数下载对应dll，正确配置php.ini并重启apache，再单独安装启动mongodb服务，最后用driver manager测试连接。

xampp配置mongodb扩展教程 xampp本地运行nosql数据库

XAMPP 本身不提供 MongoDB 插件，也不能“一键集成”MongoDB —— 它只是 Apache + PHP + MySQL 的打包环境，而 MongoDB 是独立服务，必须手动部署并让 PHP 通过 mongodb 扩展连接它。

确认 PHP 版本与扩展匹配项（最容易出错的一步）

PHP 启动失败、Unable to load dynamic library 'mongodb' 报错，90% 出在这里。你必须同时核对四个参数：

PHP version：用 php -v 或打开 http://localhost/dashboard/phpinfo.php 查看，比如 8.2.12
Compiler：phpinfo 中找 Compiler 行，XAMPP 当前主流是 MSVC17（对应 VC17）
Thread Safety：必须是 enabled（即 TS 版本），XAMPP 默认都是 TS
Architecture：XAMPP 64 位安装包对应 x64，32 位对应 x86；别凭操作系统位数猜，看 phpinfo 的 Architecture 行

去 PECL mongodb Windows 下载页找对应组合的 php_mongodb.dll，例如：php_mongodb-1.19.2-8.2-ts-vc17-x64.zip。下错任意一项，Apache 就起不来。

正确配置 php.ini 加载 mongodb 扩展

扩展文件放进 C:\xampp\php\ext\ 后，编辑 C:\xampp\php\php.ini，在 ;extension=openssl 附近加一行：

extension=mongodb

注意：不是 extension=php_mongodb.dll，也不是 extension=mongo（那是已废弃的旧扩展）。如果写错名字，错误日志里会反复出现 tried: \xampp\php\ext\php_mongodb.dll (The specified module could not be found)。

改完后必须重启 Apache（不是只刷新页面），然后访问 phpinfo.php 搜索 “mongodb”，看到模块信息才算成功。没出现？回头检查上一步的四参数是否全对。

XAMPP 8.0.30

XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin

下载

启动 MongoDB 服务（和 XAMPP 无关，但必须跑起来）

MongoDB 社区版需单独下载安装，不能靠 XAMPP 启动。步骤极简：

从 mongodb.com/download 下载 Windows .msi 安装包（选 Complete）
安装时勾选 Install MongoDB as a Service，指定 dbPath 如 C:\data\db（提前手动创建该目录）
安装完自动注册为系统服务，命令行执行 net start MongoDB 启动
验证：运行 mongosh（新 CLI，需单独下载）或 mongo（已弃用），输入 db.runCommand({ping:1}) 应返回 { "ok" : 1 }

PHP 连接时用的是这个服务地址（默认 mongodb://127.0.0.1:27017），不是 XAMPP 的端口。别试图把 MongoDB 塞进 Apache 目录里 —— 它压根不走 HTTP 协议。

测试连接：用最简代码验证整个链路

在 C:\xampp\htdocs\test-mongo.php 写一段最小验证脚本：

<?php $manager = new MongoDB\Driver\Manager("mongodb://127.0.0.1:27017");
try {
    $manager->executeCommand('test', new MongoDB\Driver\Command(['ping' => 1]));
    echo "✅ MongoDB 服务可连";
} catch (Exception $e) {
    echo "❌ 连接失败：" . $e->getMessage();
}
?>

浏览器访问 http://localhost/test-mongo.php。若报 Class 'MongoDB\Driver\Manager' not found，说明扩展没加载成功；若报连接拒绝，说明 mongosh 没跑或防火墙拦了 27017 端口。

真正容易被忽略的是：XAMPP 和 MongoDB 是两个完全独立的进程，各自管理自己的日志、路径、权限。哪怕 PHPINFO 显示扩展已启用，只要 MongoDB 服务没启动，new MongoDB\Driver\Manager() 就会超时失败 —— 这个分离性，比 MySQL 嵌入式模式更需要手动意识。