Laravel分页查询如何获取底层模型Collection而非数组
直接结论
无需手动用collect()包装数组,Laravel分页器内置了直接返回底层原生模型集合的方法,拿到的集合和get()查询返回的类型完全一致
原理解释
你观察到User::select('id')->paginate(10)->items()返回数组,是因为items()方法本身的设计定位:它用于输出适配通用交互规范的数组格式,返回时会主动把内部存储的集合拆解为数组,这并不代表分页器本身是以数组形式存储查询结果的。
实际上分页器实例从创建完成开始,就全程持有查询返回的原始Eloquent Collection实例,全程没有做过类型转换。
内置获取方法
直接在分页器实例上调用getCollection()方法,即可零成本拿到底层的原生Eloquent集合:
// 返回值类型与 User::select('id')->get() 完全一致,为 Illuminate\Database\Eloquent\Collection $userModelCollection = User::select('id')->paginate(10)->getCollection();
关键差异说明
- 对比手动
collect($paginator->items())的方案:手动包装得到的是通用的Illuminate\Support\Collection,会丢失Eloquent Collection专属的模型快捷操作方法(比如按主键快速查找、批量关联加载等);而getCollection()返回的是原生模型集合,功能与get()返回的集合无任何区别 - 分页器常用返回方法的边界对比:
items():返回数组格式的分页结果,主要适配API响应、纯数组交互的场景getCollection():返回无格式转换的底层Eloquent集合,适合需要集合操作的业务逻辑- 直接遍历分页器实例(如
foreach ($paginator as $user)),本质上就是在遍历它持有的这个底层集合,不会产生额外的数组/集合转换开销
内容的提问来源于stack exchange,提问作者panthro
相关产品推荐
相关产品推荐

