如何在 PHP 中处理 JSON 数据？

在PHP中处理JSON数据是开发Web应用和API交互的核心技能之一。以下从编码、解码、错误处理、性能优化及实际应用场景等角度进行全面阐述：

---

一、JSON与PHP数据结构的相互转换

1. 编码：PHP数据 → JSON字符串

通过json_encode()函数实现，支持数组、对象及自定义类的序列化：

$data = [
    'name' => 'John Doe',
    'age' => 30,
    'city' => 'New York'
];
$jsonString = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);

参数说明：

• JSON_PRETTY_PRINT：格式化输出，便于阅读。
• JSON_UNESCAPED_UNICODE：保留非ASCII字符（如中文）。
• JSON_NUMERIC_CHECK：强制数字类型编码，避免字符串化。

2. 解码：JSON字符串 → PHP数据

使用json_decode()函数，可返回对象或关联数组：

$json = '{"name":"John Doe","age":42,"email":"johndoe@example.com"}';
$dataAsObject = json_decode($json);          // 返回对象
$dataAsArray = json_decode($json, true);     // 返回关联数组

参数扩展：

• 第三个参数$depth控制递归深度（默认512），避免栈溢出。
• 第四个参数$flags支持JSON_BIGINT_AS_STRING处理大整数。

二、错误处理与调试

1. 捕获编码/解码错误

$json = '{"invalid": "\xB1\x31"}';  // 非UTF-8字符
$data = json_decode($json);

if (json_last_error() !== JSON_ERROR_NONE) {
    $errorMsg = json_last_error_msg();
    die("JSON解析失败：$errorMsg");
}

常见错误类型：

• JSON_ERROR_SYNTAX：语法错误（如缺少引号）。
• JSON_ERROR_UTF8：非UTF-8编码字符。
• JSON_ERROR_DEPTH：嵌套层级超出限制。

2. 数据验证工具

• 使用JSONLint验证JSON合法性。
• 确保文件编码为UTF-8，避免解析异常。

三、实际应用场景

1. 处理API响应

$url = 'https://api.example.com/data';
$jsonResponse = file_get_contents($url);
$data = json_decode($jsonResponse, true);

if ($data === null) {
    throw new Exception("API响应解析失败：" . json_last_error_msg());
}
echo "当前天气：" . $data['weather'][0]['description'];

• 注意：使用file_get_contents需开启allow_url_fopen，或改用cURL库。

2. 修改并保存JSON文件

// 读取文件
$filePath = 'data.json';
$jsonString = file_get_contents($filePath);
$data = json_decode($jsonString, true);

// 修改数据
$data['users'][] = ['name' => 'Alice', 'age' => 28];

// 保存文件
file_put_contents($filePath, json_encode($data, JSON_PRETTY_PRINT));

• 确保Web服务器对文件有读写权限。

四、性能优化与高级技巧

1. 流式处理大型JSON

• 使用JsonStreamingParser库逐行解析，减少内存占用（适用于GB级数据）。

2. 自定义对象序列化

通过实现JsonSerializable接口控制编码行为：

class User implements JsonSerializable {
    private $name;
    public function jsonSerialize() {
        return ['username' => $this->name];
    }
}
$user = new User();
echo json_encode($user);  // 输出{"username":"John"}

• 仅序列化公共属性或自定义结构。

3. 处理特殊数据类型

• 日期时间：转换为ISO 8601格式：

$data = ['created_at' => (new DateTime())->format(DateTime::ISO8601)];

• 二进制数据：Base64编码后存储。

五、安全注意事项

1. 输入过滤：验证外部JSON数据的合法性，避免注入攻击。
2. 深度限制：设置json_decode()的$depth参数，防止DoS攻击。
3. 避免敏感数据泄露：使用JSON_PARTIAL_OUTPUT_ON_ERROR避免异常暴露内部信息。

---

六、常见问题解决方案

问题现象	原因分析	解决方法
json_decode()返回null	JSON语法错误或编码问题	使用json_last_error_msg()定位问题
中文字符被转义为Unicode	未启用JSON_UNESCAPED_UNICODE	添加该选项到json_encode()
大整数精度丢失	PHP自动转为浮点数	使用JSON_BIGINT_AS_STRING选项

通过以上方法，开发者可以高效、安全地在PHP中处理JSON数据，覆盖从基础操作到生产环境优化的全流程需求。