PHP与MySQL:实现数据库查询结果分页显示详解

本文将详细介绍如何使用php和mysql实现数据库查询结果的分页显示功能。通过计算总记录数、确定每页显示数量以及动态生成sql `limit` 子句,我们将构建一个完整的后端逻辑,并结合html/css创建交互式分页导航。本教程涵盖从数据查询到页面渲染的全过程,旨在帮助开发者高效管理大量数据展示。

在Web开发中,当数据库查询结果集非常庞大时,一次性加载所有数据不仅效率低下,还会严重影响用户体验。因此,实现数据的分页显示成为一项基本且重要的功能。本教程将指导您如何利用PHP和MySQL的强大能力,结合HTML和CSS,构建一个健壮、高效且用户友好的分页系统。

核心概念与原理

数据分页的核心思想是将一个大型结果集分割成多个较小的、可管理的页面。这通常涉及到以下几个关键概念:

  1. 总记录数 (Total Records):数据库中符合查询条件的总条目数。这是计算总页数的基础。
  2. 每页显示数量 (Page Size):每个页面希望显示的数据条目数。
  3. 总页数 (Total Pages):根据总记录数和每页显示数量计算出的总页面数量。
  4. 当前页码 (Current Page):用户当前正在查看的页面编号。
  5. SQL LIMIT 子句:MySQL(以及其他SQL数据库)提供 LIMIT offset, row_count 子句,用于从结果集中跳过 offset 条记录,然后返回 row_count 条记录。这是实现分页查询的关键。

后端数据处理:PHP与MySQL

我们将使用PHP来处理数据库交互和分页逻辑。假设您已经建立了一个名为 $conn 的MySQLi数据库连接。

1. 获取总记录数

首先,我们需要查询数据库中符合条件的总记录数,以便计算出总页数。

query($sql_count);

if ($result_count) {
    $row_count = $result_count->fetch_assoc();
    $total_rows = $row_count['total_rows']; // 数据库中的总记录数
} else {
    $total_rows = 0;
    // 错误处理
    error_log("查询总记录数失败: " . $conn->error);
}
?>

2. 分页参数计算

接下来,根据总记录数和预设的每页显示数量,计算出总页数以及当前页面的偏移量。

 0 ? $total_pages : 1));

// 计算 SQL 查询的起始偏移量
$offset = ($current_page - 1) * $pagesize;

// 如果没有记录,确保 offset 不为负
if ($total_rows == 0) {
    $offset = 0;
}
?>

解释:

  • filter_input(INPUT_GET, 'page', FILTER_SANITIZE_NUMBER_INT) 安全地获取URL中的 page 参数,并将其转换为整数。
  • ?: 1 是PHP 7+ 的 null 合并运算符,如果 page 参数不存在或无效,则默认设置为 1。
  • max(1, min($current_page, $total_pages > 0 ? $total_pages : 1)) 确保 $current_page 始终是一个有效的页码。如果 $total_pages 为 0(即没有记录),则将其限制为 1。
  • $offset 是 LIMIT 子句需要的起始位置,它是基于0的索引。

3. 构建分页查询并获取数据

使用计算出的 $offset 和 $pagesize 来构建带有 LIMIT 子句的SQL查询。为了防止SQL注入,我们强烈建议使用预处理语句。

prepare($sql_data);

