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)