PHP中处理JSON数组并以HTML表格形式展示数据-php教程-PHP中文网

PHP中处理JSON数组并以HTML表格形式展示数据

霞舞

发布： 2025-11-12 13:38:01

原创

178人浏览过

php中处理json数组并以html表格形式展示数据

本教程详细指导如何在PHP中处理包含数组的JSON数据。通过`file_get_contents`获取JSON内容，并使用`json_decode(..., true)`将其转换为PHP关联数组。文章将重点展示如何遍历这些数组记录，并将其关键字段以清晰的HTML表格形式输出，提供完整的代码示例和实践建议，帮助开发者高效地展示外部JSON数据。

在现代Web开发中，从外部API或文件中获取JSON格式的数据是一项常见任务。PHP提供了强大的内置函数来解析和处理这些数据。本文将深入讲解如何获取包含数组的JSON数据，将其解码为PHP可操作的数组结构，并最终以美观且易读的HTML表格形式呈现出来。

获取并解析JSON数据

首先，我们需要从指定的URL或本地文件获取JSON字符串。PHP的file_get_contents()函数是完成此任务的理想选择。获取到JSON字符串后，json_decode()函数负责将其转换为PHP变量。

<?php
// 定义JSON数据的来源URL
$json_url = "https://example.com/api/data.json"; // 请替换为实际的JSON数据源

// 获取JSON字符串内容
$json_string = file_get_contents($json_url);

// 检查是否成功获取内容
if ($json_string === false) {
    die("无法获取JSON数据，请检查URL或网络连接。");
}

// 将JSON字符串解码为PHP数组
// 第二个参数设置为 true，表示将JSON对象解码为关联数组，而非对象
$data = json_decode($json_string, true);

// 检查JSON解码是否成功
if (json_last_error() !== JSON_ERROR_NONE) {
    die("JSON解码失败: " . json_last_error_msg());
}

// 此时，$data 变量将是一个PHP数组，结构类似于：
// Array
// (
//     [0] => Array ( [id] => 13355, [bin] => 540134, ... )
//     [1] => Array ( [id] => 13356, [bin] => 547287, ... )
//     ...
// )
?>

登录后复制

在上述代码中，$data变量现在包含了一个PHP数组，其中每个元素又是一个关联数组，代表了JSON中的一个记录。

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

遍历与显示JSON数组数据

要将这些数据以表格形式展示，我们需要遍历 $data 数组中的每一个记录，并为每个记录生成一行HTML表格。

即构数智人

即构数智人是由即构科技推出的AI虚拟数字人视频创作平台，支持数字人形象定制、短视频创作、数字人直播等。

查看详情

构建HTML表格

一个标准的HTML表格由 zuojiankuohaophpcntable> 标签定义，内部包含 <thead> 用于表头、<tbody> 用于表体。每一行由 <tr> 标签定义，而每个单元格则由 <td>（数据单元格）或 <th>（表头单元格）定义。

<?php
// ... (接上文代码)

// 确保 $data 是一个数组且不为空
if (is_array($data) && !empty($data)) {
    echo "<table border='1'>"; // 添加边框以便查看效果
    echo "<thead>";
    echo "<tr>";
    // 假设所有记录的键都相同，我们可以从第一个记录中提取键作为表头
    $first_record = reset($data); // 获取第一个记录
    if (is_array($first_record)) {
        foreach (array_keys($first_record) as $key) {
            // 过滤掉不希望显示的字段，例如 'created_at', 'updated_at', 'ekalan'
            if (!in_array($key, ['created_at', 'updated_at', 'ekalan'])) {
                echo "<th>" . htmlspecialchars(str_replace('_', ' ', ucfirst($key))) . "</th>";
            }
        }
    }
    echo "</tr>";
    echo "</thead>";
    echo "<tbody>";

    // 遍历 $data 数组中的每个记录
    foreach ($data as $record) {
        echo "<tr>";
        // 遍历当前记录的每个字段
        foreach ($record as $key => $value) {
            // 同样过滤不希望显示的字段
            if (!in_array($key, ['created_at', 'updated_at', 'ekalan'])) {
                // 使用 htmlspecialchars() 防止XSS攻击，并确保特殊字符正确显示
                echo "<td>" . htmlspecialchars($value) . "</td>";
            }
        }
        echo "</tr>";
    }

    echo "</tbody>";
    echo "</table>";
} else {
    echo "<p>没有可显示的数据。</p>";
}
?>

登录后复制

在这个示例中，我们动态地从第一个记录的键中生成了表格的列头，并遍历了所有记录以填充表格内容。htmlspecialchars() 函数用于转义HTML特殊字符，这对于防止跨站脚本攻击（XSS）至关重要。

完整代码示例

将上述步骤整合，形成一个完整的PHP脚本：

