本文详解如何在 PHP 中构建 MongoDB 动态查询时，避免 array_push 错误地将 $or 条件插入为数字索引项（如 "0": { "$or": [...] }），而是正确合并至关联数组的 $or 键下，确保查询结构符合 MongoDB 官方语法要求。
本文详解如何在 php 中构建 mongodb 动态查询时，避免 `array_push` 错误地将 `$or` 条件插入为数字索引项（如 `"0": { "$or": [...] }`），而是正确合并至关联数组的 `$or` 键下，确保查询结构符合 mongodb 官方语法要求。
在使用 MongoDB PHP 驱动（如 mongodb/mongodb v1.10+）构建动态查询时，一个常见但隐蔽的陷阱是：误用 array_push() 向已含 $or 键的关联数组中“追加”新条件，导致键名被自动转为数字索引（如 0, 1），破坏了 MongoDB 查询的语义结构。这会使查询无法匹配预期文档，甚至触发驱动层异常。
根本原因在于：$query 是一个 PHP 关联数组（即 array），而 array_push($query, $item) 的行为是将 $item 作为新元素追加到数组末尾，并自动分配整数键——即使 $query 原本只有字符串键（如 'schoolId', '$or'），array_push 仍会强制生成 0, 1 等数字键，从而产生类似 "0": { "$or": [...] } 的非法结构。
✅ 正确做法是：显式操作 $query['$or'] 键本身，而非对整个 $query 数组执行 array_push。
✅ 正确构建与合并 $or 条件
首先，重构 $nameArray 为纯二维数组（每个子数组代表一个 $or 分支）：
立即学习“PHP免费学习笔记（深入）”；
if ($this->name !== "") {
$nameConditions = [
['fullName' => new MongoDB\BSON\Regex('^' . preg_quote($this->name, '/'), 'i')],
['firstLastName' => new MongoDB\BSON\Regex('^' . preg_quote($this->name, '/'), 'i')],
['registration_temp_perm_no' => new MongoDB\BSON\Regex('^' . preg_quote($this->name, '/'), 'i')],
];
// 安全合并：若 $query 已存在 '$or'，则合并；否则直接赋值
if (isset($query['$or']) && is_array($query['$or'])) {
$query['$or'] = array_merge($nameConditions, $query['$or']);
} else {
$query['$or'] = $nameConditions;
}
}⚠️ 注意事项：
- 必须使用 preg_quote() 对 $this->name 进行转义，防止正则元字符（如 ., *, ^, $）引发意外匹配或语法错误；
- 使用 array_merge() 而非 + 运算符，因其能保证数值索引重排且语义明确；$a + $b 在键冲突时会忽略 $b 中同名键，不适用于此场景；
- 务必检查 isset($query['$or'])，避免向 null 或非数组类型执行 array_merge 导致警告。
? 完整动态查询组装逻辑（推荐结构）
为提升可维护性，建议将条件组装模块化：
// 初始化基础查询
$query = [];
// 固定字段条件
if ($this->programId) {
$query['classId'] = new MongoDB\BSON\ObjectID($this->programId);
}
if ($this->schoolId) {
$query['schoolId'] = new MongoDB\BSON\ObjectID($this->schoolId);
}
$query['status'] = 'Active';
// transport_details 复合条件（$or / $and）
$transportConditions = $this->buildTransportConditions();
if (!empty($transportConditions)) {
$query = array_merge($query, $transportConditions);
}
// name 模糊搜索（安全合并至 $or）
if ($this->name !== "") {
$nameConditions = $this->buildNameOrConditions();
if (isset($query['$or'])) {
$query['$or'] = array_merge($nameConditions, $query['$or']);
} else {
$query['$or'] = $nameConditions;
}
}
// 最终用于 find() 的查询对象
$result = $collection->find($query, $options);其中 buildTransportConditions() 可封装您原代码中 routeId/stopId 的复杂逻辑，返回形如 ['$and' => [...]] 的子数组，再通过 array_merge() 合并进主查询。
✅ 验证查询结构（调试技巧）
在执行前打印标准化 JSON，确认结构合规：
echo json_encode($query, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
// ✅ 正确输出应包含："$or": [{...}, {...}, {...}], "schoolId": {...}, ...
// ❌ 错误输出示例：{"0": {"$or": [...]}, "schoolId": {...}} → 即表示 array_push 误用总结
- array_push() 仅适用于索引数组追加，绝不应用于向关联数组“添加新查询子句”；
- MongoDB 查询条件必须严格保持键名语义（$or, $and, $elemMatch 等），PHP 数组键名即对应 MongoDB 操作符；
- 所有动态 $or 条件必须显式赋值或合并至 $query['$or']；
- 始终对用户输入做正则转义，并校验 BSON 类型（如 ObjectID）的有效性；
- 将条件构建逻辑拆分为小函数，大幅提升可读性、复用性与测试友好度。
遵循以上实践，即可彻底规避“数字键 $or”问题，构建出语义清晰、结构健壮的 MongoDB 动态查询。
