使用fputcsv 保存CSV 文件時，如何控製文件編碼格式避免亂碼問題？

M66 2025-06-22

1. fputcsv函數簡介

PHP 中的fputcsv函數用於將一個數組數據寫入到CSV 文件中，它是處理CSV 文件生成和寫入的常用函數。 fputcsv的基本語法如下：

 fputcsv($file, $fields, $delimiter = ',', $enclosure = '"', $escape_char = '\\');

其中，參數$file是文件句柄， $fields是要寫入的數組， $delimiter是分隔符，默認是逗號， $enclosure是圍繞字段的字符，默認為雙引號， $escape_char是轉義字符。

2. 常見亂碼問題

當我們在多種操作系統（如Windows 和Linux）中打開CSV 文件時，可能會遇到亂碼問題。這是由於不同操作系統和應用程序使用的默認字符編碼不一致導致的。例如，Windows 默認使用GBK 或者Windows-1252 編碼，而Linux 和macOS 更常用UTF-8 編碼。

3. 控制編碼格式的策略

3.1 使用mb_convert_encoding轉換編碼

為了確保文件在不同環境中都能夠正確顯示，我們可以在使用fputcsv寫入數據之前，使用mb_convert_encoding函數將數據編碼轉換為統一的編碼格式，通常推薦使用UTF-8 編碼。

 // 假設數據是中文
$data = ['姓名', '年齡', '城市'];
$data = array_map(function($value) {
    return mb_convert_encoding($value, 'UTF-8', 'auto'); // 自動識別並轉換為 UTF-8
}, $data);

$file = fopen('output.csv', 'w');
fputcsv($file, $data);
fclose($file);

這種方法確保了CSV 文件中每一列的內容都採用UTF-8 編碼，從而避免了亂碼問題。

3.2 設置BOM 頭以支持UTF-8 編碼

UTF-8 編碼的文件有時會被某些程序（如Excel）錯誤地識別為ANSI 編碼。為了解決這個問題，可以在文件的開頭添加UTF-8 的BOM（字節順序標記）。這樣可以確保文件在Excel 中正確顯示。

 $file = fopen('output.csv', 'w');

// 添加 BOM 頭
fwrite($file, "\xEF\xBB\xBF");

$data = ['姓名', '年齡', '城市'];
fputcsv($file, $data);

fclose($file);

3.3 修改Excel 的默認編碼

在某些情況下，我們可以直接設置Excel 打開CSV 文件時的編碼方式。雖然這種方法不一定適用所有場景，但它是解決亂碼問題的一個備選方案。可以通過在CSV 文件的URL 中指定編碼格式來實現：

 $fileUrl = 'http://m66.net/downloads/csv/output.csv';

當然，這種方法適用於文件以URL 形式直接下載時，用戶在下載過程中指定了編碼方式。

3.4 強制輸出為特定編碼格式

有時候，我們需要將CSV 文件導出為指定的編碼格式（如GBK）。可以在寫入之前將每一行的數據通過mb_convert_encoding轉換為目標編碼格式。

 $data = ['姓名', '年齡', '城市'];
$data = array_map(function($value) {
    return mb_convert_encoding($value, 'GBK', 'UTF-8'); // 將 UTF-8 轉為 GBK
}, $data);

$file = fopen('output.csv', 'w');
fputcsv($file, $data);
fclose($file);

這種方式適合在中國地區的Windows 系統中使用，防止因Excel 默認使用GBK 編碼而導致的亂碼。

4. 總結

在使用PHP 的fputcsv函數時，遇到編碼問題是一個常見的挑戰。通過控製文件編碼格式，確保文件在不同系統和應用程序中正確顯示，避免亂碼，可以使用以下幾種方法：

使用mb_convert_encoding將數據轉換為統一的編碼格式。
添加UTF-8 BOM 頭，以確保Excel 正確識別UTF-8 編碼。
根據需要選擇不同的字符編碼，如GBK，來適配不同的操作系統。
在URL 中直接指定編碼方式（例如m66.net ）來規避部分兼容性問題。

通過這些技巧，可以在導出CSV 文件時避免亂碼問題，提升用戶體驗。