<?php
/**
 * PHP教程：从JSON数组中提取数据并以HTML表格形式展示
 *
 * 本脚本演示了如何从外部URL获取JSON数据，将其解码为PHP数组，
 * 并将数组中的每个记录以HTML表格的形式输出到浏览器。
 */

// 1. 定义JSON数据的来源URL
$json_url = "https://example.com/api/data.json"; // **请替换为实际的JSON数据源URL**

// 2. 获取JSON字符串内容
$json_string = @file_get_contents($json_url); // 使用@抑制警告，后续手动处理错误

// 3. 错误处理：检查是否成功获取内容
if ($json_string === false) {
    die("<p>错误：无法获取JSON数据。请检查URL或网络连接。</p>");
}

// 4. 将JSON字符串解码为PHP关联数组
$data = json_decode($json_string, true);

// 5. 错误处理：检查JSON解码是否成功
if (json_last_error() !== JSON_ERROR_NONE) {
    die("<p>错误：JSON解码失败。原因: " . json_last_error_msg() . "</p>");
}

// 6. 准备HTML表格输出
if (is_array($data) && !empty($data)) {
    echo "<!DOCTYPE html>";
    echo "<html lang='zh'>";
    echo "<head>";
    echo "    <meta charset='UTF-8'>";
    echo "    <meta name='viewport' content='width=device-width, initial-scale=1.0'>";
    echo "    <title>JSON数据表格展示</title>";
    echo "    <style>";
    echo "        body { font-family: Arial, sans-serif; margin: 20px; }";
    echo "        table { width: 100%; border-collapse: collapse; margin-top: 20px; }";
    echo "        th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }";
    echo "        th { background-color: #f2f2f2; }";
    echo "    </style>";
    echo "</head>";
    echo "<body>";
    echo "    <h1>JSON数据列表</h1>";

    echo "    <table>";
    echo "        <thead>";
    echo "            <tr>";

    // 定义要显示的字段及其对应的表头名称
    $display_fields = [
        'id'        => 'ID',
        'bin'       => 'BIN',
        'tur'       => '类型',
        'banka_adi' => '银行名称',
        'type'      => '卡类型',
        'name'      => '简称'
        // 'created_at', 'updated_at', 'ekalan' 等字段在此处被排除
    ];

    foreach ($display_fields as $field_key => $header_name) {
        echo "<th>" . htmlspecialchars($header_name) . "</th>";
    }
    echo "            </tr>";
    echo "        </thead>";
    echo "        <tbody>";

    // 遍历 $data 数组中的每个记录
    foreach ($data as $record) {
        echo "            <tr>";
        foreach ($display_fields as $field_key => $header_name) {
            // 检查字段是否存在，如果不存在则显示空字符串或默认值
            $value = isset($record[$field_key]) ? $record[$field_key] : '';
            echo "<td>" . htmlspecialchars($value) . "</td>";
        }
        echo "            </tr>";
    }

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

} else {
    echo "<p>没有可显示的数据，或者数据格式不符合预期。</p>";
}
?>

登录后复制

注意事项与最佳实践

错误处理： 在实际应用中，务必对file_get_contents()和json_decode()的返回值进行检查。网络问题、URL错误或无效的JSON格式都可能导致脚本失败。使用json_last_error()和json_last_error_msg()可以获取详细的JSON解析错误信息。
数据安全： 在将任何来自外部源的数据输出到HTML页面之前，始终使用htmlspecialchars()函数进行转义。这可以有效防止跨站脚本（XSS）攻击，因为恶意脚本可能会被注入到数据中。
动态列处理： 如果JSON数据的结构可能变化（例如，字段名称或数量），可以考虑更灵活的表头生成方式。例如，可以从第一个数据记录中提取所有键作为列头，或者维护一个白名单/黑名单来控制哪些字段显示。本示例中采用了预定义$display_fields的方式，提供了更好的控制。
性能优化： 对于非常大的JSON文件，file_get_contents()可能会占用大量内存。在这种情况下，可以考虑使用流式读取或分块处理JSON数据，但这超出了本教程的范围。
用户体验： 除了基本的表格样式，还可以引入CSS来美化表格，使其更具可读性和吸引力。
字段存在性检查： 在访问 $record[$field_key] 之前，使用 isset() 或 array_key_exists() 检查字段是否存在是一个好习惯，以避免在某些记录缺少特定字段时产生PHP警告。

总结

通过本教程，我们学习了如何在PHP中获取、解码并处理包含数组的JSON数据。关键步骤包括使用file_get_contents()获取JSON字符串，json_decode(..., true)将其转换为PHP关联数组，以及利用foreach循环遍历数组内容并以HTML表格形式输出。遵循错误处理和安全最佳实践，可以确保您的应用程序健壮且安全地展示外部数据。

以上就是PHP中处理JSON数组并以HTML表格形式展示数据的详细内容，更多请关注php中文网其它相关文章！