PHP处理JSON：编码解码实用技巧

本文深入解析了PHP中JSON数据处理的核心技巧，涵盖json_encode()与json_decode()的高效编码解码方法，包括中文不转义、缩进格式化、UTF-8编码异常修复、深度限制与安全校验等实战要点，帮助开发者规避常见坑点，提升前后端数据交互的稳定性、可读性与安全性——无论你是调试接口、处理用户输入，还是构建高可靠API，这些简洁而关键的实践方案都值得即学即用。

PHP 提供了内置函数用于处理 JSON 数据，主要通过 json_encode() 和 json_decode() 实现数据的序列化与反序列化。以下是具体操作方式：

一、使用 json_encode() 将 PHP 变量编码为 JSON 字符串

该函数将 PHP 数组或对象转换为标准 JSON 格式的字符串，适用于向 JavaScript 前端传递数据或保存结构化内容。

1、确保待编码的数据为关联数组（键名非数字）或标准对象，否则可能生成 JSON 数组而非 JSON 对象。

2、调用 json_encode($data)，其中 $data 为要编码的变量。

3、如需输出中文不被转义为 Unicode，添加参数 JSON_UNESCAPED_UNICODE：json_encode($data, JSON_UNESCAPED_UNICODE)。

4、检查返回值是否为 false，若为 false 可通过 json_last_error_msg() 获取错误原因。

二、使用 json_decode() 将 JSON 字符串解码为 PHP 数据结构

该函数将合法 JSON 字符串还原为 PHP 中的数组或对象，便于后端逻辑处理。

1、传入 JSON 字符串作为第一个参数，例如 $json_str = '{"name":"张三","age":25}'。

2、第二个参数决定返回类型：设为 true 返回关联数组；设为 false（默认）返回 stdClass 对象。

3、若 JSON 格式非法，函数返回 null，应使用 json_last_error() 判断错误类型。

4、对含深层嵌套或大体积 JSON，建议先用 json_validate($str) 预检合法性（PHP 8.3+ 支持；低版本可用 json_decode($str) !== null 且 json_last_error() === JSON_ERROR_NONE 替代）。

三、处理 UTF-8 编码异常导致的 json_encode 失败

当输入字符串包含非 UTF-8 编码字符（如 GBK、ISO-8859-1），json_encode 会返回 false，需预先转码。

1、使用 mb_convert_encoding($str, 'UTF-8', 'auto') 自动识别并转换源编码。

2、若已知原始编码为 GBK，可显式指定：mb_convert_encoding($str, 'UTF-8', 'GBK')。

3、对多维数组，需递归遍历每个字符串元素执行转码，避免部分字段残留非法字节。

4、转换后再次调用 json_encode，确认返回值非 false。

四、控制 json_encode 输出格式以提升可读性

调试或日志记录时，需生成缩进格式的 JSON 字符串，便于人工阅读。

1、在 json_encode 第二个参数中加入 JSON_PRETTY_PRINT 标志。

2、如需同时保留中文不转义和缩进效果，组合使用：JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT。

3、注意该模式会增加输出长度，生产环境接口响应中应避免启用。

4、若需去除空白符（如压缩 JSON），可手动用 preg_replace('/\s+/', '', $json) 处理，但需确保不破坏字符串内空格。

五、安全解析不可信来源的 JSON 数据

来自用户输入、API 响应或文件读取的 JSON 可能含恶意结构（如超深嵌套、极大数值、重复键），需限制解析行为。

1、使用 json_decode($input, false, 16, JSON_THROW_ON_ERROR) 启用异常抛出，避免静默失败。

2、设置最大深度为合理值（如 16），防止栈溢出攻击；PHP 7.3+ 支持第四个参数控制深度。

3、对数值型字段，检查是否超出 PHP_INT_MAX 或 float 范围，必要时用 is_int() 或 is_float() 显式判断类型。

4、禁用 JSON_BIGINT_AS_STRING 以外的大整数自动转换，防止精度丢失，尤其在处理 ID、金额等关键字段时。

好了，本文到此结束，带大家了解了《PHP处理JSON：编码解码实用技巧》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！