PHP与JSON：数据交互中的高效协作艺术

在Web开发的数据流中，JSON如同通用的“数据信封”，而PHP则是拆封与封装的“快递员”。从前端表单提交到后端API响应，二者的默契配合是实现数据无缝流转的关键。本文将带你探索PHP处理JSON的核心技巧，让数据交互变得简单高效。

一、JSON的“翻译器”：核心函数的妙用

PHP处理JSON的两大核心函数——json_encode和json_decode，如同双向翻译器，实现PHP变量与JSON字符串的互转。

1. 编码：PHP变量→JSON字符串

json_encode($value, $options)将PHP数组/对象转化为JSON字符串。关键参数：

• JSON_UNESCAPED_UNICODE：保留中文不转义（避免\uXXXX格式）；
• JSON_PRETTY_PRINT：输出格式化的JSON（便于阅读）；
• JSON_UNESCAPED_SLASHES：不转义斜杠（如URL中的/）。

示例：

$data = [
    "name" => "张三",
    "age" => 28,
    "hobbies" => ["阅读", "编程"],
    "website" => "https://example.com"
];

// 基础编码（中文转义）
echo json_encode($data); 
// 输出：{"name":"\u5f20\u4e09","age":28,...}

// 优化编码（中文+格式化）
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
// 输出：
// {
//     "name": "张三",
//     "age": 28,
//     "hobbies": ["阅读","编程"],
//     "website": "https://example.com"
// }

2. 解码：JSON字符串→PHP变量

json_decode($json_str, $assoc)将JSON字符串转化为PHP变量。关键参数：

• $assoc=true：返回数组（推荐，便于数组操作）；
• $assoc=false：返回对象（默认）。

示例：

$json_str = '{"name":"李四","score":[90,85,95]}';

// 返回数组
$arr = json_decode($json_str, true);
echo $arr["name"]; // 输出：李四
echo $arr["score"][0]; // 输出：90

// 返回对象
$obj = json_decode($json_str);
echo $obj->name; // 输出：李四
echo $obj->score[1]; // 输出：85

二、避坑指南：解码失败的“急救箱”

json_decode失败时返回null，需通过错误处理定位问题：

• json_last_error()：返回错误码；
• json_last_error_msg()：返回错误描述（PHP 5.5+）。

常见错误场景：

• JSON格式错误（如末尾多逗号：{"age":28,}）；
• 非UTF-8编码的字符串；
• 嵌套层级过深（默认递归深度512，可通过ini_set('xdebug.max_nesting_level', 1000)调整）。

错误处理示例：

$invalid_json = '{"name":"王五", "age":30,}'; // 末尾多逗号
$decoded = json_decode($invalid_json, true);

if ($decoded === null) {
    echo "解码失败：" . json_last_error_msg(); 
    // 输出：解码失败：Syntax error
}

三、实战场景：后端API的JSON交互

PHP作为后端接口，常接收前端POST的JSON数据并返回JSON响应。完整流程：

1. 获取前端原始JSON数据：

   $raw_data = file_get_contents('php://input'); // 读取POST原始数据

2. 解码并处理业务逻辑：

   $request = json_decode($raw_data, true);
   if ($request === null) {
      exit(json_encode(["status" => 400, "msg" => "无效的JSON数据"]));
   }
   
   // 业务逻辑：计算总分
   $total_score = array_sum($request["scores"]);

3. 返回JSON响应：