if ($stmt) {
    // 绑定参数:'ii' 表示两个参数都是整数
    $stmt->bind_param('ii', $offset, $pagesize);

    // 执行语句
    $stmt->execute();

    // 绑定结果到变量
    $stmt->bind_result($sid, $hunters, $smoker, $boomers, $spitters, $jockeys, $charger, $total_kills);

    $output_table = '
    ';

    // 遍历结果集并生成表格行
    while ($stmt->fetch()) {
        $output_table .= sprintf('
        ', 
        htmlspecialchars($sid), 
        htmlspecialchars($total_kills), 
        htmlspecialchars($hunters), 
        htmlspecialchars($jockeys), 
        htmlspecialchars($charger), 
        htmlspecialchars($smoker), 
        htmlspecialchars($boomers), 
        htmlspecialchars($spitters)
        );
    }
    $output_table .= '
Player Total Kills Hunter Jockey Charger Smoker Boomer Spitter
%s %s %s %s %s %s %s %s
'; $stmt->close(); // 关闭语句 } else { $output_table = "

数据查询失败: " . $conn->error . "

"; error_log("准备SQL语句失败: " . $conn->error); } ?>

解释:

  • LIMIT ?, ? 使用问号作为占位符,分别对应 offset 和 pagesize。
  • $conn->prepare($sql_data) 创建一个预处理语句对象。
  • $stmt->bind_param('ii', $offset, $pagesize) 将变量绑定到占位符。'ii' 指定了两个参数都是整数类型。
  • $stmt->execute() 执行查询。
  • $stmt->bind_result(...) 将查询结果的每一列绑定到指定的PHP变量。
  • while ($stmt->fetch()) 循环遍历结果集,每次迭代都会将当前行的数据填充到绑定的变量中。
  • htmlspecialchars() 用于防止XSS攻击,确保输出到HTML的内容是安全的。

前端页面渲染与分页导航

现在,我们已经获取了当前页的数据,并将其格式化为HTML表格。接下来,我们需要创建分页导航链接,让用户可以在不同页面之间切换。


    
        ';

// "首页" 和 "上一页" 链接
$first_link = ($current_page > 1) ? '首页' : '首页';
$prev_page = max(1, $current_page - 1);
$prev_link = ($current_page > 1) ? sprintf('上一页', $prev_page) : '上一页';

$footer_pagination .= sprintf('%s | %s', $first_link, $prev_link);

// 数字页码链接
for ($i = 1; $i <= $total_pages; $i++) {
    $active_class = ($current_page == $i) ? ' active' : '';
    $footer_pagination .= sprintf(' %1$d ', $i, $active_class);
}

// "下一页" 和 "末页" 链接
$next_page = min($total_pages, $current_page + 1);
$next_link = ($current_page < $total_pages) ? sprintf('下一页', $next_page) : '下一页';
$last_link = ($current_page < $total_pages) ? sprintf('末页', $total_pages) : '末页';

$footer_pagination .= sprintf(' | %s | %s', $next_link, $last_link);


$footer_pagination .= '
        
    
    
        

Website built & designed by Blade

'; // 渲染所有内容 echo $output_table; echo $footer_pagination; $conn->close(); // 关闭数据库连接 ?>

解释:

  • 我们动态生成 "首页"、"上一页"、"下一页" 和 "末页" 链接。如果当前页是第一页,"首页"和"上一页"会显示为不可点击的文本(或带有禁用样式)。同理,末页也是如此。
  • 数字页码循环从1到 $total_pages。当前页码的链接会添加 active 类,以便通过CSS进行样式高亮。
  • 所有链接都使用 ?page=X 的URL格式来传递页码参数。

完整示例代码

将上述所有代码片段组合起来,形成一个完整的 index.php 文件(或其他您希望的文件名)。

connect_error) {
    die("连接失败: " . $conn->connect_error);
}

// 1. 获取总记录数
$sql_count = "SELECT COUNT(*) AS total_rows FROM Special_Infected_Kills";
$result_count = $conn->query($sql_count);

if ($result_count) {
    $row_count = $result_count->fetch_assoc();
    $total_rows = $row_count['total_rows'];
} else {
    $total_rows = 0;
    error_log("查询总记录数失败: " . $conn->error);
}

// 2. 分页参数计算
$pagesize = 20; // 每页显示20条记录

// 计算总页数,如果没有记录,至少有一页
$total_pages = ceil($total_rows / $pagesize);
if ($total_rows == 0) {
    $total_pages = 1; // 至少显示一页,即使没有数据
}

// 获取当前页码,默认为第一页
$current_page = filter_input(INPUT_GET, 'page', FILTER_SANITIZE_NUMBER_INT) ?: 1;

// 确保当前页码在有效范围内
$current_page = max(1, min($current_page, $total_pages));

// 计算 SQL 查询的起始偏移量
$offset = ($current_page - 1) * $pagesize;

// 3. 构建分页查询并获取数据
$sql_data = "SELECT 
                STEAM_ID, Hunters, Smoker, Boomers, Spitters, Jockeys, Charger,
                (Hunters + Smoker + Boomers + Spitters + Jockeys + Charger) AS Total_Kills
             FROM Special_Infected_Kills 
             ORDER BY Total_Kills DESC
             LIMIT ?, ?";

$stmt = $conn->prepare($sql_data);
$output_table = '';

if ($stmt) {
    $stmt->bind_param('ii', $offset, $pagesize);
    $stmt->execute();
    $stmt->bind_result($sid, $hunters, $smoker, $boomers, $spitters, $jockeys, $charger, $total_kills);

    $output_table = '
    ';

    while ($stmt->fetch()) {
        $output_table .= sprintf('
        ', 
        htmlspecialchars($sid), 
        htmlspecialchars($total_kills), 
        htmlspecialchars($hunters), 
        htmlspecialchars($jockeys), 
        htmlspecialchars($charger), 
        htmlspecialchars($smoker), 
        htmlspecialchars($boomers), 
        htmlspecialchars($spitters)
        );
    }
    $output_table .= '
Player Total Kills Hunter Jockey Charger Smoker Boomer Spitter
%s %s %s %s %s %s %s %s
'; $stmt->close(); } else { $output