ThinkPHP分页技巧：快速获取上一页与下一页的URL地址-ThinkPHP-PHP中文网

thinkphp 分页器无现成 getprevurl()/getnexturl() 方法，需手动拼接；关键在于复用当前 get 参数仅修改 page 或 cursor 值，避免丢参、错跳或 404。

thinkphp分页技巧：快速获取上一页与下一页的url地址

直接给结论：ThinkPHP 自带的分页器不提供现成的 getPrevUrl() 或 getNextUrl() 方法，必须手动拼接；关键不是“怎么生成”，而是“怎么保证拼得对”——尤其当 URL 已含搜索参数、路由模式变化、或用了游标分页时，硬写 ?page=2 会丢参数、错跳转、甚至触发 404。

为什么不能直接用 `$page->nextPageUrl()`？

ThinkPHP 6 的 Paginator 类（think\Pagination\Driver\Bootstrap 等）只暴露 render() 和部分属性（如 $list->currentPage()、$list->hasMore()），没有封装单个链接生成逻辑。有人尝试访问 $list->url(2)，但该方法在多数驱动里是 protected 或未实现。

常见错误现象：

btpanel phpsite 宝塔面板PHP网站

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

下载

直接拼 "?page=" . ($page + 1)：忽略当前 URL 中的 q=abc&status=1 等参数，点下一页就清空搜索条件
用 $_SERVER['REQUEST_URI'] 替换 page 值：遇到 /admin/user/index/page/3 这类 PATH_INFO 路由时，正则替换容易出错或漏斜杠
把 input('page') 当字符串参与运算：'10' + 1 得 11 没问题，但 '10a' + 1 得 1，结果跳到第 1 页

安全拼接上一页/下一页 URL 的实操步骤

核心思路：复用 ThinkPHP 解析后的查询参数，只改 page 值，其余原样保留。

先取当前所有有效 GET 参数：$params = input();
确保 page 是整数且合法：$current = (int) input('page', 1); $current = max(1, $current);
算目标页码：$prev = $current > 1 ? $current - 1 : null;，$next = $list->hasMore() ? $current + 1 : null;
构造新参数数组：if ($prev !== null) $params['page'] = $prev;，然后用 url('index', $params)（适用于路由定义）或 url('') . '?' . http_build_query($params)（通用 GET 模式）
注意：若项目启用了 url_html_suffix（如 .html），需额外处理后缀，否则 ?page=2 会和 /index.html 冲突

游标分页场景下 URL 怎么拼？

游标分页不用 page，用的是 cursor，所以“上一页/下一页”的语义完全改变——它依赖数据本身顺序，而非页码数字。

下一页 URL：取当前页最后一条记录的 id（或时间戳），传为 cursor=12345，即 http_build_query(array_merge($params, ['cursor' => $nextCursor]))
上一页 URL：不能简单 cursor-1，必须查上一页最后一条的 id，再用 WHERE id 反向取，因此上一页游标需单独查一次（或缓存前一页末尾值）
前端必须区分两种状态：首次加载无 cursor，后续请求带 cursor；URL 里出现 page 和 cursor 同时存在，说明逻辑混乱
不要试图把游标塞进 paginate()：它的 page 参数会被强制解释为页码，导致 SQL 生成 LIMIT 12345, 20，彻底错乱