如何正确遍历并输出 PHP 多维关联数组（如物流追踪 JSON 解析结果）

轻婷酱_2978

发布时间：2026-01-29 12:55:02

970人浏览过

来源于php中文网

原创

如何正确遍历并输出 PHP 多维关联数组（如物流追踪 JSON 解析结果）

本文详解如何安全、准确地遍历由 json_decode($json, true) 生成的深层嵌套数组，并在 html 表格中逐条渲染物流扫描记录，避免“undefined array key”和“foreach on null”等常见错误。

在 PHP 中处理 API 返回的 JSON 数据时，使用 json_decode($json, true) 将其转为关联数组是常规做法。但当结构深度较大（如物流追踪数据中包含 ShipmentData → Shipment → Scans → [n] → ScanDetail）时，直接链式访问（如 $item['Shipment']['Scans']['ScanDetail']）极易因键不存在或类型不匹配而触发警告甚至致命错误——正如问题中所示：Warning: Undefined array key "Shipment" 和 foreach() argument must be of type array|object, null given。

根本原因在于：$item['Shipment']['Scans'] 是一个索引数组（含多个 [0] => [...], [1] => [...] 元素），而每个元素内部才是 ['ScanDetail'] 关联子数组。因此，$item['Shipment']['Scans']['ScanDetail'] 实际试图访问一个不存在的字符串键 'ScanDetail'（而非遍历数组），导致返回 null，后续 foreach 即报错。

✅ 正确做法是逐层判断 + 安全遍历。以下是推荐的健壮实现：

$json = file_get_contents('https://track.delhivery.com/api/v1/packages/json/?waybill=<THEWAYBILLNUMBER>&token=<THETOKENKEY>');
$arr = json_decode($json, true);

// 【关键】添加基础结构校验，防止空响应或格式异常
if (!is_array($arr) || !isset($arr['ShipmentData']) || empty($arr['ShipmentData'])) {
    echo '<p>未获取到有效物流数据，请检查运单号或 Token。</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器"><img
                                                                                src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="DeepBI DHTML 页面生成器" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器">DeepBI DHTML 页面生成器</a>
                                                                        <p>生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力：

- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面；  
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”；  
- 提及位于 `apps/console/src/featur</p>
                                                                </div>
                                                                <a href="/xiazai/skill12116" title="DeepBI DHTML 页面生成器" 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;
}

$items = $arr['ShipmentData'];
echo '<table border="1" style="border-collapse: collapse; width: 100%;">';
echo '<thead><tr><th>扫描时间</th><th>操作状态</th><th>扫描地点</th><th>状态码</th></tr></thead>';
echo '<tbody>';

foreach ($items as $item) {
    // 确保 Shipment 存在且为数组
    if (!isset($item['Shipment']) || !is_array($item['Shipment'])) continue;

    $shipment = $item['Shipment'];

    // 确保 Scans 存在且为非空数组
    if (!isset($shipment['Scans']) || !is_array($shipment['Scans']) || empty($shipment['Scans'])) continue;

    // 第一层：遍历 Scans 数组（每个元素是一个含 'ScanDetail' 的子数组）
    foreach ($shipment['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['ScannedLocation'] ?? 'N/A') . '</td>';
        echo '<td>' . htmlspecialchars($detail['StatusCode'] ?? 'N/A') . '</td>';
        echo '</tr>';
    }
}

echo '</tbody></table>';

? 关键注意事项：