如何安装MongoDB并配置与PHP的数据库连接及报错解决

一、先搞定核心依赖：MongoDB PHP扩展 #

• 必须安装官方MongoDB PHP扩展（注意：不是旧版的mongo扩展，是新版的mongodb扩展，旧版已废弃）
  • 验证是否安装：执行命令 php -m，或者在PHP项目中创建phpinfo.php（内容<?php phpinfo(); ?>），搜索mongodb关键字，确认存在该扩展
  • 未安装的话按环境处理：
    • Linux：用包管理器直接装，比如Debian/Ubuntu系用 apt install php-mongodb（要对应你的PHP版本，比如php7.4就装php7.4-mongodb）；或者用PECL安装 pecl install mongodb，安装后在php.ini里添加extension=mongodb.so，重启Apache/Nginx/PHP-FPM
    • Windows：下载和你的PHP版本、线程安全（TS/NT）匹配的mongodb.dll文件，放到PHP的ext目录，然后在php.ini里添加extension=mongodb.dll，重启IIS或Apache

二、正确的MongoDB连接代码示例 #

不要再用废弃的MongoClient类，用官方推荐的MongoDB\Client：

<?php
// 本地默认端口连接（MongoDB默认监听27017）
$client = new MongoDB\Client("mongodb://localhost:27017");

// 带用户名密码的认证连接（比如MongoDB开启了权限验证）
// $client = new MongoDB\Client("mongodb://你的用户名:你的密码@localhost:27017/?authSource=admin");

// 选择数据库和集合
$db = $client->test_db; // test_db是你的数据库名，不存在会自动创建
$collection = $db->test_col; // test_col是集合名，不存在会自动创建

// 测试插入数据
$insertResult = $collection->insertOne([
    'username' => 'test_user',
    'email' => 'test@example.com'
]);

echo "插入成功，文档ID：" . $insertResult->getInsertedId();
?>

三、对应报错的排查方案 #

结合你截图里的报错（推测是扩展未加载或连接失败类问题）：

• 若报错Class 'MongoDB\Client' not found：
  1. 检查php.ini里是否正确添加了扩展配置，有没有拼写错误
  2. 重启web服务后再验证phpinfo，确认扩展已加载
  3. 确认扩展版本和PHP版本匹配，比如PHP8.0不能用太老的mongodb扩展
• 若报错Failed to connect to MongoDB server：
  1. 检查MongoDB服务是否启动：Windows看服务列表里的MongoDB Server是否运行；Linux执行 systemctl status mongod
  2. 确认端口27017未被防火墙拦截，本地可以用telnet localhost 27017或nc -zv localhost 27017测试连通性
  3. 若MongoDB配置了远程连接，检查mongod.conf里的bindIp是否允许当前服务器访问
• 若报错认证失败：
  确认连接字符串里的用户名、密码正确，且该用户拥有对应数据库的权限，authSource要填用户创建时所在的库（默认是admin）

四、最终验证 #

1. 访问phpinfo.php，确认mongodb扩展已加载
2. 运行上面的测试代码，若能正常输出文档ID，说明连接成功

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