本文详解如何安全、准确地遍历 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' 子键。
原始代码中的关键错误有三处：
- ❌ 错误假设：$item['Shipment']['Scans']['ScanDetail'] —— 实际结构是 $item['Shipment']['Scans'][0]['ScanDetail']，即 Scans 是数组，需先遍历；
- ❌ 缺少空值防护：未校验 $item['Shipment'] 或 $item['Shipment']['Scans'] 是否存在，导致 Undefined array key 警告；
- ❌ 表格结构错位：内层 echo '' 放在最内层循环外，导致
开闭不匹配，HTML 渲染异常。 ✅ 正确做法是：逐层解构 + 显式判空 + 合理嵌套循环。以下是推荐的健壮实现：
<?php $json = file_get_contents('https://track.delhivery.com/api/v1/packages/json/?waybill=<THEWAYBILLNUMBER>&token=<THETOKENKEY>'); $arr = json_decode($json, true); // 安全提取：检查顶层结构是否存在 if (!isset($arr['ShipmentData']) || !is_array($arr['ShipmentData'])) { echo '<p>⚠️ 未获取到有效运单数据，请检查运单号或 Token。</p><div class="aritcle_card flexRow"> <div class="artcardd flexRow"> <a class="aritcle_card_img" href="/xiazai/skill11098" title="Node.js 可靠编程"><img src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="Node.js 可靠编程" ></a> <div class="aritcle_card_info flexColumn"> <a href="/xiazai/skill11098" title="Node.js 可靠编程">Node.js 可靠编程</a> <p>Node.js 可靠编程技能。避免事件循环阻塞、异步陷阱、ESM 兼容问题和内存泄漏。触发词：Node.js 开发、async/await、流处理、性能优化、安全编码。</p> </div> <a href="/xiazai/skill11098" title="Node.js 可靠编程" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</p>'; exit; } $shipments = $arr['ShipmentData']; echo '<table border="1" class="shipment-table" style="border-collapse: collapse; width: 100%; margin: 1em 0;">'; echo '<thead><tr><th>扫描时间</th><th>操作状态</th><th>扫描类型</th><th>地点</th></tr></thead>'; echo '<tbody>'; 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 '<tr>'; echo '<td>' . htmlspecialchars($detail['ScanDateTime'] ?? 'N/A') . '</td>'; echo '<td>' . htmlspecialchars($detail['Scan'] ?? 'N/A') . '</td>'; echo '<td>' . htmlspecialchars($detail['ScanType'] ?? 'N/A') . '</td>'; echo '<td>' . htmlspecialchars($detail['ScannedLocation'] ?? 'N/A') . '</td>'; echo '</tr>'; } } echo '</tbody></table>'; ?>? 关键要点总结：
- ✅ 使用 ?? 空合并运算符和 isset() + is_array() 组合进行防御性编程，杜绝未定义键警告；
- ✅ Scans 是数字索引数组（[0] => [...], [1] => [...]），必须用 foreach ($scans as $scan) 进入每一项，再取 $scan['ScanDetail']；
- ✅ 所有用户数据输出前务必使用 htmlspecialchars() 防止 XSS；
- ✅
必须与 成对出现在同一层级循环内（即每个扫描记录对应一个 ）； - ✅ 建议添加 和 提升语义化与可维护性。
通过以上结构化遍历，即可稳定、安全地将深层嵌套的物流轨迹数据渲染为清晰可读的 HTML 表格。
- ✅ 建议添加 和 提升语义化与可维护性。
