萬盛學電腦網

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

PHP 寫入資料到 CSV 檔案的完整實作指南

前言

在 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() - 讀取 CSV 檔案

  • 語法:fgetcsv(handle, length, delimiter, enclosure, escape)
  • 參數說明:
    • handle:由 fopen() 開啟的檔案指標
    • length:單行最大長度(建議設定較大值避免截斷)
    • delimiter:分隔符號(預設為逗號)
    • enclosure:包圍字元(預設為雙引號)
    • escape:跳脫字元(預設為反斜線)
  • 回傳陣列包含該行各欄位,若到達檔案結束則回傳 FALSE

fputcsv() - 寫入 CSV 檔案

  • 語法:fputcsv(handle, fields, delimiter, enclosure, escape)
  • 將陣列 fields 格式化為 CSV 行並寫入檔案
  • 自動處理包含分隔符、換行符或包圍字元的欄位值
  • 成功回傳寫入的字元數,失敗回傳 FALSE

進階應用技巧

1. 編碼處理

中文環境建議在寫入前轉換編碼:

$row = array_map(function($val) {
    return mb_convert_encoding($val, 'BIG-5', 'UTF-8');
}, $row);
fputcsv($fp, $row);

2. 大量資料分批處理

// 避免記憶體耗盡,分批寫入
$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);
}

3. 加入 BOM 標記(Excel 相容性)

// 在寫入資料前加入 UTF-8 BOM
fwrite($fp, "\xEF\xBB\xBF");

常見問題與解決方案

問題原因解決方法
中文顯示亂碼編碼不匹配寫入前用 mb_convert_encoding() 轉為 BIG-5 或加入 BOM
欄位內含逗號導致欄位錯位未正確包圍fputcsv() 會自動處理,確保正確使用
大檔案寫入超時執行時間限制調整 ini_set('max_execution_time') 或分批處理
記憶體不足一次讀入過多資料使用 fgetcsv() 逐行讀取,避免 file() 一次載入全部

最佳實務建議

  1. 永遠檢查檔案開啟結果:使用 !== FALSE 嚴格比較
  2. 妥善關閉檔案控制代碼:使用 fclose() 釋放資源
  3. 錯誤處理:搭配 try-catch 或檢查回傳值
  4. 測試資料完整性:匯出後用 Excel 或文字編輯器驗證
  5. 考慮使用套件:如 league/csv 提供更豐富功能

總結

PHP 內建的 fgetcsv() 和 fputcsv() 提供了高效、可靠的 CSV 處理能力。掌握這些函數的正確用法,並注意編碼、記憶體與錯誤處理,即可輕鬆實現各類 CSV 匯入匯出需求。實務上建議根據資料量選擇適當策略,必要時引入成熟套件以簡化開發。

copyright © 萬盛學電腦網 all rights reserved