PHP JSON解析与生成教学_PHP处理JSON数据完整流程

PHP处理JSON的核心是json_encode()和json_decode():前者将PHP变量转JSON字符串,注意数组类型、中文编码及不可序列化值返回false;后者将JSON转PHP变量,默认返对象,加true参数返数组,失败返回null,需用json_last_error()或JSON_THROW_ON_ERROR检查错误。

PHP 处理 JSON 数据的核心就是 json_encode()json_decode() 两个函数,用对了就很简单,用错了就容易出 Warning 或返回 null。关键不在语法多难,而在理解数据类型转换规则和错误处理习惯。

JSON 生成:把 PHP 变量转成 JSON 字符串

json_encode() 把数组或对象转为合法 JSON 字符串。注意三点:

  • 关联数组(键名是字符串)会生成 JSON 对象 {"name":"张三"};索引数组(键名是数字且连续)会生成 JSON 数组 ["a","b"]
  • 中文默认被转成 Unicode(如 \u4f60),加 JSON_UNESCAPED_UNICODE 参数可保留原文:json_encode($data, JSON_UNESCAPED_UNICODE)
  • 如果变量含资源、闭包或不可序列化的对象,json_encode 会返回 false,建议加判断:if (false === $json = json_encode($data)) { /* 处理错误 */ }

JSON 解析:把 JSON 字符串转回 PHP 变量

json_decode() 还原数据,默认返回 stdClass 对象;传第二个参数 true 才返回关联数组:

  • json_decode('{"name":"李四"}') → 对象,取值写法:$obj->name
  • json_decode('{"name":"李四"}', true) → 数组,取值写法:$arr['name']
  • 解析失败时返回 null(不是 false!),可用 json_last_error() 查具体错误,比如 JSON_ERROR_SYNTAX 表示 JSON 格式不对
  • 常见坑:前端传来的 JSON 字符串可能带 BOM 或多余空格,建议先 trim($json_str) 再解析

实战中必须加的防护动作

真实项目里不能假设 JSON 一定合法。每次 decode 后都该检查:

  • 是否为 null(解析失败)
  • 是否为期望类型(比如预期是数组,结果却是对象)
  • 关键字段是否存在(用 isset()array_key_exists()

一个轻量级校验示例:

$data = json_decode($input, true); if (null === $data || !is_array($data) || !isset($data['id'])) {   die('非法 JSON 或缺少 id 字段'); }

进阶技巧:自定义 JSON 行为

PHP 7.3+ 支持 JSON_THROW_ON_ERROR,让解析失败直接抛异常,比查错误码更直观:

  • json_decode($str, true, 512, JSON_THROW_ON_ERROR) —— 错误时抛 JsonException
  • 配合 try/catch 写法更干净,适合 API 接口层统一错误处理
  • 若需控制浮点数精度、跳过 NaN/INF,可用 JSON_PRESERVE_ZERO_FRACTION 等扩展标志

基本上就这些。不复杂但容易忽略细节,尤其是错误判断和中文编码。写完 encode/decode 多看一眼返回值,比事后 debug 快十倍。