本文详解如何使用 json_decode() 将 curl 获取的 json 响应转换为 php 关联数组，并通过标准下标语法安全、准确地访问嵌套结构（如 $decoded['data']['id']），避免常见语法错误。
本文详解如何使用 json_decode() 将 curl 获取的 json 响应转换为 php 关联数组，并通过标准下标语法安全、准确地访问嵌套结构（如 $decoded['data']['id']），避免常见语法错误。
在 PHP 中调用 REST API（例如 https://reqres.in/api/users/2）时，cURL 是最常用的 HTTP 客户端工具。但很多开发者在解析返回数据时容易混淆语法——尤其误将 PHP 数组访问写成 JavaScript 风格（如 $decoded.data）或非法符号引用（如 $decoded.[data]），导致报错或输出空值。
正确做法是：先确保响应体为合法 JSON 字符串，再用 json_decode($json, true) 转为关联数组，最后使用方括号语法逐层访问键名。
以下是优化后的完整示例代码（含错误处理与类型校验）：
<?php
$ch = curl_init();
$url = "https://reqres.in/api/users/2";
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$resp = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
// 检查请求是否成功
if ($resp === false || $httpCode !== 200) {
die("cURL error: " . curl_error($ch) . " | HTTP Status: $httpCode");
}
// 解码 JSON 为关联数组（第二个参数 true 至关重要！）
$decoded = json_decode($resp, true);
// 验证解码结果是否有效
if (json_last_error() !== JSON_ERROR_NONE) {
die("JSON decode failed: " . json_last_error_msg());
}
// ✅ 正确访问嵌套字段的方式：
$user_id = $decoded['data']['id'] ?? null;
$user_email = $decoded['data']['email'] ?? '';
$user_name = $decoded['data']['first_name'] . ' ' . ($decoded['data']['last_name'] ?? '');
echo "ID: $user_id\n";
echo "Email: $user_email\n";
echo "Name: $user_name\n";
?>? 关键要点说明：
立即学习“PHP免费学习笔记（深入）”；
- json_decode($resp, true) 的 true 参数决定返回 关联数组（[] 访问），而非默认的 stdClass 对象（需 -> 访问）；
- 所有数组键必须用单引号包裹的字符串（如 'data'），不可省略引号，也不可用点号.代替；
- 强烈建议使用空合并运算符 ?? 提供默认值（如 $decoded['data']['id'] ?? null），防止因 API 字段缺失导致 Notice: Undefined index；
- 务必检查 curl_exec() 返回值和 json_last_error()，避免静默失败；
- 若 API 实际返回的是 HTML 或重定向页面（非纯 JSON），json_decode() 将失败——此时应检查 Content-Type: application/json 响应头及 URL 是否正确。
掌握这一模式后，你可稳定解析任意层级的 JSON 响应（如 $decoded['items'][0]['attributes']['price']），为构建健壮的 API 集成打下坚实基础。
