本文详解 PHP 官方 MongoDB 驱动（mongodb/mongodb 扩展）中 find() 方法的标准语法，重点纠正常见 JSON 式数组误写问题，提供可直接运行的示例代码及关键注意事项。
本文详解 php 官方 mongodb 驱动（mongodb/mongodb 扩展）中 `find()` 方法的标准语法，重点纠正常见 json 式数组误写问题，提供可直接运行的示例代码及关键注意事项。
在使用 PHP 官方 MongoDB 驱动（即通过 Composer 安装的 mongodb/mongodb 包）时，find() 方法的第一个参数必须是 PHP 关联数组（associative array），而非类 JSON 字符串或嵌套数组结构。这是初学者最常踩的坑：误将 JavaScript 或 Shell 中的 MongoDB 查询语法（如 { "client": "ABC" }）直接照搬到 PHP 中，导致解析错误（例如 Parse error: syntax error, unexpected '{'）。
✅ 正确写法如下：
$client = new MongoDB\Client("mongodb://localhost");
$dbs = $client->dbX->main;
// ✅ 正确：使用 PHP 关联数组表示查询条件
$result = $dbs->find(['client' => 'ABC']);
// ✅ 也可显式使用 array()（PHP 5.4+ 推荐短数组语法 []）
// $result = $dbs->find(array('client' => 'ABC'));
foreach ($result as $main_entry) {
echo $main_entry->_id . ': ' . ($main_entry->client ?? 'N/A') . "\n";
}⚠️ 常见错误写法及原因：
| 错误示例 | 问题说明 |
|---|---|
| $dbs->find([{"client": "ABC"}]); | {"client": "ABC"} 是非法 PHP 语法（JSON 对象不能直接出现在数组中），PHP 解析器在 { 处报错 |
| $dbs->find('{ "client": "ABC" }'); | 传入字符串会被当作空查询处理（等价于 find([])），且不触发类型校验，逻辑错误难以发现 |
| $dbs->find([['client' => 'ABC']]); | 多了一层数组包装，实际传入的是 array(array(...))，驱动无法识别为有效查询过滤器 |
? 补充说明：
立即学习“PHP免费学习笔记（深入）”；
- 查询条件支持完整 MongoDB 查询操作符，例如：
$dbs->find(['client' => 'ABC', 'status' => ['$in' => ['active', 'pending']]]);
- 如需限制结果数量或跳过文档，应配合 limit()、skip() 等游标方法使用：
$result = $dbs->find(['client' => 'ABC'])->limit(10)->skip(0);
- 始终建议对查询结果进行类型检查或异常捕获（尤其在生产环境）：
try { $result = $dbs->find(['client' => 'ABC']); foreach ($result as $doc) { /* ... */ } } catch (MongoDB\Driver\Exception\Exception $e) { error_log('MongoDB query failed: ' . $e->getMessage()); }
? 总结：PHP 中 MongoDB 查询的核心原则是——用原生 PHP 数组表达 BSON 结构，而非模仿 JSON 字面量。牢记 ['key' => 'value'] 是标准，{"key": "value"} 是非法。掌握这一基本语法，即可安全构建任意复杂度的查询条件。
