thinkphp6.x的collection类是对查询结果进行内存级链式操作的核心工具,支持筛选、排序、去重、分页等,模型查询默认返回collection,原生查询需用collect()转换,所有方法返回新实例且惰性求值。

ThinkPHP6.x 中的 Collection 类是对查询结果(如 Db::table()->select() 或模型查询返回的数组)进行内存级操作的核心工具,它让数据筛选、排序、分组等操作更直观、链式化,无需反复写循环或 SQL。
Collection 的创建与基础转换
查询结果默认是二维数组,需手动转为 Collection 实例才能使用高级方法:
- 模型查询可直接获取 Collection:`UserModel::where('status', 1)->select()` 返回的就是
Collection对象(前提是未调用->toArray()) - 原生查询需显式转换:`$collection = collect(Db::table('user')->select());`
- 已有数组也可转:`$collection = collect($rawArray);`
按条件动态筛选(filter / where / whereIn 等)
Collection 提供多种筛选方式,比 PHP 原生 array_filter 更语义化:
-
where('field', $value):精确匹配,支持嵌套字段如where('profile.age', '>=', 18) -
whereBetween('age', [18, 60]):范围筛选 -
whereIn('status', [1, 2, 3]):多值匹配 -
filter(function ($item) { return $item['score'] > 80; }):自定义闭包逻辑,适合复杂判断
注意:where 方法对 null 值默认不匹配,如需包含空值可用 whereNotNull('field') 或组合使用 orWhereNull。
灵活排序与多字段优先级控制
排序支持字符串字段、闭包计算、正反序混合,且可链式叠加:
-
sortBy('price'):升序;sortByDesc('price'):降序 -
sortBy(['status' => 'desc', 'created_time' => 'asc']):多字段排序,键为字段名,值为方向 -
sortBy(function ($item) { return strlen($item['name']); }):按字符串长度排序 -
thenSortBy('id'):在前一个sortBy结果基础上追加次级排序(需 ThinkPHP 6.3+ 或手动实现)
去重、分页与结构转换技巧
Collection 还封装了常用结构操作,避免手动处理:
-
unique('email'):按指定字段去重(保留首次出现项) -
chunk(10):切分成每组 10 条的二维集合,适合批量处理 -
forPage($page, $listRows):模拟分页(注意:这是内存分页,非数据库分页,大数据量慎用) -
pluck('name', 'id'):提取键值对,生成[1 => '张三', 2 => '李四'] -
mapWithKeys(function ($item) { return [$item['id'] => $item['score'] * 10]; }):自定义键值映射
不复杂但容易忽略:所有 Collection 方法均返回新实例,原集合不变(惰性求值),可放心链式调用。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











