PHP操作JSON数据详解

本文深入解析PHP中JSON数据处理的核心要点，涵盖json_encode()与json_decode()的正确用法、常见陷阱（如返回null、中文转义、对象/数组切换）、MySQL JSON字段的安全读写规范、不可序列化类型（资源、闭包等）的应对策略，以及PHP 8.2+新增的JSON_THROW_ON_ERROR异常机制；特别强调UTF-8编码一致性这一贯穿文件、数据库连接和HTTP响应的关键前提，帮助开发者避开90%以上的JSON相关生产问题。

PHP中用 json_encode() 和 json_decode() 处理JSON字段

PHP原生支持JSON，核心就靠这两个函数：把PHP变量转成JSON字符串用 json_encode()，把JSON字符串还原成PHP数据用 json_decode()。它们不是“插件”，无需安装扩展（PHP 5.2+ 默认内置），但默认行为容易踩坑。

常见错误现象：json_encode() 返回 null；json_decode() 返回 null 或意外的 stdClass 对象；中文变成 \uXXXX；数据库存入后查出来是空或乱码。

• json_encode() 返回 null 多半因为输入数据含不可序列化的类型（如资源句柄、闭包、某些对象未实现 JsonSerializable）
• json_decode() 返回 null 时，先用 json_last_error_msg() 看具体错误，90% 是字符串本身格式不合法（比如末尾多逗号、单引号代替双引号）
• 中文被转义：加参数 JSON_UNESCAPED_UNICODE，例如 json_encode($data, JSON_UNESCAPED_UNICODE)
• 想得到数组而非对象：第二个参数传 true，即 json_decode($json, true)
• 注意字符编码：输入字符串必须是UTF-8，否则 json_encode() 直接失败

MySQL JSON字段在PHP里怎么安全读写

MySQL 5.7+ 支持 JSON 类型字段，但PHP层不能直接把数组塞进去——得先转成JSON字符串再存，查出来再解码。重点不是“能不能”，而是“怎么避免SQL注入和类型错乱”。

使用场景：存储配置项、动态表单数据、多语言文案等结构可变的内容。

• 写入前必须用 json_encode()，且检查返回值是否为 null，否则INSERT会存入字符串 "null" 而非真正的JSON
• 不要拼接JSON字符串进SQL语句（比如 "INSERT INTO t (j) VALUES ('".json_encode($x)."')"），必须用预处理或至少用 mysqli_real_escape_string() 处理结果字符串
• 从MySQL读出的JSON字段是字符串，需显式调用 json_decode() 才能当数组用；若字段允许为 NULL，记得判空再解码
• MySQL内部对JSON做校验，但如果PHP传入非法JSON（如 json_encode([1,2,]) 末尾逗号），MySQL会报错 Invalid JSON text

遇到 json_encode(): type is not supported 怎么办

这个错误说明你试图编码一个PHP不支持的类型，最常见的是资源（resource）、闭包（Closure）、未实现序列化接口的对象，或者循环引用数组。

性能影响：强行用 var_export() 或 serialize() 替代，会导致数据无法被前端或其它服务消费，JSON标准不兼容。

• 先用 gettype() 和 is_object() 检查可疑变量，定位到具体键名
• 资源类型（如 mysqli 连接、文件句柄）必须提前关闭或剥离，不能进JSON
• 对象要转JSON，优先让类实现 JsonSerializable 接口，定义 jsonSerialize() 方法返回可编码的数组
• 临时方案：用 array_map() + is_resource() 过滤掉资源，或用 json_encode($data, JSON_PARTIAL_OUTPUT_ON_ERROR)（PHP 7.3+）跳过非法项（但会静默丢失数据，慎用）

PHP 8.2+ 的 JSON_THROW_ON_ERROR 有什么实际用处

以前写 json_decode() 必须配 if ($data === null) { echo json_last_error_msg(); }，现在可以统一抛异常，让错误更早暴露、更容易捕获。

兼容性影响：PHP 8.2+ 才支持，老项目升级前需确认环境版本；开启后所有JSON函数失败都抛 JsonException，不能用 === null 判断了。

• 推荐写法：

  try {
      $data = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
  } catch (JsonException $e) {
      // 记录日志、返回友好提示
  }

• 注意：JSON_THROW_ON_ERROR 只影响当前调用，不会全局生效；多个JSON操作仍需各自加try-catch
• 和 json_last_error() 不兼容——一旦用了这个标志，再调用 json_last_error() 返回0（JSON_ERROR_NONE）

实际项目中最容易被忽略的是字符编码一致性：PHP文件编码、数据库连接编码（SET NAMES utf8mb4）、HTTP响应头（Content-Type: application/json; charset=utf-8）三者必须都是UTF-8，否则哪怕 json_encode() 成功，前端解析也会失败。

本篇关于《PHP操作JSON数据详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！