当前位置：首页 > 文章列表 > 文章 > php教程 > PHP生成带汇总的HTML表格教程

PHP生成带汇总的HTML表格教程

2025-08-25 17:24:59 0浏览收藏

本教程详细讲解了如何使用PHP从特定格式的文本文件中读取数据，并动态生成带有详细记录和汇总统计的HTML表格。通过文件操作、字符串解析，以及对姓名、薪资、城市、年龄等数据的聚合，计算唯一姓名数量、总薪资、最常见城市和平均年龄等统计信息。教程涵盖`fopen()`、`fgets()`、`explode()`等关键函数的使用，以及`array_unique()`、`array_sum()`、`array_count_values()`等统计函数的应用，旨在为Web开发者提供一个清晰实用的数据展示解决方案，尤其适用于从非数据库数据源中提取数据并进行结构化展示的场景。同时强调了错误处理、数据清洗、HTML转义等最佳实践，确保代码的健壮性和安全性。

PHP从文本文件解析数据并生成带汇总行的HTML表格教程

本教程详细讲解如何使用PHP从特定格式的文本文件中读取、解析数据，并将其动态渲染成一个带有详细记录和底部汇总统计行的HTML表格。内容涵盖文件操作、字符串解析、数据聚合（如计算唯一值、总和、最常见项和平均值）以及HTML表格的构建，旨在提供一个清晰实用的数据展示解决方案。

1. 概述与数据源格式

在Web开发中，经常需要从非数据库的数据源（如文本文件）中读取信息并以结构化的方式展示。本教程将以一个常见的场景为例：从一个包含员工信息的文本文件（name.txt）中读取数据，并将其展示为一个HTML表格。更进一步，我们不仅展示每条详细记录，还将在表格底部添加一行汇总统计数据，包括唯一姓名数量、总薪资、最常见的城市和平均年龄。

我们的数据源文件name.txt中的每一行都遵循key:value,key:value,...的格式，例如：

name:Ivan,Salary:5000,town:Sofia,age:20
name:Pesho,Salary:1500,town:Pleven,age:19
...

2. 数据解析与存储

要实现表格的动态生成和汇总统计，我们需要逐行读取文件，解析每行数据，并将其存储到合适的PHP数组中，以便后续处理。

2.1 文件读取与行解析

使用fopen()打开文件，feof()判断文件是否结束，fgets()逐行读取。对于每一行，我们首先使用explode(',', $string)将其按逗号分割成键值对字符串，然后对每个键值对再使用explode(':', $val)按冒号分割成键和值。为了数据清洗，务必使用trim()去除值两端的空白字符。

2.2 收集数据以供汇总

在遍历文件并输出每行详细数据的同时，我们需要将每条记录中的关键数据（如姓名、薪资、城市、年龄）分别收集到独立的数组中。这是实现汇总统计的关键步骤，因为统计计算需要所有相关数据集合。

<?php

$file = fopen('name.txt', "r"); // 打开数据文件

// 用于存储所有数据的数组，以便后续进行汇总计算
$names = [];
$cities = [];
$salaries = [];
$ages = [];

echo "<table border=\"1px\">"; // 开始HTML表格
echo "<tr>
        <th>Name</th>
        <th>Salary</th>
        <th>Town</th>
        <th>Age</th>
      </tr>"; // 表格头部

while (!feof($file)) { // 循环读取文件直到末尾
    $string = fgets($file); // 读取一行
    if (trim($string) === '') { // 跳过空行
        continue;
    }

    $finalArray = []; // 用于存储当前行解析后的数据

    $asArr = explode(',', $string); // 按逗号分割键值对
    foreach ($asArr as $val) {
        $tmp = explode(':', $val, 2); // 按冒号分割键和值，限制分割次数为2以防值中包含冒号
        if (count($tmp) === 2) {
            $key = trim($tmp[0]);
            $value = trim($tmp[1]);
            $finalArray[$key] = $value;
        }
    }

    // 确保所有预期字段都存在，并获取其值
    // 使用 null coalescing operator (??) 确保即使字段缺失也不会报错
    $name = $finalArray['name'] ?? '';
    $salary = (int)($finalArray['Salary'] ?? 0); // 薪资转换为整数
    $city = $finalArray['town'] ?? '';
    $age = (int)($finalArray['age'] ?? 0); // 年龄转换为整数

    // 将当前行的数据添加到各自的收集数组中
    $names[] = $name;
    $salaries[] = $salary;
    $cities[] = $city;
    $ages[] = $age;

    // 输出当前行的详细数据到表格
    echo '<tr>';
    echo '<td>' . htmlspecialchars($name) . '</td>';
    echo '<td>' . htmlspecialchars($salary) . '</td>';
    echo '<td>' . htmlspecialchars($city) . '</td>';
    echo '<td>' . htmlspecialchars($age) . '</td>';
    echo '</tr>';
}

