將資料庫查詢結果渲染為 HTML 表格是後台管理、報表展示常見需求。本文提供通用 renderTable() 函數,自動生成表頭、資料列、支援自定義欄位映射、樣式類別。
<?php
/**
* 將 PDOStatement 或陣列渲染為 HTML 表格
* @param PDOStatement|array $result 查詢結果
* @param array $columns 欄位配置 ['db_field' => '顯示標題', ...] 為空則自動取鍵名
* @param array $attrs table 標籤屬性
* @return string HTML 字串
*/
function renderTable($result, array $columns = [], array $attrs = []) {
// 統一轉為陣列
$rows = $result instanceof PDOStatement ? $result->fetchAll() : $result;
if (!$rows) return '<p class="empty">無資料</p>';
// 自動生成欄位配置
if (!$columns) {
$first = reset($rows);
$columns = array_combine(array_keys($first), array_keys($first));
}
// 構建 table 屬性
$attrStr = '';
foreach ($attrs as $k => $v) $attrStr .= " $k=\"$v\"";
$html = "<table$attrStr>\n<thead><tr>";
foreach ($columns as $title) {
$html .= "<th>" . htmlspecialchars($title) . "</th>";
}
$html .= "</tr></thead>\n<tbody>";
foreach ($rows as $row) {
$html .= "<tr>";
foreach (array_keys($columns) as $field) {
$val = $row[$field] ?? '';
$html .= "<td>" . htmlspecialchars((string)$val) . "</td>";
}
$html .= "</tr>";
}
$html .= "</tbody></table>";
return $html;
}
// 使用範例
$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'root', '');
$stmt = $pdo->query('SELECT id, name, email, created_at FROM users WHERE status = 1');
echo renderTable($stmt, [
'id' => 'ID',
'name' => '姓名',
'email' => '電子郵件',
'created_at' => '註冊時間'
], ['class' => 'table table-striped', 'id' => 'userTable']);
?>
<?php
function renderTableAdvanced($rows, array $columns, array $options = []) {
$transformers = $options['transformers'] ?? []; // 欄位值轉換函數
$actions = $options['actions'] ?? null; // 操作欄生成函數 fn($row) => HTML
// ... 表頭生成略 ...
foreach ($rows as $row) {
$html .= "<tr>";
foreach ($columns as $field => $title) {
$val = $row[$field] ?? '';
if (isset($transformers[$field])) {
$val = $transformers[$field]($val, $row);
}
$html .= "<td>" . htmlspecialchars((string)$val) . "</td>";
}
if ($actions) {
$html .= "<td>" . $actions($row) . "</td>";
}
$html .= "</tr>";
}
// ...
}
// 使用
echo renderTableAdvanced($users, [
'id' => 'ID',
'name' => '姓名',
'status' => '狀態',
'balance' => '餘額',
'created_at' => '建立時間'
], [
'transformers' => [
'status' => fn($v) => $v ? '<span class="badge success">啟用</span>' : '<span class="badge danger">停用</span>',
'balance' => fn($v) => '¥' . number_format($v, 2),
'created_at' => fn($v) => date('Y-m-d H:i', strtotime($v)),
],
'actions' => fn($row) => '<a href="/user/edit/' . $row['id'] . '">編輯</a> | <a href="/user/del/' . $row['id'] . '" onclick="return confirm(\'確定刪除?\')">刪除</a>'
]);
?>
<!-- 引入 DataTables -->
<link rel="stylesheet" href="https://cdn.datatables.net/1.13/css/jquery.dataTables.min.css">
<script src="https://code.jquery.com/jquery-3.6.min.js"></script>
<script src="https://cdn.datatables.net/1.13/js/jquery.dataTables.min.js"></script>
<script>
$(document).ready(function() {
$('#userTable').DataTable({
language: { url: '//cdn.datatables.net/plug-ins/1.13/i18n/zh_HANT.json' },
pageLength: 10,
order: [[0, 'desc']]
});
});
</script>
後端只需輸出標準 <table id="userTable">...</table>,前端自動獲得分頁、排序、搜尋、匯出功能。