PHP处理JSON的核心是json_encode()和json_decode():前者将PHP变量转JSON字符串,注意数组类型、中文编码及不可序列化值返回false;后者将JSON转PHP变量,默认返对象,加true参数返数组,失败返回null,需用json_last_error()或JSON_THROW_ON_ERROR检查错误。

PHP 处理 JSON 数据的核心就是 json_encode() 和 json_decode() 两个函数,用对了就很简单,用错了就容易出 Warning 或返回 null。关键不在语法多难,而在理解数据类型转换规则和错误处理习惯。
JSON 生成:把 PHP 变量转成 JSON 字符串
用 json_encode() 把数组或对象转为合法 JSON 字符串。注意三点:
- 关联数组(键名是字符串)会生成 JSON 对象
{"name":"张三"};索引数组(键名是数字且连续)会生成 JSON 数组["a","b"] - 中文默认被转成 Unicode(如
\u4f60),加 JSON_UNESCAPED_UNICODE 参数可保留原文:json_encode($data, JSON_UNESCAPED_UNICODE) - 如果变量含资源、闭包或不可序列化的对象,json_encode 会返回 false,建议加判断:
if (false === $json = json_encode($data)) { /* 处理错误 */ }
JSON 解析:把 JSON 字符串转回 PHP 变量
用 json_decode() 还原数据,默认返回 stdClass 对象;传第二个参数 true 才返回关联数组:
-
json_decode('{"name":"李四"}')→ 对象,取值写法:$obj->name -
json_decode('{"name":"李四"}', true)→ 数组,取值写法:$arr['name'] - 解析失败时返回 null(不是 false!),可用
json_last_error()查具体错误,比如JSON_ERROR_SYNTAX表示 JSON 格式不对 - 常见坑:前端传来的 JSON 字符串可能带 BOM 或多余空格,建议先
trim($json_str)再解析
实战中必须加的防护动作
真实项目里不能假设 JSON 一定合法。每次 decode 后都该检查:
立即学习“PHP免费学习笔记(深入)”;
- 是否为 null(解析失败)
- 是否为期望类型(比如预期是数组,结果却是对象)
- 关键字段是否存在(用
isset()或array_key_exists())
一个轻量级校验示例:
$data = json_decode($input, true); if (null === $data || !is_array($data) || !isset($data['id'])) { die('非法 JSON 或缺少 id 字段'); }进阶技巧:自定义 JSON 行为
PHP 7.3+ 支持 JSON_THROW_ON_ERROR,让解析失败直接抛异常,比查错误码更直观:
-
json_decode($str, true, 512, JSON_THROW_ON_ERROR)—— 错误时抛JsonException - 配合 try/catch 写法更干净,适合 API 接口层统一错误处理
- 若需控制浮点数精度、跳过 NaN/INF,可用
JSON_PRESERVE_ZERO_FRACTION等扩展标志
基本上就这些。不复杂但容易忽略细节,尤其是错误判断和中文编码。写完 encode/decode 多看一眼返回值,比事后 debug 快十倍。











