PHP SplFileObject 類高效讀取大檔案完整指南

傳統 fopen/fgets 或 file_get_contents 處理大檔案（百 MB 至 GB 級）易導致記憶體耗盡或超時。PHP 5.1+ 內建 SplFileObject 提供物件導向、記憶體友善、支援隨機存取的大檔案處理方案。

SplFileObject vs 傳統方法

核心方法速查

$file = new SplFileObject('large.log', 'r');

// 定位到指定行 (0-based index)
$file->seek(1000);           // 跳到第 1001 行
echo $file->key();           // 獲取當前行號 (0-based)
echo $file->current();       // 獲取當前行內容
$file->next();               // 移到下一行

// 判斷結尾
if (!$file->eof()) { ... }

// 獲取檔案資訊 (繼承 SplFileInfo)
echo $file->getSize();       // 檔案大小
echo $file->getMTime();      // 修改時間
echo $file->getExtension();  // 副檔名

// CSV 解析
$csv = new SplFileObject('data.csv', 'r');
$csv->setFlags(SplFileObject::READ_CSV);
foreach ($csv as $row) {
    // $row 為陣列 [欄位1, 欄位2, ...]
}

實用函數：讀取指定行範圍 (支援 PHP 5.1+ 與 PHP 4 相容)

<?php
/**
 * 讀取檔案指定行範圍內容
 * @param string $filename 檔案路徑
 * @param int $startLine 起始行號 (1-based)
 * @param int $endLine 結束行號 (1-based)
 * @param string $mode 開啟模式
 * @return array 行內容陣列
 */
function getFileLines($filename, $startLine = 1, $endLine = 50, $mode = 'r') {
    $content = [];
    $count = $endLine - $startLine;
    
    // PHP 5.1+ 使用 SplFileObject
    if (version_compare(PHP_VERSION, '5.1.0', '>=')) {
        $fp = new SplFileObject($filename, $mode);
        $fp->seek($startLine - 1);  // seek 為 0-based
        
        for ($i = 0; $i <= $count; $i++) {
            if ($fp->eof()) break;
            $content[] = $fp->current();
            $fp->next();
        }
    } 
    // PHP 4/5.0 相容模式
    else {
        $fp = fopen($filename, $mode);
        if (!$fp) return ['error' => 'can not read file'];
        
        // 跳過前面的行
        for ($i = 1; $i < $startLine; $i++) {
            if (feof($fp)) break;
            fgets($fp);
        }
        
        // 讀取目標行
        for ($i = $startLine; $i <= $endLine; $i++) {
            if (feof($fp)) break;
            $content[] = fgets($fp);
        }
        fclose($fp);
    }
    
    return array_filter($content);  // 過濾空值
}

// 使用範例：讀取第 35270-35280 行
echo '<pre>';
var_dump(getFileLines('test.php', 35270, 35280));
echo '</pre>';
?>

進階應用：大型 CSV 分批匯入資料庫

<?php
class CsvBatchImporter {
    private $file;
    private $batch_size;
    private $offset;
    
    public function __construct($csv_path, $batch_size = 1000) {
        $this->file = new SplFileObject($csv_path, 'r');
        $this->file->setFlags(SplFileObject::READ_CSV | SplFileObject::SKIP_EMPTY);
        $this->batch_size = $batch_size;
        $this->offset = 0;
    }
    
    public function getNextBatch() {
        $this->file->seek($this->offset);
        $batch = [];
        
        for ($i = 0; $i < $this->batch_size; $i++) {
            if ($this->file->eof()) break;
            $batch[] = $this->file->current();
            $this->file->next();
        }
        
        $this->offset += count($batch);
        return $batch;
    }
    
    public function hasMore() {
        $this->file->seek($this->offset);
        return !$this->file->eof();
    }
    
    public function getTotalLines() {
        // 快速獲取總行數：定位到檔案末尾
        $this->file->seek($this->file->getSize());
        return $this->file->key();
    }
}

// 使用範例
$importer = new CsvBatchImporter('huge_data.csv', 500);
$total = $importer->getTotalLines();
echo "總行數: $total\n";

while ($importer->hasMore()) {
    $batch = $importer->getNextBatch();
    // 這裡執行批次 INSERT
    // $db->insertBatch('table', $batch);
    echo "處理批次: {$importer->offset} / $total\n";
    
    // 避免長時間佔用資料庫連線
    usleep(10000);
}
?>

效能測試參考 (100MB CSV, 100萬行)

注意事項

• seek() 參數為 0-based 索引，第 1 行是 0
• key() 回傳 0-based 行號，顯示時需 +1
• 大檔案 seek() 到末尾獲取行數極快，但會移動指標，後續讀取前需重新 seek()
• Windows 換行符 \r\n 會被正確處理，current() 回傳不含換行符的內容
• 啟用 SplFileObject::SKIP_EMPTY 旗標可自動跳過空行

SplFileObject 是 PHP 核心擴展 (C 實現)，效能遠超純 PHP 迴圈。大檔案處理首選，無需安裝額外擴展。