PHP 文件讀寫與內容替換完整實戰指南

前言

文件操作是 PHP 後端開發基礎技能：日誌記錄、配置管理、模板渲染、靜態化生成、數據導入導出等場景無處不在。本文系統梳理 fopen 模式、讀取寫入函數、指針控制、鎖機制、編碼陷阱，並提供可直接用於生產的封裝函數。

核心函數速查

fopen 模式完整對照表

**二進制安全**：Windows 下建議加 b 後綴（如 rb、wb），避免 \r\n 轉換導致位置偏移。

實戰範例：安全寫入、讀取替換、追加日誌

1. 原子性寫入（避免半寫損壞）

<?php
function safeWrite(string $path, string $data): bool {
    $dir = dirname($path);
    if (!is_dir($dir)) mkdir($dir, 0755, true);
    
    $tmp = $path . '.tmp.' . random_bytes(8);
    $fp = fopen($tmp, 'wb');
    if (!$fp) return false;
    
    if (flock($fp, LOCK_EX)) {
        $written = fwrite($fp, $data);
        flock($fp, LOCK_UN);
        fclose($fp);
        if ($written === false || $written !== strlen($data)) {
            @unlink($tmp);
            return false;
        }
        return rename($tmp, $path); // 原子替換
    }
    fclose($fp);
    @unlink($tmp);
    return false;
}
?>

2. 逐行讀取並替換（大文件記憶體友好）

<?php
function replaceInFile(string $path, string $search, string $replace): bool {
    $tmp = $path . '.replace.tmp';
    $rfp = fopen($path, 'rb');
    $wfp = fopen($tmp, 'wb');
    if (!$rfp || !$wfp) { @fclose($rfp); @fclose($wfp); @unlink($tmp); return false; }
    
    while (($line = fgets($rfp)) !== false) {
        fwrite($wfp, str_replace($search, $replace, $line));
    }
    fclose($rfp);
    fclose($wfp);
    return rename($tmp, $path);
}
?>

3. 高併發日誌追加（非阻塞鎖 + 旋轉）

<?php
function appendLog(string $logDir, string $message, int $maxSize = 10*1024*1024): void {
    $date = date('Y-m-d');
    $file = $logDir . "/app_{$date}.log";
    if (!is_dir($logDir)) mkdir($logDir, 0755, true);
    
    // 日誌輪轉
    if (file_exists($file) && filesize($file) > $maxSize) {
        $rotate = $logDir . "/app_{$date}_" . time() . ".log";
        rename($file, $rotate);
    }
    
    $fp = fopen($file, 'ab'); // 追加二進制
    if (!$fp) return;
    
    // 非阻塞獨佔鎖，獲取失敗直接丟棄（日誌允許丟失極少量）
    if (flock($fp, LOCK_EX | LOCK_NB)) {
        fwrite($fp, date('c') . " {$message}\n");
        flock($fp, LOCK_UN);
    }
    fclose($fp);
}
?>

常見坑與避雷指南

現代替代：SplFileObject 物件導向封裝

<?php
// 逐行遍歷
$file = new SplFileObject('data.csv');
$file->setFlags(SplFileObject::READ_CSV);
foreach ($file as $row) {
    // $row 已解析為陣列
}

// 寫入
$file = new SplFileObject('output.txt', 'w');
$file->fwrite("第一行\n");
$file->fwrite("第二行\n");
// 自動 fclose
?>

優點：自動資源管理、內建 CSV 解析、可迭代、支援 seek() 隨機訪問。

結語

PHP 文件操作看似基礎，實則蘊含「模式選擇、鎖策略、編碼處理、大文件流式處理、原子性寫入」等工程細節。掌握 fopen 全模式、善用 flock、避開 file_get_contents 大文件陷阱、採用臨時文件+重命名實現原子寫入，是從「能跑通」到「生產可靠」的關鍵躍升。