系统讲解ThinkPHP分页查询的数据封装与样式自定义方法

三、深度自定义分页样式（告别Bootstrap）

默认的 render() 方法生成的是Bootstrap 3样式的分页HTML。如果你的项目使用的是其他UI框架（如Element UI、Layui）或者需要完全自定义样式，那么就需要自己来掌控HTML的生成。

方法一：自定义分页驱动（适用于全局样式变更）。

1. 创建一个自定义驱动类，例如 app/commonpaginatorCustom.php：

hasPages()) {
            return sprintf(
                '

                    共 %d 条记录，每页 %d 条，当前第 %d/%d 页。
                    %s %s %s
                
',
                $this->total,
                $this->listRows(),
                $this->currentPage(),
                $this->lastPage(),
                $this->getPreviousButton('上一页'),
                $this->getLinks(),
                $this->getNextButton('下一页')
            );
        }
        return '';
    }

    // 自定义页码按钮链接
    protected function getLinks() {
        $html = '';
        for ($i = 1; $i lastPage; $i++) {
            if ($i == $this->currentPage()) {
                $html .= "{$i} ";
            } else {
                $html .= "url($i)}'>{$i} ";
            }
        }
        return $html;
    }

    // 生成URL，这里简单处理，实际应用需考虑查询参数
    protected function url($page) {
        return "?page=" . $page;
    }
}

2. 在配置文件 config/paginate.php 中指定驱动：

return [
    'type' => 'appcommonpaginatorCustom', // 指定自定义驱动
    'var_page' => 'page',
];

方法二：在模板中手动构建分页HTML（更灵活，推荐）。

我更常用这种方法，因为可以针对不同页面做细微调整。将分页对象 $list 赋值到模板后，在模板文件（如 view/user/index.html）中：

{/* 假设你使用的是ThinkPHP内置模板引擎 */}

    {* 上一页 *}
    {if $list->currentPage() > 1}
        url($list->currentPage() - 1)}" class="layui-laypage-prev">上一页
    {/if}

    {* 页码 *}
    {for start="1" end="$list->lastPage()" name="i"}
        {if $i == $list->currentPage()}
            {$i}
        {else}
            url($i)}">{$i}
        {/if}
    {/for}

    {* 下一页 *}
    {if $list->currentPage() lastPage()}
        url($list->currentPage() + 1)}" class="layui-laypage-next">下一页
    {/if}

    共 {$list->total()} 条

核心技巧：$list->url($page) 方法会根据你的配置（如 var_page）和当前URL参数，智能生成指定页码的完整URL，这是保持分页链接正确的关键，比自己拼接URL要可靠得多。

四、性能优化与常见问题排查

1. 大数据量分页优化：当 total() 超过百万时，SELECT COUNT(*) 会变慢。可以考虑：
- 使用 paginate($listRows, false, ['page' => $page]) 传入一个简单的总记录数（如从缓存或估算获得）。
- 或者使用游标、子查询优化等高级SQL技巧。ThinkPHP的 paginate() 方法支持第二个参数 $simple，设置为 true 可实现“简单模式”，但样式和功能会受限。

2. 分页URL参数丢失：这是最常见的问题。确保在调用 paginate() 时，通过 query 选项传递当前请求参数：

->paginate(15, false, [
    'query' => request()->param(),
    'page' => input('page/d', 1)
]);

3. 样式不生效：检查自定义驱动类是否正确继承和命名，配置文件是否生效。更稳妥的方式是直接在控制器中动态指定：

$list = Db::name('user')->paginate(15, false, [
    'type' => appcommonpaginatorCustom::class,
]);

总结一下，ThinkPHP的分页功能就像一把瑞士军刀，基础功能顺手，但深挖下去也能满足各种定制化需求。关键在于理解其数据封装原理（那个分页对象），然后根据场景选择最合适的扩展方式——是封装API数据结构，还是彻底重写前端样式。希望这篇教程能帮你把分页功能用得更加得心应手。