萬盛學電腦網

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

PHP 檔案讀取方法完整解析:fgetc/fgets/fread/檔案指標控制

檔案讀取函數對比

PHP 提供多種檔案讀取函數,各有適用場景。理解其差異能寫出高效、記憶體友善的程式碼。

函數讀取單位適用場景記憶體指標移動
fgetc()單一字元字元級解析、自定義協議極低+1 byte
fgets()單行 (含換行)日誌、CSV、設定檔逐行處理單行到下一行開頭
fread()指定位元組二進位檔案、固定長度記錄、分塊讀取指定大小+length bytes
fgetcsv()CSV 記錄標準 CSV 解析 (支援引號、逸出)單行到下一記錄
file()全檔案→陣列小檔案一次性處理全檔案N/A
file_get_contents()全檔案→字串小檔案、API 請求全檔案N/A

檔案指標控制核心函數

<?php
$fp = fopen('data.bin', 'rb');

// 取得目前位置
$pos = ftell($fp); // int

// 移動指標: fseek($handle, $offset, $whence)
fseek($fp, 0, SEEK_SET);   // 檔案開頭
fseek($fp, -10, SEEK_END); // 倒數 10 位元組
fseek($fp, 100, SEEK_CUR); // 從目前位置向後 100

// 重置到開頭
rewind($fp); // 等同 fseek($fp, 0, SEEK_SET)

// 判斷結尾
while (!feof($fp)) {
    // 讀取邏輯
}

// 取得檔案大小
$size = fstat($fp)['size']; // 或 filesize($filename)
?>

實戰範例:各種讀取場景

1. 逐字元處理 (自定義協議解析)

<?php
function parseCustomProtocol(string $filepath): array
{
    $fp = fopen($filepath, 'rb');
    $tokens = [];
    $buffer = '';
    
    while (($char = fgetc($fp)) !== false) {
        if ($char === '|') { // 分隔符
            $tokens[] = $buffer;
            $buffer = '';
        } elseif ($char === "\n") { // 記錄結束
            $tokens[] = $buffer;
            $buffer = '';
            break; // 單記錄解析示例
        } else {
            $buffer .= $char;
        }
    }
    
    fclose($fp);
    return $tokens;
}
?>

2. 逐行處理 (大型日誌分析)

<?php
function analyzeLog(string $filepath): array
{
    $stats = ['total' => 0, 'errors' => 0, 'warnings' => 0, 'ips' => []];
    
    $fp = fopen($filepath, 'rb');
    while (($line = fgets($fp)) !== false) {
        $stats['total']++;
        
        if (str_contains($line, 'ERROR')) $stats['errors']++;
        if (str_contains($line, 'WARN')) $stats['warnings']++;
        
        // 簡易 IP 提取
        if (preg_match('/\b(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})\b/', $line, $m)) {
            $stats['ips'][$m[1]] = ($stats['ips'][$m[1]] ?? 0) + 1;
        }
    }
    fclose($fp);
    
    arsort($stats['ips']);
    $stats['top_ips'] = array_slice($stats['ips'], 0, 10, true);
    
    return $stats;
}
?>

3. 固定長度記錄讀取 (二進位結構)

<?php
// 結構: id(4 bytes) + name(32 bytes) + score(4 bytes) = 40 bytes/record
function readBinaryRecords(string $filepath): Generator
{
    $fp = fopen($filepath, 'rb');
    $recordSize = 40;
    
    while (!feof($fp)) {
        $data = fread($fp, $recordSize);
        if (strlen($data) < $recordSize) break; // 不完整記錄
        
        yield unpack('Vid/Vscore/a32name', $data);
    }
    
    fclose($fp);
}

// 使用
foreach (readBinaryRecords('scores.dat') as $record) {
    echo "ID: {$record['id']}, Name: " . trim($record['name']) . ", Score: {$record['score']}\n";
}
?>

4. 記憶體高效的大檔案處理模式

<?php
// ❌ 錯誤:大檔案一次讀完會 OOM
$content = file_get_contents('huge.log'); // 記憶體爆炸

// ✅ 正確:分塊處理 + 生成器
function readChunks(string $filepath, int $chunkSize = 8192): Generator
{
    $fp = fopen($filepath, 'rb');
    while (!feof($fp)) {
        yield fread($fp, $chunkSize);
    }
    fclose($fp);
}

// 處理 10GB 日誌檔,記憶體恆定 ~8KB
foreach (readChunks('huge.log') as $chunk) {
    // 串流處理:正則搜尋、壓縮、加密、網路傳輸
    processChunk($chunk);
}
?>

進階:SplFileObject 物件導向介面

<?php
$file = new SplFileObject('data.csv', 'r');
$file->setFlags(
    SplFileObject::READ_CSV |     // 自動 CSV 解析
    SplFileObject::READ_AHEAD |   // 预读下一行
    SplFileObject::SKIP_EMPTY     // 跳過空行
);
$file->setCsvControl(',', '"', '\\'); // 自訂分隔符

foreach ($file as $rowNum => $fields) {
    // $fields 已是陣列
    if ($rowNum === 0) continue; // 跳過標頭
    processRow($fields);
}

// 靈活控制指標
$file->seek(100); // 跳到第 100 行
echo $file->key(); // 目前行號
echo $file->current(); // 目前行內容

效能基準測試參考 (100MB 檔案)

方法耗時峰值記憶體備註
file_get_contents0.12s100MB+不適合大檔
file()0.15s120MB+陣列額外開銷
fgets() 迴圈0.18s2MB推薦逐行處理
fread(8KB) 迴圈0.14s1MB最佳平衡
SplFileObject0.20s2MBOOP 風格
readfile() 輸出0.10s1MB直接輸出最快

常見錯誤與避坑

  1. feof() 陷阱:while (!feof($fp)) { fgets($fp); } 會多執行一次。正確寫法:while (($line = fgets($fp)) !== false)
  2. 文字 vs 二進位模式:Windows 下 fopen($f, 'r') 會轉換 \r\n,處理二進位必須用 'rb'
  3. 編碼問題:fgets() 讀取 UTF-8 含 BOM 檔案會包含 BOM,需手動移除
  4. 資源洩漏:異常拋出時未 fclose(),使用 try/finally 或 register_shutdown_function()

總結

選擇正確的讀取函數是效能關鍵:逐行用 fgets()、二進位用 fread()、小檔便利用 file_get_contents()、直接輸出用 readfile()、CSV 用 SplFileObject。掌握檔案指標控制 (fseek/ftell/rewind) 能實現隨機存取、斷點續傳、多執行緒分段下載等進階功能。

copyright © 萬盛學電腦網 all rights reserved