ThinkPHP如何自定义分页样式及逻辑_Pagination扩展实现-ThinkPHP-PHP中文网

thinkphp 6 自定义分页需继承 bootstrap 类重写 render() 方法，显式指定 type 参数；支持跳转页码和每页条数切换需手动拼接带 query 的 url；ajax 分页须判断 isajax() 并返回纯 html 片段。

thinkphp如何自定义分页样式及逻辑_pagination扩展实现

默认分页 HTML 是硬编码在 think\paginator\driver\Bootstrap 类里的，直接改源码等于埋雷——下次升级就丢。真正可维护的做法是继承并重写渲染模板。

实操建议：

新建类 app\util\CustomPaginator，继承 think\paginator\driver\Bootstrap
重写 render() 方法，返回你自己的 HTML 字符串（注意保留 $this->app->config->get('pagination') 中的 var_page、list_rows 等关键参数）
在分页调用处显式指定驱动：UserModel::paginate(15, false, ['page' => input('page/d', 1), 'query' => request()->param(), 'type' => \app\util\CustomPaginator::class])

常见错误：只覆盖了 render() 却没处理 hasMore() 或 currentPage() 的逻辑，导致“下一页”按钮在最后一页仍显示。

原生 paginate() 不提供前端交互所需的表单结构和路由参数透传机制，必须手动拼接 url() 并确保 query 参数不丢失。

实操建议：

在模板中用 url('index', array_merge(request()->param(), ['page' => 1])) 生成首页链接，避免清空搜索条件
「跳转页码」输入框需配合 JS 提交表单，且 form action 必须带完整 query 参数（例如 ?keyword=abc&page=），否则提交后丢失筛选条件
「每页条数」切换建议用 GET 链接而非表单，例如：@#@#@#@#@#@#@#@#@#@0

容易踩的坑：把 list_rows 当作分页器内部参数硬编码，实际它只是查询时的 limit 值；分页对象本身不感知这个值，需在控制器中手动传递给 paginate() 的第二个参数（即每页数量）。

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

下载

request()->param() 会包含所有 GET + POST 参数，但分页只需要保留非分页相关的查询条件（比如搜索词、分类 ID），否则 page 和 list_rows 会被重复携带，造成链接混乱。

实操建议：

用 array_diff_key(request()->param(), array_flip(['page', 'list_rows'])) 过滤掉分页专用键
更稳妥的方式是显式声明白名单：$keep = ['keyword', 'category_id', 'status']; $query = array_intersect_key(request()->param(), array_flip($keep))
注意：如果用了路由变量（如 route('user/detail', ['id' => 123])），则不能依赖 request()->param()，得从 Route::current()->params() 取

性能影响小，但兼容性差在 TP6.0.0 ~ 6.0.8 之间 request()->param() 对空数组处理不一致，建议加 ?? [] 防错。

核心原因：AJAX 请求时，request()->isAjax() 为 true，但分页模板里仍输出完整 HTML 布局（含），浏览器解析失败。

实操建议：

在自定义 render() 开头加判断：if ($this->app->request->isAjax()) { return $this->renderAjax(); }
renderAjax() 只返回纯分页 HTML 片段（如 <div class="pagination">...</div>），不包含任何 layout 或 script 标签
前端 JS 接收响应后，用 document.querySelector('.pagination').innerHTML = data 替换，不要用 location.reload()

最容易被忽略的是：TP 默认关闭了 AJAX 请求的 CSRF token 自动注入，如果分页链接含 POST 表单（如跳转页码），需手动在 JS 中读取 meta 标签或 hidden input 的 token 值并附带到请求头。