XAMPP不支持MongoDB插件启用，需手动匹配PHP版本（TS/NTS、x64/x86）下载php_mongodb.dll并配置php.ini；独立安装MongoDB Server并以服务方式运行mongod；最后通过PHP脚本验证Client连接与扩展加载状态。
不能直接在 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：
- 去官方 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 根本没在跑：
立即学习“PHP免费学习笔记（深入）”；
- 去 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})"（需提前装mongoshCLI） - 如果提示端口被占，用
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目录
最容易被跳过的其实是服务状态验证：每次改完配置，先确认 mongod 进程活着、端口通着、PHP 扩展列在 phpinfo() 里——三者缺一不可。顺序错了，排查成本翻倍。
