如何在 PHP 中使用 MongoDB 聚合管道获取数组字段的元素数量

本文介绍如何在 php 中通过 MongoDB 聚合操作（$size 表达式）准确统计文档中数组字段（如 telephone）的元素个数，并提供可直接运行的代码示例与关键注意事项。

本文介绍如何在 php 中通过 mongodb 聚合操作（`$size` 表达式）准确统计文档中数组字段（如 `telephone`）的元素个数，并提供可直接运行的代码示例与关键注意事项。

在 mongodb 应用开发中，常需对嵌套数组字段进行统计分析——例如判断某用户文档中存储了多少个电话号码（telephone: [“+8613800138000”, “+8615900159000”]）。PHP 官方驱动（mongodb/mongodb v1.10+）不支持直接在 find() 中使用 $size 作为查询条件（该操作符仅用于聚合阶段），因此必须借助聚合管道（Aggregation Pipeline）实现数组长度计算。

✅ 正确做法：使用 $size 在 $project 阶段计算数组长度

以下是一个完整、健壮的 PHP 示例（基于官方 MongoDBDriverManager 或 MongoDBClient）：

<?php require 'vendor/autoload.php';  $client = new MongoDBClient('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 个电话号码：%sn",         $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 文档内任意数组字段的元素数量，这是处理多值字段统计需求的标准且推荐方案。