You need to enable JavaScript to run this app. Laravel分页查询如何获取底层模型Collection而非数组
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 01:06:10