php怎么转换json

PHP中JSON转换的完整指南：从编码到解码的实用技巧

在Web开发中,JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，因其易读性和跨语言兼容性，已成为前后端数据交互的主流选择，PHP作为服务器端开发的核心语言，提供了强大的JSON处理功能，能够轻松实现PHP数据结构与JSON字符串之间的相互转换，本文将详细介绍PHP中JSON转换的核心方法、常见场景及注意事项，帮助你高效处理JSON数据。

PHP数据转为JSON字符串：json_encode()的使用

将PHP数组或对象转换为JSON字符串,主要依赖json_encode()函数，这是PHP与前端交互时最常用的操作，例如将数据库查询结果、API响应数据以JSON格式返回给客户端。

基本语法与示例

json_encode()的基本语法为：

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

• $value：要编码的PHP变量（通常为数组或对象）。
• $options：可选参数，用于控制编码行为（如JSON格式化、中文处理等）。
• $depth：可选参数，指定递归编码的最大深度（默认512）。

示例1：索引数组转JSON

$array = ["apple", "banana", "cherry"];
$jsonStr = json_encode($array);
echo $jsonStr; // 输出: ["apple","banana","cherry"]

示例2：关联数组转JSON（转为对象格式）

$assocArray = ["name" => "张三", "age" => 25, "city" => "北京"];
$jsonStr = json_encode($assocArray);
echo $jsonStr; // 输出: {"name":"张三","age":25,"city":"北京"}

示例3：对象转JSON

class User {
    public $name;
    public $email;
    public function __construct($name, $email) {
        $this->name = $name;
        $this->email = $email;
    }
}
$user = new User("李四", "lisi@example.com");
$jsonStr = json_encode($user);
echo $jsonStr; // 输出: {"name":"李四","email":"lisi@example.com"}

常用$options参数

json_encode()的$options参数通过常量控制编码行为，常用值包括：

• JSON_UNESCAPED_UNICODE：不转义Unicode字符（解决中文乱码问题）。
• JSON_PRETTY_PRINT：格式化输出（缩进美化，便于调试）。
• JSON_FORCE_OBJECT：强制将数组转为对象（即使索引数组也会转为）。

示例：中文不转义+格式化输出

$data = ["姓名" => "王五", "爱好" => ["编程", "阅读"]];
$jsonStr = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
echo $jsonStr;
/* 输出:
{
    "姓名": "王五",
    "爱好": [
        "编程",
        "阅读"
    ]
}
*/

注意：默认情况下，json_encode()会对中文进行Unicode转义（如\u738b\u4e94），导致前端显示为乱码，使用JSON_UNESCAPED_UNICODE可保留原始中文字符。

JSON字符串转为PHP数据：json_decode()的使用

接收前端或其他系统传来的JSON数据时,需通过json_decode()将其转换为PHP数组或对象，以便后续处理。

基本语法与示例

json_decode()的基本语法为：

json_decode(string $json, bool $associative = false, int $depth = 512, int $flags = 0): mixed

• $json：要解码的JSON字符串。
• $associative：是否将JSON对象转为关联数组（true为数组，false为对象）。
• $depth：递归解码的最大深度。
• $flags：解码选项（如JSON_BIGINT_AS_STRING处理大整数）。

示例1：JSON字符串转数组

$jsonStr = '{"name":"赵六","age":30,"hobbies":["travel","music"]}';
$array = json_decode($jsonStr, true); // 第二个参数设为true
print_r($array);
/* 输出:
Array
(
    [name] => 赵六
    [age] => 30
    [hobbies] => Array
        (
            [0] => travel
            [1] => music
        )
)
*/

示例2：JSON字符串转对象（默认）

$jsonStr = '{"name":"钱七","email":"qianqi@example.com"}';
$obj = json_decode($jsonStr); // 默认转为对象
echo $obj->name; // 输出: 钱七
echo $obj->email; // 输出: qianqi@example.com

解码失败的处理

如果JSON字符串格式错误（如缺少引号、语法不匹配），json_decode()会返回null，并可通过json_last_error()获取错误信息。

示例：错误处理

$invalidJson = '{"name":"孙八","age":30'; // 缺少闭合括号
$result = json_decode($invalidJson);
if ($result === null) {
    echo "JSON解码失败: " . json_last_error_msg(); // 输出: JSON解码失败: Syntax error
}

json_last_error_msg()返回具体的错误原因（如“语法错误”、“深度超限”等），便于调试。

特殊场景处理

• 大整数处理：JSON标准中数字范围有限，PHP解码大整数时可能丢失精度，使用JSON_BIGINT_AS_STRING可将大整数转为字符串：

  $jsonStr = '{"id": 12345678901234567890}';
  $data = json_decode($jsonStr, false, 512, JSON_BIGINT_AS_STRING);
  echo $data->id; // 输出: 12345678901234567890（字符串类型）

• 空数组与空对象：JSON的[]解码为PHP数组[]，解码为PHP对象stdClass（除非设置$associative=true）。

JSON转换的常见问题与解决方案

中文乱码问题

原因：json_encode()默认对中文字符进行Unicode转义，导致前端显示为\u编码。
解决：添加JSON_UNESCAPED_UNICODE选项：

$data = ["中文" => "测试"];
echo json_encode($data, JSON_UNESCAPED_UNICODE); // 输出: {"中文":"测试"}

深度超限错误

原因：当JSON数据嵌套层级超过$depth参数（默认512）时，会返回null并报错。
解决：增加$depth值：

$deepJson = str_repeat('{"a":', 600) . '"b"}' . str_repeat('}', 600);
$data = json_decode($deepJson, true, 1024); // 设置深度为1024

特殊字符转义问题

原因：JSON标准要求某些字符（如、\、）需转义，但可能影响数据可读性。
解决：通过$options自定义转义规则，或在前端解码时处理。

PHP对象与JSON对象的对应关系

• PHP的stdClass对象解码JSON对象时，属性名区分大小写。
• PHP私有/受保护的属性无法被json_encode()编码（需通过魔术方法__sleep()和__wakeup()处理）。

实战场景：API响应与数据处理

假设后端需返回用户信息给前端,步骤如下：

1. 准备PHP数据

   $userData = [
       "status" => "success",
       "data" => [
           ["id" => 1, "name" => "用户A", "roles" => ["admin", "editor"]],
           ["id" => 2, "name" => "用户B", "roles" => ["user"]]
       ]
   ];

2. 编码为JSON并返回

   header('Content-Type: application/json'); // 设置响应头为JSON格式
   echo json_encode($userData, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);

   前端接收到的JSON：

   {
       "status": "success",
       "data": [
           {
               "id": 1,
               "name": "用户A",
               "roles": ["admin", "editor"]