ThinkPHP 6 的 paginate() 返回 Paginator 对象，需用 items() 获取数据集；items() 返回 Collection，all() 转数组；toArray() 返回含分页信息的完整数组，data 键才存当页数据。
ThinkPHP 6 的 paginate() 返回值结构是什么
直接调用 paginate() 得到的不是纯数组，而是一个实现了 think\Paginator 接口的对象（如 think\paginator\driver\Bootstrap），它**不支持直接 foreach 遍历原始数据**，也不等价于 toArray() 后的结果。你看到的“分页数据集”其实是该对象的 items 属性（一个 Collection 实例），不是 data 或 list。
常见错误：把 $list = $query->paginate(10) 当作数组用，写 foreach($list as $item) —— 这会遍历整个 Paginator 对象的属性（含分页信息），不是你要的数据。
- 正确取每页数据：用
$list->items()，返回Collection；或$list->items()->all()转成原生数组 -
$list->toArray()是把**分页元信息 + 数据 items** 一起转成数组，结构是['data' => [...], 'current_page' => 1, ...]，其中data才是你那一页的记录 - 如果你只需要数据、不要分页渲染，
paginate()其实没必要——直接用limit()->select()更轻量
如何在控制器里安全取出分页后的数据数组
别依赖模板自动解析，显式提取最可控。尤其当你需要对数据做额外处理（如字段映射、关联预加载后加工）时，必须先拿到原始数据集。
- 推荐方式：
$data = $list->items()->all();—— 简洁、类型明确、无冗余字段 - 兼容旧习惯：
$data = $list->toArray()['data'] ?? [];—— 注意 PHP 8.0+ 的空合并链式写法要确保toArray()不抛异常 - 避免：
json_decode(json_encode($list), true)—— 会把Collection和闭包等转成空数组或丢失结构 - 如果用了
with()关联预加载，$list->items()返回的每条记录已包含关联数据，无需再循环查
分页数据为空时 items() 和 toArray()['data'] 行为差异
当查询无结果（比如关键词没匹配到），paginate() 仍会返回一个 Paginator 对象，但数据部分表现不同，容易引发 Undefined index: data 或空集合误判。
立即学习“PHP免费学习笔记（深入）”；
-
$list->items()永远返回Collection，哪怕为空，可安全调用->count()、->isEmpty() -
$list->toArray()['data']在无数据时是空数组[]，但若中间有异常（如模型访问器报错），可能根本不存在data键 - 稳妥判断空数据：
if ($list->isEmpty()) { ... }或if ($list->items()->count() === 0) { ... } - 模板中用
{$list->isEmpty() ? '暂无数据' : ''}比判count($list)更准确
性能注意：别在分页对象上反复调用 items()
items() 不是简单 getter，它内部会触发一次数据缓存初始化（虽然只执行一次），但在循环或高频调用场景下仍有轻微开销。
- 单次使用没问题，但如需多次访问数据（如先统计再遍历），先赋值：
$items = $list->items(); $count = $items->count(); foreach($items as $item) {...} - 不要写
foreach($list->items() as $item)多次——每次都会重建 Collection 实例 - 如果只是导出或 API 返回，直接用
$list->items()->toArray()，比$list->toArray()['data']少一层嵌套，也更语义清晰
Paginator 对象本身带分页逻辑和模板渲染能力，但“取数据”这个动作，始终要认准 items() 这个入口。其他路径要么多一层转换，要么隐含边界风险。
