Laravel集合怎么操作 Laravel Collection常用方法汇总 【手册】

别把 Collection 当数组用，它不支持 $col[0]

Collection 是对象，不是数组封装；直接用下标访问会报错，比如 $users[0] 或 isset($col['name']) 都会失败。这是新手最常撞墙的地方。

• 取首项必须用 first()，末项用 last()，空时默认返回 NULL（可传默认值）
• 判断是否存在某键？别用 array_key_exists，改用 containsStrict('key', $value) 或 has('key')（后者只检查顶层键）
• 想遍历并修改原集合？别在 foreach 里改 $item —— Collection 的元素是值传递，原集合不会变

Filter()、where()、reject() 到底该选谁

三者语义和性能不同，混用容易逻辑翻车或漏匹配。

• filter()：任意逻辑，比如 filter(fn($u) => $u['score'] > 80 && $u['active'])，适合复杂条件
• where()：快捷字段匹配，支持操作符（'age', '>=', 18）、点号路径（'profile.phone'）、松散比较；但 where('score', null) 会同时匹配 null 和 0，要严格判空请用 whereNull('score')
• reject()：不是 filter() 的语法糖，它是独立优化过的反向过滤，语义清晰且少一次回调调用 —— 别写 filter(fn($x) => !$x['active'])，直接用 reject('active', false)

map() 和 transform()：改原集合还是生成新集合

Collection 默认不可变，绝大多数方法（包括 map、filter、sortBy）都返回新实例。只有少数明确设计为“就地修改”的方法才动原数据。

• map()：安全、推荐，返回新集合，原集合完全不受影响
• transform()：直接改当前实例，返回 $this；仅当你确定后续不再需要原始数据，且想复用变量名时才用，比如批量格式化请求参数后直接提交
• 误用风险：链式调用中中途赋值给变量，比如 $active = $users->where('active', true); $active->transform(...);，这不会影响 $users，但如果你以为它会影响，就会出逻辑 bug

合并多个集合并按 key 聚合求和，别用 merge()

merge() 是键覆盖或追加，不聚合；union() 去重但不累加。要实现“同 name 合并 score”，得走三步流水线：

• 先用 concat() 把所有集合堆成一个（$all = $a->concat($b)->concat($c)）
• 再用 groupBy('name') 分组，得到以 name 为键的子集合
• 最后 map() 每个分组：用 sum('score') 累加，并构造新结构，例如 map(fn($group) => ['name' => $group->first()['name'], 'score' => $group->sum('score')])

这个模式在处理多来源报表、订单汇总、权限合并等场景里反复出现，记牢这三步比背十个方法更实用。