本文详解如何在 PHP 中通过 MongoDB 聚合管道的 $size 操作符，准确获取文档中数组字段（如 telephone）的元素个数，适用于动态长度数组的统计与条件查询场景。
本文详解如何在 php 中通过 mongodb 聚合管道的 `$size` 操作符，准确获取文档中数组字段（如 `telephone`）的元素个数，适用于动态长度数组的统计与条件查询场景。
在 MongoDB 应用开发中，经常需要对嵌套数组字段进行量化分析——例如判断某用户是否填写了多个电话号码（telephone: ["+8613800138000", "+8615900159000"]），或筛选拥有至少 2 个联系方式的用户。MongoDB 原生不支持直接在 find() 中使用 count() 类函数操作数组长度，但可通过聚合管道（Aggregation Pipeline）中的 $size 表达式高效实现。
✅ 推荐方案：使用 $project + $size 聚合阶段
$size 是 MongoDB 内置的聚合表达式，可安全返回数组字段的元素数量（对非数组字段会报错，因此需确保目标字段为数组类型）。以下是在 PHP 中（以官方 MongoDB PHP Library v1.14+ 为例）的完整实现：
<?php
// 假设已建立连接：$client → $db → $collection
$collection = $db->selectCollection('users');
// 查询所有文档，并新增一个字段 'tel_count' 表示 telephone 数组长度
$result = $collection->aggregate([
[
'$project' => [
'name' => 1,
'telephone' => 1,
'tel_count' => ['$size' => '$telephone'] // 关键：计算数组长度
]
]
]);
foreach ($result as $doc) {
echo sprintf(
"User: %s | Telephones: %d [%s]\n",
$doc->name ?? 'N/A',
$doc->tel_count ?? 0,
implode(', ', $doc->telephone ?? [])
);
}
?>⚠️ 注意事项与最佳实践
-
字段类型校验：$size 仅接受数组类型；若 telephone 可能为 null、字符串或缺失，建议前置使用 $isArray 进行保护：
'$tel_count' => [ '$cond' => [ 'if' => ['$isArray' => '$telephone'], 'then' => ['$size' => '$telephone'], 'else' => 0 ] ] -
性能提示：$size 是轻量级表达式，无需索引即可高效执行；但若需按数组长度过滤（如“查找 telephone ≥ 3 的用户”），应配合 $match 阶段并置于 $project 之后（或使用 $expr 在 find() 中）：
立即学习“PHP免费学习笔记（深入）”；
$collection->find([ '$expr' => ['$gte' => [['$size' => '$telephone'], 3]] ]); -
避免常见错误：
- ❌ 不要尝试用 PHP 的 count() 处理游标结果——这会拉取全部文档到内存，丧失数据库端计算优势；
- ❌ 不要误写为 '$size' => '$telephone'（语法错误），正确格式是 ['$size' => '$telephone']（关联数组键为操作符）。
✅ 总结
通过聚合管道中的 $size 表达式，PHP 开发者可在 MongoDB 层面精准、高效地统计任意数组字段的元素数量，既减少网络传输开销，又提升查询逻辑的可维护性。结合 $cond 类条件表达式，还能优雅处理边缘情况，是生产环境中推荐的标准实践。
