本文介绍如何在 PHP 中通过 MongoDB 聚合操作（$size 表达式）准确统计文档中数组字段（如 telephone）的元素个数，并提供可直接运行的代码示例与关键注意事项。
本文介绍如何在
php
中通过
mongodb
聚合操作（`$size` 表达式）准确统计文档中数组字段（如 `telephone`）的元素个数，并提供可直接运行的代码示例与关键注意事项。
在 MongoDB 应用开发中，常需对嵌套数组字段进行统计分析——例如判断某用户文档中存储了多少个电话号码（telephone: ["+8613800138000", "+8615900159000"]）。PHP 官方驱动（mongodb/mongodb v1.10+）不支持直接在 find() 中使用 $size 作为查询条件（该操作符仅用于聚合阶段），因此必须借助聚合管道（Aggregation Pipeline）实现数组长度计算。
✅ 正确做法：使用 $size 在 $project 阶段计算数组长度
以下是一个完整、健壮的 PHP 示例（基于官方 MongoDB\Driver\Manager 或 MongoDB\Client）：
? 提示：若仅需筛选 telephone 元素数 ≥ 2 的文档，可在 $project 后追加 $match 阶段：
⚠️ 注意事项与最佳实践
$size 仅适用于数组字段
：若目标字段不存在、为 null 或非数组类型（如字符串、对象），聚合将报错 TypeError: cannot use $size on non-array field。建议先用 $isArray + $cond 做安全兜底：
立即学习
“
PHP免费学习笔记（深入）
”；
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
避免在 find() 中误用 $size
：如下写法是
错误且无效
的：
正确方式始终是聚合（aggregate）——因为 $size 是聚合表达式，非查询操作符。
性能提示
：$size 是轻量级内存计算，无索引依赖；但若需高频按数组长度查询，可考虑在写入时预存 telephone_count 字段并建立索引，提升读取效率。
综上，通过 aggregate() 配合 $project 和 $size，你可精准、高效地在 PHP 中获取 MongoDB 文档内任意数组字段的元素数量，这是处理多值字段统计需求的标准且推荐方案。
mydb->users;
// 统计每个用户的 telephone 数组长度，并保留原始字段（可选）
$result = $collection->aggregate([
[
'$project' => [
'name' => 1,
'telephone' => 1,
'telephone_count' => ['$size' => '$telephone'], // 关键：计算数组长度
'_id' => 0
]
]
]);
foreach ($result as $doc) {
echo sprintf(
"用户 %s 有 %d 个电话号码：%s\n",
$doc->name ?? 'N/A',
$doc->telephone_count ?? 0,
json_encode($doc->telephone ?? [])
);
}['$match' => ['telephone_count' => ['$gte' => 2]]]'telephone_count' => [
'$cond' => [
'if' => ['$isArray' => '$telephone'],
'then' => ['$size' => '$telephone'],
'else' => 0
]
]$collection->find(['telephone' => ['$size' => 2]]); // ❌ 不支持，会静默忽略或报错