0

0

如何在 PHP 中解析并结构化输出 JSON 数据

心靈之曲

心靈之曲

发布时间:2026-01-06 20:28:31

|

167人浏览过

|

来源于php中文网

原创

如何在 PHP 中解析并结构化输出 JSON 数据

本文介绍如何安全解析从 api 获取的 json 数据,修复常见语法错误,并使用 `json_decode()` 将其转化为可操作的 php 数组,进而按需提取、分类和格式化输出(如 `{l},{100%}` 形式)。

在实际开发中,直接 echo 原始 JSON 响应(尤其是经 gzip 压缩后解码的)不仅难以阅读,还存在严重安全隐患——例如未校验数据完整性、忽略 JSON 语法错误、缺乏结构化处理逻辑等。你当前的代码:

 "()",
  "format" => "json"
));

$result = file_get_contents(
    '(url)'.$params,
    false,
    stream_context_create(array(
        'http' => array('method' => 'GET')
    ))
);
echo gzdecode($result); // ❌ 危险:直接输出原始数据,无校验、无解析、无转义
?>

存在多个关键问题,需逐一解决:

✅ 第一步:修复并验证 JSON 数据源

你提供的示例 JSON 存在 两个致命语法错误

  • "name": "T } 缺少闭合双引号(应为 "name": "T");
  • selection12 中嵌套了 selection5 字段,而其他 selection* 均为扁平数组结构,属于数据模型不一致,极可能是服务端 bug 或字段误嵌套。

⚠️ 重要提醒:PHP 的 json_decode() 在遇到语法错误时会静默返回 null($resultArray === null),但不会抛出异常。因此,必须显式检查解码结果

PHP5 和 MySQL 圣经
PHP5 和 MySQL 圣经

本书是全面讲述PHP与MySQL的经典之作,书中不但全面介绍了两种技术的核心特性,还讲解了如何高效地结合这两种技术构建健壮的数据驱动的应用程序。本书涵盖了两种技术新版本中出现的最新特性,书中大量实际的示例和深入的分析均来自于作者在这方面多年的专业经验,可用于解决开发者在实际中所面临的各种挑战。

下载

立即学习PHP免费学习笔记(深入)”;

$json = gzdecode($result);
$resultArray = json_decode($json, true); // 第二个参数 true → 返回关联数组(非对象)

if (json_last_error() !== JSON_ERROR_NONE) {
    throw new RuntimeException('Invalid JSON received: ' . json_last_error_msg());
}

if ($resultArray === null) {
    throw new RuntimeException('JSON decode failed — check for malformed quotes, trailing commas, or encoding issues.');
}

✅ 第二步:结构化提取目标字段

根据你的需求“组织为 {L},{100%}”,即从每个 selectionX 数组中提取首项 name(如 "L")和次项 name 中的百分比部分(如 "100%\nA" → 提取 "100%"),可编写通用解析逻辑:

$parsed = [];

foreach ($resultArray as $key => $items) {
    if (!is_array($items) || count($items) < 2) continue;

    // 提取第一项 name(如 "L", "S", "H")
    $label = $items[0]['name'] ?? '';

    // 提取第二项 name 并截取百分比(支持 "100%", "100.00%" 等格式)
    $percentRaw = $items[1]['name'] ?? '';
    preg_match('/(\d+(?:\.\d+)?%)/', $percentRaw, $matches);
    $percent = $matches[1] ?? 'N/A';

    $parsed[] = ['label' => $label, 'percent' => $percent];
}

// 输出为 {L},{100%} 格式
$output = '';
foreach ($parsed as $item) {
    $output .= '{' . htmlspecialchars($item['label']) . '},{' . htmlspecialchars($item['percent']) . '}';
}
echo $output; // ✅ 安全输出,已转义 HTML 特殊字符

✅ 第三步:增强健壮性与可维护性

  • 使用 cURL 替代 file_get_contents:更可控的超时、错误处理与 HTTPS 支持;
  • 添加缓存与重试机制:避免频繁请求失败;
  • 定义明确的数据契约(DTO):用类型提示 + assert() 验证结构,例如确保每个 selectionX 是含两个元素的数组;
  • 日志记录异常 JSON 响应体(脱敏后),便于排查上游数据问题。

总结

不要直接 echo 原始响应;始终:
1️⃣ gzdecode() 后立即 json_decode(..., true);
2️⃣ 检查 json_last_error();
3️⃣ 使用 htmlspecialchars() 转义输出,防止 XSS;
4️⃣ 按业务逻辑遍历、提取、重组数组,而非字符串正则硬匹配;
5️⃣ 推动 API 提供方修复 JSON 结构一致性问题(如 selection12 的嵌套异常)。

结构清晰、校验完备、输出安全——这才是生产环境 PHP 数据消费的正确姿势。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2238

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1485

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1388

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

951

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1412

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1233

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1444

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1303

2023.11.13

PPT动态图表制作教程大全
PPT动态图表制作教程大全

本专题整合了PPT动态图表制作相关教程,阅读专题下面的文章了解更多详细内容。

13

2026.01.07

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.4万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号