讀取文字檔並輸出內容是 PHP 開發的基礎操作。依據檔案大小、記憶體限制與效能需求,可採用 fopen() 逐行讀取、file_get_contents() 一次性讀取、或 file() 轉陣列等不同策略。本文將逐一解析各方法優劣與適用場景,並提供最佳實踐建議。
feof() 判斷結尾,流程清晰。<?php
$filePath = __DIR__ . '/data/large_log.txt';
$handle = fopen($filePath, 'rb'); // 二進位模式跨平台相容
if ($handle === false) {
throw new RuntimeException("無法開啟檔案:$filePath");
}
while (($line = fgets($handle)) !== false) {
// 即時處理:去除換行、過濾、寫入 DB 等
echo rtrim($line, "\r\n") . '<br>';
}
fclose($handle);
?>
$handle = fopen($filePath, 'rb', false, null, 8192); // 8KB 緩衝
// 或使用 stream_set_chunk_size($handle, 16384);
<?php
$path = __DIR__ . '/config/settings.json';
if (!file_exists($path)) {
exit("檔案不存在:$path");
}
$content = @file_get_contents($path); // @ 抑制警告,自行判斷 false
if ($content === false) {
exit("讀取失敗:$path");
}
echo $content;
// 或解析 JSON
$config = json_decode($content, true);
?>
讀取 500MB 檔案會瞬間佔用 500MB+ 記憶體,易觸發 memory_limit 錯誤。生產環境嚴禁用於大檔。
<?php
$lines = file($filePath, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
foreach ($lines as $lineNum => $line) {
echo "第 $lineNum 行:$line<br>";
}
?>
本質:內部仍呼叫 fopen() 逐行讀取並建立陣列,記憶體佔用與 file_get_contents() 相近,不適合大檔。
<?php
$file = new SplFileObject(__DIR__ . '/data/users.csv');
$file->setFlags(
SplFileObject::READ_CSV |
SplFileObject::READ_AHEAD |
SplFileObject::SKIP_EMPTY |
SplFileObject::DROP_NEW_LINE
);
foreach ($file as $row) {
// $row 已自動切割為陣列
printf("ID: %s, Name: %s, Email: %s<br>", $row[0], $row[1], $row[2]);
}
?>
Iterator,可直接 foreach、array_map、filter。fseek()、rewind() 隨機存取。| 檔案大小 | fopen+fgets | file_get_contents | file() | SplFileObject |
|---|---|---|---|---|
| 10 MB | ~2 MB 峰值 | ~12 MB | ~14 MB | ~3 MB |
| 100 MB | ~2 MB 峰值 | ~120 MB ⚠️ | ~130 MB ⚠️ | ~3 MB |
| 1 GB | ~2 MB 峰值 | OOM 💥 | OOM 💥 | ~3 MB |
fopen() + fgets() 或 SplFileObject。file_get_contents() 最簡潔。SplFileObject::READ_CSV 一步到位。try-catch 或檢查回傳值,避免 @ 掩蓋真實問題。mb_convert_encoding() 或 iconv() 轉碼。選對檔案讀取策略,不僅能避免記憶體溢位,更能簡化後續業務邏輯。下次面對 storage/logs/laravel-2024-06-01.log 這類百 MB 日誌時,請毫不猶豫選擇 SplFileObject 或 fopen() 逐行處理。