ThinkPHP中Collection数据集_链式操作与高阶函数用法【操作】-ThinkPHP-PHP中文网

thinkphp的collection是可变集合，所有操作如filter、sort、map等默认就地修改原数据集，不返回新实例；需克隆或重建才能保留原始数据，且无链式调用能力。

thinkphp中collection数据集_链式操作与高阶函数用法【操作】

ThinkPHP 的 Collection 不是 Laravel 那套，它不支持链式返回新实例，所有操作默认就地修改原数据集 —— 这一点不搞清，后续所有 filter、map、sort 都会踩坑。

为什么 `Collection::filter()` 之后原数组被改了？

ThinkPHP 的 Collection 是「可变集合」，filter()、sort()、shuffle() 等方法直接修改 $this->items，不返回新实例。它没有 Laravel 那种「每个方法都返回新 Collection」的设计。

调用 $col->filter($callback) 后，原 $col 已被过滤，再 ->count() 得到的是过滤后数量
想保留原始数据？必须手动克隆：$new = clone $col，或先 $col->toArray() 再 Collection::make() 重建
注意 filter() 对 0、false、'' 的判定和 PHP empty() 一致，不是 strict truthy；若需保留 0，回调里得显式写 return $item !== null 这类判断

`Collection::map()` 和 `array_map()` 行为差异在哪？

Collection::map() 会保留原始键名（包括字符串键），但只遍历 $this->items 值，不提供键参数；而原生 array_map() 可通过 use 捕获外部变量，Collection::map() 的闭包只能访问传入的值。

ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

$col->map(function($v) { return $v * 2; }) ✅ 有效
$col->map(function($v, $k) { ... }) ❌ 第二个参数 $k 不会被传入，始终为 null
要按键操作？改用 each() 或直接遍历 $col->toArray()
如果 map 后需要重置数字索引（比如后续要 chunk()），得手动 array_values() 再 Collection::make()

链式调用能连 `where()` 和 `Collection` 方法吗？

不能混用。数据库查询的 where() 是 Query 类的方法，返回的是 Query 实例；Collection 是独立类，二者无继承或转换关系。常见错误是查完直接链式调 ->filter()，会报 Call to undefined method think\db\Query::filter()。

正确流程：先 Db::table()->where(...)->select() 得到数组 → 用 Collection::make($array) 转成集合 → 再调 filter/map
别写 Db::table()->where(...)->select()->filter(...)，select() 返回的是数组或 Collection（取决于配置），但绝不是支持 filter 的对象
如果开启了 'collection' => true 全局配置，select() 默认返回 Collection，此时才能接 ->filter()，但要注意该配置影响所有查询，可能破坏已有逻辑

`reduce()` 容易忽略的类型陷阱

Collection::reduce() 的初始值决定返回类型，且不校验闭包返回值类型 —— 如果初始值是 0，但某次迭代返回了字符串，后续累加就变成字符串拼接。

$col->reduce(function($carry, $item) { return $carry + $item; }, 0) → 数字累加 ✅
$col->reduce(function($carry, $item) { return $carry . $item; }, '') → 字符串拼接 ✅
但若初始值是 0，闭包里写了 return $carry . $item，结果就是 "0123" 这种意外字符串 ❌
复杂聚合建议改用 each() + 外部变量，或先 toArray() 再用原生 array_reduce()，控制力更强