ThinkPHP8.0数据分页处理_ThinkPHP8.0分页类使用方法【功能】-ThinkPHP-PHP中文网

thinkphp 8.0 分页核心是 paginate() 方法，支持数字和数组两种参数形式：数字参数自动读取 page 参数且不可定制；数组参数可显式控制页码、条数、查询参数、是否统计总数及启用 simple 模式。

thinkphp8.0数据分页处理_thinkphp8.0分页类使用方法【功能】

ThinkPHP 8.0 的分页不是靠手动写 limit + count 拼 SQL 实现的，核心就是 paginate() 方法——它自动处理总数查询、分页数据切片、URL 参数拼接和渲染逻辑。但直接调用不等于不出错，尤其在参数控制、性能敏感或 URL 场景复杂时，容易掉坑里。

paginate() 支持「数字参数」和「数组参数」两种传参形式，行为差异直接影响分页逻辑是否可控：

传数字（如 ->paginate(15)）：框架自动从请求中读取 page 参数，默认值为 1；list_rows 固定为 15；无法干预当前页码、额外查询参数、是否统计总数等细节
传数组（如 ->paginate(['list_rows' => 15, 'page' => $p, 'query' => ['status' => 1]])）：可显式指定当前页、每页条数、附加 URL 参数、是否跳过总数查询（total 设为具体数值）、甚至启用 simple 模式（只查下一页有无数据，不查总数）
常见错误：在 API 接口里用数字参数，但前端传的是 page_no 而非 page，导致始终返回第 1 页——必须用数组参数配 'var_page' => 'page_no'

用户带关键词搜索后翻页，链接里没保留 keyword=xxx，点第二页就变全量数据——这不是 bug，是默认行为。解决靠 appends() 或数组参数里的 query：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

链式调用：$users->appends(['keyword' => input('keyword')])，适用于已执行 paginate() 后再补参
构造时注入：->paginate(['list_rows' => 10, 'query' => input('only', ['keyword', 'status'])])，更干净，且能自动过滤空值
注意：appends() 对 simple 分页无效；若用 request()->param() 手动取参，记得过滤掉 page 类参数，否则会重复拼接

当表有千万级记录，SELECT COUNT(*) FROM user WHERE status = 1 可能耗时几百毫秒甚至秒级，而 paginate() 默认每次都会执行它。优化路径很明确：

加覆盖索引：确保 WHERE 条件字段（如 status）和主键都在同一个索引里，让 InnoDB 用索引快速估算行数
用 simple 模式：->paginate(['list_rows' => 20, 'simple' => true])，它只查 SELECT * FROM ... LIMIT 21，判断是否有下一页，不查总数，render() 渲染出的页码只有「上一页/下一页」，无总页数
缓存总数：手动 $count = cache('user_count_status_1') ?: Db::name('user')->where('status', 1)->count(); cache('user_count_status_1', $count, 3600);，再传给 paginate(['total' => $count])

改了 config/paginate.php 里的 'type' 或直接在 render() 里传模板路径，但页面还是默认样式——大概率是模板文件路径不对或变量名不匹配：

确认模板路径是相对于 view_path 的，比如设 'type' => 'bootstrap'，就要有 view_path . 'paginator/bootstrap.php'
自定义模板内必须使用框架约定的变量：$first、$last、$prev、$next、$list（页码数组）、$current、$total 等，少一个或拼错名就白搭
如果用 $list->render('custom')，custom.php 必须放在 view_path . 'paginator/' 下，不能放根目录或随便建子目录