萬盛學電腦網

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

PHP 導出 Word 與 Excel 文件:原生 Header 方案與身份證號科學計數法避坑指南

原生 Header 導出基礎方案

無需第三方庫(如 PhpSpreadsheet),利用瀏覽器對 MIME 類型的識別,直接輸出 HTML/表格標記,Office 兼容打開:

導出 Word (.doc)

<?php
header("Content-Type: application/msword");
header("Content-Disposition: attachment; filename=\"報告.doc\"");
header("Cache-Control: max-age=0");
// 輸出 HTML 內容,Word 會自動渲染
echo '<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word">';
echo '<head><meta charset="UTF-8"></head><body>';
echo '<h1>導出報告標題</h1>';
echo '<p>這是段落內容,支援 <b>粗體</b>、<table><tr><td>表格</td></tr></table> 等 HTML 標記。</p>';
echo '</body></html>';
?>

導出 Excel (.xls)

<?php
header("Content-Type: application/vnd.ms-excel");
header("Content-Disposition: attachment; filename=\"數據統計.xls\"");
header("Cache-Control: max-age=0");
// 輸出 HTML 表格
echo '<table border="1">';
echo '<tr><th>姓名</th><th>身份證號</th><th>金額</th></tr>';
echo '<tr><td>張三</td><td>110101199001011234</td><td>1000.00</td></tr>';
echo '</table>';
?>

經典坑:身份證號/長數字變科學計數法

現象:Excel 自動將 18 位身份證號識別為數字,顯示為 1.10101E+17,格式刷「文本」也無效(因文件打開時已自動轉型)。

根因

Excel 打開 HTML 表格時,對純數字單元格自動推斷為數值類型,超過 11 位即轉科學計數法。

三種解決方案(按推薦度排序)

方案一:前綴製表符 \t(最簡單、最兼容)

<?php
$id = '110101199001011234';
echo "<td>\t{$id}</td>"; // \t 強制 Excel 識別為文本
?>

原理:\t 使單元格內容以非數字字符開頭,Excel 判定為文本,**不顯示製表符**,完美解決。

方案二:CSS 樣式 mso-number-format:\@(Office 專屬)

<td style="mso-number-format:'\@';">110101199001011234</td>

優點:語義明確;缺點:僅 Office 支援,WPS/LibreOffice 可能無效。

方案三:前綴單引號 '(傳統做法)

<td>'110101199001011234</td>

缺點:單引號**會顯示**在單元格中,影響美觀與後續數據處理。

完整導出 Excel 代碼範例(含身份證號修正)

<?php
header("Content-Type: application/vnd.ms-excel; charset=UTF-8");
header("Content-Disposition: attachment; filename=\"用戶數據_" . date('Ymd') . ".xls\"");
header("Pragma: no-cache");
header("Expires: 0");

$users = [
    ['name' => '張三', 'idcard' => '110101199001011234', 'amount' => 1000.00],
    ['name' => '李四', 'idcard' => '310115198505205678', 'amount' => 2500.50],
];

echo "<table border='1'>";
echo "<tr><th>姓名</th><th>身份證號</th><th>金額</th></tr>";
foreach ($users as $u) {
    echo "<tr>";
    echo "<td>{$u['name']}</td>";
    // 核心修正:\t 前綴
    echo "<td>\t{$u['idcard']}</td>";
    echo "<td>{$u['amount']}</td>";
    echo "</tr>";
}
echo "</table>";
?>

進階:中文文件名跨瀏覽器兼容

<?php
$filename = "報表_" . date('Ymd') . ".xls";
$ua = $_SERVER['HTTP_USER_AGENT'];
if (preg_match('/MSIE|Trident|Edge/', $ua)) {
    // IE/Edge: URL 編碼
    $filename = urlencode($filename);
} elseif (preg_match('/Firefox/', $ua)) {
    // Firefox: RFC 5987 encoding
    $filename = "utf-8''" . rawurlencode($filename);
} else {
    // Chrome/Safari/現代瀏覽器
    $filename = urlencode($filename);
}
header("Content-Disposition: attachment; filename*=UTF-8''{$filename}; filename=\"{$filename}\"");
?>

局限性與升級建議

維度原生 Header 方案PhpSpreadsheet / Laravel Excel
依賴零依賴Composer 包
格式豐富度基礎 HTML 表格/樣式完整 Excel 功能(公式、圖表、樣式、合併儲存格)
大數據性能流式輸出極快需啟用 chunkRead/Writer,內存較高
.xlsx 支援不支援(僅 .xls/.doc)完美支援
適用場景簡單報表、臨時導出、無 Composer 環境複雜報表、生產級系統、.xlsx 需求

總結

原生 Header 導出是「輕量級武器」:零依賴、極速、支援流式輸出。核心避坑點在於**長數字文本化**,推薦使用 \t 前綴方案(不顯示、兼容性最好)。對於複雜報表、.xlsx 格式、樣式精細控制,請引入 PhpSpreadsheet 或 Laravel Excel 專業庫。

copyright © 萬盛學電腦網 all rights reserved