php json_decode

json_decode() 是 PHP 中用于将 JSON 字符串转换为 PHP 变量的函数。这个函数非常有用，当你从 API 接收 JSON 格式的数据或者需要解析存储为 JSON 字符串的数据时，可以使用它来解析这些数据。

基本用法

$data = json_decode($json_str, $assoc, $depth, $options);

• $json_str 是一个有效的 JSON 字符串。

• $assoc 当设置为 true 时，返回的将是关联数组而不是对象。默认为 false。

• $depth 用户自定义的递归深度，用于json_decode()内部的递归处理。默认深度为 512。

• $options 位掩码参数，可以是以下选项的组合：

  • JSON_BIGINT_AS_STRING (自 PHP 5.4.0 起可用)：当设置时，所有整数超过一定大小（在 32 位系统中为 32 位整数，64 位系统中为 64 位整数）将被转换为字符串。

  • JSON_OBJECT_AS_ARRAY (自 PHP 5.4.0 起可用)：当设置时，将对象转换为关联数组。

  • JSON_UNESCAPED_SLASHES (自 PHP 5.5.0 起可用)：当设置时，\/ 将被转换为 /。

  • JSON_PRETTY_PRINT (自 PHP 5.4.0 起可用)：当设置时，返回的 JSON 字符串将包含空白字符以提高可读性。

  • JSON_UNESCAPED_UNICODE (自 PHP 5.4.0 起可用)：当设置时，所有的 Unicode 字符将被转换为其原始的 Unicode 转义序列。

示例

// JSON 字符串
$json = '{"name":"John", "age":30, "city":"New York"}';

// 转换为对象
$obj = json_decode($json);
echo $obj->name; // 输出 "John"

// 转换为关联数组
$arr = json_decode($json, true);
echo $arr['name']; // 输出 "John"

// 使用选项
$jsonWithOptions = '{"name":"John", "age":30, "city":"New York"}';
$decoded = json_decode($jsonWithOptions, true, 512, JSON_UNESCAPED_SLASHES);
echo $decoded['city']; // 输出 "New York" 而不是 "New York"

注意事项

• 确保你的 JSON 字符串是有效的。无效的 JSON 字符串会导致 json_decode() 返回 null 并产生一个警告。

• 当你期望一个对象时，不要将 $assoc 设置为 true，因为这会导致函数返回一个关联数组而不是对象。

• 如果你不确定 JSON 字符串是否有效，可以在调用 json_decode() 之前使用 json_last_error() 函数来检查是否有错误。

• 当处理大型 JSON 数据时，注意 $depth 参数的设置，以避免 "Maximum depth" 错误。

• 使用 json_decode() 时，要警惕潜在的安全风险，特别是当 JSON 数据来自不可信的源时。始终验证和清理数据，以防止可能的注入攻击。

json_decode() 是处理 JSON 数据的强大工具，正确使用它可以大大简化你的数据处理流程。