PHP 利用 Table 標籤導出 Excel：Header 設置、編碼處理、資料庫查詢實戰

利用瀏覽器將 HTML <table> 識別為 Excel 的特性，通過設置 Content-Type: application/vnd.ms-excel 實現零依賴導出。本文講解 Header 細節、中文編碼陷阱、資料庫查詢導出完整流程與局限性。

核心 Header 設置

header('Content-Type: application/vnd.ms-excel; charset=utf-8');
header('Content-Disposition: attachment; filename="export_' . date('Ymd_His') . '.xls"');
header('Cache-Control: max-age=0');
header('Expires: 0');

• vnd.ms-excel：觸發 Excel 關聯（.xls 格式）；
• charset=utf-8：關鍵，防止中文亂碼；
• Content-Disposition: attachment：強制下載而非瀏覽器打開；
• 文件名建議加時間戳避免緩存。

最小可行導出頁面

<?php
header('Content-Type: application/vnd.ms-excel; charset=utf-8');
header('Content-Disposition: attachment; filename="demo.xls"');
?>
<table border="1">
  <tr><td colspan="3" align="center">標題行</td></tr>
  <tr><th>ID</th><th>姓名</th><th>年齡</th></tr>
  <tr><td>1</td><td>張三</td><td>20</td></tr>
  <tr><td>2</td><td>李四</td><td>22</td></tr>
</table>

資料庫查詢導出完整範例

<?php
// config
$db = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'user', 'pass');
$db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

// Header
header('Content-Type: application/vnd.ms-excel; charset=utf-8');
header('Content-Disposition: attachment; filename="users_' . date('Ymd') . '.xls"');
header('Cache-Control: max-age=0');

// 查詢
$stmt = $db->query('SELECT id, username, email, created_at FROM users ORDER BY id');
$rows = $stmt->fetchAll(PDO::FETCH_ASSOC);
?>
<table border="1">
  <thead>
    <tr>
      <th>ID</th>
      <th>用戶名</th>
      <th>郵箱</th>
      <th>註冊時間</th>
    </tr>
  </thead>
  <tbody>
    <?php foreach ($rows as $row): ?>
    <tr>
      <td><?= htmlspecialchars($row['id']) ?></td>
      <td><?= htmlspecialchars($row['username']) ?></td>
      <td><?= htmlspecialchars($row['email']) ?></td>
      <td><?= htmlspecialchars($row['created_at']) ?></td>
    </tr>
    <?php endforeach; ?>
  </tbody>
</table>

中文編碼終極解決方案

1. PHP 文件保存為 UTF-8 無 BOM；
2. Header 顯式聲明 charset=utf-8；
3. 資料庫連接 charset=utf8mb4；
4. 輸出經過 htmlspecialchars() 防止標籤注入破壞結構；
5. 若仍亂碼：嘗試 iconv('UTF-8', 'GBK//IGNORE', $str) 轉 GBK（老版本 Excel 兼容性更好），但會丟失 Emoji。

進階技巧：多工作表、樣式、公式

HTML Table 導出本質是 HTML 片段，Excel 打開時解析渲染。支援：

• 內聯樣式：<td style="background:#ffff00; font-weight:bold;"> 背景色、字體；
• 數字格式：<td style="mso-number-format:'\#\,\#\#0.00'">1234.56</td> 強制兩位小數；
• 公式：<td>=SUM(A2:A10)</td> Excel 會計算；
• 多工作表：不支援，單文件僅一個工作表。

局限性與替代方案對比

大數據導出優化：分塊輸出

header('Content-Type: application/vnd.ms-excel; charset=utf-8');
header('Content-Disposition: attachment; filename="big_export.xls"');

// 表頭
echo '<table border="1"><thead><tr><th>ID</th><th>Name</th></tr></thead><tbody>';

$pdo = new PDO(...);
$stmt = $pdo->query('SELECT id, name FROM huge_table');
$stmt->setFetchMode(PDO::FETCH_ASSOC);

while ($row = $stmt->fetch()) {
    echo '<tr><td>' . htmlspecialchars($row['id']) . '</td>';
    echo '<td>' . htmlspecialchars($row['name']) . '</td></tr>';
    // 定期 flush 避免記憶體峰值
    if (($row['id'] % 1000) === 0) flush();
}

echo '</tbody></table>';

最佳實踐清單

1. 文件編碼 UTF-8 無 BOM + Header charset=utf-8；
2. 資料庫連接 utf8mb4；
3. 所有動態內容 htmlspecialchars()；
4. 超過 5000 行或需多工作表 → PhpSpreadsheet/Spout；
5. 超過 5 萬行 → fputcsv/Spout 流式；
6. 提供下載鏈接頁面而非直接觸發，便於用戶重試。

HTML Table 導出是「瑞士軍刀」：簡單場景極其高效，複雜場景及時換工具。