ThinkPHP 6 可通过 render('template/path') 直接指定自定义分页模板，模板中用 $page 调用分页方法拼HTML；TP5.1 需继承 \Think\Page 重写 show() 方法，并用 setConfig('parameter', ...) 保留URL参数。
ThinkPHP 6 的 render() 方法怎么改分页 HTML 结构
直接改 render() 输出的 HTML，核心是传入自定义的分页模板路径，而不是重写整个分页类。TP6 默认用的是 think\paginator\driver\Bootstrap 风格，但它的 HTML 渲染逻辑封装在 render() 调用的视图文件里，不是硬编码在 PHP 中。
实操建议：
- 复制框架默认模板：把
vendor/topthink/framework/src/think/paginator/driver/bootstrap4.php（或bootstrap5.php，取决于你用的版本）拷到resources/view/paginate/下，比如命名为custom.php - 在分页对象上调用
render()时传入路径：$list->render('paginate/custom') - 模板里可直接使用
$page变量（即分页实例），调用$page->currentPage()、$page->lastPage()、$page->getUrl($pageNo)等方法拼 HTML - 注意：模板中不要 echo 或 return，只输出 HTML 片段；框架会自动捕获输出并注入到最终响应中
ThinkPHP 5.1 如何替换分页 HTML 模板
TP5.1 没有内置模板路径参数，render() 不接受字符串路径，必须通过配置或继承方式干预。最稳妥的做法是自定义分页类，继承 Think\Page（TP5.1 是 Think\Page，不是 think\Paginator）。
常见错误现象：直接覆盖 Think\Page 的 show() 方法但没重写 first()、last()、prev()、next()，导致首页/末页链接失效或跳转错乱。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 新建类
app\common\CustomPage，继承\Think\Page - 重写
show()方法，里面手动拼 HTML，用$this->firstRow、$this->totalRows、$this->rollPage等属性计算页码范围 - 确保
$this->url已正确设置（通常需在构造后调用$page->setConfig('path', 'xxx')或提前赋值$page->url = U('index/index', [...])） - 避免在
show()中硬编码 URL 参数，应复用$this->parameter数组（它存着 GET 参数）
自定义分页时 URL 参数丢失怎么办
典型表现：点击第2页后，原带的 ?type=hot&sort=desc 消失了，只剩 ?page=2。根本原因是分页生成链接时没合并当前请求参数。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
TP6 的解决方式：在调用 paginate() 前，显式传入 query 参数：
$list = Db::name('article')->where($map)->paginate(10, false, ['query' => request()->param()]);
TP5.1 的解决方式：初始化 Page 实例后，用 setConfig() 注入参数：
$page = new \Think\Page($count, 10);
$page->setConfig('parameter', http_build_query(request()->param()));
关键点：
-
request()->param()包含所有 GET + POST 参数，若只要 GET，用input('get.') - TP6 中
query选项值必须是数组，不能是已拼好的 query string - 如果用了路由变量（如
route('article/list', ['id' => 123])），要确保query参数和路由变量不冲突
分页按钮数量动态控制与省略号逻辑
默认 TP 分页显示 5 个页码按钮（当前页 ±2），但实际常需要“首/尾固定 + 中间滚动”效果，比如：1 … 5 6 7 8 9 … 100。这不能靠 CSS 隐藏，得在模板里写判断逻辑。
TP6 自定义模板（如 custom.php）中可这样处理：
<?php
$currentPage = $page->currentPage();
$lastPage = $page->lastPage();
$pagesToShow = 5;
$half = (int) floor($pagesToShow / 2);
<p>// 构造页码数组
$pages = [];
if ($lastPage <= $pagesToShow) {
$pages = range(1, $lastPage);
} else {
$start = max(1, $currentPage - $half);
$end = min($lastPage, $currentPage + $half);
if ($start == 1) {
$end = min($lastPage, $pagesToShow);
} elseif ($end == $lastPage) {
$start = max(1, $lastPage - $pagesToShow + 1);
}
$pages = range($start, $end);
}
?>
容易踩的坑：
- 没处理边界情况（如总页数只有 1 或 2 页），导致
range(3,1)返回空数组 - 省略号（
…）前后没加条件判断，比如第2页时显示 “1 … 2 3 … 100”，其实不需要第一个省略号 - 用
$page->getUrl($p)生成链接时，未校验$p是否在合法范围内（1 到$lastPage），可能生成无效链接
复杂点在于页码逻辑和 URL 合并要同时兼顾——模板里既要算页码，又要拼带参数的 URL，稍不注意就漏参数或崩结构。
