PHP json_decode()函数详解

「作者主页」：士别三日wyx
「作者简介」：CSDN top100、阿里云博客专家、华为云享专家、网络安全领域优质创作者
「推荐专栏」：对网络安全感兴趣的小伙伴可以关注专栏《网络安全入门到精通》

json_decode() 可以对JSON字符串「解码」，并转换为PHP变量。

语法

mixed json_decoce( $json_str, assoc, depth, options )
 
参数
 
 $json_str ：需要解码的JSON字符串，只能处理UTF-8编码的数据
 assoc ：布尔类型，true返回数组，（默认）false返回对象
 depth ：整数类型，递归的深度（默认512层），最大 2147483647 层
 options ：二进制掩码，目前只支持 JSON_BIGINT_AS_STRING
 
返回值
 
通过恰当的类型，返回解码后的数据，默认返回对象类型。
JSON格式错误 或 超过递归解析深度 或 false 或 null，就返回null。
 
一、返回数组类型
 
 json_decode() 默认返回「对象」类型，如果想返回「数组」类型，就将 assoc 参数设置为true。 assoc 参数可省略，默认为false。
 
实例：
 
var_dump(json_decode('{"key1":"value1","key2":"value2"}'));
var_dump(json_decode('{"key1":"value1","key2":"value2"}', true));
 
输出：
 
object(stdClass)#1 (2) {
  ["key1"]=>
  string(6) "value1"
  ["key2"]=>
  string(6) "value2"
}
array(2) {
  ["key1"]=>
  string(6) "value1"
  ["key2"]=>
  string(6) "value2"
}
 
 options 参数设置为 JSON_OBJECT_AS_ARRAY 时，也可以转换成「数组」类型。
 
实例：
 
var_dump(json_decode('{"key1":"value1","key2":"value2"}', JSON_OBJECT_AS_ARRAY));
 
输出：
 
array(2) {
  ["key1"]=>
  string(6) "value1"
  ["key2"]=>
  string(6) "value2"
}
 

 
二、JSON的键和值必须用双引号
 
「解析」的JSON字符串，最外侧用单引号包裹，里面的键值对用「双引号」包裹，才能正常解析，否则会返回null。
 
实例：
 
var_dump(json_decode('{"key1":"value1","key2":"value2"}'));
var_dump(json_decode("{'key1':'value1','key2':'value2'}"));
 
输出：
 
object(stdClass)#1 (2) {
  ["key1"]=>
  string(6) "value1"
  ["key2"]=>
  string(6) "value2"
}
NULL
 
这时，（PHP 7.3以上）可以设置参数 options 为JSON_THROW_ON_ERROR，使其在解析错误时抛出异常，方便我们及时处理错误。
 

 
三、返回null问题
 
除了刚才提到的JSON字符串格式错误会返回null，还有其他的原因。
 
遇到返回null的问题时，可以在 json_decode() 后面，打印  json_last_error() 查看错误。
 
实例：
 
var_dump(json_decode("{'key1':'value1','key2':'value2'}"));
echo json_last_error();
 
输出：
 
NULL
4
 
 json_last_error() 返回值解析：
 
0 = JSON_ERROR_NONE //没有错误
1 = JSON_ERROR_DEPTH //超过最大堆栈深度
2 = JSON_ERROR_STATE_MISMATCH //无效或异常的json
3 = JSON_ERROR_CTRL_CHAR //控制字符错误,可能是编码不对
4 = JSON_ERROR_SYNTAX //JSON字符串语法错误
5 = JSON_ERROR_UTF8 //异常的UTF-8字符，只能处理UTF8编码的数据
 

 
四、大整数问题
 
 options 参数设置为 JSON_BIGINT_AS_STRING，可以将超过PHP整型「最大值」的整数解析为字符串。
 

 
五、传入非字符串类型
 
如果传入的不是字符串类型，就不会解码，或者说「无法解码」：
 
数值型会原样返回
运算符会运算后返回运算结果
布尔型（true返回1，false返回NULL）
null会返回NULL
 
实例：
 
var_dump(json_decode(10));
var_dump(json_decode(10.11));
var_dump(json_decode(1*2));
var_dump(json_decode(true));
var_dump(json_decode(false));
var_dump(json_decode(null));
 
输出：
 
int(10)
float(10.11)
int(2)
int(1)
NULL
NULL
 

 
六、强制类型转换
 
解码后进行「强制类型转换」
 
实例：
 
var_dump((array)json_decode(10));
var_dump((int)json_decode(false));
 
输出：
 
array(1) {
  [0]=>
  int(10)
}
int(0)