Laravel集合方法有哪些_Laravel集合方法【汇总】-php教程-PHP中文网

laravel集合核心方法只有五个：filter()、where()、map()、pluck()、groupby()；其余多为变体或特定场景使用。filter()适用于复杂闭包逻辑，where()仅支持简单键值匹配；map()多行需显式return；pluck()支持嵌套键与unique()组合；groupby()返回嵌套collection而非数组，须按集合方式操作。

laravel集合方法有哪些_laravel集合方法【汇总】

直接说结论：Laravel 集合不是“方法列表背诵题”，真正高频、不可绕开的核心方法就五个 —— filter()、where()、map()、pluck()、groupBy()；其余方法要么是它们的变体，要么只在特定场景下才值得单独调用。

什么时候该用 `filter()` 而不是 `where()`

二者都筛选，但语义和行为完全不同：filter() 是通用闭包过滤器，where() 是专为键值匹配设计的快捷语法。

filter() 适合复杂条件：比如 $users->filter(fn($u) => $u->created_at->diffInDays(now()) > 30 && $u->profile?->is_verified)
where() 只支持简单比较：$users->where('status', 1) 或 $users->where('age', '>=', 18)；它不支持嵌套属性（如 'profile.active'）或时间对象方法调用
常见坑：用 filter(fn($u) => $u['status']) 会把 status = 0 的记录也干掉 —— 因为 PHP 把 0 当作 falsy；必须写成 === 0 或显式判断
whereNotNull('email') 比 filter(fn($u) => !empty($u['email'])) 更安全，自动跳过 null/undefined 键

`map()` 多行逻辑必须写 `return`，否则全变 `null`

箭头函数单表达式自动返回没问题，但一旦加了 if、foreach 或多步处理，漏 return 就等于整个元素被替换成 null。

Laravel 13.2.0

PHP中文网提供Laravel 13.2.0版本下载，Laravel框架是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。

下载

安全写法：$users->map(fn($u) => ['id' => $u->id, 'label' => strtoupper($u->name)])
危险写法：$users->map(fn($u) => { $label = strtoupper($u->name); $u->id; }) —— 最后一行没 return，结果每个元素都是 null
想原地改原集合？用 transform()，但它不返回新实例，链式调用到这里就断了
需要重排数字索引（比如切片后要 [0] 访问）？记得接 values()，否则 $collection[0] 会报错 —— 集合不支持数组下标访问

`pluck()` 提取字段时，嵌套键和 `unique()` 组合很常用

pluck() 看似简单，但它是 API 响应、下拉选项、ID 列表生成的主力，且天然支持点号路径和去重。

提取模型关系字段：$userEmails = $users->pluck('profile.email')，自动跳过没有 profile 的用户
去重后转数组：$userEmails->unique()->values()->all()，避免重复邮箱干扰前端选择
别对空集合调用 pluck() 后直接 first() —— 如果集合为空，first() 返回 null，但不会报错；若业务强依赖非空，得先 isNotEmpty() 判断
注意：如果源数据是 Eloquent Collection，pluck('name') 返回的是 Collection，不是数组；需要 ->all() 或 ->toArray() 才能给前端 JSON

`groupBy()` 返回的是嵌套集合，不是二维数组

这是最容易踩坑的一点：分组后不能当普通数组用，$grouped['active'][0] 会出错，必须按集合方式操作。

$grouped = $users->groupBy('status') → $grouped['active'] 是一个 Collection，不是数组
取某一分组第一个用户：$grouped['active']->first() ✅，而不是 $grouped['active'][0] ❌
遍历分组：foreach ($grouped as $status => $usersInStatus) { ... } 没问题，因为 Collection 支持 foreach
如果后续还要 pluck() 或 sum()，直接链式调用即可：$grouped['active']->pluck('name')->join(', ')