本文详解如何使用 Laravel 集合的 groupBy() 方法，基于深层嵌套数组字段（例如 company.id）对数据进行精准分组，避免常见误区，并提供可直接运行的代码示例与关键注意事项。
本文详解如何使用 laravel 集合的 `groupby()` 方法，基于深层嵌套数组字段（例如 `company.id`）对数据进行精准分组，避免常见误区，并提供可直接运行的代码示例与关键注意事项。
在 Laravel 开发中，常需对已获取的 PHP 数组（如 API 响应或数据库查询后处理的数据）按嵌套结构中的某个键（如 $item['company']['id']）进行分组。此时，绝不能直接将值传入 groupBy()——这正是提问者遇到问题的根本原因：groupBy($data['company']['id']) 实际上是把一个具体数值（如 2）当作“分组键名”传入，导致 Laravel 尝试以该值为键创建新集合，而非从每个元素中动态提取字段。
✅ 正确做法是：将 groupBy() 的参数设为一个回调函数（Closure）或支持点号语法（dot notation）的字符串路径，让 Laravel 对集合中每个项执行提取逻辑。
✅ 推荐写法（两种等效方式）
方式一：使用闭包（Laravel 9+ 支持箭头函数）
$grouped = collect($array['data'])
->groupBy(fn ($item) => $item['company']['id']);方式二：使用点号语法（更简洁、可读性高）
$grouped = collect($array['data'])->groupBy('company.id');✅ 点号语法是 Laravel 集合的内置特性，会自动递归解析嵌套数组/对象属性（如 'company.id' → $item['company']['id']），无需手动写闭包，且兼容关联数组与 StdClass 对象。
? 完整可运行示例
use Illuminate\Support\Collect;
$array = [
"data" => [
[
"company" => ["id" => 1, "name" => "company1"],
"reports" => ["active_reports" => 3, "completed_reports" => 2]
],
[
"company" => ["id" => 2, "name" => "company2"],
"reports" => ["active_reports" => 6, "completed_reports" => 1]
],
[
"company" => ["id" => 2, "name" => "company2"],
"reports" => ["active_reports" => 7, "completed_reports" => 5]
]
]
];
$grouped = collect($array['data'])->groupBy('company.id');
// 输出 JSON 格式化结果（便于验证）
echo $grouped->toJson(JSON_PRETTY_PRINT);输出即为所期望的结构：
{
"1": [
{
"company": { "id": 1, "name": "company1" },
"reports": { "active_reports": 3, "completed_reports": 2 }
}
],
"2": [
{
"company": { "id": 2, "name": "company2" },
"reports": { "active_reports": 6, "completed_reports": 1 }
},
{
"company": { "id": 2, "name": "company2" },
"reports": { "active_reports": 7, "completed_reports": 5 }
}
]
}⚠️ 关键注意事项
- ❌ 不要在循环中对单个元素调用 collect($item)->groupBy(...)：groupBy() 是作用于整个集合的方法，对单个数组调用会返回错误结构（如你看到的空键 ""）。
- ✅ groupBy() 返回的是 Illuminate\Support\Collection，键为分组值（如 "1"、"2"），值为同组元素组成的子集合。
- ? 若需进一步处理（如合并同公司 report 数值），可链式调用 map()：
$summary = $grouped->map(function ($items, $companyId) { return [ 'company' => $items->first()['company'], 'total_active' => $items->sum('reports.active_reports'), 'total_completed' => $items->sum('reports.completed_reports') ]; }); - ? 点号语法同样适用于对象属性（如 $item->company->id），Laravel 会智能适配数组与对象访问。
掌握这一技巧，你就能高效、声明式地完成任意层级嵌套数据的分组任务，大幅提升数据预处理阶段的开发效率与代码可维护性。
