萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 將 MySQL 查詢結果輸出為 HTML 表格

前言

將資料庫查詢結果渲染為 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 / Bootstrap Table

<!-- 引入 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>,前端自動獲得分頁、排序、搜尋、匯出功能。

copyright © 萬盛學電腦網 all rights reserved