PHP如何生成JSON数据或解析JSON字符串？

在PHP中生成和解析JSON数据是Web开发中常见的操作，主要通过json_encode()和json_decode()函数实现。以下从生成、解析、参数配置到错误处理的全方位解析：

一、生成JSON数据

1. 基本方法

PHP使用json_encode()函数将数据结构（数组、对象）转换为JSON字符串。
示例：

$data = ["name" => "张三", "age" => 30];
$json = json_encode($data);
echo $json; // 输出：{"name":"张三","age":30}

若需生成JSON文件，可结合file_put_contents()：

file_put_contents("data.json", json_encode($data));

2. 编码与参数控制

• 字符编码：确保输入数据为UTF-8格式，非UTF-8数据需先转换（如iconv()）。
• 参数选项（$options）：
  • JSON_PRETTY_PRINT：格式化输出，便于阅读。
  • JSON_UNESCAPED_UNICODE：保留Unicode字符（如中文）不被转义。
  • JSON_FORCE_OBJECT：强制将数组转为JSON对象。

示例：

$json = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);

3. 数据库生成JSON

从MySQL获取数据并生成JSON：

// 连接数据库并查询
$result = mysqli_query($conn, "SELECT * FROM users");
$data = mysqli_fetch_all($result, MYSQLI_ASSOC);
// 设置响应头并输出
header('Content-Type: application/json; charset=utf-8');
echo json_encode($data);

二、解析JSON字符串

1. 基本解析

使用json_decode()将JSON字符串转为PHP对象或数组：

$jsonStr = '{"name":"张三","age":30}';
$obj = json_decode($jsonStr);         // 返回对象
$arr = json_decode($jsonStr, true);   // 返回关联数组

2. 读取JSON文件

通过file_get_contents()读取文件内容后解析：

$jsonStr = file_get_contents("data.json");
$data = json_decode($jsonStr, true);

3. 复杂数据处理

• 嵌套对象/数组：通过.或[]访问属性。
• 大整数处理：使用JSON_BIGINT_AS_STRING选项避免精度丢失：

$data = json_decode($jsonStr, true, 512, JSON_BIGINT_AS_STRING);

三、函数参数详解

1. json_encode()参数

参数	说明
$value	待编码的数据（数组、对象等）
$options	位掩码组合（如JSON_PRETTY_PRINT）
$depth	最大递归深度（默认512）

2. json_decode()参数

参数	说明
$assoc	true返回数组，false返回对象（默认）
$depth	递归深度限制（防止栈溢出）
$options	如JSON_THROW_ON_ERROR（PHP 7.3+，解析失败时抛出异常）

---

四、常见错误及处理

1. JSON格式错误

• 错误表现：json_decode()返回null。
• 排查工具

if (json_last_error() !== JSON_ERROR_NONE) {

echo "错误信息：" . json_last_error_msg();
}

<span data-key="14" class="reference-num" data-pages="undefined">130</span><span data-key="15" class="reference-num" data-pages="undefined">133</span>

#### 2. **编码问题**
- **非UTF-8字符**：需转换编码：
```php
$jsonStr = iconv('GBK', 'UTF-8//IGNORE', $jsonStr);

3. 语法错误

多余逗号：使用正则修复：

$jsonStr = preg_replace('/,\s*([$$

}])/', '1′,1′,jsonStr);

<span data-key="17" class="reference-num" data-pages="undefined">130</span>

#### 4. **类型限制**
- **大整数处理**：使用`JSON_BIGINT_AS_STRING`保留为字符串。
- **循环引用**：避免在数据结构中出现递归引用。

---

### **五、最佳实践**
1. **生成时**：
 - 始终设置`Content-Type: application/json`响应头。
 - 使用`JSON_UNESCAPED_UNICODE`避免中文乱码。
2. **解析时**：
 - 检查`json_last_error()`确保解析成功。
 - 优先使用关联数组（`$assoc = true`）简化数据操作。
3. **调试工具**：
 - 使用在线JSON验证工具（如JSONLint）检查格式。
 - 输出`json_last_error_msg()`快速定位问题。

---

通过上述方法，开发者可以高效处理PHP与JSON之间的数据转换，同时规避常见陷阱，确保数据交互的准确性和可靠性。