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)
?>
<?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;
}
?>
<?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;
}
?>
<?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";
}
?>
<?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);
}
?>
<?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(); // 目前行內容
| 方法 | 耗時 | 峰值記憶體 | 備註 |
|---|---|---|---|
| file_get_contents | 0.12s | 100MB+ | 不適合大檔 |
| file() | 0.15s | 120MB+ | 陣列額外開銷 |
| fgets() 迴圈 | 0.18s | 2MB | 推薦逐行處理 |
| fread(8KB) 迴圈 | 0.14s | 1MB | 最佳平衡 |
| SplFileObject | 0.20s | 2MB | OOP 風格 |
| readfile() 輸出 | 0.10s | 1MB | 直接輸出最快 |
while (!feof($fp)) { fgets($fp); } 會多執行一次。正確寫法:while (($line = fgets($fp)) !== false)fopen($f, 'r') 會轉換 \r\n,處理二進位必須用 'rb'fgets() 讀取 UTF-8 含 BOM 檔案會包含 BOM,需手動移除fclose(),使用 try/finally 或 register_shutdown_function()選擇正確的讀取函數是效能關鍵:逐行用 fgets()、二進位用 fread()、小檔便利用 file_get_contents()、直接輸出用 readfile()、CSV 用 SplFileObject。掌握檔案指標控制 (fseek/ftell/rewind) 能實現隨機存取、斷點續傳、多執行緒分段下載等進階功能。