Collection是封装对象,不支持数组语法$collection[0],须用->first()等方法;filter/reject基于truthy/falsy判断,需显式处理0/空字符串;map后建议->values()重置索引;when/unless用于条件链式调用,闭包需use引入变量;Collection惰性求值且不可变。

Collection 是对象不是数组,别用 [] 直接取值
很多人在 foreach 之外想取第 0 个元素,写 $collection[0] 报错:Cannot use object of type Illuminate\Support\Collection as array。因为 Collection 是封装过的对象,不支持原生数组语法。
- 要用
->first()取第一个,->last()取最后一个 - 按索引取?得先转成数组:
$collection->values()->get(0)(注意get()是基于 0 的,不是键名) - 如果确定有键,且想用键访问,用
->get('key')或->pull('key')(后者会移除) -
->toArray()确实能转数组,但别滥用——一转就失去链式调用和延迟计算优势
filter() 和 reject() 的闭包返回值必须明确为 truthy/falsy
写 $collection->filter(function ($item) { return $item->status; }) 看似没问题,但一旦 $item->status 是 0、''、null,整条数据就被过滤掉了——这不是 bug,是设计如此。
- 需要保留 0 或空字符串?显式判断:
return $item->status !== null或is_numeric($item->status) -
reject()是filter()的反向逻辑,别以为它只“拒绝 false”,它拒绝所有 falsy 值 - 想按字段是否存在过滤?用
->whereNotNull('field')更安全,语义清晰且不依赖 PHP 隐式转换
map() 改变结构后记得用 values() 重置键
对集合做 map() 后,原始键可能保留(比如从数据库查出来带 id 键),也可能变成数字键,但更常见的是“键乱了”:你想要连续数字索引,结果得到 [2 => ..., 5 => ..., 7 => ...],后续 ->chunk(3) 或 ->splice() 行为异常。
- 只要不需要保留原始键,map 后立刻加
->values(),比如:$collection->map(...)->values() -
->all()不重置键,->toArray()也不重置关联键,只有->values()强制转为数字索引 - 批量修改模型属性后保存,也建议
->values()再传给Model::upsert(),避免键冲突
when() 和 unless() 是条件链式入口,不是 if 替代品
看到代码里一堆 if ($condition) { $collection = $collection->xxx(); },其实大可换成 ->when($condition, fn($c) => $c->xxx())。但它不是万能的——闭包里不能 break,也不能提前 return。
- 多个条件嵌套?用多个
->when()并列,别套在闭包里再写 if - 闭包中想复用变量?必须用
use ($var)显式引入,PHP 不自动继承作用域 -
->unless()就是->when(! $condition),别为了少打几个字符硬套,可读性优先 - 注意:这些方法返回新集合,原集合不变;但如果在循环里反复赋值,性能无额外开销——Collection 是 lazy 的,操作只是记下动作,真正执行在迭代或
->all()时
map() 立刻执行了,其实可能等到你 dd() 才触发。调试时别只看 dump 结果,要留意执行时机。


















