PHP JSON解析：遍历并显示多层嵌套数组的完整指南-php教程-PHP中文网

PHP JSON解析：遍历并显示多层嵌套数组的完整指南

心靈之曲

发布： 2025-09-20 10:39:01

原创

820人浏览过

PHP JSON解析：遍历并显示多层嵌套数组的完整指南

本教程将指导您如何在PHP中正确解析并遍历深层嵌套的JSON数据结构，特别是针对数组类型的值。通过实例代码，您将学习如何使用json_decode解析JSON字符串，并通过foreach循环有效提取并展示数组中的所有元素，避免仅获取第一个值的问题。

理解JSON数据结构与PHP解析

在web开发中，json（javascript object notation）是一种轻量级的数据交换格式，广泛用于前后端数据传输。php提供了内置函数来处理json数据。当接收到包含复杂嵌套结构（如数组中包含数组，或对象中包含数组）的json字符串时，正确地解析并提取所需数据是关键。

考虑以下JSON字符串，其中包含一个名为embeddings的数组：

{
    "id": "e92b4fb9-273d-407b-86d0-aa9310d770e4",
    "accountIdentifier": "account",
    "team": {
        "identifier": "283992e6-19b2-43f9-bdcc-03a3be702bfe"
    },
    "results": {
        "my-input": {
            "status": "SUCCESSFUL",
            "endTime": "2021-11-06T19:58:32.589+0000",
            "results.json": {
                "embeddings": [10, 13, 14, 18, 170]
            },
            "vico": {
                "exc": 0,
                "sec": 0
            }
        }
    }
}

登录后复制

我们的目标是从这个JSON中提取embeddings数组中的所有数值：10, 13, 14, 18, 170。

PHP解析JSON字符串

在PHP中，我们使用json_decode()函数将JSON字符串转换为PHP变量。为了方便访问，通常将其转换为关联数组（true作为第二个参数）。

$output = '
{"id":"e92b4fb9-273d-407b-86d0-aa9310d770e4","accountIdentifier":"account",
"team":{"identifier":"283992e6-19b2-43f9-bdcc-03a3be702bfe"}, "results":{"my-input":{"status":"SUCCESSFUL",
"endTime":"2021-11-06T19:58:32.589+0000",
"results.json":{"embeddings":[10,13,14,18,170]},"vico":{"exc":0,"sec":0}}}}
';

$json = json_decode($output, true);

登录后复制

现在，$json变量是一个多维关联数组，其结构与原始JSON数据对应。

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

访问嵌套数组元素

要访问embeddings数组，我们需要按照JSON的层级结构逐层深入。根据JSON路径，embeddings位于$json["results"]["my-input"]["results.json"]["embeddings"]。

如果仅仅尝试使用echo $json["results"]["my-input"]["results.json"]["embeddings"][0];，只会输出数组的第一个元素10。这是因为[0]明确指定了数组的索引，只获取了该索引位置的值。

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

核心解决方案：遍历数组

要获取embeddings数组中的所有值，我们需要对该数组进行迭代。PHP提供了foreach循环，它非常适合遍历数组中的所有元素。

// 首先，定位到包含embeddings数组的层级
$embeddingsArray = $json["results"]["my-input"]["results.json"]["embeddings"];

// 使用foreach循环遍历数组中的每个元素
foreach ($embeddingsArray as $value) {
    echo $value . " "; // 输出每个值，并用空格分隔
}

登录后复制

将上述逻辑整合到完整代码中：

<?php

$output = '
{"id":"e92b4fb9-273d-407b-86d0-aa9310d770e4","accountIdentifier":"account",
"team":{"identifier":"283992e6-19b2-43f9-bdcc-03a3be702bfe"}, "results":{"my-input":{"status":"SUCCESSFUL",
"endTime":"2021-11-06T19:58:32.589+0000",
"results.json":{"embeddings":[10,13,14,18,170]},"vico":{"exc":0,"sec":0}}}}
';

// 将JSON字符串解码为PHP关联数组
$json = json_decode($output, true);

// 检查解码是否成功且目标路径存在
if ($json && isset($json["results"]["my-input"]["results.json"]["embeddings"])) {
    // 获取embeddings数组
    $embeddings = $json["results"]["my-input"]["results.json"]["embeddings"];

    echo "Embedding Values: ";
    // 遍历embeddings数组并输出每个值
    foreach ($embeddings as $value) {
        echo $value . " ";
    }
    echo "\n"; // 换行以保持输出整洁
} else {
    echo "Error: Could not decode JSON or target path not found.\n";
    // 调试用途：输出JSON解码错误信息
    if (json_last_error() !== JSON_ERROR_NONE) {
        echo "JSON Decode Error: " . json_last_error_msg() . "\n";
    }
}

?>

登录后复制

运行这段代码将输出：

Embedding Values: 10 13 14 18 170

登录后复制

这正是我们期望的结果。

注意事项与最佳实践

错误处理： 在实际应用中，json_decode()可能会因为JSON格式不正确而返回null。务必使用if ($json)或json_last_error()来检查解码是否成功，并处理潜在的错误。
路径检查： 在访问深层嵌套数组或对象之前，最好使用isset()或empty()函数检查中间路径是否存在，以避免因路径不存在而引发的PHP警告或错误。
数据类型： json_decode()默认会将JSON数字转换为PHP的int或float，JSON字符串转换为PHP字符串，JSON布尔值转换为PHP布尔值。
可读性： 对于复杂的嵌套结构，可以先将目标数组赋值给一个临时变量，再进行遍历，这样可以提高代码的可读性。