當以 UTF-8 輸出 CSV 供中文環境 Excel 開啟時,若缺少 BOM(Byte Order Mark),Excel 會預設用 ANSI/GBK 解碼導致亂碼。本文示範在 PHP 下載流中自動加入 BOM 的實作。
Windows 記事本將文字檔另存為 UTF-8 時,會在檔頭插入三個不可見字元 EF BB BF(十六進位),即 BOM。系統偵測到 BOM 即判定為 UTF-8 編碼。
<?php
$filename = "export.csv";
header('Expires: ' . gmdate('D, d M Y H:i:s', $_SERVER['REQUEST_TIME'] + 10) . ' GMT');
header('Cache-Control: max-age=10');
header('Content-Type: text/csv; charset=utf-8');
header("Content-Disposition: attachment; filename={$filename}");
// 輸出 BOM:\xEF\xBB\xBF
$out = "\xEF\xBB\xBF";
// 若有提示訊息置於第一行
if (!empty($extra['notice'])) {
$out .= "{$extra['notice']}\r\n";
}
// 逐行輸出資料
foreach ($table as $row) {
$out .= implode(",", $row) . "\r\n";
}
// 若需轉碼可取消註解
// if (mb_detect_encoding($out) == 'UTF-8') {
// $out = iconv("UTF-8//IGNORE", "GBK", $out);
// }
echo $out;
?>
\xEF\xBB\xBF。Content-Type 宣告 charset=utf-8。\r\n 相容 Excel。此法可確保中文 Excel 直接開啟 CSV 時正確識別編碼,免去使用者手動匯入設定的麻煩。