json_encode 函数

适用PHP版本

PHP 5.2.0及以上版本

函数说明

json_encode() 函数用于将一个 PHP 变量（如数组、对象）转换为 JSON 格式的字符串。此函数广泛应用于前后端数据交互，尤其是在 Web 开发中，作为接口数据传输的常用格式。

函数语法

json_encode(mixed $value, int $options = 0, int $depth = 512): string|false

参数

• $value (mixed): 要编码为 JSON 格式的 PHP 值，通常是数组、对象或者标量值。
• $options (int, 可选): 控制编码选项。常用的选项包括：
  • JSON_HEX_TAG - 将 < 和 > 转换为 \u003C 和 \u003E。
  • JSON_HEX_AMP - 将 & 转换为 \u0026。
  • JSON_HEX_APOS - 将单引号转换为 \u0027。
  • JSON_HEX_QUOT - 将双引号转换为 \u0022。
  • JSON_PRETTY_PRINT - 输出格式化的 JSON 字符串。
  • JSON_UNESCAPED_SLASHES - 不转义斜杠。
  • JSON_UNESCAPED_UNICODE - 不转义 Unicode 字符。
• $depth (int, 可选): 设置递归深度的最大限制，默认是 512。

返回值

返回一个 JSON 格式的字符串，如果编码失败，返回 false。

示例

以下示例展示了如何使用 json_encode() 函数将 PHP 数组转换为 JSON 字符串：

示例代码

<?php
$data = array("name" => "John", "age" => 30, "city" => "New York");
$jsonData = json_encode($data);
echo $jsonData;
?>

示例代码说明

在这个示例中，我们首先定义了一个 PHP 数组 $data，然后使用 json_encode() 函数将其转换为 JSON 格式的字符串并输出。最终输出的字符串将类似于：{"name":"John","age":30,"city":"New York"}。