XAMPP环境安装MongoDB扩展 XAMPP PHP连接MongoDB-php教程-PHP中文网

xampp不支持mongodb插件启用，需手动匹配php版本（ts/nts、x64/x86）下载php_mongodb.dll并配置php.ini；独立安装mongodb server并以服务方式运行mongod；最后通过php脚本验证client连接与扩展加载状态。

xampp环境安装mongodb扩展 xampp php连接mongodb

不能直接在 XAMPP 控制面板里“启用 MongoDB 插件”——XAMPP 根本没有这个功能，装了扩展也不等于数据库服务就跑起来了。

确认 PHP 版本和线程安全模式（TS/NTS）

这是所有后续操作的前提，错一个就白忙活：

打开命令行，运行 C:\xampp\php\php.exe -v 查看 PHP 主版本（如 8.2、7.4）
访问 http://localhost/dashboard/phpinfo.php，搜索 Thread Safety：显示 enabled 表示是 TS（线程安全），disabled 是 NTS
再搜 Architecture：x64 或 x86 —— 这决定你要下 64 位还是 32 位 DLL
别凭感觉选；XAMPP 默认是 TS + x64（Win10/11），但旧版可能仍是 x86

下载并配置 php_mongodb.dll 扩展

PECL 提供的 DLL 必须严格匹配你的环境，否则 php.ini 加载时会报 Unable to load dynamic library 'mongodb' 或 %1 is not a valid Win32 application：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

去官方 PECL 页面下载：https://windows.php.net/downloads/pecl/releases/mongodb/ —— 不要用 GitHub 或第三方网盘，版本混乱风险高
选最新稳定版（如 1.19.3），再按你查到的参数选文件，例如：php_mongodb-1.19.3-8.2-ts-vs16-x64.zip
解压后把 php_mongodb.dll 放进 C:\xampp\php\ext
编辑 C:\xampp\php\php.ini，在 ;extension=mbstring 类似位置添加一行：extension=mongodb（注意：不是 php_mongodb.dll，也不是 extension=php_mongodb）
重启 Apache；如果启动失败，立刻检查 Apache error log 里的具体报错，而不是反复改配置

独立运行 mongod 服务（不是 XAMPP 服务！）

很多人卡在这一步：以为装了扩展就能连上，结果 MongoDB\Client 报 Failed to connect to 127.0.0.1:27017 —— 因为 mongod 根本没在跑：

去 MongoDB 官网下载 Community Server ZIP 版（不要 MSI），解压到固定路径，如 C:\mongodb
手动创建数据目录：mkdir C:\mongodb\data\db 和日志目录：mkdir C:\mongodb\log
以管理员身份运行 CMD，执行：cd /d C:\mongodb\bin & mongod --dbpath "C:\mongodb\data\db" --logpath "C:\mongodb\log\mongod.log" --install
然后运行：net start MongoDB；验证是否成功：mongosh --eval "db.runCommand({ping:1})"（需提前装 mongosh CLI）
如果提示端口被占，用 netstat -ano | findstr :27017 查 PID，再用任务管理器结束对应进程

PHP 连接测试与常见错误

写个最小可测脚本，别一上来就套框架逻辑：

<?php try {
    $client = new MongoDB\Client("mongodb://127.0.0.1:27017");
    $db = $client->test;
    $coll = $db->test_collection;
    $result = $coll->insertOne(['ts' => time()]);
    echo "Inserted with ID: " . $result->getInsertedId();
} catch (MongoDB\Driver\Exception\Exception $e) {
    echo "Error: " . $e->getMessage();
}
?>

如果报 Class 'MongoDB\Client' not found：说明扩展没加载成功，回头查 phpinfo() 里有没有 mongodb 模块段
如果报 Connection refused 或超时：90% 是 mongod 没运行，或防火墙/杀软拦截了 27017 端口
如果用的是旧代码（new MongoClient()）：那是废弃的 ext-mongo，PHP 7.1+ 已不支持，必须改用 mongodb 扩展 + Client 类
别忽略 libsasl.dll 缺失问题——极少数 Windows 环境（尤其老系统）会因此加载失败，需手动补全该 DLL 到 C:\xampp\php 目录