PHP连不上MongoDB主因是mongodb扩展未正确安装或未启用，需用pecl安装并配置php.ini后重启；操作数据须用MongoDB\Client而非Manager；查_id需用ObjectId类封装字符串；遍历Cursor应限制数量或转数组。
PHP 连不上 MongoDB：先确认扩展装对了没
连不上不是代码写错了，八成是 mongodb 扩展根本没装，或者装的是过时的 mongo（已废弃）。PHP 7.2+ 官方只支持 mongodb 扩展，用 pecl install mongodb 装完，还得在 php.ini 里加一行 extension=mongodb，重启 PHP 进程才生效。不重启，extension_loaded('mongodb') 永远返回 false。
常见错误现象：Fatal error: Uncaught Error: Class 'MongoDB\Driver\Manager' not found —— 就是扩展没加载成功。
- 用
php -m | grep mongo看扩展是否在列表里 - 用
php --ri mongodb查看扩展版本和编译参数，确认支持你的 PHP 版本 - Docker 环境别只改 host 的
php.ini，容器内也要同步配置
new Manager() 之后不能直接查数据：必须用 Client 包一层
MongoDB\Driver\Manager 是底层驱动，只管连接和发包，不提供 find()、insertOne() 这类方法。真要操作数据，得用官方推荐的高阶客户端库 MongoDB\Client，它基于 Manager 构建，封装了数据库/集合访问逻辑。
容易踩的坑：有人照着旧文档写 $manager->selectCollection(...)->find(...)，结果报错——因为 selectCollection 返回的是 MongoDB\Collection 实例，但它的 find() 接收的是 MongoDB\Driver\Query 对象，不是数组条件。
立即学习“PHP免费学习笔记（深入）”；
- 正确起步方式：
$client = new MongoDB\Client('mongodb://localhost:27017'); - 获取集合：
$collection = $client->selectDatabase('test')->selectCollection('users'); - 查数据：
$collection->find(['status' => 'active'])—— 条件直接传关联数组就行
ObjectId 不能当字符串直接比较：要用 ObjectId 类包装
存进 MongoDB 的 _id 字段默认是 ObjectId 类型，不是字符串。如果从 URL 或表单拿到一个 ID 字符串（比如 "65a1b2c3d4e5f67890123456"），直接写 find(['_id' => '65a1b2c3d4e5f67890123456'])，查不到任何结果——MongoDB 会把它当字符串匹配，而实际存的是二进制 ObjectId。
必须显式构造：new MongoDB\BSON\ObjectId('65a1b2c3d4e5f67890123456')。否则即使 ID 看起来一样，类型不对就完全不匹配。
- 插入时如果没指定
_id，驱动自动用ObjectId生成；查的时候也得用同类型去查 - 从
find()结果里取出来的_id是ObjectId实例，(string) $doc['_id']才转成字符串用于前端展示 - 用
is_object($id) && $id instanceof MongoDB\BSON\ObjectId做类型校验比strlen($id) === 24可靠得多
Cursor 遍历前不调 toArray() 就直接 foreach：小心内存和超时
find() 返回的是 MongoDB\Driver\Cursor（或 MongoDB\Model\BSONDocument 流），它本身不加载全部数据，而是按需拉取。直接 foreach ($cursor as $doc) { ... } 看似没问题，但若集合很大、网络慢、或 PHP 脚本执行时间短，容易触发游标超时（Cursor not found 错误），或因未及时释放资源导致内存缓慢增长。
更稳妥的做法是明确控制数据量和生命周期：
- 加
limit()：$collection->find([], ['limit' => 100])，避免一次捞太多 - 需要全量处理时，用
$cursor->toArray()转成数组再遍历（注意内存） - 长期运行脚本（如 CLI）记得设大点
cursorTimeoutMillis：find([], ['cursorType' => 'tailable', 'maxTimeMS' => 30000])
ObjectId 生成和比对、Cursor 生命周期、扩展加载状态——这三处出问题的概率远高于语法错误，调不通先盯死它们。
