PHP处理JSON核心是json_encode()和json_decode(),中文乱码需加JSON_UNESCAPED_UNICODE,解析后统一用数组避免对象访问错误,必须配合json_last_error()检查错误,BOM头和编码不一致需预处理,嵌套访问前须做存在性判断。

PHP处理JSON数据,核心就两件事:json_encode() 和 json_decode()。其他所有问题——中文乱码、解析失败、嵌套访问报错、空值判断异常——基本都源于这两个函数的参数误用或错误忽略。
json_encode() 编码时中文变成 \u4f60\u597d 怎么办
这是默认行为,不是bug。PHP为兼容性把 UTF-8 中文转成 Unicode 转义序列,但接口返回或日志里看着难受。
- 必须加
JSON_UNESCAPED_UNICODE标志:json_encode($data, JSON_UNESCAPED_UNICODE) - 别只加这一个:生产环境避免
JSON_PRETTY_PRINT,它会插入空格和换行,导致签名验签失败或前端 JSON.parse 报错 - 如果数据含 HTML 字符(比如用户提交的富文本),
json_encode()不会自动转义<或";需按需在编码前用htmlspecialchars()处理,否则可能引发 XSS - 资源类型(如
mysqli句柄、文件指针)无法被编码,会静默丢弃对应字段,提前unset()或过滤掉
json_decode() 解析后是对象还是数组
不指定第二个参数时,默认返回 stdClass 对象;设为 true 才返回关联数组。混用 -> 和 [] 是新手最常踩的坑。
- 统一用数组:始终传
true,后续所有访问都用$arr['key'],避免Trying to get property 'xxx' of non-object - 对象有其适用场景:比如你明确要复用已有类方法,或想用
property_exists()判断字段是否存在 - 注意空数组和空对象区别:
json_decode('[]', true)返回[](PHP 空数组),json_decode('{}', true)也返回[]—— PHP 里空对象解码后就是空数组,这点容易误判
json_decode() 返回 null 却查不到错误原因
json_decode() 静默返回 null 并不等于失败,只有配合 json_last_error() 才能定位真实问题。
立即学习“PHP免费学习笔记(深入)”;
- 必须检查:
if ($result === null && json_last_error() !== JSON_ERROR_NONE),仅判null会漏掉JSON_ERROR_DEPTH(嵌套太深)等边界情况 - BOM 头是隐形杀手:UTF-8 文件开头的
\xEF\xBB\xBF会让整个字符串解析失败,用trim($json, "\xEF\xBB\xBF")预清洗 - 编码不一致:从 curl 或 POST 接收的字符串可能含 GBK/ISO-8859-1,先用
mb_convert_encoding($json, 'UTF-8', 'auto')统一再解码 - JSON 语法错常见于拼接字符串生成 JSON 的场景(如手动拼
"{...}"),优先用json_encode()生成,而非字符串拼接
嵌套结构取值时 Notice: Undefined index 或 Trying to access array offset on value of type null
深层键名访问前不做存在性检查,PHP 就会直接报错,尤其当上游数据结构不稳定时。
- 用
isset()或array_key_exists()做防御性访问:if (isset($data['user']['profile']['id'])) { ... } - PHP 7.4+ 可用空合并操作符:
$id = $data['user']['profile']['id'] ?? null;,但注意它不区分undefined和null值 - 对不确定是否为数组的变量,先
is_array()判定,再访问,避免Invalid argument supplied for foreach() - 不要依赖
json_decode($json, true)后一定得到完整结构——API 返回可能省略某些字段,或返回null替代空对象
最易被忽略的是:错误检测不能只做一次。从文件读、网络请求、用户输入拿到的 JSON 字符串,每一处都得独立做 BOM 清洗、编码转换、json_last_error() 检查。看似重复,实则是防止某一处疏漏让整个流程静默崩坏。



















