在 PHP 開發中,將資料匯出為 CSV 格式是常見需求。本文將詳細說明如何使用 PHP 內建函數 fputcsv() 將資料寫入 CSV 檔案,並搭配 fgetcsv() 讀取現有 CSV 進行資料轉換與重組。
<?php
$row = 0;
ini_set('max_execution_time', 300); // 設定執行時間上限 300 秒
$cate = $item = $value = $us = '';
// 開啟輸出檔案(寫入模式)
$fp = fopen("torah1.csv", "w");
// 開啟來源檔案(讀取模式)
if (($handle = fopen("t.csv", "r")) !== FALSE) {
while (($data = fgetcsv($handle, 1000, ",")) !== FALSE) {
$num = count($data);
$row++;
// 解析每一欄位
for ($c = 0; $c < $num; $c++) {
if ($c == 0) {
$us = $data[$c];
} elseif ($c == 1) {
$item = explode(" ", $data[$c]);
echo "<pre>";
print_r($item);
} elseif ($c == 2) {
$value = $data[$c];
} elseif ($c == 3) {
$cate1 = $data[$c];
}
}
// 限制處理筆數(除錯用)
if ($row > 1838) {
exit;
}
// 寫入重組後的資料
fputcsv($fp, array($us, $item[0], $item[1], $item[2], $item[3]));
}
fclose($handle);
}
fclose($fp);
?>
fgetcsv(handle, length, delimiter, enclosure, escape)handle:由 fopen() 開啟的檔案指標length:單行最大長度(建議設定較大值避免截斷)delimiter:分隔符號(預設為逗號)enclosure:包圍字元(預設為雙引號)escape:跳脫字元(預設為反斜線)FALSEfputcsv(handle, fields, delimiter, enclosure, escape)fields 格式化為 CSV 行並寫入檔案FALSE中文環境建議在寫入前轉換編碼:
$row = array_map(function($val) {
return mb_convert_encoding($val, 'BIG-5', 'UTF-8');
}, $row);
fputcsv($fp, $row);
// 避免記憶體耗盡,分批寫入
$batchSize = 1000;
$buffer = [];
foreach ($dataSource as $row) {
$buffer[] = $row;
if (count($buffer) >= $batchSize) {
foreach ($buffer as $line) {
fputcsv($fp, $line);
}
$buffer = [];
}
}
// 寫入剩餘資料
foreach ($buffer as $line) {
fputcsv($fp, $line);
}
// 在寫入資料前加入 UTF-8 BOM fwrite($fp, "\xEF\xBB\xBF");
| 問題 | 原因 | 解決方法 |
|---|---|---|
| 中文顯示亂碼 | 編碼不匹配 | 寫入前用 mb_convert_encoding() 轉為 BIG-5 或加入 BOM |
| 欄位內含逗號導致欄位錯位 | 未正確包圍 | fputcsv() 會自動處理,確保正確使用 |
| 大檔案寫入超時 | 執行時間限制 | 調整 ini_set('max_execution_time') 或分批處理 |
| 記憶體不足 | 一次讀入過多資料 | 使用 fgetcsv() 逐行讀取,避免 file() 一次載入全部 |
!== FALSE 嚴格比較fclose() 釋放資源try-catch 或檢查回傳值league/csv 提供更豐富功能PHP 內建的 fgetcsv() 和 fputcsv() 提供了高效、可靠的 CSV 處理能力。掌握這些函數的正確用法,並注意編碼、記憶體與錯誤處理,即可輕鬆實現各類 CSV 匯入匯出需求。實務上建議根據資料量選擇適當策略,必要時引入成熟套件以簡化開發。