ThinkPHP统计排行与分页显示功能示例

何川

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

原创

本文介绍了利用ThinkPHP内置机制实现复杂数据统计与分页展示的方法。内容涵盖参数设置、子查询处理、排名生成逻辑及前端视图渲染，为开发者提供清晰的实现参考。

结果与目标

本方案旨在解决以下需求：

动态统计：根据特定条件（如时间范围）统计关联数据的数量。
实时排名：对统计数据按数量降序排列并生成排名字段。
分页展示：将庞大排名列表进行分页处理，并在页面上直观呈现名次、名称及数值。

准备条件

第1步：理解分页参数

ThinkPHP的分页功能依赖于几个核心参数的配合，正确理解它们是构建稳定分页的前提：

count：总记录数，用于计算总页数。
firstRow：当前页的起始行索引。
listRows：每页显示的记录条数。
list：最终输出的当前页数据集合，需确保其总数与分页逻辑匹配。

第2步：明确操作入口

主要涉及后台控制器的数据处理逻辑与前端视图的模板解析。入口通常为控制器中的排行列表方法，负责接收用户传入的类型参数（如月排行或总排行），并返回相应的HTML响应。

真实操作顺序

第1步：设置查询环境与初始化变量

首先确定分类类型，并针对不同的排行周期（如上月）动态调整时间范围。对于非月度排行的情况，通常作为全量统计处理。随后，初始化用户状态表与业务表的连接条件，并清空旧的排名计数缓存。

// 初始化基础参数
$type = $this->_get('type', 'trim');
$opener_id = $this->opener_id; // 假设这是登录用户的ID

// 处理日期过滤
if($type == 0){ // 上月排行
    $arrLastMonth = $this->getLastMonthStartEndDay();
    $lastStartDay = $arrLastMonth['lastStartDay'];
    $lastEndDay = $arrLastMonth['lastEndDay'] . ' 23:59:59'; 
    $b_time = strtotime($lastStartDay);
    $e_time = strtotime($lastEndDay);
    $where['b.addtime'] = array(array('gt',$b_time),array('lt',$e_time),'and'); 
} else {
    $where = []; // 总排行无时间限制
}

// 通用状态过滤
$where['a.status'] = array('eq','1');

// 重置用户变量以用于子查询排名
M()->query('SET @rank = 0;');

第2步：构建子查询获取完整排名

由于SQL的LIMIT子句在聚合和排序之后执行，为了在分页前获得完整的排名序号，需要使用一个嵌套的子查询。先查出符合统计条件的全部数据及其基数，再在外层查询中利用用户变量(@rank)递增生成排名。

// 内部子查询：统计每个用户的有效数据量
$subQuery = M()->table('sh_opener a')->join('sh_user b on a.id = b.opener_id')->where($where)->group('a.id')->order('usercount desc')->field('a.id,count(b.id) as usercount,a.name')->select(false);

// 外层查询：基于子查询生成排名字段
$all = M()->table('' . $subQuery . ' a')->getField('a.id, a.usercount, a.name, (@rank := IFNULL(@rank, 0) + 1) as rank');
$count = count($all); // 获取总条目数

此时，$all数组包含了所有符合条件的记录以及它们的绝对排名。这对于后续定位“我的排名”非常关键。

第3步：配置分页实例并截取当前页数据

使用ThinkPHP内置的Page类管理分页参数，并将分页逻辑应用到最终的查询中，仅取当前页所需的数据片段以减少内存消耗。

// 实例化分页对象，每页10条
$Page = new Page($count, 10);

// 重新查询当前页数据（注意加上limit）
$list = M()->table('sh_opener a')->join('sh_user b on a.id = b.opener_id')->where($where)->group('a.id')->order('usercount desc')->limit($Page->firstRow . ',' . $Page->listRows)->field('count(b.id) as usercount, a.name, a.id')->select();

// 手动补全当前页数据的排名，因为直接从数据库limit拿到的数据没有rank字段
foreach ($list as $k => $v) {
    $list[$k]['rank'] = $k + 1 + $Page->firstRow;
}

第4步：渲染当前用户信息

在前端通常需要特别突出当前登录用户的个人成绩。直接在全量的$all数据集中查找当前用户的ID即可。

$my_user_count = isset($all[$opener_id]) ? $all[$opener_id]['usercount'] : 0;
$my_rank = isset($all[$opener_id]) && $all[$opener_id]['rank'] ? $all[$opener_id]['rank'] : '-';

$this->assign('my_user_count', $my_user_count);
$this->assign('my_rank', $my_rank);
$this->assign('page', $Page->show());
$this->assign('list', $list);
$this->display();

完成判断

第1步：核对页面输出结构

视图文件（View）负责将Controller传递的数据渲染为直观的表格。以下为标准的HTML布局逻辑：

顶部导航：切换月排行/总排行的Tab。
个人状态栏：展示当前用户的商户数和当前所在排名。
排行列表：循环输出每一行的名次、名称和数值，前三名可添加特殊图标样式。
底部分页：渲染上一页、下一页及页码跳转链接。

第2步：检查辅助函数

确保辅助方法getLastMonthStartEndDay能正确计算出上个月的起止日期，特别是处理跨年（1月回滚到12月）的情况，以保证时间条件查询的准确性。

private function getLastMonthStartEndDay(){
    $thismonth = date('m');
    $thisyear = date('Y');
    if ($thismonth == 1) {
        $lastmonth = 12;
        $lastyear = $thisyear - 1;
    } else {
        $lastmonth = $thismonth - 1;
        $lastyear = $thisyear;
    }
    $lastStartDay = $lastyear . '-' . $lastmonth . '-1';
    $lastEndDay = $lastyear . '-' . $lastmonth . '-' . date('t', strtotime($lastStartDay));
    return array('lastStartDay' => $lastStartDay, 'lastEndDay' => $lastEndDay);
}