萬盛學電腦網

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

PHP 文本文件轉 CSV 輸出類(固定寬度解析)

固定寬度文本文件(如銀行對賬單、主機導出數據)需轉為 CSV 導入數據庫或分析。本文提供一個繼承 SplFileObject 的 Fixed2CSV 類,支援自定義字段位置/寬度、分隔符、行尾符,並可選擇性輸出指定字段,內存效率高。

類設計

class Fixed2CSV extends SplFileObject {
    private $fields = [];      // [startPos => width, ...]
    private $separator = ',';
    private $eol = "\n";

    public function __set($name, $value) {
        if (in_array($name, ['fields','separator','eol'])) $this->$name = $value;
        else throw new Exception("Unknown property: $name");
    }
    public function __get($name) {
        if (in_array($name, ['fields','separator','eol'])) return $this->$name;
        throw new Exception("Unknown property: $name");
    }

    // 核心:重寫 current() 將固定寬度行轉為 CSV
    public function current() {
        $line = parent::current();
        if ($line === false) return false;

        $csv = '';
        $fieldsIter = new CachingIterator(new ArrayIterator($this->fields));
        foreach ($fieldsIter as $start => $width) {
            $csv .= trim(substr($line, $start, $width));
            $csv .= $fieldsIter->hasNext() ? $this->separator : $this->eol;
        }
        return $csv;
    }
}

使用示例

try {
    // 文件每行固定寬度:0-9(10字符) | 10-24(15字符) | 25-44(20字符) | 45-69(25字符)
    $file = new Fixed2CSV('data/fixed_width.txt');
    $file->fields = [0=>10, 10=>15, 25=>20, 45=>25];
    $file->separator = ',';
    $file->eol = "\n";

    echo "完整輸出:\n";
    foreach ($file as $line) echo $line;

    // 僅導出第 1、3 字段
    $file2 = new Fixed2CSV('data/fixed_width.txt');
    $file2->fields = [0=>10, 25=>20];
    echo "\n僅導出字段 1 和 3:\n";
    foreach ($file2 as $line) echo $line;

} catch (Exception $e) {
    echo '錯誤:' . $e->getMessage();
}

關鍵特性

  • 繼承 SplFileObject:自動實現 Iterator、SeekableIterator、Countable,支援 foreach、seek()、count(),逐行讀取內存常駐極低。
  • 靈活字段選擇:$fields 陣列鍵為起始位置(0 基),值為寬度,可任意組合、跳過字段。
  • 自定義分隔符/行尾:支援 CSV(,)、TSV(\t)、自定義字符,行尾支援 \n/\r\n。
  • 異常處理:屬性訪問攔截,拋出明確異常。

應用場景

  • 銀行/金融固定格式對賬文件導入數據庫
  • 大型機/舊系統導出數據遷移
  • 日誌文件結構化解析
  • ETL 數據清洗預處理

擴展建議

  • 增加 setEncoding($from, $to) 支援字符集轉換(如 GBK→UTF-8)。
  • 增加 skipLines($n) 跳過文件頭說明行。
  • 增加 validateLine($line) 鉤子,過濾不符合格式的髒數據。
  • 輸出直接流式寫入文件/數據庫,避免大文件內存峰值。

利用 SPL 迭代器特性,Fixed2CSV 以極少代碼實現了高效、靈活的固定寬度轉 CSV,是數據遷移與集成項目中的得力工具。

copyright © 萬盛學電腦網 all rights reserved