Laravel 中使用 mapToGroups 构建公司与部门名称的映射集合-php教程-PHP中文网

Laravel 中使用 mapToGroups 构建公司与部门名称的映射集合

本文介绍如何在 Laravel 中将 JSON 数据解析为 PHP 数组后，高效构建以公司为键、部门名称数组为值的嵌套集合，重点讲解 mapToGroups 方法的正确用法及常见误区。

本文介绍如何在 laravel 中将 json 数据解析为 php 数组后，高效构建以公司为键、部门名称数组为值的嵌套集合，重点讲解 `maptogroups` 方法的正确用法及常见误区。

在 Laravel 开发中，常需对原始数据（如 JSON API 响应）进行结构化重组。例如，给定一组含 company 和 department 字段的员工/组织记录，目标是生成一个以公司名为键、去重后的部门名称列表为值的关联集合——这恰好是 Collection::mapToGroups() 方法的经典适用场景。

相比手动 groupBy 后再 pluck 或 map，mapToGroups 更简洁、语义更清晰：它接收一个回调函数，该函数对每个元素返回一个键值对（key => value），最终自动聚合成以 key 为索引、value 组成数组的集合。

以下是完整实现步骤：

解析 JSON 并转为 Collection
注意：原始 $jsonData 是 JSON 字符串（非已解码数组），需先调用 json_decode($jsonData, false) 转为对象数组（false 表示返回 stdClass 对象；若为关联数组则用 true，后续访问改为 $item['company']）。
使用 mapToGroups 进行键值映射
回调中返回 [$item->company => $item->department]，Collection 会自动将相同 company 的 department 汇总为数组。
可选：转为普通 PHP 数组
如需传递给 Blade 或 API 响应，调用 toArray() 即可。

// 假设 $jsonData 是原始 JSON 字符串
$dataCollection = collect(json_decode($jsonData, false))
    ->mapToGroups(function ($item) {
        return [$item->company => $item->department];
    })
    ->toArray();

// 输出示例：
// [
//   "Company 1" => ["Department 1", "Department 2"],
//   "Company 2" => ["Department 1", "Department 2"],
//   "Company 3" => ["Department 1", "Department 2"]
// ]

✅ 关键优势：

自动去重？不，mapToGroups 默认保留所有值（包括重复 department）。若需去重，可在 mapToGroups 后链式调用 map(fn($departments) => $departments->unique())。
若原始数据中存在空或 null 的 company，建议前置过滤：->filter(fn($item) => !empty($item->company))，避免产生无效键。

⚠️ 常见误区提醒：