PHP数据重构与HTML表格分组显示教程-php教程-PHP中文网

PHP数据重构与HTML表格分组显示教程

DDD

发布： 2025-07-13 22:24:02

原创

542人浏览过

PHP数据重构与HTML表格分组显示教程

本教程旨在解决PHP数组数据在HTML表格中按特定字段（如用户和日期）进行分组显示的需求。通过介绍一种数据预处理方法，将原始扁平数组重构为层级结构，然后利用重构后的数据高效地生成HTML表格，实现同一用户和日期下的多个相关记录在单个表格单元格内聚合展示，从而优化数据呈现效果。

挑战：按用户/日期分组显示位置信息

在web开发中，我们经常需要将后端获取的数据以表格形式展示给用户。然而，当数据存在一对多关系时（例如，一个用户在同一天访问了多个地点），直接遍历原始数组可能会导致重复显示关键信息，如用户姓名和日期，使得表格冗余且不易阅读。

考虑以下原始PHP数组结构，其中包含了用户ID、地点ID、姓名、地点和日期信息：

$arr =
   [
      [
         'user_id' => 5,
         'l_id' => 10,
         'Name' => 'John Doe',
         'Location' => 'Chicago',
         'date' => '2021-10-02'
      ],
      [
         'user_id' => 5,
         'l_id' => 11,
         'Name' => 'John Doe',
         'Location' => 'Houston',
         'date' => '2021-10-02'
      ],
      [
         'user_id' => 6,
         'l_id' => 12,
         'Name' => 'Rob Doe',
         'Location' => 'Dallas',
         'date' => '2021-10-02'
      ],
      [
         'user_id' => 6,
         'l_id' => 13,
         'Name' => 'Rob Doe',
         'Location' => 'Philadelphia',
         'date' => '2021-10-02'
      ],
   ];

登录后复制

如果直接使用简单的循环生成HTML表格，结果会是：

Name	Date	Location
John Doe	2021-10-02	Chicago
John Doe	2021-10-02	Houston
Rob Doe	2021-10-02	Dallas
Rob Doe	2021-10-02	Philadelphia

这与我们期望的输出不同。我们希望将同一用户在同一天的所有地点信息聚合到一个单元格中，使表格更加紧凑和直观：

Name	Date	Location
John Doe	2021-10-02	Chicago Houston
Rob Doe	2021-10-02	Dallas Philadelphia

解决方案：数据重构与HTML渲染

要实现上述目标，核心思想是先对原始数据进行重构，将其转换为更适合分组展示的层级结构，然后再根据新结构生成HTML。

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

步骤一：重构原始数据

我们需要一个函数来遍历原始数组，并根据user_id进行分组。对于每个用户，我们将收集其所有的地点信息到一个子数组中。

/**
 * 将扁平的用户位置数组重构为按用户分组的层级数组。
 *
 * @param array $oldArray 原始的用户位置数据数组。
 * @return array 重构后的数组，以user_id为键，每个元素包含用户信息及所有相关位置。
 */
function arrayChanger(array $oldArray): array
{
    $newArray = [];
    foreach ($oldArray as $record) {
        // 如果该user_id尚未在newArray中，则初始化其结构
        if (!isset($newArray[$record['user_id']])) {
            $newArray[$record['user_id']] = [
                'user_id' => $record['user_id'],
                'Name' => $record['Name'],
                'date' => $record['date'],
                'UserLocations' => [] // 用于存储该用户的所有位置信息
            ];
        }
        // 将当前记录的位置信息添加到对应用户的UserLocations数组中
        $newArray[$record['user_id']]['UserLocations'][] = [
            'Location' => $record['Location'],
        ];
    }
    return $newArray;
}

登录后复制

函数说明：

arrayChanger 函数接收原始的 $arr 数组作为输入。
它遍历 $oldArray 中的每一条记录。
使用 user_id 作为新数组 $newArray 的主键。这样，所有属于同一个 user_id 的记录都会被归集到同一个父级元素下。
每个父级元素会包含 user_id、Name、date 等共享信息，以及一个名为 UserLocations 的子数组，该子数组专门用来存放该用户的所有 Location 信息。

经过 arrayChanger($arr) 处理后，我们的数据结构将大致变为：

芦笋演示

一键出成片的录屏演示软件，专为制作产品演示、教学课程和使用教程而设计。

查看详情

[
    5 => [
        'user_id' => 5,
        'Name' => 'John Doe',
        'date' => '2021-10-02',
        'UserLocations' => [
            ['Location' => 'Chicago'],
            ['Location' => 'Houston']
        ]
    ],
    6 => [
        'user_id' => 6,
        'Name' => 'Rob Doe',
        'date' => '2021-10-02',
        'UserLocations' => [
            ['Location' => 'Dallas'],
            ['Location' => 'Philadelphia']
        ]
    ]
]

登录后复制

这种结构使得我们可以在外层循环中一次性获取用户姓名和日期，然后在内层循环中遍历并聚合其所有位置信息。

步骤二：生成HTML表格

有了重构后的数据，生成符合要求的HTML表格就变得简单了。我们只需要遍历重构后的数组，对于每个用户记录，生成一行 <tr>。在该行中，用户姓名和日期各占一个 <td>，而所有位置信息则通过内循环拼接，并用 换行符分隔，放入同一个“Location” <td> 中。

// 假设 $arr 是上面定义的原始数组
$processedData = arrayChanger($arr);

$html = '<table>
    <thead>
        <tr>
            <th>Name</th>
            <th>Date</th>
            <th>Location</th>
        </tr>
    </thead>
<tbody>';