// 文件读取完毕，关闭文件句柄
fclose($file);

?>

3. 生成汇总统计行

在所有数据行都已输出并且数据收集完毕后，我们就可以对收集到的数组进行统计计算，并将其作为表格的最后一行输出。

3.1 统计计算方法

唯一姓名数量: 使用array_unique()去除重复姓名，然后用count()计算唯一元素的数量。
总薪资: 使用array_sum()直接计算所有薪资的总和。
最常见城市: 使用array_count_values()统计每个城市出现的次数，然后用max()找到最大出现次数，再用array_search()找出对应最大次数的城市。
平均年龄: 使用array_sum()计算所有年龄的总和，然后除以count()得到的总人数。为了得到整数结果，可以进行类型转换(int)。

3.2 输出汇总行

将计算出的统计值作为新的中的元素输出。

<?php
// ... (接上一段代码)

// 计算汇总统计数据
$countOfUniqueNames = count(array_unique($names)); // 唯一姓名数量
$sumOfAllSalaries = array_sum($salaries); // 总薪资

$citiesCount = array_count_values($cities); // 统计每个城市出现的次数
$maxVal = 0;
$mostCommonCity = 'N/A';
if (!empty($citiesCount)) {
    $maxVal = max($citiesCount); // 最多出现的次数
    $mostCommonCity = array_search($maxVal, $citiesCount); // 对应最多次数的城市
}


$averageAges = 0;
if (!empty($ages)) {
    $averageAges = (int)(array_sum($ages) / count($ages)); // 平均年龄
}


// 输出汇总行
echo '<tr>';
echo '<td><strong>唯一姓名数: ' . htmlspecialchars($countOfUniqueNames) . '</strong></td>';
echo '<td><strong>总薪资: ' . htmlspecialchars($sumOfAllSalaries) . '</strong></td>';
echo '<td><strong>最常见城市: ' . htmlspecialchars($mostCommonCity) . '</strong></td>';
echo '<td><strong>平均年龄: ' . htmlspecialchars($averageAges) . '</strong></td>';
echo '</tr>';
echo "</table>"; // 结束HTML表格

?>

4. 完整代码示例

将上述所有代码片段组合起来，形成一个完整的PHP脚本。

<?php

// 假设 name.txt 文件内容如下：
// name:Ivan,Salary:5000,town:Sofia,age:20
// name:Pesho,Salary:1500,town:Pleven,age:19
// name:Gosho,Salary:2000,town:Varna,age:18
// name:Georgi,Salary:3000,town:Pleven,age:46
// name:Ivailo,Salary:6000,town:Pleven,age:25
// name:Stamat,Salary:7000,town:Varna,age:46
// name:Aleksandar,Salary:1500,town:Burgas,age:44
// name:Kiko,Salary:5000,town:Plovdiv,age:25
// name:Misho,Salary:5250,town:Sofia,age:24
// name:Daniel,Salary:3000,town:Plovdiv,age:34
// name:John,Salary:6000,town:Pleven,age:50
// name:Ana,Salary:9000,town:Sofia,age:18
// name:Maria,Salary:9500,town:Sofia,age:30
// name:Marian,Salary:9500,town:Sofia,age:20
// name:Petko,Salary:9500,town:Sofia,age:19
// name:Nikola,Salary:9500,town:Sofia,age:45
// name:Ani,Salary:9500,town:Sofia,age:47

$filePath = 'name.txt';

// 检查文件是否存在且可读
if (!file_exists($filePath) || !is_readable($filePath)) {
    die("错误：文件 '$filePath' 不存在或无法读取。");
}

$file = fopen($filePath, "r");
if (!$file) {
    die("错误：无法打开文件 '$filePath'。");
}

// 用于存储所有数据的数组，以便后续进行汇总计算
$names = [];
$cities = [];
$salaries = [];
$ages = [];

echo "<!DOCTYPE html>
<html lang=\"zh-CN\">
<head>
    <meta charset=\"UTF-8\">
    <title>员工数据统计</title>
    <style>
        table {
            width: 100%;
            border-collapse: collapse;
        }
        th, td {
            border: 1px solid #ddd;
            padding: 8px;
            text-align: left;
        }
        th {
            background-color: #f2f2f2;
        }
        tr:last-child {
            font-weight: bold;
            background-color: #e0e0e0;
        }
    </style>
