PHP 中遍历并输出多维关联数组(如物流追踪 JSON 解析结果)的正确方法

发布时间 - 2026-01-29 00:00:00    点击率:

本文详解如何安全、准确地遍历 php 中由 `json_decode($json, true)` 生成的深层嵌套数组,并以 html 表格形式输出物流扫描记录,避免“undefined array key”和“foreach() argument must be of type array|object”等常见错误。

在处理物流 API 返回的 JSON 数据(如 Delhivery 轨迹接口)时,json_decode($json, true) 会将其转换为多维关联数组。但直接按路径硬编码访问(如 $item['Shipment']['Scans']['ScanDetail'])极易出错——因为 Scans 本身是一个索引数组,其每个元素才是包含 'ScanDetail' 键的子数组,而非 Scans 直接拥有 'ScanDetail' 子键。

原始代码中的关键错误有三处:

  1. ❌ 错误假设:$item['Shipment']['Scans']['ScanDetail'] —— 实际结构是 $item['Shipment']['Scans'][0]['ScanDetail'],即 Scans 是数组,需先遍历;
  2. ❌ 缺少空值防护:未校验 $item['Shipment'] 或 $item['Shipment']['Scans'] 是否存在,导致 Undefined array key 警告;
  3. ❌ 表格结构错位:内层 echo '' 放在最内层循环外,导致 开闭不匹配,HTML 渲染异常。

    ✅ 正确做法是:逐层解构 + 显式判空 + 合理嵌套循环。以下是推荐的健壮实现:

    &token=');
    $arr = json_decode($json, true);
    
    // 安全提取:检查顶层结构是否存在
    if (!isset($arr['ShipmentData']) || !is_array($arr['ShipmentData'])) {
        echo '

    ⚠️ 未获取到有效运单数据,请检查运单号或 Token。

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

    '; exit; } $shipments = $arr['ShipmentData']; echo ''; echo ''; echo ''; foreach ($shipments as $shipment) { // 确保 Shipment 存在且为数组 if (!isset($shipment['Shipment']) || !is_array($shipment['Shipment'])) { continue; } $shipmentData = $shipment['Shipment']; // 确保 Scans 存在且为非空数组 $scans = $shipmentData['Scans'] ?? []; if (!is_array($scans) || empty($scans)) { continue; } // 遍历 Scans 数组(每个元素是 [ 'ScanDetail' => [...] ]) foreach ($scans as $scan) { // 每个 scan 元素必须包含 ScanDetail 键 if (!isset($scan['ScanDetail']) || !is_array($scan['ScanDetail'])) { continue; } $detail = $scan['ScanDetail']; // 输出一行扫描记录 echo ''; echo ''; echo ''; echo ''; echo ''; echo ''; } } echo '
    扫描时间操作状态扫描类型地点
    ' . htmlspecialchars($detail['ScanDateTime'] ?? 'N/A') . '' . htmlspecialchars($detail['Scan'] ?? 'N/A') . '' . htmlspecialchars($detail['ScanType'] ?? 'N/A') . '' . htmlspecialchars($detail['ScannedLocation'] ?? 'N/A') . '
    '; ?>

    ? 关键要点总结:

    • ✅ 使用 ?? 空合并运算符和 isset() + is_array() 组合进行防御性编程,杜绝未定义键警告;
    • ✅ Scans 是数字索引数组([0] => [...], [1] => [...]),必须用 foreach ($scans as $scan) 进入每一项,再取 $scan['ScanDetail'];
    • ✅ 所有用户数据输出前务必使用 htmlspecialchars() 防止 XSS;
    • ✅ 必须与 成对出现在同一层级循环内(即每个扫描记录对应一个 );
    • ✅ 建议添加 和 提升语义化与可维护性。

      通过以上结构化遍历,即可稳定、安全地将深层嵌套的物流轨迹数据渲染为清晰可读的 HTML 表格。


# php  # html  # js  # json  # 编码  # ai  # lsp  # xss  # echo  # Array  # Object  # 运算符  # 关联数组  # foreach  # 循环  # 接口  # undefined  # tbody  # td  # tr  # 遍历  # 多维  # 是否存在  # 是一个  # 放在  # 才是  # 将其  # 并以  # 而非  # 转换为 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 合肥制作网站的公司有哪些,合肥聚美网络科技有限公司介绍?  利用vue写todolist单页应用  做企业网站制作流程,企业网站制作基本流程有哪些?  西安专业网站制作公司有哪些,陕西省建行官方网站?  米侠浏览器网页背景异常怎么办 米侠显示修复  打造顶配客厅影院,这份100寸电视推荐名单请查收  如何在Windows环境下新建FTP站点并设置权限?  Linux虚拟化技术教程_KVMQEMU虚拟机安装与调优  详解Huffman编码算法之Java实现  Laravel怎么设置路由分组Prefix_Laravel多级路由嵌套与命名空间隔离【步骤】  如何快速生成ASP一键建站模板并优化安全性?  如何彻底删除建站之星生成的Banner?  如何在云服务器上快速搭建个人网站?  Win11怎么设置默认图片查看器_Windows11照片应用关联设置  如何在企业微信快速生成手机电脑官网?  如何快速搭建高效服务器建站系统?  桂林网站制作公司有哪些,桂林马拉松怎么报名?  Laravel Eloquent性能优化技巧_Laravel N+1查询问题解决  Laravel如何与Inertia.js和Vue/React构建现代单页应用  如何在VPS电脑上快速搭建网站?  Laravel如何实现用户注册和登录?(Auth脚手架指南)  香港服务器如何优化才能显著提升网站加载速度?  google浏览器怎么清理缓存_谷歌浏览器清除缓存加速详细步骤  高防服务器:AI智能防御DDoS攻击与数据安全保障  EditPlus中的正则表达式实战(5)  Bootstrap整体框架之CSS12栅格系统  Python自动化办公教程_ExcelWordPDF批量处理案例  Laravel怎么在Controller之外的地方验证数据  Laravel如何编写单元测试和功能测试?(PHPUnit示例)  如何在景安云服务器上绑定域名并配置虚拟主机?  如何在万网自助建站中设置域名及备案?  Laravel Pest测试框架怎么用_从PHPUnit转向Pest的Laravel测试教程  HTML透明颜色代码怎么让图片透明_给img元素加透明色的技巧【方法】  如何在不使用负向后查找的情况下匹配特定条件前的换行符  iOS UIView常见属性方法小结  千库网官网入口推荐 千库网设计创意平台入口  详解ASP.NET 生成二维码实例(采用ThoughtWorks.QRCode和QrCode.Net两种方式)  canvas 画布在主流浏览器中的尺寸限制详细介绍  矢量图网站制作软件,用千图网的一张矢量图做公司app首页,该网站并未说明版权等问题,这样做算不算侵权?应该如何解决?  高防网站服务器:DDoS防御与BGP线路的AI智能防护方案  详解免费开源的DotNet二维码操作组件ThoughtWorks.QRCode(.NET组件介绍之四)  Laravel如何集成微信支付SDK_Laravel使用yansongda-pay实现扫码支付【实战】  Laravel Eloquent模型如何创建_Laravel ORM基础之Model创建与使用教程  JS弹性运动实现方法分析  JavaScript如何实现倒计时_时间函数如何精确控制  百度浏览器网页无法复制文字怎么办 百度浏览器复制修复  如何在Windows虚拟主机上快速搭建网站?  Laravel事件监听器怎么写_Laravel Event和Listener使用教程  Laravel表单请求验证类怎么用_Laravel Form Request分离验证逻辑教程  javascript中的try catch异常捕获机制用法分析