PHP解析AI返回JSON应始终用json_decode($json, true)转为关联数组，避免stdClass链式访问错误；需校验json_last_error()、兼容不同模型字段名、二次解析arguments字符串、流式响应需逐行提取data后解码，并用array_key_exists()或safe_get()安全取值。
PHP中用 json_decode() 解析AI返回的嵌套JSON时，必须设 assoc = true
AI接口（如OpenAI、Qwen、Claude）返回的响应体是标准JSON字符串，但PHP默认用 json_decode($json) 会生成 stdClass 对象，导致后续取值要写 $obj->choices[0]->message->content 这种易错、难调试的链式访问。更稳妥的做法是强制转为关联数组：json_decode($json, true)。
常见错误现象：直接访问 $data->choices 报错 Trying to get property 'choices' of non-object，本质是没意识到返回的是数组还是对象。
- 所有AI API响应都应先检查
json_last_error()，避免空响应或格式错误导致静默失败 -
true参数不只影响顶层，整个嵌套结构（包括messages、tool_calls、function等字段）都会变成数组键名，统一用['choices'][0]['message']['content'] - 如果必须保留对象（比如对接已有依赖
stdClass的旧逻辑），可用json_decode($json, false)，但务必对每层做isset()或空对象判断，不能裸用->
处理 tool_calls 或 function 字段时，别假设结构固定
大模型调用工具（function calling）返回的 tool_calls 是数组，但不同厂商字段名不一致：OpenAI用 ['tool_calls'][0]['function']['name'] 和 ['arguments']；而部分国产模型可能扁平化为 ['function_name'] 和 ['function_arguments']。硬编码键名极易在切换模型时崩掉。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先用
var_dump(array_keys($response['choices'][0]['message'] ?? []))快速探查实际字段结构 - 提取工具调用逻辑应封装成函数，内部用
isset($msg['tool_calls']) ? ... : ($msg['function_name'] ?? null)做兼容分支 -
arguments字段值是JSON字符串（不是数组！），必须二次json_decode($args, true)，否则直接foreach会报错
遇到 Content-Type: text/event-stream 流式响应，不能直接 json_decode
AI接口开启 stream=true 后，返回的是SSE（Server-Sent Events）格式，每行以 data: 开头，末尾带双换行。直接传给 json_decode() 必然失败，典型错误信息是 JSON decode error: Syntax error。
正确做法是逐行解析：
- 用
file_get_contents('php://input')或 cURL 的CURLOPT_WRITEFUNCTION捕获原始流 - 按
\n分割后，过滤掉空行和event:、id:行，提取data: { ... }中的JSON片段 - 对每个有效
data行单独json_decode(..., true)，再合并或增量更新状态（例如拼接delta['content']） - 注意：流式响应中
delta字段可能为空、缺失或含控制字段（如finish_reason），不能无条件取['content']
嵌套过深时用 array_key_exists() 替代 isset() 防止误判
AI返回的JSON常有可选字段（如 refusal、logprobs、usage），且某些字段值可能是 null。用 isset($arr['choices'][0]['message']['content']) 在 content 为 null 时返回 false，但业务上 null 和缺失是两种含义。
关键区别：
-
isset()对null返回false，对未定义键也返回false，无法区分 -
array_key_exists('content', $msg)能准确判断键是否存在，哪怕值为null - 深度嵌套建议写辅助函数，例如
safe_get($arr, ['choices', 0, 'message', 'content'], '')，内部用循环 +array_key_exists()安全取值
真正麻烦的不是嵌套层数，而是同一字段在不同响应类型里语义漂移——比如 content 在普通回复里是字符串，在工具调用里是 null，在拒绝回答时可能根本不存在。得靠上下文判断，不能只看键名。
