php怎么格式化json数据库

PHP如何格式化JSON数据库：实用技巧与最佳实践

在Web开发中，JSON（JavaScript Object Notation）因其轻量级、易读性和与JavaScript的天然兼容性，已成为数据交换的主流格式，PHP作为后端开发的核心语言之一，经常需要处理JSON数据——无论是从数据库读取后格式化为JSON，还是将JSON数据存入数据库并规范格式，本文将围绕“PHP怎么格式化JSON数据库”这一核心问题，从基础操作到高级技巧，详细拆解JSON数据的格式化方法,帮助开发者高效处理数据库与JSON之间的数据转换。

PHP与JSON数据：基础概念解析

在讨论格式化之前，需要明确两个核心场景：

1. 数据库数据转JSON：将MySQL、PostgreSQL等关系型数据库中的查询结果（如数组、对象）格式化为标准JSON字符串。
2. JSON数据存入数据库：接收前端或其他服务传来的JSON数据，解析并格式化为符合数据库存储要求的结构（如字符串、JSON字段类型）。

PHP内置了json_encode()和json_decode()两个核心函数，分别用于“PHP数据→JSON”和“JSON→PHP数据”的转换,这是格式化的基础。

场景一：数据库数据格式化为JSON（输出/传输）

从MySQL查询结果生成JSON

假设我们有一个users表，存储用户信息（id、name、email、created_at）,需要将查询结果格式化为JSON数组。

步骤1：查询数据库获取数据

使用PDO或MySQLi扩展执行SQL查询，获取结果集（数组形式）：

<?php
$pdo = new PDO('mysql:host=localhost;dbname=test', 'username', 'password');
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$stmt = $pdo->query("SELECT id, name, email, created_at FROM users ORDER BY id");
$users = $stmt->fetchAll(PDO::FETCH_ASSOC); // 关联数组形式
?>

步骤2：使用json_encode()转换为JSON

直接对数组调用json_encode(),得到JSON字符串：

$jsonData = json_encode($users);
echo $jsonData;
// 输出示例：
// [
//   {"id":1,"name":"张三","email":"zhangsan@example.com","created_at":"2023-01-01 10:00:00"},
//   {"id":2,"name":"李四","email":"lisi@example.com","created_at":"2023-01-02 11:00:00"}
// ]

关键参数：控制JSON格式

json_encode()支持多个参数，可通过调整参数优化输出格式：

• JSON_PRETTY_PRINT：美化输出，缩进换行（适合调试/日志）：

  echo json_encode($users, JSON_PRETTY_PRINT);
  // 输出带缩进的JSON，可读性更强

• JSON_UNESCAPED_UNICODE：避免中文等非ASCII字符被转义（如\u4e2d\u6587）：

  $user = ['name' => '张三', 'city' => '北京'];
  echo json_encode($user, JSON_UNESCAPED_UNICODE);
  // 输出：{"name":"张三","city":"北京"}（而非{"name":"\u5f20\u4e09","city":"\u5317\u4eac"}）

• JSON_NUMERIC_CHECK：将数字类型的字符串自动转为数字（如"123"→123）：

  $data = ['id' => '123', 'price' => '99.99'];
  echo json_encode($data, JSON_NUMERIC_CHECK);
  // 输出：{"id":123,"price":99.99}

处理复杂数据结构（嵌套JSON）

如果数据库中存储了JSON字段（如MySQL 5.7+的JSON类型），或需要生成嵌套JSON结构，需确保PHP数据是合法的数组/对象。

// 查询包含“标签”字段的用户（tags为JSON字符串）
$stmt = $pdo->query("SELECT id, name, tags FROM users WHERE id = 1");
$user = $stmt->fetch(PDO::FETCH_ASSOC);
// 将tags字符串解析为PHP数组，再重新编码为JSON
$user['tags'] = json_decode($user['tags'], true); // true表示返回数组
$jsonData = json_encode($user, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);

场景二：JSON数据格式化存入数据库

当接收前端或其他服务传来的JSON数据时，需先解析为PHP数据，再格式化后存入数据库，常见场景包括：表单提交的JSON字符串、API请求体等。

接收并解析JSON数据

假设前端通过POST请求发送JSON数据：

// 前端代码示例
fetch('/api/users', {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({name: '王五', email: 'wangwu@example.com', tags: ['php', 'json']})
});

PHP端接收并解析：

<?php
// 获取原始POST数据
$jsonInput = file_get_contents('php://input');
// 解析JSON为PHP数组（第二个参数true表示关联数组）
$data = json_decode($jsonInput, true);
// 验证JSON是否解析成功
if (json_last_error() !== JSON_ERROR_NONE) {
    throw new Exception('JSON格式错误：' . json_last_error_msg());
}
// data = ['name' => '王五', 'email' => 'wangwu@example.com', 'tags' => ['php', 'json']]
?>

格式化数据存入数据库

根据数据库字段类型，选择存储方式：

方式1：存为JSON字符串（兼容所有数据库）

如果数据库字段为TEXT或VARCHAR，直接将PHP数组通过json_encode()转为字符串存储：

// 将tags数组转为JSON字符串
$data['tags_json'] = json_encode($data['tags'], JSON_UNESCAPED_UNICODE);
// 存入数据库（假设tags字段为TEXT类型）
$stmt = $pdo->prepare("INSERT INTO users (name, email, tags) VALUES (:name, :email, :tags)");
$stmt->execute([
    ':name' => $data['name'],
    ':email' => $data['email'],
    ':tags' => $data['tags_json']
]);

方式2：使用数据库原生JSON字段（MySQL 5.7+/PostgreSQL等）

如果数据库支持原生JSON类型（如MySQL的JSON），可直接存储PHP数组,数据库会自动序列化：

// 直接传入数组，PDO会将其转为JSON字符串（需确保PDO驱动支持）
$stmt = $pdo->prepare("INSERT INTO users (name, email, tags) VALUES (:name, :email, :tags)");
$stmt->execute([
    ':name' => $data['name'],
    ':email' => $data['email'],
    ':tags' => $data['tags'] // 直接传数组，MySQL会自动编码为JSON
]);

存储前的数据校验与格式化

为确保数据合规，存储前需对JSON数据进行校验和格式化：

• 字段校验：检查必填字段、数据类型（如email是否合法、tags是否为数组）。
• 安全过滤：使用htmlspecialchars()防止XSS，或使用filter_var()过滤数据（如FILTER_VALIDATE_EMAIL）。
• 格式统一：如日期格式统一为YYYY-MM-DD，手机号统一格式等。

示例：

// 校验email格式
if (!filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
    throw new Exception('邮箱格式不合法');
}
// 统一tags格式（转为小写并去重）
$data['tags'] = array_map('strtolower', $data['tags']);
$data['tags'] = array_unique($data['tags']);

高级技巧：处理JSON格式化中的常见问题

解决中文乱码问题

如果输出JSON时中文显示为\u编码，通常是因为字符集不匹配，确保：

• PHP文件编码为UTF-8（无BOM头）。
• 数据库连接字符集为UTF-8：

  $pdo->exec("SET NAMES utf8");

• json_encode()时添加JSON_UNESCAPED_UNICODE参数。

处理特殊字符（如引号、换行）

JSON对特殊字符有转义要求，可通过JSON_HEX_QUOT（引号转为\u0022）或JSON_UNESCAPED_SLASHES（避免斜杠转义）控制：

$text = '他说："Hello, World!"';
echo json_encode($text, JSON_HEX_QUOT | JSON_UNESCAPED_SLASHES);
// 输出：{\u