无法通过PHP连接MongoDB？配置扩展后仍报类不存在错误

你已经完成了扩展文件放置和php.ini配置，但还是碰到类找不到的错误，这大概率是扩展版本不匹配或者代码调用方式不对导致的，我来帮你一步步排查解决：

1. 先明确你安装的是哪个MongoDB扩展 #

MongoDB针对PHP有两个核心扩展，两者的API完全不同：

• 旧版mongo扩展（已停止维护，仅支持PHP 5.x至PHP 7.0）：只有这个扩展里才有MongoClient类
• 新版mongodb扩展（官方推荐，支持PHP 7.0+到PHP 8.x）：这个扩展移除了MongoClient，改用MongoDB\Client类

你可以先核对下载的dll文件名：

• 旧版是php_mongo.dll，新版是php_mongodb.dll

2. 检查php.ini配置是否准确 #

根据你安装的扩展类型，调整php.ini的配置项：

• 若装的是旧版mongo扩展，需添加：

  extension=php_mongo.dll
  

• 若装的是新版mongodb扩展，需添加：

  extension=php_mongodb.dll
  

额外注意：

• 确认dll文件名和配置里的完全一致（比如不要少写后缀名）
• 你的PHP是32位还是64位？下载的dll必须和PHP的架构、版本完全匹配，否则扩展根本加载不起来

3. 验证扩展是否成功加载 #

修改一个PHP文件，加入phpinfo();，访问该页面后搜索「mongo」或「mongodb」，如果能看到对应的模块信息，说明扩展加载成功；如果没有，可能是这几个问题：

• 你修改了错误的php.ini文件（XAMPP中CLI和Web服务可能使用不同的php.ini）
• dll版本和PHP版本/架构不兼容
• 没有重启Web服务器

也可以用命令行验证：打开终端进入PHP安装目录，执行php -m，查看输出里是否有mongo或mongodb模块

4. 调整PHP代码的调用方式 #

如果确认装的是新版mongodb扩展，就不能再用MongoClient了，换成MongoDB\Client的示例代码如下：

<?php
// 新版扩展的连接示例
$client = new MongoDB\Client("mongodb://localhost:27017");
// 选择目标数据库和集合
$db = $client->your_database_name;
$collection = $db->your_collection_name;
?>

要是你坚持要用旧版MongoClient，需要下载对应PHP版本的php_mongo.dll（注意：该扩展已停止更新，存在安全风险，不推荐），且你的PHP版本必须在7.0及以下（PHP 7.1+不再支持旧扩展）

5. 最后别忘了重启Web服务器 #

不管是修改了php.ini还是替换了dll，都要重启XAMPP的Apache服务，配置才能生效

内容的提问来源于stack exchange，提问作者user8564341