Collection的map、filter、reduce是核心操作,难点在于闭包边界控制与链式调用中的数据形态变化:map逐项转换不改变长度但可能引入null;filter按truthy/falsy过滤,需显式处理0或空字符串;reduce必须显式返回累加器且初始值决定返回类型。

Collection 的 map、filter、reduce 不是“高阶用法”,而是日常必须掌握的核心操作——它们的真正难点不在语法,而在闭包逻辑的边界控制和链式调用中的数据形态变化。
map 会改变原始值类型,但不改变集合长度
map 逐项转换,返回新 Collection,原集合不变。常见错误是误以为它能“过滤”或“跳过”某些项——它不能,空值或 null 也会占位。
- 如果回调返回
null,对应位置就是null,不是被移除 - 想边映射边筛选,得接
filter():比如$collection->map(...)->filter()->values() - 注意键名保留:默认不重置索引,需加
values()才变成数字索引
$users = collect([['name' => 'Alice'], ['name' => 'Bob']]); $names = $users->map(fn($u) => strtoupper($u['name'])); // collect(['ALICE', 'BOB']) // 若某项为 null:$users->map(fn($u) => $u['name'] ?? null) → collect(['Alice', null])
filter 的闭包返回值决定去留,不是“真假值”而是“是否为 truthy”
filter 判断依据是 PHP 的“truthy/falsy”规则,不是严格布尔。空字符串 ''、整数 0、浮点 0.0、空数组 [] 都会被过滤掉——这点极易踩坑。
- 要保留
0或''?必须显式比较:filter(fn($v) => $v === 0 || $v !== '') - 不传参数时,
filter()默认剔除所有 falsy 值(包括0、false、null) - 键名默认保留,可能造成“稀疏数组”,需要
values()重排
$data = collect([0, 1, '', 'hello', false]); $data->filter(); // collect([1, 'hello']) —— 0 和 '' 和 false 全没了 $data->filter(fn($v) => $v !== ''); // collect([0, 1, 'hello', false])
reduce 的累加器类型由初始值决定,且必须显式返回
reduce 的回调必须返回累加器($carry),否则下一轮 $carry 变成 null,后续逻辑崩塌。初始值不传时,第一项作初始值——此时若集合为空,直接报错 Undefined offset。
- 永远显式传初始值,尤其是期望返回数组、对象或数字时
- 初始值类型决定最终类型:传
[]得数组,传0得数字,传collect()得 Collection - 别在 reduce 里做副作用(如修改外部变量),它本意是纯函数式累积
$prices = collect([19.99, 29.99, 9.99]); $total = $prices->reduce(fn($carry, $price) => $carry + $price, 0); // 59.97 // 错误写法(没返回 carry): // $prices->reduce(fn($carry, $p) => $carry += $p); // 第二轮 $carry 是 null
最常被忽略的是三者组合后的“类型漂移”:比如 map 返回对象后,再 filter 就得按对象属性判断;reduce 累加出数组后,不能再当 Collection 调用 first()——得先 collect() 包一层。链式调用看着流畅,数据形态却在悄悄变。










