PHP格式化SQL查询结果输出的技巧
在PHP开发中，执行SQL查询后获取的结果通常需要经过格式化处理才能满足不同场景的需求，比如页面展示、接口返回、文件导出等。本文将介绍几种实用的PHP格式化SQL查询结果的方法，帮助开发者更灵活地处理数据。
一、基础格式化：将查询结果转为关联数组
默认情况下，使用mysqli或PDO执行查询后，结果集可能是对象形式，或者索引数组形式，为了更方便地操作字段，第一步通常是将结果转为关联数组，让字段名作为数组的键。
以下是使用mysqli扩展将查询结果格式化为关联数组的示例：
<?php
// 数据库连接配置
$host = '127.0.0.1';
$user = 'root';
$password = '123456';
$dbname = 'test_db';
// 创建连接
$conn = new mysqli($host, $user, $password, $dbname);
// 检查连接是否成功
if ($conn->connect_error) {
die("连接失败: " . $conn->connect_error);
}
// 执行SQL查询
$sql = "SELECT id, username, email, create_time FROM users LIMIT 5";
$result = $conn->query($sql);
// 初始化结果数组
$userList = [];
// 将查询结果转为关联数组
if ($result->num_rows > 0) {
while ($row = $result->fetch_assoc()) {
$userList[] = $row;
}
}
// 输出格式化后的数组
print_r($userList);
// 关闭连接
$conn->close();
?>上述代码中，fetch_assoc()方法会将每一行结果转为关联数组，字段名作为键，字段值作为值，最终把所有行存入$userList数组中，方便后续处理。
二、字段值格式化：处理特殊类型数据
SQL查询结果中常包含时间、数值、布尔值等特殊类型的数据，直接输出可能不符合预期，需要针对性格式化。
1. 时间字段格式化
如果数据库中存储的是时间戳或者默认的datetime格式，可以使用date()函数转为指定格式的字符串。
<?php
// 假设$user是上一步获取的关联数组中的一行数据
$user = [
'id' => 1,
'username' => 'zhangsan',
'email' => 'zhangsan@ipipp.com',
'create_time' => '2024-05-20 14:30:00' // 数据库存储的datetime格式
];
// 格式化时间字段为Y年m月d日 H:i:s格式
$user['create_time'] = date('Y年m月d日 H:i:s', strtotime($user['create_time']));
print_r($user);
?>2. 数值字段格式化
对于金额、百分比等数值类字段，可以使用number_format()函数保留指定小数位，或者添加千分位分隔符。
<?php
// 假设查询到的订单数据
$order = [
'order_id' => 1001,
'amount' => 1234.5678, // 原始金额
'discount_rate' => 0.85 // 折扣率
];
// 金额保留2位小数，添加千分位分隔符
$order['amount'] = number_format($order['amount'], 2, '.', ',');
// 折扣率转为百分比格式，保留1位小数
$order['discount_rate'] = number_format($order['discount_rate'] * 100, 1) . '%';
print_r($order);
?>三、结果集批量格式化：自定义处理规则
如果需要对所有查询结果统一应用格式化规则，可以封装一个通用的格式化函数，遍历结果集逐行处理。
<?php
/**
* 批量格式化用户查询结果
* @param array $rawList 原始查询结果数组（关联数组格式）
* @return array 格式化后的结果数组
*/
function formatUserList(array $rawList): array
{
$formattedList = [];
foreach ($rawList as $row) {
$formattedRow = [
'用户ID' => $row['id'],
'用户名' => $row['username'],
'邮箱' => $row['email'],
// 格式化时间，空值处理
'注册时间' => !empty($row['create_time']) ? date('Y-m-d H:i', strtotime($row['create_time'])) : '未知',
// 隐藏邮箱中间部分
'脱敏邮箱' => preg_replace('/(\w{3})\w+(\w{2}@.*)/', '$1****$2', $row['email'])
];
$formattedList[] = $formattedRow;
}
return $formattedList;
}
// 假设$userList是之前查询得到的原始关联数组结果
$rawUserList = [
['id' => 1, 'username' => 'zhangsan', 'email' => 'zhangsan@ipipp.com', 'create_time' => '2024-05-20 14:30:00'],
['id' => 2, 'username' => 'lisi', 'email' => 'lisi@ipipp.com', 'create_time' => '2024-05-21 09:15:00']
];
$formattedUserList = formatUserList($rawUserList);
print_r($formattedUserList);
?>上述函数将原始字段名替换为更友好的中文键名，同时处理了时间格式化、空值兜底、邮箱脱敏等常见需求，批量处理所有结果行，大幅减少重复代码。
四、输出为不同格式：应对多场景需求
根据使用场景不同，格式化后的结果可能需要输出为JSON、HTML表格、CSV等格式。
1. 输出为JSON格式（接口场景）
如果是给前端接口返回数据，直接将格式化后的数组转为JSON字符串即可，注意设置正确的响应头。
<?php
// 假设$formattedUserList是已经格式化好的数组
$formattedUserList = [
['用户ID' => 1, '用户名' => 'zhangsan', '注册时间' => '2024-05-20 14:30'],
['用户ID' => 2, '用户名' => 'lisi', '注册时间' => '2024-05-21 09:15']
];
// 设置响应头为JSON格式
header('Content-Type: application/json; charset=utf-8');
// 输出JSON，第二个参数设置JSON_UNESCAPED_UNICODE避免中文转义
echo json_encode(['code' => 0, 'msg' => 'success', 'data' => $formattedUserList], JSON_UNESCAPED_UNICODE);
?>2. 输出为HTML表格（页面展示场景）
如果需要在网页上直接展示查询结果，可以将格式化后的数组转为HTML表格，注意对特殊字符进行转义，避免XSS风险。
<?php
// 假设$formattedUserList是已经格式化好的数组
$formattedUserList = [
['用户ID' => 1, '用户名' => 'zhangsan', '注册时间' => '2024-05-20 14:30'],
['用户ID' => 2, '用户名' => 'lisi', '注册时间' => '2024-05-21 09:15']
];
if (!empty($formattedUserList)) {
echo '<table border="1" cellpadding="8" cellspacing="0">';
// 输出表头
echo '<tr>';
foreach (array_keys($formattedUserList[0]) as $header) {
echo '<th>' . htmlspecialchars($header, ENT_QUOTES, 'UTF-8') . '</th>';
}
echo '</tr>';
// 输出表格内容
foreach ($formattedUserList as $row) {
echo '<tr>';
foreach ($row as $value) {
echo '<td>' . htmlspecialchars($value, ENT_QUOTES, 'UTF-8') . '</td>';
}
echo '</tr>';
}
echo '</table>';
} else {
echo '暂无数据';
}
?>这里使用htmlspecialchars()函数对输出的内容进行转义，将<、>、"等特殊字符转为HTML实体，避免恶意脚本注入，保证页面安全。
五、使用PDO的统一格式化处理
如果使用PDO扩展操作数据库，可以利用PDO的ATTR_DEFAULT_FETCH_MODE属性直接设置默认的获取模式为关联数组，简化结果处理流程。
<?php
// PDO连接数据库
$dsn = "mysql:host=127.0.0.1;dbname=test_db;charset=utf8mb4";
$username = "root";
$password = "123456";
try {
$pdo = new PDO($dsn, $username, $password);
// 设置错误模式为异常
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
// 设置默认获取模式为关联数组
$pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);
// 执行查询，结果直接返回关联数组
$sql = "SELECT id, username, email FROM users LIMIT 3";
$result = $pdo->query($sql)->fetchAll();
print_r($result);
} catch (PDOException $e) {
die("数据库操作失败: " . $e->getMessage());
}
?>通过设置PDO::ATTR_DEFAULT_FETCH_MODE为PDO::FETCH_ASSOC，后续所有查询的fetch()和fetchAll()方法都会直接返回关联数组，不需要每次手动调用fetch_assoc()类似的方法，减少重复代码。
以上就是PHP中格式化SQL查询结果的常用技巧，开发者可以根据实际业务场景选择合适的处理方式，让数据输出更符合需求。