PHP 中 JSON 数组的详尽指南：解码、遍历、处理错误

2024-03-22 16:01:54

## PHP 中 JSON 数组的深入指南

作为一名技术专家，我经常使用 JSON（JavaScript 对象表示法）来处理数据和与外部 API 通信。在 PHP 中使用 JSON 数组时，有许多重要的方面需要考虑。在这篇文章中，我将深入探讨 JSON 数组在 PHP 中的使用，包括解码、访问元素、循环遍历以及处理错误。

解码 JSON

将 JSON 字符串解码为 PHP 数组的第一步是使用 json_decode() 函数。这个函数接收两个参数：一个包含 JSON 字符串的字符串，以及一个布尔值，指示是否将结果解码为关联数组（默认值为 false，解码为对象）。

例如，要将以下 JSON 字符串解码为关联数组：

{
    "tasks": [
        {"id": 1, "task": "Task 1"},
        {"id": 2, "task": "Task 2"}
    ]
}

可以使用以下代码：

$json = '{"tasks": [{"id": 1, "task": "Task 1"}, {"id": 2, "task": "Task 2"}]}';
$decoded = json_decode($json, true);

现在，$decoded 变量将包含一个关联数组，其中键是 JSON 对象的键，值是 JSON 对象的值。

访问数组元素

一旦 JSON 字符串被解码，就可以像访问任何其他 PHP 数组一样访问其元素。使用方括号表示法访问键名，或使用点表示法访问属性。

例如，要访问解码数组中第一个任务的 ID，可以使用：

echo $decoded['tasks'][0]['id']; // 输出 1

或者：

echo $decoded->tasks[0]->id; // 输出 1

循环遍历数组

遍历 JSON 数组的一个简单方法是使用 foreach 循环。这将遍历数组中的每个元素并允许你访问其键和值。

例如，要循环遍历解码数组中的任务并打印其名称，可以使用：

foreach ($decoded['tasks'] as $task) {
    echo $task['task'] . "\n"; // 输出 "Task 1" 和 "Task 2"
}

处理错误

如果 JSON 字符串无效或解码失败，json_decode() 函数将返回 NULL。要获取错误信息，可以使用 json_last_error() 函数。

例如：

if ($decoded === NULL) {
    $error = json_last_error();
    echo "JSON Decode Error: " . $error . "\n";
}

JSON 数组示例

以下是一个示例 JSON 数组，用于表示一组任务：

{
    "tasks": [
        {
            "id": 1,
            "task": "Task 1",
            "status": "pending"
        },
        {
            "id": 2,
            "task": "Task 2",
            "status": "completed"
        }
    ]
}

在 PHP 中使用示例 JSON 数组

$json = '{"tasks": [{"id": 1, "task": "Task 1", "status": "pending"}, {"id": 2, "task": "Task 2", "status": "completed"}]}';
$decoded = json_decode($json, true);

echo "Total Tasks: " . count($decoded['tasks']) . "\n"; // 输出 2

foreach ($decoded['tasks'] as $task) {
    echo "Task: " . $task['task'] . " (Status: " . $task['status'] . ")\n";
}
// 输出：
// Task: Task 1 (Status: pending)
// Task: Task 2 (Status: completed)