ThinkPHP分页请求参数修改更改page请求参数名-ThinkPHP-PHP中文网

thinkphp 5.1+ 自定义分页参数名需继承原分页驱动类并重写 getcurrentpage() 方法，同时配置 var_page 控制链接参数名，二者缺一不可；仅改 var_page 或手动修改 $_get 均无效。

thinkphp分页请求参数修改更改page请求参数名

ThinkPHP 5.1+ 如何自定义分页的 `page` 参数名

默认情况下，ThinkPHP 的分页组件（Paginator）只认 page 这个 URL 参数来获取当前页码。如果你的前端或接口规范要求用 pn、current 或其他名称，直接改 URL 不起作用——分页器压根不读它。

根本原因是：分页器初始化时会调用 input('page')（或 input('page/d', 1)），这个行为写死在 think\paginator\driver\Bootstrap 等驱动类的构造逻辑里，但框架留了钩子让你覆盖。

最稳妥的方式是创建自定义分页器类，继承原驱动并重写 getCurrentPage() 方法
不要试图用 $_GET 手动赋值再传给 paginate()，因为 paginate() 内部仍会重新调用 input() 读取
ThinkPHP 6.0+ 的 LengthAwarePaginator 同样适用该方案，只是命名空间不同

重写 `getCurrentPage()` 获取自定义参数

以 ThinkPHP 5.1 为例，在 app\common\paginator\CustomBootstrap.php 中定义：

namespace app\common\paginator;

use think\paginator\driver\Bootstrap;

class CustomBootstrap extends Bootstrap
{
    protected function getCurrentPage()
    {
        // 改成读取 'pn' 参数，fallback 到 1
        $page = input('pn/d', 1);
        return $this->app->validate($page, 'number>=1') ? (int) $page : 1;
    }
}

然后在控制器中显式使用它：

$list = Db::name('user')->paginate(10, false, [
    'type'     => 'app\common\paginator\CustomBootstrap',
    'var_page' => 'pn', // 这个影响生成的分页链接里的参数名
]);

var_page 控制分页 HTML 链接中显示的参数名（如 ?pn=2），但它不影响读取逻辑——读取由 getCurrentPage() 决定
必须同时改 getCurrentPage() 和 var_page，否则会出现“点下一页跳转的是 pn=2，但服务端仍按 page=2 解析”的错位
如果用了 simple() 分页，也要确保自定义类继承自 SimpleBootstrap 并重写对应方法

全局替换所有分页的参数名（不推荐但可行）

如果你项目里所有分页都要统一改成 current，可以在应用初始化（如 app\common\behavior\InitHook.php）中重绑定分页驱动：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

// 注意：此方式侵入性强，升级 ThinkPHP 时需反复核对
Container::get('think\Paginator')
    ->setDriver('bootstrap', function ($app) {
        return new \app\common\paginator\CustomBootstrap($app);
    });

更轻量的做法是封装一个助手函数：

function custom_paginate($list, $per_page = 15, $config = [])
{
    $default = [
        'type'     => 'app\common\paginator\CustomBootstrap',
        'var_page' => 'current',
    ];
    return $list->paginate($per_page, false, array_merge($default, $config));
}