能用,且必须通过查询构造器链式调用paginate();TP5.1+已移除think\Paginator类,改由Query/Builder层原生支持,返回Paginator(5.1)或LengthAwarePaginator(6.0)实例。

ThinkPHP 5.1+ 里 Paginator 类被移除后,paginate() 还能用吗
能用,而且必须用——但不是调用旧版 Paginator 实例,而是直接在查询构造器上链式调用 paginate() 方法。TP 5.1 起把分页逻辑彻底收归到 Query 和 Builder 层,Paginator 类本身已从核心中剥离,手动 new 它会报 Class 'think\Paginator' not found。
常见错误现象:
– 升级后原代码里写 new \think\Paginator(...) 直接崩溃
– 沿用 TP5.0 的自定义分页类继承 \think\Paginator,运行时报类不存在
- 所有分页必须走
Db::table()->where(...)->paginate()或$model->where(...)->paginate() - 不再支持传入原始数组 + 手动实例化分页器;如需数组分页,请改用
collection()->paginate() -
paginate()返回的是LengthAwarePaginator实例(TP6)或Paginator(TP5.1),二者接口基本一致,但底层类名和路径不同,别硬类型提示旧类
如何让老项目里的分页模板不报错:$list->render() 还有效吗
有效,但渲染逻辑变了。TP5.1+ 的 paginate() 返回对象仍带 render() 方法,且默认使用 think\view\driver\Think 模板引擎的 paginate 标签,但模板里不能假设它一定有 lastPage、total 这些旧属性——得用标准方法访问:
- 用
$list->lastPage()代替$list->lastPage(属性已转为方法) - 用
$list->total()代替$list->total -
$list->currentPage()、$list->hasPages()同理,全部是方法调用 - 如果模板里写了
{$list->firstRow}这类 TP5.0 特有属性,会返回 null 或报错,必须删掉或替换为{$list->firstItem()}
兼容技巧:在控制器里加一层适配,比如 $pageData = $list->toArray() + ['current_page' => $list->currentPage()],再 assign 给模板,避免改大量模板。
立即学习“PHP免费学习笔记(深入)”;
自定义分页参数传不进去?paginate(15, false, ['page' => 'p']) 失效原因
TP5.1+ 的 paginate() 签名变了,第三个参数不再是配置数组,而是布尔值控制是否显示简单分页;分页配置必须用静态方法提前设置,或通过 config('paginate') 全局覆盖。
常见错误现象:
– 写 paginate(15, false, ['page' => 'p']),结果 URL 参数还是 page,没生效
– 设置 ['query' => ['status'=>1]] 在第三个参数里,发现 URL 里没带上
- 正确做法:在控制器开头或配置文件里调用
\think\Paginator::currentPageResolver(function () { return input('p/d', 1); }); - URL 参数名统一由
currentPageResolver控制,不是paginate()参数传的 - 要追加查询参数,用
$list->appends(['status' => 1]),在模板里配合$list->render()自动注入 - 全局配置分页参数(如每页数、跳转链接样式)应写进
config/paginate.php,而非每次调用都传
TP6 中 LengthAwarePaginator 和 TP5.1 的 Paginator 有啥关键差异
核心行为一致,但 TP6 把分页器升级为 Laravel 风格的 LengthAwarePaginator,导致两个容易踩的坑:
- TP6 不再自动识别
input('page'),必须显式设置解析器,否则currentPage()永远返回 1 - TP6 的
render()默认输出 Bootstrap 4/5 样式,若项目用纯 HTML 或 Layui,得重写think\paginator\driver\Bootstrap对应的视图,或直接用$list->links('default')切回基础 ul/li - TP6 中
$list->toArray()返回结构和 TP5.1 不同:多了data键包裹数据,且per_page改为per_page(TP5.1 是list_rows),注意 JSON 接口字段对齐
最常被忽略的一点:TP6 的分页器不兼容 TP5.1 的自定义驱动类写法,如果你以前扩展过 MyPaginator 并继承 \think\Paginator,现在必须重写为实现 Illuminate\Contracts\Pagination\LengthAwarePaginator 接口,否则连构造都失败。


















