PHP：将行式数据库结果转换为列式HTML表格的教程

本教程详细介绍了如何使用php将传统的行式数据库查询结果转换为列式（或称透视）html表格。文章通过两阶段方法——数据重组和表格渲染——解决将多条记录归类到同一列并按行展示的需求，确保输出结构清晰、易于理解，并包含示例代码和注意事项。

在Web开发中，我们经常从数据库获取数据，这些数据通常以行式（每条记录一行）呈现。然而，有时业务需求要求我们将这些行式数据转换成一种列式或“透视”的视图，例如，将不同的学期（Term）作为列标题，而将每个学期下的课程（Course）作为行内容。本教程将指导您如何使用PHP实现这种数据转换和HTML表格渲染。

问题场景

假设我们从MySQL数据库获取的数据结构如下：

我们希望将其转换为以下HTML表格形式：

这要求我们将相同Term下的Course和ASSESSED值聚合到同一列，并根据每个Term下课程的数量动态生成行。

立即学习“PHP免费学习笔记（深入）”；

解决方案概述

解决此问题的核心在于两步：

1. 数据重组（Grouping）：将原始的扁平化数据结构转换为一个按Term分组的二维数组。
2. HTML表格渲染（Pivoting）：遍历重组后的数据，动态生成HTML表格的头部和主体，确保课程按列对齐。

1. 数据重组：按学期分组课程

首先，我们需要将从数据库获取的原始数据（假设存储在一个名为$initialData的数组中）进行重组。这个重组过程会将所有属于同一个Term的课程及其评估信息收集到一个子数组中。

原始数据示例（PHP数组形式）：

$initialData = [
    ['term' => 1, 'course' => 'SCIENCE-100', 'assessed' => ''],
    ['term' => 1, 'course' => 'STEM-200', 'assessed' => 'BC'],
    ['term' => 2, 'course' => 'ASP-400', 'assessed' => 'AB'],
    ['term' => 3, 'course' => 'LEV-100', 'assessed' => 'CD'],
    ['term' => 3, 'course' => 'WEL-200', 'assessed' => 'AB'],
];

数据重组代码：

INFINITE ALBUM

面向游戏玩家的生成式AI音乐

下载

$groupedByTerm = [];
foreach ($initialData as $item) {
    $term = $item['term'];
    $course = $item['course'];
    $assessed = $item['assessed'];

    // 如果该学期尚未存在于分组数组中，则初始化一个空数组
    if (!isset($groupedByTerm[$term])) {
        $groupedByTerm[$term] = [];
    }
    // 将课程和评估信息添加到对应学期的数组中
    $groupedByTerm[$term][] = ['course' => $course, 'assessed' => $assessed];
}

重组后的数据结构示例：

/*
$groupedByTerm 数组的结构将类似于：
[
    1 => [
        ['course' => 'SCIENCE-100', 'assessed' => ''],
        ['course' => 'STEM-200', 'assessed' => 'BC']
    ],
    2 => [
        ['course' => 'ASP-400', 'assessed' => 'AB']
    ],
    3 => [
        ['course' => 'LEV-100', 'assessed' => 'CD'],
        ['course' => 'WEL-200', 'assessed' => 'AB']
    ],
]
*/

这个$groupedByTerm数组现在以Term作为主键，每个键对应一个包含该学期所有课程详情的数组。

2. HTML表格渲染：动态生成透视表

有了重组后的数据，我们现在可以开始构建HTML表格。这包括生成表头（包含Term）和表体（包含Course及其详情）。

完整HTML表格生成代码：

echo '<table class="s-table">';

// 获取所有学期并排序，用于生成表头和确保列顺序
$allTerms = array_keys($groupedByTerm);
sort($allTerms); // 确保学期按数字顺序排列

// 生成表头
echo '<thead><tr><th>Term</th>';
foreach ($allTerms as $term) {
    echo '<th>' . htmlspecialchars($term) . '</th>';
}
echo '</tr></thead>';

// 生成表体
echo '<tbody>';
$row = 0; // 用于跟踪当前正在处理的是每个学期中的第几门课程
do {
    $hasData = false; // 标记当前行是否还有数据需要显示
    echo '<tr>';

    // 第一列：第一行显示“Course”，后续行留空
    if ($row == 0) {
        echo '<td>Course</td>';
    } else {
        echo '<td></td>';
    }

    // 遍历所有学期，填充当前行的课程数据
    foreach ($allTerms as $term) {
        echo '<td>';
        // 检查当前学期是否存在第 $row 个课程
        if (isset($groupedByTerm[$term][$row])) {
            $hasData = true; // 发现数据，表示需要继续生成下一行
            $courseData = $groupedByTerm[$term][$row];
            echo htmlspecialchars($courseData['course']);
            // 如果存在评估值，则追加显示
            if (!empty($courseData['assessed'])) {
                echo ' (' . htmlspecialchars($courseData['assessed']) . ')';
            }
        }
        echo '</td>';
    }
    echo '</tr>';
    $row++; // 移动到下一个课程索引

} while ($hasData); // 只要前一行有数据，就继续生成下一行
echo '</tbody>';
echo '</table>';

代码解析：

1. 表头生成：

   • $allTerms = array_keys($groupedByTerm); 提取所有唯一的学期编号。
   • sort($allTerms); 对学期编号进行排序，以确保表格列的顺序是正确的（例如，1, 2, 3 而不是 1, 3, 2）。
   • 然后，一个foreach循环用于为每个学期生成一个标签。

   • 表体生成：

     • 使用do-while循环来动态生成行。这个循环的关键在于$hasData变量。
     • $row变量跟踪我们正在处理的是每个Term下的第几个课程（例如，第一个课程、第二个课程等）。
     • 循环内部，首先为当前行生成第一个（在第一行显示“Course”，其他行留空）。
     • 接着，foreach ($allTerms as $term)循环遍历所有学期，为每个学期生成一个。
     • isset($groupedByTerm[$term][$row])检查当前学期是否存在对应$row索引的课程。
       • 如果存在，则$hasData设为true，并输出课程名称和评估值（如果存在）。
       • 如果不存在，则该将为空。
       • $row++在每次循环结束时递增，以便在下一行处理每个学期的下一个课程。
       • while ($hasData)条件确保循环会一直执行，直到所有学期的所有课程都已显示完毕（即有一整行没有任何数据）。

       注意事项与优化

       • 数据安全：在输出任何用户提供或数据库中的数据到HTML时，始终使用htmlspecialchars()函数来防止跨站脚本（XSS）攻击。
       • 性能考量：对于非常大的数据集，一次性将所有数据加载到内存中进行重组可能会消耗大量资源。在这种情况下，可以考虑在SQL查询阶段进行部分聚合，或者采用分页加载。
       • 样式：本教程只关注数据结构和渲染逻辑，表格样式（如class="s-table"）需要通过CSS来定义。
       • 可读性：如果表格的列数（即学期数）非常多，这种横向扩展的表格可能在小屏幕上难以阅读。可以考虑响应式设计或替代的展示方式。
       • 替代渲染方式：直接使用echo语句生成HTML字符串是一种简单的方法。在更复杂的应用中，您可能会使用模板引擎（如Twig、Blade）或输出缓冲（ob_start()）来更好地组织和管理HTML输出。

       总结

       通过将原始的行式数据库结果首先重组为按关键字段（如Term）分组的二维数组，然后利用do-while循环和适当的条件判断，我们可以有效地将数据透视并渲染成列式HTML表格。这种方法提供了一个灵活且强大的解决方案，以满足特定的数据展示需求，同时保持代码的清晰和可维护性。