</head>
<body>";

echo "<h2>员工信息及统计</h2>";
echo "<table border=\"1px\">";
echo "<thead>";
echo "<tr>
        <th>姓名</th>
        <th>薪资</th>
        <th>城市</th>
        <th>年龄</th>
      </tr>";
echo "</thead>";
echo "<tbody>";

while (!feof($file)) {
    $string = fgets($file);
    if ($string === false) { // 检查 fgets 是否返回 false (文件读取错误或结束)
        break;
    }
    $string = trim($string); // 去除行尾空白符和换行符
    if ($string === '') { // 跳过空行
        continue;
    }

    $finalArray = [];

    $asArr = explode(',', $string);
    foreach ($asArr as $val) {
        $tmp = explode(':', $val, 2); // 限制分割次数为2，以防值中包含冒号
        if (count($tmp) === 2) {
            $key = trim($tmp[0]);
            $value = trim($tmp[1]);
            $finalArray[$key] = $value;
        }
    }

    // 从解析后的数组中提取数据，并进行类型转换和默认值处理
    $name = $finalArray['name'] ?? '';
    $salary = (int)($finalArray['Salary'] ?? 0); // 薪资确保为整数
    $city = $finalArray['town'] ?? '';
    $age = (int)($finalArray['age'] ?? 0); // 年龄确保为整数

    // 将当前行的数据添加到各自的收集数组中
    $names[] = $name;
    $salaries[] = $salary;
    $cities[] = $city;
    $ages[] = $age;

    // 输出当前行的详细数据到表格
    echo '<tr>';
    echo '<td>' . htmlspecialchars($name) . '</td>';
    echo '<td>' . htmlspecialchars($salary) . '</td>';
    echo '<td>' . htmlspecialchars($city) . '</td>';
    echo '<td>' . htmlspecialchars($age) . '</td>';
    echo '</tr>';
}

fclose($file); // 关闭文件句柄

// 计算汇总统计数据
$countOfUniqueNames = count(array_unique($names));
$sumOfAllSalaries = array_sum($salaries);

$citiesCount = array_count_values($cities);
$mostCommonCity = 'N/A';
if (!empty($citiesCount)) {
    $maxVal = max($citiesCount);
    $mostCommonCity = array_search($maxVal, $citiesCount);
}

$averageAges = 0;
if (!empty($ages)) {
    $averageAges = (int)(array_sum($ages) / count($ages));
}

// 输出汇总行
echo '<tr>';
echo '<td><strong>唯一姓名数: ' . htmlspecialchars($countOfUniqueNames) . '</strong></td>';
echo '<td><strong>总薪资: ' . htmlspecialchars($sumOfAllSalaries) . '</strong></td>';
echo '<td><strong>最常见城市: ' . htmlspecialchars($mostCommonCity) . '</strong></td>';
echo '<td><strong>平均年龄: ' . htmlspecialchars($averageAges) . '</strong></td>';
echo '</tr>';

echo "</tbody>";
echo "</table>";
echo "</body>
</html>";

?>

5. 注意事项与最佳实践

错误处理: 在实际应用中，应增加更健壮的错误处理，例如检查fopen()是否成功，以及fgets()是否返回false。本教程的代码已包含文件存在性检查。
数据清洗与验证: trim()函数对于去除从文件中读取的字符串中的空白字符至关重要。对于数值类型的数据（如薪资和年龄），应进行类型转换（intval()或(int)）以确保计算的准确性。
HTML转义: 在将数据输出到HTML中时，始终使用htmlspecialchars()函数来防止跨站脚本（XSS）攻击，即使是来自内部文件的数据也应遵循此原则。
代码可读性: 使用有意义的变量名，添加注释，并保持代码结构清晰，有助于理解和维护。
性能考量: 对于非常大的文件，一次性将所有数据加载到内存中可能会导致性能问题。在这种情况下，可以考虑使用生成器（PHP 5.5+）或更复杂的流式处理方法。但对于本示例中的文件大小，当前方法是高效且易于理解的。
数据结构选择: 根据具体需求选择合适的数据结构。这里使用独立的数组来收集姓名、薪资等，是为了方便后续的聚合函数操作。如果需要更复杂的数据关联，可能需要构建一个包含所有记录的数组对象。