PHP 数据库数据格式转换方法

本文深入解析了PHP中数据库数据格式转换的核心实践与常见陷阱，涵盖从PDO结果集的数组/对象形态选择、日期时间的可靠格式化、TINYINT布尔值的安全类型转换，到JSON导出时的UTF-8编码与非法字符处理等关键环节；强调转换必须以明确目标格式为前提，结合数据来源（PDO/MySQLi/ORM）精准选型，规避隐式转换、时区偏差和编码乱码等“看似简单却极易出错”的细节问题，真正实现健壮、可维护、跨环境兼容的数据层格式治理。

PHP 中处理数据库数据格式转换，核心在于明确目标格式（如 JSON、数组、对象、时间戳转日期字符串等），再结合数据来源（PDO、MySQLi、ORM）选择合适方法，避免硬编码和类型错误。

数据库查询结果转标准 PHP 数组

默认 PDO 返回的是关联数组或对象，若需纯索引数组（如用于前端表格渲染），可用 PDO::FETCH_NUM；若需同时含键名和索引（兼顾可读性与遍历灵活性），推荐 PDO::FETCH_BOTH。使用 fetch_all() 时注意参数顺序：

• 关联数组：$stmt->fetchAll(PDO::FETCH_ASSOC)
• 索引数组：$stmt->fetchAll(PDO::FETCH_NUM)
• 对象（stdClass）：$stmt->fetchAll(PDO::FETCH_OBJ)
• 自定义类实例：$stmt->fetchAll(PDO::FETCH_CLASS, 'User')（需类属性与字段名匹配）

日期/时间字段自动格式化

MySQL 的 DATETIME 或 TIMESTAMP 字段在 PHP 中默认是字符串。若需统一转为易读格式（如 "Y-m-d H:i:s"），可在获取后批量处理，也可借助 PDO 的 setAttribute 配合类型映射（需 MySQL 8.0+ 和 PDO MySQL driver 支持）：

• 简单方式：用 date('Y-m-d', strtotime($row['created_at']))，但注意时区一致性
• 推荐方式：在查询中用 MySQL 函数预处理，如 SELECT DATE_FORMAT(created_at, '%Y-%m-%d') as date_str FROM logs
• 进阶方式：为 PDO 设置 PDO::ATTR_EMULATE_PREPARES => false，并启用 PDO::MYSQL_ATTR_USE_BUFFERED_QUERY，配合 DateTime::createFromFormat() 精确解析

数值与布尔字段的类型安全转换

MySQL 中的 TINYINT(1) 常被用作布尔标志，但 PDO 默认返回整数（0/1），而非 PHP 的 true/false。直接用 (bool)$row['is_active'] 可能出错（因 0→false，1→true，看似合理，但若字段允许 NULL，则需额外判断）。稳妥做法：

• 统一用三元表达式：$row['is_active'] === '1' ? true : ($row['is_active'] === '0' ? false : null)
• 或封装为辅助函数：function dbBool($value) { return $value === '1' || $value === true || $value === 1; }
• 对浮点数字段，用 (float)$row['price'] 强制转换，避免科学计数法字符串残留

批量数据导出为 JSON 且兼容中文与特殊字符

用 json_encode() 输出数据库结果前，务必设置 UTF-8 编码，并处理可能的非法字符（如 MySQL 中的控制符、未转义反斜杠）：

• 确保连接层已设 UTF-8：$pdo->exec("SET NAMES utf8mb4")
• 编码时添加标志：json_encode($data, JSON_UNESCAPED_UNICODE | JSON_INVALID_UTF8_SUBSTITUTE)
• 若数据含二进制或不可见字符，先过滤：array_map(function($v) { return is_string($v) ? preg_replace('/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/', '', $v) : $v; }, $row)

不复杂但容易忽略。关键不是写得多，而是每一步都清楚数据当前是什么类型、要变成什么类型、中间有没有隐式转换陷阱。

好了，本文到此结束，带大家了解了《PHP 数据库数据格式转换方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！