本文介绍一种无需修改数据库结构即可将按 id_key 分组的扁平化查询结果（如 sql 返回的多行单值）动态渲染为固定列数（如 value1/value2/value3）html 表格的方法，核心在于在 php 中按组聚合并控制单元格输出逻辑。
本文介绍一种无需修改数据库结构即可将按 id_key 分组的扁平化查询结果（如 sql 返回的多行单值）动态渲染为固定列数（如 value1/value2/value3）html 表格的方法，核心在于在 php 中按组聚合并控制单元格输出逻辑。
要实现将原始 SQL 查询结果（每行含 ID_KEY 和单个 VALUE）转换为「每 ID_KEY 占一行、其对应多个 VALUE 按顺序横向展开为独立列」的 HTML 表格，关键在于在遍历结果集时识别 ID_KEY 的边界，并动态填充同组内的多个 <td> 单元格——而非依赖数据库已提供 VALUE1/VALUE2/VALUE3 字段。
以下是一个健壮、可直接集成的 PHP 实现方案：
$result = $con->query($sql);
if ($result && $result->num_rows > 0) {
$res = '<table border="1" class="data-table">';
$res .= '<thead><tr>';
$res .= '<th>ID_KEY</th>';
$res .= '<th>VALUE1</th>';
$res .= '<th>VALUE2</th>';
$res .= '<th>VALUE3</th>';
$res .= '</tr></thead><tbody>';
// 获取首行，作为新组起点
$row = mysqli_fetch_assoc($result);
while ($row) {
$currentKey = $row['ID_KEY'];
$res .= '<tr><td>' . htmlspecialchars($currentKey) . '</td>';
// 输出当前组的第一个 VALUE
$res .= '<td>' . htmlspecialchars($row['VALUE']) . '</td>';
// 继续读取后续行，只要 ID_KEY 匹配就追加为新列（VALUE2, VALUE3...）
$colCount = 1; // 已输出 1 个 VALUE（即 VALUE1）
while (($row = mysqli_fetch_assoc($result)) && $row['ID_KEY'] === $currentKey) {
$colCount++;
// 可选：限制最多输出 3 列（VALUE1~VALUE3），避免越界
if ($colCount <= 3) {
$res .= '<td>' . htmlspecialchars($row['VALUE']) . '</td>';
}
}
// 若某组不足 3 个值，补空单元格以保持表格结构整齐
while ($colCount < 3) {
$res .= '<td> </td>';
$colCount++;
}
$res .= '</tr>';
}
$res .= '</tbody></table>';
return $res;
} else {
return '<p>No data available.</p>';
}✅ 关键设计说明：
- 顺序强依赖：SQL 查询必须使用 ORDER BY ID_KEY, ID（或能保证同 ID_KEY 的行连续出现），否则分组逻辑失效；
- 安全防护：使用 htmlspecialchars() 防止 XSS，避免用户输入破坏 HTML 结构；
- 结构健壮性：自动补全缺失列（如某 ID_KEY 只有 2 条记录，则 VALUE3 显示为空），确保表格列数恒定；
- 可扩展提示：若需支持动态列数（如最多 N 个 VALUE），可将 3 替换为变量 $maxColumns，并在循环中统一控制。
⚠️ 注意事项：
立即学习“前端免费学习笔记（深入）”；
- 此方案适用于 ID_KEY 分组内记录数相对稳定（如始终为 3）的场景；若数量波动极大（如 1–10+），建议改用二维数组预聚合（$data[$idKey][] = $value），再遍历生成表格，逻辑更清晰且易调试；
- 生产环境应配合 PDO 或 MySQLi 面向对象方式 + 异常处理，提升可维护性；
- 长期来看，若此类查询频繁且性能敏感，可考虑添加数据库视图或使用窗口函数（如 ROW_NUMBER() OVER (PARTITION BY ID_KEY ORDER BY ID)）辅助分组编号，但本方案最大优势正是零数据库变更。
该方法平衡了简洁性、兼容性与实用性，是处理“一对多扁平结果→横向表格”需求的经典 PHP 渲染模式。
