PHP 文件讀取函數家族深度對比與實戰選型指南
PHP 提供了豐富的文件讀取函數,各有適用場景。本文系統對比 fgets、fgetss、fgetcsv、readfile、fpassthru、file、fgetc、fread 的功能差異、性能特徵與最佳用法。
三大讀取模式分類
| 模式 | 函數 | 特點 | 適用場景 |
| 行讀取 | fgets | 按行讀取,保留換行符,可限制長度 | 大文本文件、日誌分析、逐行處理 |
| fgetss | fgets 變體,剝離 HTML/PHP 標籤 | 不受信輸入處理、留言板過濾 |
| fgetcsv | fgets 變體,按分隔符解析為數組 | 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) | ~2MB | 1.2s | ⭐⭐⭐⭐⭐ 逐行處理首選 |
| file() | ~200MB | 0.8s | ⭐⭐ 內存暴增,僅小文件 |
| readfile() | ~1MB | 0.6s | ⭐⭐⭐⭐⭐ 直接輸出最快 |
| fread (8KB) | ~2MB | 1.0s | ⭐⭐⭐⭐ 二進制/固定長度 |
| fgetc | ~1MB | 45s | ⭐ 極慢,禁止生產使用 |
進階技巧與避坑
- 文件鎖:讀取前
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()
└── 大文件 → ❌ 避免,改用流式處理