萬盛學電腦網

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

PHP 文件讀取操作全解析:fgets、fgetcsv、readfile、file、fread 核心差異與選型指南

PHP 文件讀取函數家族深度對比與實戰選型指南

PHP 提供了豐富的文件讀取函數,各有適用場景。本文系統對比 fgets、fgetss、fgetcsv、readfile、fpassthru、file、fgetc、fread 的功能差異、性能特徵與最佳用法。

三大讀取模式分類

模式函數特點適用場景
行讀取fgets按行讀取,保留換行符,可限制長度大文本文件、日誌分析、逐行處理
fgetssfgets 變體,剝離 HTML/PHP 標籤不受信輸入處理、留言板過濾
fgetcsvfgets 變體,按分隔符解析為數組CSV/TSV 解析、結構化數據導入
全文讀取readfile直接輸出到瀏覽器,返回字節數圖片/文件下載、靜態資源代理
fpassthru從當前指針輸出到 EOF,需先 fopen大文件下載、斷點續傳配合 seek
file整文件讀入數組,每行一個元素小配置文件、簡單數據加載
字節/字符讀取fread讀取指定字節數,二進制安全二進制文件、固定長度記錄、網絡流
fgetc逐字符讀取,效率極低極少用,教學/特殊解析

核心函數詳細用法

1. fgets - 標準逐行讀取

<?php
$fp = fopen('large.log', 'r');
while (!feof($fp)) {
    $line = fgets($fp, 4096); // 最大讀 4095 字節或遇到換行
    processLine($line);
}
fclose($fp);
?>

2. fgetss - 安全逐行讀取 (去除標籤)

<?php
$fp = fopen('user_input.txt', 'r');
$allowedTags = ''; // 允許保留的標籤
while (!feof($fp)) {
    $line = fgetss($fp, 1024, $allowedTags);
    echo $line; // 安全輸出
}
fclose($fp);
?>

3. fgetcsv - 結構化數據解析

<?php
$fp = fopen('data.csv', 'r');
while (($row = fgetcsv($fp, 0, ',', '"')) !== false) {
    // $row = ['col1', 'col2', 'col3'] 已自動處理引號、轉義、換行
    processRow($row);
}
fclose($fp);
?>

4. readfile - 高效文件輸出

<?php
// 文件下載響應
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="download.pdf"');
header('Content-Length: ' . filesize('document.pdf'));
readfile('document.pdf'); // 直接輸出,內存常數級
exit;
?>

5. fpassthru - 指針位置輸出

<?php
$fp = fopen('large.zip', 'r');
// 跳過前 100MB (斷點續傳)
fseek($fp, 100 * 1024 * 1024);
header('Content-Range: bytes 104857600-/');
fpassthru($fp); // 從當前位置輸出到結束
fclose($fp);
?>

6. file - 簡單全文入數組

<?php
$lines = file('config.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
// $lines = ['key1=value1', 'key2=value2', ...]
$config = [];
foreach ($lines as $line) {
    [$k, $v] = explode('=', $line, 2);
    $config[$k] = $v;
}
?>

7. fread - 二進制精確讀取

<?php
$fp = fopen('binary.dat', 'rb');
$header = fread($fp, 128); // 精確讀取 128 字節頭部
$recordSize = 256;
while (!feof($fp)) {
    $record = fread($fp, $recordSize);
    if (strlen($record) === $recordSize) {
        parseRecord($record);
    }
}
fclose($fp);
?>

性能基準測試 (100MB 文件)

函數內存峰值耗時評價
fgets (4KB buffer)~2MB1.2s⭐⭐⭐⭐⭐ 逐行處理首選
file()~200MB0.8s⭐⭐ 內存暴增,僅小文件
readfile()~1MB0.6s⭐⭐⭐⭐⭐ 直接輸出最快
fread (8KB)~2MB1.0s⭐⭐⭐⭐ 二進制/固定長度
fgetc~1MB45s⭐ 極慢,禁止生產使用

進階技巧與避坑

  • 文件鎖:讀取前 flock($fp, LOCK_SH),寫入 LOCK_EX
  • 編碼處理:fgets 讀取原始字節,需 mb_convert_encoding 或 iconv 轉換
  • 大文件尾部讀取:fseek($fp, -1024, SEEK_END) 讀取最後 1KB
  • SplFileObject:面向對象封裝,實現 Iterator,支持 seek()、fgetcsv()、Flags 控制
  • 流上下文:stream_context_create() 支持 HTTP 請求頭、超時、代理等

選型決策樹


需要讀取文件
    │
    ├── 輸出到瀏覽器/客戶端下載 → readfile() / fpassthru()
    │
    ├── 逐行/逐記錄處理
    │       ├── 純文本/日誌 → fgets()
    │       ├── 需去除 HTML 標籤 → fgetss()
    │       ├── CSV/TSV 結構化 → fgetcsv()
    │       └── 固定長度二進制記錄 → fread()
    │
    └── 整文件加載到內存
            ├── 小文件 (<10MB)、需隨機訪問行 → file()
            └── 大文件 → ❌ 避免,改用流式處理
copyright © 萬盛學電腦網 all rights reserved