本文介绍如何在 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）：
<?php
require 'vendor/autoload.php';
$client = new MongoDB\Client('mongodb://localhost:27017');
$collection = $client->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 ?? [])
);
}? 提示：若仅需筛选 telephone 元素数 ≥ 2 的文档，可在 $project 后追加 $match 阶段：
['$match' => ['telephone_count' => ['$gte' => 2]]]
⚠️ 注意事项与最佳实践
-
$size 仅适用于数组字段：若目标字段不存在、为 null 或非数组类型（如字符串、对象），聚合将报错 TypeError: cannot use $size on non-array field。建议先用 $isArray + $cond 做安全兜底：
立即学习“PHP免费学习笔记（深入）”；
'telephone_count' => [ '$cond' => [ 'if' => ['$isArray' => '$telephone'], 'then' => ['$size' => '$telephone'], 'else' => 0 ] ] -
避免在 find() 中误用 $size：如下写法是错误且无效的：
$collection->find(['telephone' => ['$size' => 2]]); // ❌ 不支持，会静默忽略或报错
正确方式始终是聚合（aggregate）——因为 $size 是聚合表达式，非查询操作符。
性能提示：$size 是轻量级内存计算，无索引依赖；但若需高频按数组长度查询，可考虑在写入时预存 telephone_count 字段并建立索引，提升读取效率。
综上，通过 aggregate() 配合 $project 和 $size，你可精准、高效地在 PHP 中获取 MongoDB 文档内任意数组字段的元素数量，这是处理多值字段统计需求的标准且推荐方案。
