thinkphp通过paginator类实现分页，使用paginate方法处理查询结果并支持自定义参数如每页数量、当前页码和url参数，示例中user模型按状态筛选后分页输出；可通过配置文件或继承paginator类自定义分页样式，结合css框架美化外观，需注意query参数传递以保留搜索条件。
ThinkPHP 是一个广泛使用的 PHP 开发框架，内置了强大的分页功能，能快速实现数据的分页展示。在实际开发中，只需要正确调用分页类并结合查询结果即可完成分页输出。同时，ThinkPHP 允许开发者自定义分页样式，以满足前端设计需求。
启用分页功能的基本步骤
在 ThinkPHP 中（以 ThinkPHP 6 为例），分页功能主要通过 Paginator 类实现。使用 paginate 方法可以直接对数据库查询结果进行分页处理。
示例如下：
// 控制器中
use app\model\User;
public function index()
{
$list = User::where('status', 1)->paginate([
'list_rows' => 10, // 每页显示数量
'page' => input('page', 1), // 当前页码
'query' => request()->param() // 保留URL参数
]);
return view('index', ['users' => $list]);
}
上述代码会自动计算总页数、当前页数据，并生成分页导航链接。模板中通过 {$users|raw} 输出分页 HTML。
立即学习“PHP免费学习笔记（深入）”；
配置分页参数与自定义选项
ThinkPHP 的 paginate 方法支持多种配置项，可以灵活调整分页行为。
- list_rows：每页显示记录数，默认为 15
- page：当前页码，可从请求中获取
- query：附加到分页链接的参数，如搜索条件
- var_page：分页参数名，默认为 'page'
- path：分页链接路径，可用于设置伪静态路径
例如：
User::paginate([
'list_rows' => 8,
'page' => input('page'),
'query' => ['keyword' => 'thinkphp'],
'path' => '/user/list'
]);
自定义分页样式与模板
默认分页样式可能不符合项目 UI 风格，ThinkPHP 支持通过继承 Paginator 类或配置模板来自定义外观。
方式一：使用系统提供的简单方法修改外观
可在配置文件 config/paginator.php 中设置：
return [
'type' => 'bootstrap', // 可替换为自定义类
'var_page' => 'page',
'path' => false,
'fragment' => '',
];
方式二：完全自定义分页 HTML
创建自定义分页类，继承 \think\Paginator：
namespace app\pagination;
use think\Paginator;
class MyPage extends Paginator
{
public function render()
{
if ($this->hasPages()) {
$html = '<div class="custom-pagination">';
$html .= $this->previous('«');
$html .= $this->getLinks();
$html .= $this->next('»');
$html .= '</div>';
return $html;
}
return '';
}
protected function getLinks()
{
$html = '';
foreach ($this->getUrlRange(1, $this->lastPage()) as $page => $url) {
$html .= $this->getPageLinkWrapper($url, $page);
}
return $html;
}
}
然后在调用时指定使用该类：
User::paginate(10, false, ['page' => input('page'), 'type' => 'app\pagination\MyPage']);
前端样式整合建议
为了使分页更美观，可结合 CSS 框架如 Bootstrap 或 Element Plus 进行样式美化。
例如添加如下 CSS：
.custom-pagination {
margin: 20px 0;
text-align: center;
}
.custom-pagination a, .custom-pagination span {
display: inline-block;
padding: 5px 10px;
margin: 0 3px;
border: 1px solid #ddd;
color: #007bff;
}
.custom-pagination .active {
background: #007bff;
color: white;
}
确保分页输出时保留必要的 class 名称，或在自定义类中加入 active 判断逻辑。
基本上就这些。ThinkPHP 的分页机制简洁高效，配合自定义类和样式，可以轻松实现符合项目需求的分页效果。不复杂但容易忽略的是 query 参数传递和路径配置，记得测试翻页时是否保留搜索条件。
