萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 讀取檔案內容並輸出顯示的多種實作方式

前言

讀取文字檔並輸出內容是 PHP 開發的基礎操作。依據檔案大小、記憶體限制與效能需求,可採用 fopen() 逐行讀取、file_get_contents() 一次性讀取、或 file() 轉陣列等不同策略。本文將逐一解析各方法優劣與適用場景,並提供最佳實踐建議。

一、fopen() + fgets():逐行串流讀取(低記憶體佔用)

核心優勢

  • 適合大型檔案(GB 級),單次只載入一行到記憶體。
  • 可精確控制讀取邏輯(跳過特定行、即時處理)。
  • 搭配 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);

二、file_get_contents():一次性讀取(程式碼最簡潔)

適用場景

  • 小型檔案(< 10MB),記憶體充裕。
  • 需對完整內容做正則、JSON 解析等全域操作。

安全寫法(檢查存在、錯誤抑制)

<?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 錯誤。生產環境嚴禁用於大檔。

三、file():直接轉陣列(逐行處理的語法糖)

<?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() 相近,不適合大檔。

四、SplFileObject:物件導向的現代選擇(PHP 5.1+)

<?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]);
}
?>

優勢

  • 內建 CSV 解析、跳過空行、移除換行符。
  • 實作 Iterator,可直接 foreach、array_map、filter。
  • 支援 fseek()、rewind() 隨機存取。

五、效能與記憶體實測對照(參考值)

檔案大小fopen+fgetsfile_get_contentsfile()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

六、最佳實踐總結

  1. 大檔/串流/記憶體敏感 → fopen() + fgets() 或 SplFileObject。
  2. 小檔/需全文處理 → file_get_contents() 最簡潔。
  3. CSV/TSV 結構化資料 → SplFileObject::READ_CSV 一步到位。
  4. 錯誤處理:統一用 try-catch 或檢查回傳值,避免 @ 掩蓋真實問題。
  5. 編碼處理:讀取非 UTF-8 檔案時,搭配 mb_convert_encoding() 或 iconv() 轉碼。

結語

選對檔案讀取策略,不僅能避免記憶體溢位,更能簡化後續業務邏輯。下次面對 storage/logs/laravel-2024-06-01.log 這類百 MB 日誌時,請毫不猶豫選擇 SplFileObject 或 fopen() 逐行處理。

copyright © 萬盛學電腦網 all rights reserved