本文详解如何使用 json_decode() 将 json 格式的字符串（如 api 响应）正确转换为 php 关联数组，并通过键名直接访问 message、data 等层级数据，避免因类型错误导致的“无法访问元素”问题。

你提供的结构看似像数组，实则是 JSON（JavaScript Object Notation）格式的字符串——一种轻量级的数据交换格式，常用于 API 响应或配置文件中。PHP 默认无法直接用 $array[‘message’] 访问它，必须先将其解析为原生 PHP 数据结构。

关键在于使用 json_decode() 函数，并传入第二个参数 true，强制返回关联数组（associative array），而非默认的 stdClass 对象：

// 示例：从字符串解析 JSON（实际中可能来自 API 响应或文件）
$jsonString = '{
    "message": "authenticated",
    "data": {
        "id": 713,
        "name": "Jamal",
        "email": "jamal@example.com",
        "role": "user"
    }
}';

// ✅ 正确：第二个参数 true → 返回关联数组
$array = json_decode($jsonString, true);

// 现在可直接用数组语法访问
echo $array['message'];           // 输出：authenticated
echo $array['data']['name'];      // 输出：Jamal
echo $array['data']['email'];     // 输出：jamal@example.com

⚠️ 注意事项：

• 若省略 true 参数（即 json_decode($jsonString)），返回的是 stdClass 对象，需用对象语法访问：$obj->message 或 $obj->data->id，否则会报错 Trying to access array offset on value of type object。
• 解析前建议检查 JSON 有效性：json_last_error() === JSON_ERROR_NONE，避免因格式错误（如多余逗号、单引号、编码问题）导致返回 null。
• 若 JSON 来自外部（如 file_get_contents() 或 curl_exec()），务必确保字符编码为 UTF-8，且无 BOM 头。

✅ 最佳实践示例（含错误处理）：

通义听悟

阿里云通义听悟是聚焦音视频内容的工作学习AI助手，依托大模型，帮助用户记录、整理和分析音视频内容，体验用大模型做音视频笔记、整理会议记录。

下载

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

$jsonString = file_get_contents('UserData.json');
if ($jsonString === false) {
    throw new Exception('Failed to read JSON file.');
}

$data = json_decode($jsonString, true);
if (json_last_error() !== JSON_ERROR_NONE) {
    throw new Exception('Invalid JSON: ' . json_last_error_msg());
}

// 安全访问（推荐使用 null 合并运算符防止键不存在）
$message = $data['message'] ?? 'unknown';
$userID   = $data['data']['id'] ?? null;
$userRole = $data['data']['role'] ?? 'guest';

echo "Status: {$message}, User ID: {$userID}, Role: {$userRole}";

总结：JSON 不是 PHP 数组，必须显式解码；牢记 json_decode($json, true) 是获取可下标访问的关联数组的唯一可靠方式。掌握此转换逻辑，是处理现代 Web API 数据的基础能力。

https://www.php.cn/faq/2012199.html