PHP连接MongoDB数据库教程

积累知识，胜过积蓄金银！毕竟在文章开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《PHP连接MongoDB数据库方法详解》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

PHP连接MongoDB必须使用官方mongodb扩展（非已废弃的mongo扩展），通过MongoDB\Driver\Manager建立连接，执行查询需用MongoDB\Driver\Query和executeQuery()，插入需用MongoDB\Driver\BulkWrite；若要使用MongoDB\Client等高级API，须额外安装mongodb/mongodb库。

PHP 连 MongoDB 不是靠 mysqli 或 PDO，必须用官方 mongodb 扩展（不是已废弃的 mongo 扩展）。

确认装的是 mongodb 扩展，不是 mongo

旧版 mongo 扩展在 PHP 7.0+ 已彻底移除，强行装会报 Class 'MongoClient' not found。现在唯一支持的是 mongodb 扩展（由 mongodb/mongo-php-driver 提供）。

• 检查是否启用：php -m | grep mongodb（Linux/macOS）或查看 phpinfo() 中是否有 mongodb 模块
• 没装？用 pecl install mongodb（需先配好 phpize 环境），然后在 php.ini 加 extension=mongodb
• Windows 用户直接下载对应 PHP 版本和线程安全（TS/NTS）的 php_mongodb.dll，丢进 ext/ 并在 php.ini 启用

用 MongoDB\Driver\Manager 建连接，别碰 MongoDB\Client（除非你用了官方库）

原生 PHP 不自带 MongoDB\Client 类——那是 mongodb/mongodb 官方封装库（基于 mongodb 扩展）提供的。纯扩展只提供底层驱动类。

• 最简连接（无认证）：$manager = new MongoDB\Driver\Manager('mongodb://127.0.0.1:27017');
• 带认证：$manager = new MongoDB\Driver\Manager('mongodb://user:pass@127.0.0.1:27017/admin');（注意 /admin 是认证数据库）
• 连接失败时抛 MongoDB\Driver\Exception\ConnectionTimeoutException 等异常，必须 try/catch，不能靠 @ 抑制

执行查询得靠 MongoDB\Driver\Query + $manager->executeQuery()

没有 mysql_query() 那种一行执行方式。所有操作都要手动构造查询对象、指定数据库和集合名。

• 查一条：$query = new MongoDB\Driver\Query(['name' => 'Alice']); $cursor = $manager->executeQuery('mydb.users', $query);
• 结果是 MongoDB\Driver\Cursor，遍历用 foreach ($cursor as $doc) { ... }，$doc 是 PHP 数组（含 ObjectId 等特殊类型）
• 插入要手动构造 MongoDB\Driver\BulkWrite 对象，再调 $manager->executeBulkWrite()；不支持单条 insert() 方法
• 别把 JSON 字符串直接传给 Query 构造函数——它只接受 PHP 数组，否则会静默失败或类型错乱

如果要用 MongoDB\Client 和链式调用，得额外装 mongodb/mongodb 库

这是社区广泛使用的 ODM 封装层，让写法接近 ORM，但它是纯 PHP 实现，依赖底层 mongodb 扩展。

• 安装：composer require mongodb/mongodb
• 连接：$client = new MongoDB\Client('mongodb://127.0.0.1:27017');
• 查数据：$collection = $client->selectCollection('mydb', 'users'); $result = $collection->find(['status' => 'active']);
• 注意：这个 $result 是 MongoDB\Model\BSONDocument 迭代器，转数组要 $doc->getArrayCopy()，不是直接当数组用

真正容易卡住的地方是错误类型混用——比如把 new MongoDB\Driver\Manager 当成 MongoDB\Client 用，或者在没装扩展的情况下 composer require 了库却以为万事大吉。连通性验证务必从 php -m 和一个最简 new Manager() 开始。

终于介绍完啦！小伙伴们，这篇关于《PHP连接MongoDB数据库教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！