本文详解 php 中使用 mongodb 官方驱动执行条件查询的正确语法，重点解决因 json 风格写法导致的解析错误（如“unexpected {, expecting ]”），明确推荐使用关联数组而非内联 json 对象作为查询条件。
本文详解 php 中使用 mongodb 官方驱动执行条件查询的正确语法，重点解决因 json 风格写法导致的解析错误（如“unexpected {, expecting ]”），明确推荐使用关联数组而非内联 json 对象作为查询条件。
在 PHP 中使用 MongoDB 官方驱动（mongodb/mongodb Composer 包）进行数据查询时，find() 方法的第一个参数必须是一个 PHP 关联数组（array），而非 JavaScript 风格的对象字面量（如 { "client": "ABC" }）。这是初学者最常遇到的语法陷阱：直接照搬 Shell 或 Node.js 的写法会导致 PHP 解析失败——因为 { ... } 在 PHP 中不是合法的数组语法，会被解释为代码块或语法错误（例如 Unexpected '{'）。
✅ 正确写法（推荐，语义清晰、兼容性强）：
$client = new MongoDB\Client("mongodb://localhost");
$db = $client->dbX;
$collection = $db->main;
// 查询 client 字段等于 "ABC" 的所有文档
$result = $collection->find(['client' => 'ABC']);
// 遍历结果（注意：返回的是 Cursor 对象，需迭代）
foreach ($result as $doc) {
echo json_encode($doc) . "\n";
}
⚠️ 常见错误写法（会导致 Parse Error）：
// ❌ 错误：PHP 不支持 { ... } 作为数组字面量
$result = $collection->find([{ "client": "ABC" }]); // Parse error: syntax error, unexpected '{'
// ❌ 错误：即使去掉外层数组，{...} 仍非法
$result = $collection->find({ "client": "ABC" }); // 同样报错
? 补充说明：
- 查询条件数组支持嵌套结构与操作符，例如：
$collection->find(['client' => 'ABC', 'status' => ['$ne' => 'inactive']]);
- 如需限制返回字段，可传入第二个选项参数（关联数组）：
$result = $collection->find( ['client' => 'ABC'], ['projection' => ['_id' => 0, 'name' => 1, 'email' => 1]] ); - 若需精确匹配（区分大小写、全字符串匹配），默认行为已满足；如需正则或模糊匹配，应使用 $regex 操作符。
? 总结：始终用 PHP 原生数组语法（['key' => 'value']）构造查询条件，避免任何类 JSON 字面量写法。这是由 PHP 语言特性决定的底层约束，而非驱动限制。坚持该规范，即可规避绝大多数 find() 语法错误。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
