PHP 生成 TXT 文件到指定目錄：fopen vs file_put_contents 實戰對比

PHP 生成 TXT 文件到指定目錄：fopen vs file_put_contents 實戰對比

將數據導出為文本文件是常見需求：日志歸檔、報表導出、接口調試存檔。PHP 提供底層 fopen/fwrite/fclose 流式操作與高層 file_put_contents 一鍵寫入，本文對比兩者優劣與適用場景。

方法一：fopen 流式寫入 (適合大文件/邊生成邊寫)

<?php
$path = 'c:/export/data_' . date('Ymd_His') . '.txt';

// 打開模式：a=追加寫入(指針尾部)，w=覆蓋寫入(指針頭部，截斷)
// a+ / w+ 同時可讀
$fp = fopen($path, 'a') or die("無法打開文件: $path");

// 模擬導出 GET/POST 參數
$data = [];
foreach (['_GET', '_POST'] as $super) {
    foreach ($GLOBALS[$super] as $k => $v) {
        $data[] = "[$k]=>$v";
    }
}
$data[] = '---END---';

// 寫入 (可分多次 fwrite，內存常數)
foreach ($data as $line) {
    fwrite($fp, $line . PHP_EOL);
}

fclose($fp);
echo "導出完成: $path";

關鍵模式對比

進階：鎖機制防併發亂序

$fp = fopen($path, 'a');
if (flock($fp, LOCK_EX)) {        // 獨佔鎖
    fwrite($fp, $data);
    fflush($fp);                  // 強制刷新到磁盤
    flock($fp, LOCK_UN);
} else {
    // 獲取鎖失敗：重試/排隊/丟棄
}
fclose($fp);

方法二：file_put_contents 一鍵寫入 (適合中小文件/原子寫入)

<?php
$path = 'c:/export/simple.txt';
$content = "導出時間: " . date('c') . PHP_EOL;
$content .= "GET: " . json_encode($_GET, JSON_UNESCAPED_UNICODE) . PHP_EOL;
$content .= "POST: " . json_encode($_POST, JSON_UNESCAPED_UNICODE) . PHP_EOL;

// 旗標組合：
// FILE_APPEND      = 追加模式 (默認覆蓋)
// LOCK_EX          = 寫入期間獨佔鎖 (防併發)
// FILE_TEXT        = 文本模式 (Windows 換行符轉換)
file_put_contents($path, $content, FILE_APPEND | LOCK_EX);

原子寫入模式 (防止讀到半寫文件)

$tmp = $path . '.tmp.' . uniqid();
file_put_contents($tmp, $content, LOCK_EX);
rename($tmp, $path); // rename 在同一文件系統原子性

性能與選型決策表

目錄權限與安全檢查清單

• is_writable(dirname($path)) 確保目錄可寫。
• 生產環境禁用 Web 根目錄下寫入，使用 /var/www/data/、/tmp/、/data/export/ 等非公開目錄。
• 文件名含用戶輸入時：basename() + 白名單字符 + random_bytes() 前綴，防目錄遍歷。
• 定期清理：Crontab find /data/export -mtime +30 -delete。

總結

• 日常 90% 場景：file_put_contents($path, $data, FILE_APPEND | LOCK_EX) 最簡潔安全。
• 大文件/流式/長連接：fopen('a') + flock + 分塊 fwrite。
• 關鍵數據：臨時文件 + rename 實現原子替換，讀端永遠見完整文件。

選對工具，讓文件導出既簡單又可靠。