PHP 高效讀寫大文件指定行：fseek 與 SplFileObject 實戰技巧

場景痛點

處理大型日誌或數據文件時，若需修改特定行內容，逐行讀入內存再寫回不現實。PHP 提供文件指針操作函數（fseek、fgets、fwrite）及 SPL 的 SplFileObject，可實現隨機存取與就地修改。

基於文件指針的就地修改

<?php
$fp = fopen('d:/file.txt', 'r+'); // 讀寫模式打開
if ($fp) {
    $i = 1;
    while (!feof($fp)) {
        // 目標：修改第 2 行
        if ($i == 2) {
            // 關鍵：fgets 讀取後指針指向行尾（即下一行開頭）
            // 若要修改第 2 行自身，需在 fgets 前定位
            fseek($fp, 2, SEEK_CUR); // 相對當前位置偏移 2 字節
            fwrite($fp, '#');        // 覆蓋寫入（非插入）
            break;
        }
        fgets($fp); // 讀取一行，指針移至下一行開頭
        $i++;
    }
    fclose($fp);
}
?>

關鍵細節解析

• 模式 r+：以讀寫方式打開，指針初始位於文件開頭，文件必須存在。
• fgets() 指針行為：讀取一行後，指針停留在該行結尾的換行符後（即下一行開頭）。
• fwrite() 覆蓋特性：寫入時從當前指針位置開始覆蓋原有字節，而非插入。若寫入內容長度超過原有行剩餘長度，會繼續覆蓋後續內容。
• fseek() 定位：SEEK_CUR 相對當前位置偏移；SEEK_SET 相對文件開頭；SEEK_END 相對文件末尾。

插入操作的替代方案

因 fwrite 為覆蓋模式，若需插入內容（如在行中間插入字符），需採用臨時文件法：

1. 打開原文件讀取，創建臨時文件寫入。
2. 逐行讀取，寫入臨時文件；到達目標行時，寫入修改後的內容。
3. 處理完畢，用臨時文件替換原文件（rename() 原子操作）。

此法雖需額外 I/O，但能保證數據完整性，適用於大文件插入/刪除行場景。

SplFileObject 面向對象封裝

PHP 5.1+ 引入 SPL，SplFileObject 提供更豐富的介面：

<?php
$fp = new SplFileObject('d:/file.txt', 'r+');
// seek(1) 移至第 2 行（索引從 0 起），指針指向行尾
$fp->seek(1);
$line = $fp->current(); // 獲取第 2 行內容
// 操作第 3 行（指針當前在行尾）
$fp->fseek(2, SEEK_CUR);
$fp->fwrite('#');
?>

優勢特性

• 迭代器介面：可直接 foreach ($file as $line) 遍歷，自動處理換行。
• 關鍵字/值存取：key() 返回行號，current() 返回行內容。
• 內建 CSV 解析：fgetcsv() 直接解析 CSV 格式。
• 靈活定位：seek()、fseek()、rewind() 多種定位方式。

性能與選型建議

結語

掌握文件指針操作與 SplFileObject，能高效解決大文件隨機讀寫需求。核心原則：理解指針移動語義，區分覆蓋與插入，選擇恰當策略。