PHP格式化数据库查询结果的技巧有哪些
在PHP开发中，操作数据库后获取的原始查询结果往往需要根据业务需求进行格式化处理，比如转换为关联数组、生成JSON数据、适配前端表格展示等。掌握高效的格式化技巧，能减少后续业务代码的复杂度，提升开发效率。下面分享几种常用的PHP格式化数据库查询结果的方法。
一、提取为关联数组格式
很多场景下我们需要将查询结果转换为以某个字段值为键的关联数组，方便后续通过键快速查找数据。以PDO扩展查询MySQL数据库为例，原始查询结果通常是索引数组或对象形式，我们可以通过遍历处理实现关联数组转换。
<?php
// 假设已经建立PDO数据库连接，$pdo为PDO实例
$sql = 'SELECT id, username, age FROM users WHERE status = 1';
$stmt = $pdo->query($sql);
$rawResult = $stmt->fetchAll(PDO::FETCH_ASSOC);
// 格式化：以id为键，整条记录为值
$formattedResult = [];
foreach ($rawResult as $row) {
$formattedResult[$row['id']] = $row;
}
// 输出格式化后的结果
print_r($formattedResult);
?>上述代码中，首先通过fetchAll(PDO::FETCH_ASSOC)获取原始关联数组结果，然后遍历数组，将每条记录的id作为新数组的键，整条记录作为对应的值，最终得到键为id的关联数组，后续如果需要获取某个id对应的用户信息，直接通过$formattedResult[$id]即可访问，无需再次遍历。
二、转换为JSON格式返回
如果是开发接口或者需要向前端传递数据，通常会将查询结果转换为JSON格式。PHP内置的json_encode函数可以快速实现这个需求，还可以根据需求设置转换参数，比如处理中文编码、格式化输出等。
<?php
// 沿用上面的$rawResult原始查询结果
// 普通JSON转换，中文会被编码为Unicode
$jsonNormal = json_encode($rawResult);
// 带中文不转义、格式化缩进的JSON转换
$jsonPretty = json_encode($rawResult, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
// 设置响应头为JSON格式后输出
header('Content-Type: application/json; charset=utf-8');
echo $jsonPretty;
?>这里使用了JSON_UNESCAPED_UNICODE参数避免中文被转义为Unicode字符，JSON_PRETTY_PRINT参数可以让生成的JSON带有缩进，方便调试查看。如果是生产环境不需要格式化，可以去掉JSON_PRETTY_PRINT参数提升性能。
三、适配前端表格的行列格式
前端表格组件通常需要特定的数据结构，比如表头对应字段名，行数据对应每条记录的值。我们可以将原始查询结果转换为这种结构，减少前端的处理逻辑。
<?php
// 原始查询结果
$rawResult = [
['id' => 1, 'username' => '张三', 'age' => 25],
['id' => 2, 'username' => '李四', 'age' => 28],
['id' => 3, 'username' => '王五', 'age' => 22]
];
// 提取表头：取第一条记录的键作为表头
$tableHeader = !empty($rawResult) ? array_keys($rawResult[0]) : [];
// 提取行数据：取每条记录的值组成二维数组
$tableRows = [];
foreach ($rawResult as $row) {
$tableRows[] = array_values($row);
}
// 组合成表格需要的格式
$tableData = [
'header' => $tableHeader,
'rows' => $tableRows
];
print_r($tableData);
?>转换后的$tableData结构可以直接传递给前端表格组件，表头对应<table>的<th>内容，行数据对应<tr>下的<td>内容，前端只需要遍历渲染即可，不需要再做额外的数据拆分处理。
四、字段值二次处理格式化
有些字段的原始值不符合展示需求，比如时间戳需要转换为日期格式、状态值需要转换为文字描述，我们可以在格式化过程中同步处理这些字段。
<?php
// 原始查询结果，包含时间戳和状态值
$rawResult = [
['id' => 1, 'username' => '张三', 'create_time' => 1698765432, 'status' => 1],
['id' => 2, 'username' => '李四', 'create_time' => 1698852032, 'status' => 0]
];
// 状态映射数组
$statusMap = [
0 => '禁用',
1 => '启用'
];
$formattedResult = [];
foreach ($rawResult as $row) {
// 时间戳转日期格式
$row['create_time'] = date('Y-m-d H:i:s', $row['create_time']);
// 状态值转文字描述
$row['status_text'] = $statusMap[$row['status']] ?? '未知状态';
$formattedResult[] = $row;
}
print_r($formattedResult);
?>上述代码在遍历原始结果时，对create_time字段的时间戳做了日期格式化，同时新增了status_text字段存储状态对应的文字描述，这样后续展示的时候直接使用格式化后的字段即可，不需要再单独做转换逻辑。
五、分组格式化结果
如果业务需要按照某个字段对查询结果分组，比如按照年龄分组统计用户，或者按照部门分组展示员工信息，可以通过遍历实现分组格式化。
<?php
// 原始用户数据
$rawResult = [
['id' => 1, 'username' => '张三', 'age' => 25, 'dept' => '技术部'],
['id' => 2, 'username' => '李四', 'age' => 28, 'dept' => '产品部'],
['id' => 3, 'username' => '王五', 'age' => 25, 'dept' => '技术部'],
['id' => 4, 'username' => '赵六', 'age' => 30, 'dept' => '产品部']
];
// 按照部门分组
$groupByDept = [];
foreach ($rawResult as $row) {
$dept = $row['dept'];
if (!isset($groupByDept[$dept])) {
$groupByDept[$dept] = [];
}
$groupByDept[$dept][] = $row;
}
// 按照年龄分组统计人数
$groupByAge = [];
foreach ($rawResult as $row) {
$age = $row['age'];
if (!isset($groupByAge[$age])) {
$groupByAge[$age] = 0;
}
$groupByAge[$age]++;
}
print_r($groupByDept);
echo PHP_EOL;
print_r($groupByAge);
?>分组格式化后的数据可以直接用于分块展示或者统计计算，比如$groupByDept可以直接渲染为按部门折叠的用户列表，$groupByAge可以快速生成年龄分布统计图表的数据源。
以上几种方法覆盖了大部分常见的PHP数据库查询结果格式化场景，实际开发中可以根据具体业务需求组合使用这些技巧，让数据处理流程更清晰高效。