本文详解 php 中使用官方 mongodb 驱动执行条件查询的正确语法，重点解决因混用 javascript 风格对象字面量导致的语法错误，并提供可直接运行的示例、常见误区及最佳实践。
本文详解 php 中使用官方 mongodb 驱动执行条件查询的正确语法，重点解决因混用 javascript 风格对象字面量导致的语法错误，并提供可直接运行的示例、常见误区及最佳实践。
在 PHP 中使用官方 mongodb/mongodb 扩展（即 MongoDB\Client）进行数据查询时，find() 方法的第一个参数必须是 PHP 原生数组（associative array），而非 JavaScript 风格的对象字面量或 JSON 字符串。这是初学者最常见的语法陷阱——误将 MongoDB Shell 或 Node.js 中的 { client: "ABC" } 写法直接照搬到 PHP 中，从而触发 Parse error: syntax error, unexpected '{' 等致命错误。
✅ 正确写法（PHP 原生关联数组）：
$client = new MongoDB\Client("mongodb://localhost");
$dbs = $client->dbX->main;
$result = $dbs->find(['client' => 'ABC']); // 注意：方括号内是 PHP 数组，键名用单/双引号，冒号为 =>
foreach ($result as $main_entry) {
echo $main_entry['_id'] . ': ' . ($main_entry['client'] ?? 'N/A') . "\n";
}⚠️ 常见错误写法及原因：
- ❌ $dbs->find([{ "client": "ABC" }]);
→ 错误：外层数组包裹了非法的 {...} 对象字面量（PHP 不支持该语法）；{ 被解析为代码块起始，引发 unexpected '{'。 - ❌ $dbs->find("{ client: 'ABC' }");
→ 错误：传入字符串而非数组，驱动无法自动解析，通常静默返回空结果或抛出 InvalidArgumentException。 - ❌ $dbs->find(['client' => ABC]);
→ 错误：未加引号的 ABC 被当作常量，若未定义则触发 Undefined constant 警告。
? 进阶提示：
立即学习“PHP免费学习笔记（深入）”；
- 支持嵌套查询与操作符，例如查找 client 为 "ABC" 且 status 为 "active" 的文档：
$result = $dbs->find([ 'client' => 'ABC', 'status' => 'active' ]); - 使用 MongoDB 操作符（如 $gt, $in, $regex）时，仍需遵循 PHP 数组结构：
$result = $dbs->find([ 'createdAt' => ['$gt' => new MongoDB\BSON\UTCDateTime(strtotime('-7 days') * 1000)], 'client' => ['$regex' => '^A', '$options' => 'i'] ]);
? 总结：
PHP 的 MongoDB 驱动严格遵循 PHP 语言规范，所有查询条件必须以 关联数组（['key' => 'value']）形式传递，切勿使用 JavaScript 或 JSON 语法。养成使用 var_dump() 检查查询参数类型（应为 array）的习惯，可快速定位语法问题。同时建议在 composer.json 中锁定 mongodb/mongodb:^1.15 及以上版本，以获得更清晰的错误提示和完整操作符支持。
