萬盛學電腦網

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

PHP 讀取 CSV 文件完整指南:fgetcsv、SplFileObject、大文件流式處理、編碼轉換

基礎:fgetcsv (最常用)

$file = 'data.csv';
$handle = fopen($file, 'r');
if (!$handle) die("無法打開文件");

// 可選:讀取標題行
$header = fgetcsv($handle);
if ($header) {
    // 標準化鍵名
    $header = array_map(fn($h) => strtolower(trim($h)), $header);
}

while (($row = fgetcsv($handle)) !== false) {
    if ($header) $row = array_combine($header, $row);
    // 處理 $row
    print_r($row);
}
fclose($handle);

進階:SplFileObject (OO、可迭代、自動實現 Iterator)

$file = new SplFileObject('data.csv');
$file->setFlags(
    SplFileObject::READ_CSV |
    SplFileObject::READ_AHEAD |     // 預讀下一行
    SplFileObject::SKIP_EMPTY |     // 跳過空行
    SplFileObject::DROP_NEW_LINE    // 去除換行符
);
$file->setCsvControl(','); // 分隔符,默認逗號

foreach ($file as $row) {
    // $row 已是數組
    print_r($row);
}
// 自動關閉文件句柄

大文件流式處理 (內存安全)

  • 不要 file($file) 或 file_get_contents() 整文件讀入內存。
  • 要 使用 fopen + fgetcsv 或 SplFileObject 逐行處理。
  • 分批入庫:累積 500-1000 條批次 INSERT,或使用 LOAD DATA INFILE (MySQL) / COPY (PostgreSQL) 極速導入。

編碼轉換 (GBK/GB2312 → UTF-8)

function convertCsvEncoding(string $inputFile, string $outputFile, string $from = 'GBK', string $to = 'UTF-8') {
    $in = fopen($inputFile, 'r');
    $out = fopen($outputFile, 'w');
    while (($row = fgetcsv($in)) !== false) {
        $row = array_map(fn($cell) => mb_convert_encoding($cell, $to, $from), $row);
        fputcsv($out, $row);
    }
    fclose($in);
    fclose($out);
}

CSV 寫入 (fputcsv)

$data = [
    ['id', 'name', 'email'],
    [1, '張三', 'zhang@example.com'],
    [2, '李四', 'li@example.com'],
];
$fp = fopen('export.csv', 'w');
// 可選:寫入 BOM 讓 Excel 正確識別 UTF-8
fwrite($fp, "\xEF\xBB\xBF");
foreach ($data as $row) {
    fputcsv($fp, $row);
}
fclose($fp);

常見坑點

問題原因解決
中文亂碼文件編碼非 UTF-8mb_convert_encoding / iconv 轉碼,或打開文件時指定編碼 (PHP 8.1+ fopen($file, 'r', context: stream_context_create(['encoding'=>'GBK'])))
字段包含逗號/換行/引號CSV 規範要求雙引號包裹、雙引號轉義fputcsv 自動處理;手動拼接極易出錯
fgetcsv 返回 false 但非 EOF行過長超過默認 0 (無限制) 或 包含 NUL 字符設置長度參數 fgetcsv($fp, 10000),預處理移除 NUL
Excel 打開科學計數法/截斷Excel 自動格式化字段前加 \t 或 ' 強制文本,或改用 XLSX (PhpSpreadsheet)

結語

fgetcsv + SplFileObject 是 PHP 處理 CSV 的標準組合。**大文件必須流式讀寫、編碼統一轉 UTF-8、寫入加 BOM 兼容 Excel**。複雜導入導出場景建議引入 Box/Spout 或 PhpSpreadsheet (功能全但內存大)。

copyright © 萬盛學電腦網 all rights reserved