PHP中如何正确遍历并显示JSON嵌套数组中的所有元素-php教程-PHP中文网

PHP中如何正确遍历并显示JSON嵌套数组中的所有元素

花韻仙語

发布： 2025-09-20 11:37:52

原创

718人浏览过

PHP中如何正确遍历并显示JSON嵌套数组中的所有元素

本教程详细讲解了如何在PHP中解析复杂的JSON字符串，并正确遍历并显示嵌套的embeddings数组中的所有元素。通过json_decode将JSON转换为关联数组后，使用foreach循环是获取数组所有值的关键，避免只显示第一个元素的问题。

在php开发中，处理json数据是常见的任务，尤其当json结构复杂且包含嵌套数组时。一个常见的需求是从这样的嵌套数组中提取并显示所有元素。本文将详细阐述如何正确实现这一目标，避免只获取到数组中第一个元素的问题。

1. 理解JSON结构与PHP解析

首先，我们来看一个典型的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
            }
        }
    }
}

登录后复制

在PHP中，我们通常使用json_decode()函数来解析JSON字符串。为了方便访问，我们通常将第二个参数设置为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变量是一个PHP关联数组，我们可以通过键名逐级访问其内部数据。

2. 识别并访问目标数组

根据JSON结构，embeddings数组位于$json["results"]["my-input"]["results.json"]["embeddings"]路径下。

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

如果我们尝试直接通过索引[0]来访问它，例如：

// 错误示例：只显示第一个元素
echo $json["results"]["my-input"]["results.json"]["embeddings"][0];
// 输出: 10

登录后复制

这种方法只会显示embeddings数组中的第一个元素（即10）。这是因为[0]明确指定了数组的第一个索引。要获取数组中的所有值，我们需要遍历整个数组。

Find JSON Path Online

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

查看详情

3. 正确遍历并显示所有元素

在PHP中，遍历数组最常用且推荐的方式是使用foreach循环。foreach循环可以迭代数组中的每一个元素，无论是关联数组还是索引数组。

要正确显示embeddings数组中的所有值，我们需要将foreach循环应用于该数组本身：

// 正确示例：遍历并显示所有元素
$embeddingsArray = $json["results"]["my-input"]["results.json"]["embeddings"];

foreach($embeddingsArray as $embeddingValue){
    echo $embeddingValue . " ";
}
// 输出: 10 13 14 18 170

登录后复制

在这个例子中：

我们首先将目标embeddings数组赋值给一个临时变量$embeddingsArray，这样可以使代码更清晰。
foreach($embeddingsArray as $embeddingValue) 语句会依次取出$embeddingsArray中的每一个元素，并将其值赋给$embeddingValue变量，然后执行循环体内的代码。
在循环体内，echo $embeddingValue . " "; 语句将当前元素的值打印出来，并在每个值后添加一个空格，以便于区分。

4. 完整示例代码

下面是包含JSON解析和正确遍历的完整PHP代码示例：

<?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}}}}
';

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

// 2. 访问到目标 embeddings 数组
// 建议在访问深层嵌套结构时，进行空值或键存在性检查，以避免潜在的PHP错误。
if (isset($json["results"]["my-input"]["results.json"]["embeddings"]) &&
    is_array($json["results"]["my-input"]["results.json"]["embeddings"])) {

    $embeddingsArray = $json["results"]["my-input"]["results.json"]["embeddings"];

    echo "Embeddings 数组中的所有值：";
    // 3. 使用 foreach 循环遍历并显示所有值
    foreach($embeddingsArray as $embeddingValue){
        echo $embeddingValue . " ";
    }
    echo "\n"; // 添加换行符
} else {
    echo "未找到 embeddings 数组或其格式不正确。\n";
}

?>

登录后复制

5. 注意事项与最佳实践

键存在性检查: 在实际开发中，当访问深层嵌套的JSON结构时，强烈建议使用isset()或empty()函数来检查每个层级的键是否存在，以防止因键不存在而引发的PHP警告或错误。如上述完整示例所示。
数据类型验证: 确认你正在遍历的是一个数组。is_array()函数可以帮助你进行验证。
错误处理: json_decode()在解析失败时会返回null。在实际应用中，应该检查json_decode()的返回值，并使用json_last_error()和json_last_error_msg()来获取详细的错误信息。
可读性: 对于非常深的嵌套结构，可以考虑将中间结果存储在临时变量中，以提高代码的可读性。