ThinkPHP6实现用户列表分页功能教程

花开有时

发布时间：2026-10-13 | 6人浏览过

原创

本文详解在ThinkPHP6框架中实现用户列表分页的步骤，涵盖从创建数据表、配置User模型到编写控制器paginate逻辑及视图渲染的全过程。通过实例代码展示如何高效处理大量数据并提供友好的页码导航。

结果与目标

在Web开发中，面对海量数据时，直接加载全部内容会导致页面响应迟缓且体验极差。引入分页机制将数据集拆分为多个较小的页面块，能显著优化性能和用户阅读体验。本文将基于ThinkPHP6框架，完整演示如何构建一个具备后台查询与前端页码切换功能的用户列表页面。

准备条件

操作开始前，需确保本地环境已安装 PHP、Composer以及 MySQL 数据库。同时需要初始化一个可用的 ThinkPHP6 项目目录。

启动服务与创建数据库：打开终端（命令行工具），进入期望的开发者根目录执行 Composer 命令完成项目搭建。

composer create-project topthink/think tp6 --prefer-dist

该指令会在当前文件夹内生成名为 tp6 的全新项目，并自动拉取相关依赖包。

随后登录数据库管理系统（如 MySQL Workbench 或 Navicat）建立一张用于测试的分页源表 users。表结构可简化为自增主键及基础字段。

CREATE TABLE `users` (
  `id` INT(11) PRIMARY KEY AUTO_INCREMENT,
  `name` VARCHAR(255),
  `age` INT(11)
);

INSERT INTO `users` (`name`, `age`) VALUES 
('Tom', 20), ('Jerry', 25), ('Alice', 30), 
('Bob', 35), ('Eve', 40);

注意填充足够多的测试数据，否则可能无法直观观察到翻页带来的视觉差异。

真实操作顺序

第1步：定义数据库操作模型

目的：建立 PHP 对象与数据库物理表之间的映射关系，以便后续进行结构化查询。

入口：在项目的 app/model/ 路径下新建类文件 User.php。

动作：继承内置的 Model 基类，并将内部属性指向对应的表名。

<?php
namespace app\model;

use think\Model;

class User extends Model
{
    // 显式绑定对应的数据库表名
    protected $table = 'users';
}

状态确认：该模型现已被全局识别，可通过命名空间 app\model\User 调用原生或扩展方法。

第2步：配置路由访问规则

目的：拦截来自浏览器的特定 URL 请求并转交给对应的业务层代码。

入口：打开项目根目录下的 route/app.php (TP6标准路由配置位置)。

动作：注册 GET 类型的静态路由映射。

use think\facade\Route;

// 当访问 /user 时映射至 User模块中的Index方法
Route::get('user', 'index');

状态确认：保存修改后，任何对 /user 发起的请求均会流转至预设的业务处理流程。

第3步：编写核心控制层逻辑

目的：接收前端参数（如页码偏移量），向数据库发送分页指令并组装输出数据。

入口：创建或编辑 app/controller/Index.php。

动作：利用 Facade 模式获取当前上下文，调用模型的便捷分页函数。

<?php
namespace app\controller;

use app\model\User;

class Index
{
    public function index()
    {
        // 提取请求携带的page参数，若无则默认为1
        $currentPage = request()->param('page', 1);
        // 设定单次切片大小
        $pageSize = 10;

        // TP6特有的链式查询接口
        // false参数表示关闭“简洁模式”，保留完整的上下页信息以供模板渲染
        $userData = User::paginate($pageSize, false, ['query' => request()->param()]);

        return view('index', ['dataList' => $userData]);
    }
}

要点解析：
1. paginate() 是 ORM 层面的封装神技，内部自动计算 LIMIT 和 OFFSET。
2. ['query' => ...] 确保了点击下一页时原有的筛选条件（如有）不丢失。

第4步：构建前端展示界面

目的：将后台传来的数组迭代展现给访客，并附带控制跳转的按钮组件。

入口：位于 view/index/ 目录下添加 index.html。

动作：使用引擎标签展开集合遍历，并在底部插入渲染钩子。

<!DOCTYPE html>
<html lang="zh">
<head>
    <meta charset="UTF-8">
    <title>用户分页展示</title>
</head>
<body>
    <h2>系统人员名录</h2>
    <table border="1">
        <thead>
            <tr><th>ID</th><th>姓名</th><th>年龄</th></tr>
        </thead>
        <tbody>
            {foreach $dataList as $item}
            <tr>
                <td>{$item.id}</td>
                <td>{$item.name}</td>
                <td>{$item.age}</td>
            </tr>
            {/foreach}
        </tbody>
    </table>
    
    <!-- 关键步骤：打印生成的页码链接按钮组 -->
    {$dataList->render()}
</body>
</html>

效果判定：
页面加载完成后应当呈现整齐排列的表格数据，且在下方出现诸如 “上一页 1 2 3 下一页” 的可交互链接。