foreach ($processedData as $userRecord) {
    $html .= '<tr>';
    $html .= '<td>' . htmlspecialchars($userRecord['Name']) . '</td>';
    $html .= '<td>' . htmlspecialchars($userRecord['date']) . '</td>';
    $html .= '<td>';

    // 遍历该用户的所有位置信息，并用 <br> 连接
    foreach ($userRecord['UserLocations'] as $locationItem) {
        $html .= htmlspecialchars($locationItem['Location']) . "<br>";
    }
    // 移除最后一个 <br>，避免多余的换行
    $html = rtrim($html, '<br>');

    $html .= '</td>';
    $html .= '</tr>';
}

$html .= '</tbody>
</table>';

echo $html;

登录后复制

代码说明：

外层 foreach 循环遍历 arrayChanger 返回的 $processedData，每次迭代处理一个用户的所有聚合信息。
对于每个用户记录，直接输出其 Name 和 date。
对于 Location 列，使用一个内层 foreach 循环遍历 UserLocations 数组。
每个 Location 值后添加 标签，使其在HTML中换行显示。
使用 rtrim($html, ' ') 移除最后一个位置信息后面多余的 标签，确保格式整洁。
使用 htmlspecialchars() 对输出内容进行转义，防止XSS攻击，这是良好的安全实践。

完整示例代码

将上述数据定义、数据重构函数和HTML生成逻辑整合在一起，即可得到完整的解决方案：

<?php

$arr =
   [
      [
         'user_id' => 5,
         'l_id' => 10,
         'Name' => 'John Doe',
         'Location' => 'Chicago',
         'date' => '2021-10-02'
      ],
      [
         'user_id' => 5,
         'l_id' => 11,
         'Name' => 'John Doe',
         'Location' => 'Houston',
         'date' => '2021-10-02'
      ],
      [
         'user_id' => 6,
         'l_id' => 12,
         'Name' => 'Rob Doe',
         'Location' => 'Dallas',
         'date' => '2021-10-02'
      ],
      [
         'user_id' => 6,
         'l_id' => 13,
         'Name' => 'Rob Doe',
         'Location' => 'Philadelphia',
         'date' => '2021-10-02'
      ],
   ];

/**
 * 将扁平的用户位置数组重构为按用户分组的层级数组。
 *
 * @param array $oldArray 原始的用户位置数据数组。
 * @return array 重构后的数组，以user_id为键，每个元素包含用户信息及所有相关位置。
 */
function arrayChanger(array $oldArray): array
{
    $newArray = [];
    foreach ($oldArray as $record) {
        if (!isset($newArray[$record['user_id']])) {
            $newArray[$record['user_id']] = [
                'user_id' => $record['user_id'],
                'Name' => $record['Name'],
                'date' => $record['date'],
                'UserLocations' => []
            ];
        }
        $newArray[$record['user_id']]['UserLocations'][] = [
            'Location' => $record['Location'],
        ];
    }
    return $newArray;
}

$processedData = arrayChanger($arr);

$html = '<table>
    <thead>
        <tr>
            <th>Name</th>
            <th>Date</th>
            <th>Location</th>
        </tr>
    </thead>
<tbody>';

foreach ($processedData as $userRecord) {
    $html .= '<tr>';
    $html .= '<td>' . htmlspecialchars($userRecord['Name']) . '</td>';
    $html .= '<td>' . htmlspecialchars($userRecord['date']) . '</td>';
    $html .= '<td>';

    // 收集所有位置到一个临时数组，然后用 implode 连接
    $locations = [];
    foreach ($userRecord['UserLocations'] as $locationItem) {
        $locations[] = htmlspecialchars($locationItem['Location']);
    }
    $html .= implode('<br>', $locations);

    $html .= '</td>';
    $html .= '</tr>';
}

$html .= '</tbody>
</table>';

echo $html;

?>

登录后复制

运行上述代码，将生成如下HTML结构，并在浏览器中呈现出我们期望的表格样式：

<table>
    <thead>
        <tr>
            <th>Name</th>
            <th>Date</th>
            <th>Location</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>John Doe</td>
            <td>2021-10-02</td>
            <td>Chicago<br>Houston</td>
        </tr>
        <tr>
            <td>Rob Doe</td>
            <td>2021-10-02</td>
            <td>Dallas<br>Philadelphia</td>
        </tr>
    </tbody>
</table>

登录后复制

注意事项与最佳实践

数据预处理的重要性：在复杂的数据展示场景中，提前对数据进行重构和聚合是至关重要的。这不仅简化了视图层的逻辑，也提高了代码的可读性和可维护性。
关注点分离：将数据处理逻辑（arrayChanger函数）与视图渲染逻辑（HTML生成）分离，遵循MVC（Model-View-Controller）或类似的设计模式，使得代码结构更加清晰。
安全性：在将用户输入或数据库检索到的数据输出到HTML时，务必使用 htmlspecialchars() 或其他适当的转义函数，以防止跨站脚本（XSS）攻击。
性能考虑：对于非常大的数据集，数据重构可能会消耗一定的内存和CPU。在极端情况下，可能需要考虑分批处理或数据库层面的聚合优化。
替代方案：
- CSS控制：对于某些简单的分组，可以通过CSS样式（如 display: inline-block 或 Flexbox/Grid）来控制单元格内内容的布局，但对于需要明确换行的情况， 标签通常更直接。
- 前端渲染：在现代Web应用中，数据通常以JSON格式发送到前端，然后由JavaScript框架（如React, Vue, Angular）进行渲染。这种情况下，数据重构可以在后端完成，也可以在前端完成，具体取决于应用架构。