本文介绍如何在 PHP 中使用 MongoDB 驱动（如 mongodb/mongodb 1.x+）准确获取文档中数组字段（如 telephone）的元素个数，重点讲解聚合管道 $size 操作符的正确用法、PHP 代码实现及常见注意事项。
本文介绍如何在 php 中使用 mongodb 驱动（如 mongodb/mongodb 1.x+）准确获取文档中数组字段（如 `telephone`）的元素个数，重点讲解聚合管道 `$size` 操作符的正确用法、php 代码实现及常见注意事项。
在 MongoDB 应用开发中，常需对嵌入式数组字段（如用户联系电话列表 telephone: ["+8613800138000", "+8615900159000"]）进行长度统计。PHP 官方 MongoDB 驱动不支持直接通过 count() 或 sizeof() 处理数据库端数组——这些操作只能在 PHP 层解析整个文档后执行，效率低且无法用于聚合或条件筛选。推荐方案是使用 MongoDB 聚合管道中的 $size 表达式，在数据库层面高效计算数组长度。
✅ 正确做法：使用 $project + $size 聚合阶段
以下为标准 PHP 实现（基于官方驱动 mongodb/mongodb v1.12+）：
<?php
require 'vendor/autoload.php';
$manager = new MongoDB\Driver\Manager("mongodb://localhost:27017");
$collection = (new MongoDB\Client())->selectCollection('mydb', 'users');
// 统计每个用户的 telephone 数组长度，并返回 _id 和 tele_count 字段
$result = $collection->aggregate([
[
'$project' => [
'_id' => 1,
'name' => 1,
'tele_count' => ['$size' => '$telephone'] // 关键：$size 接收字段路径字符串
]
]
]);
foreach ($result as $doc) {
echo "User {$doc->_id}: {$doc->name} has {$doc->tele_count} phone(s)\n";
}? 提示：'$size' => '$telephone' 中的 $telephone 是 MongoDB 的字段引用语法（带 $ 前缀），不是 PHP 变量；若字段可能不存在或非数组类型，$size 将报错。生产环境建议先用 $isArray 或 $type 做类型校验。
⚠️ 注意事项与健壮性增强
-
空数组/缺失字段处理：$size 对 null 或缺失字段抛出错误。安全写法应结合 $ifNull 和 $cond：
立即学习“PHP免费学习笔记（深入）”；
'$tele_count' => [ '$cond' => [ 'if' => ['$isArray' => '$telephone'], 'then' => ['$size' => '$telephone'], 'else' => 0 ] ] -
仅需总数？用 $sum 替代遍历：若目标是「所有文档 telephone 元素总数」，可链式追加 $group：
[ '$group' => ['_id' => null, 'total_phones' => ['$sum' => ['$size' => '$telephone']]] ] 索引无关性：$size 是内存计算操作，无法利用索引优化。高频统计场景建议在应用层维护冗余字段（如 telephone_count: 2），并配合更新钩子保持一致性。
✅ 总结
- ✅ 优先使用聚合管道 $size 操作符，语义清晰、性能优越；
- ✅ 在 PHP 中严格遵循 ['$size' => '$field_name'] 语法，注意 $ 是 MongoDB 运算符而非 PHP 变量；
- ✅ 对非强制数组字段，务必添加类型判断逻辑，避免运行时错误；
- ❌ 避免在 PHP 中 foreach 解析全部文档再 count($doc->telephone) —— 数据量大时严重拖慢响应。
掌握 $size 的正确用法，是构建高性能 MongoDB-PHP 应用的关键基础技能之一。
