PHP操作MongoDB必须使用官方mongodb扩展（非废弃的mongo扩展），通过MongoDB\Client连接，基于BSON文档进行增删改查，连接惰性触发，需注意ObjectId、DateTime等类型正确使用及字段类型严格性。
PHP 操作 MongoDB 不再用 mongo 扩展（已废弃），必须用 mongodb 扩展（官方维护，基于 libmongoc）。它不提供传统“连接-查询-关闭”式 API，而是以面向对象 + BSON 文档为核心，直接对接现代 MongoDB 协议（4.0+）。
怎么确认已正确安装 mongodb 扩展
运行 php -m | grep mongodb，有输出说明扩展已加载；若报错或无输出，需手动安装：
- Linux（pecl）：
pecl install mongodb，然后在php.ini中加extension=mongodb.so - macOS（Homebrew + php）：
pecl install mongodb，检查php --ini显示的配置路径是否包含该扩展 - Windows：从 pecl.php.net 下载对应 PHP 版本和线程安全（TS/NTS）的
php_mongodb.dll，放入ext/并在php.ini中添加extension=php_mongodb.dll - 验证是否生效：
php -r "var_dump(extension_loaded('mongodb'));"应返回bool(true)
连接 MongoDB 并选择数据库/集合
MongoDB\Driver\Manager 是底层连接管理器，但日常操作推荐用官方高阶库 mongodb/mongodb（Composer 安装），它封装了 Manager、Collection 和 BSON 类型处理：
- 安装客户端库：
composer require mongodb/mongodb - 连接示例：
$client = new MongoDB\Client('mongodb://127.0.0.1:27017'); $collection = $client->selectDatabase('test')->selectCollection('users'); - 注意：连接字符串中不能省略
mongodb://前缀；本地默认端口是27017，非27018或其他 - 连接本身不触发网络请求（lazy connect），首次操作（如
find()）才真正建连；超时、认证失败等错误会在首次操作时抛出MongoDB\Driver\Exception\ConnectionTimeoutException等
插入、查询、更新文档的典型写法
所有操作都基于 BSON 文档（PHP 数组或 MongoDB\BSON\ObjectId 等类型），不接受 JSON 字符串直接传入：
立即学习“PHP免费学习笔记（深入）”；
- 插入单条：
$collection->insertOne(['name' => 'Alice', 'age' => 30])，返回InsertOneResult，可用getInsertedId()获取_id - 查询全部：
$collection->find([])返回Cursor，需遍历：foreach ($collection->find(['age' => ['$gt' => 25]]) as $doc) { echo $doc['name'] . "\n"; } - 更新单条：
$collection->updateOne(['name' => 'Alice'], ['$set' => ['age' => 31]])；注意第二个参数必须是操作符（如$set、$inc），不能直接传数组 - 查询条件中用
MongoDB\BSON\ObjectId匹配_id：['_id' => new MongoDB\BSON\ObjectId('60a1b2c3d4e5f67890123456')]，字符串 ID 不能直接当数组键用
常见报错和绕不开的坑
这些错误高频出现，且原因隐蔽：
-
Uncaught MongoDB\Driver\Exception\RuntimeException: No servers found：连接字符串格式错（比如漏了mongodb://）、MongoDB 进程没启、防火墙拦截、或 DNS 解析失败（尤其用localhost时建议换127.0.0.1） -
Cannot use object of type MongoDB\BSON\ObjectId as array：把ObjectId当数组访问了，正确取值是$id->__toString() - 插入后查不到：未指定
_id时驱动自动生成ObjectId，但如果你用字符串 ID 插入（如['_id' => 'abc']），后续用new ObjectId('abc')查不到——因为不是同类型 - 日期存成字符串而非
DateTimeInterface：用new DateTime()而不是date('Y-m-d')，否则 MongoDB 当普通字符串存，无法做时间范围查询
最易被忽略的是：所有文档操作都默认不校验字段类型，int 和 string 的 1 在 MongoDB 里是完全不同的值，业务逻辑里混用会导致查不到数据，却不会报错。
