萬盛學電腦網

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

PHP 文件下載自動添加 BOM 頭解決 CSV 中文亂碼

什麼是 BOM?

BOM(Byte Order Mark)是文件開頭的幾個不可見字節(UTF-8 為 EF BB BF),告訴編輯器/系統「這是 UTF-8 編碼」。Excel 打開 CSV 時,若無 BOM 會按系統默認編碼(中文環境為 GBK)解析,導致中文亂碼。

解決方案:輸出前輸出 BOM

<?php
$filename = "file.csv";

// 設置下載 Header
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 头(關鍵步驟)
$out = "\xEF\xBB\xBF"; // UTF-8 BOM

// 可選:第一行輸出提示信息
if (!empty($extra['notice'])) {
    $out .= "{$extra['notice']}\r\n";
}

// 輸出數據行(假設 $table 為二維數組)
foreach ($table as $row) {
    $out .= implode(",", $row) . "\r\n";
}

echo $out;
exit;

關鍵點說明

  1. BOM 必須在最先輸出,任何空白、echo 都會導致 BOM 不在文件開頭失效。
  2. 編碼一致性:數據本身必須是 UTF-8。若數據源為 GBK,需先 iconv('GBK', 'UTF-8//IGNORE', $data) 轉換。
  3. CSV 字段包含逗號/換行/雙引號:需用雙引號包裹並轉義內部雙引號(str_replace('"', '""', $field)),或使用 fputcsv 寫入臨時文件再輸出。
  4. 大文件流式輸出:避免一次性拼接巨大字符串佔用內存,改用 fopen('php://output', 'w') 逐行 fputcsv。

流式輸出優化版(大數據推薦)

<?php
$filename = "export_".date('YmdHis').".csv";
header('Content-Type: text/csv; charset=utf-8');
header("Content-Disposition: attachment; filename={$filename}");
header('Cache-Control: max-age=0');

$out = fopen('php://output', 'w');
// 寫入 BOM
fwrite($out, "\xEF\xBB\xBF");

// 表頭
fputcsv($out, array('ID', '姓名', '郵箱', '註冊時間'));

// 模擬分批查詢輸出
$pdo = new PDO("mysql:host=localhost;dbname=test;charset=utf8", 'user', 'pass');
$stmt = $pdo->query("SELECT id, name, email, created_at FROM users");
while ($row = $stmt->fetch(PDO::FETCH_NUM)) {
    fputcsv($out, $row);
}
fclose($out);
exit;

總結

「輸出 BOM + UTF-8 編碼 + 正確 Header」是 PHP 導出 Excel 兼容 CSV 的標準三部曲。生產環境請優先使用流式輸出,並做好異常捕獲與日誌記錄。

copyright © 萬盛學電腦網 all rights reserved