檔案處理是伺服端程式設計核心技能。PHP 提供豐富的檔案系統函數,本文系統整理 fopen() 模式、讀寫函數、檔案指標控制、錯誤處理與最佳實務。
fopen() 模式完整對照表
| 模式 | 讀/寫 | 指標初始位置 | 檔案不存在 | 截斷檔案 | 適用場景 |
r | 唯讀 | 開頭 | 失敗 | 否 | 讀取現有檔案 |
r+ | 讀寫 | 開頭 | 失敗 | 否 | 讀取並修改現有檔案 |
w | 唯寫 | 開頭 | 建立新檔 |
是(清空) | 覆寫/建立新檔 |
w+ | 讀寫 | 開頭 | 建立新檔 |
是(清空) | 讀寫新檔/覆寫 |
a | 唯寫 | 結尾 | 建立新檔 |
否 | 追加寫入(日誌) |
a+ | 讀寫 | 結尾 | 建立新檔 |
否 | 追加並可讀取 |
x | 唯寫 | 開頭 |
建立新檔 |
否 | 獨佔建立(檔案存在則失敗) |
x+ | 讀寫 | 開頭 |
建立新檔 |
否 | 獨佔建立讀寫 |
c | 唯寫 | 開頭 |
建立新檔 |
否 |
不截斷開啟(配合 flock) |
c+ | 讀寫 | 開頭 |
建立新檔 |
否 | 不截斷讀寫(配合 flock) |
⚠️ 關鍵差異: w/w+ 會清空現有檔案內容;a/a+ 保留內容並移至結尾;x/x+ 確保不覆蓋既有檔案;c/c+ 適合配合鎖定使用。
基本開啟與關閉
<?php
// 開啟檔案
$handle = fopen('data.txt', 'r');
if ($handle === false) {
die('無法開啟檔案');
}
try {
// 操作檔案...
} finally {
fclose($handle); // 確保關閉,釋放資源
}
?>
讀取操作
逐行讀取(最常用)
<?php
$handle = fopen('large.log', 'r');
while (($line = fgets($handle)) !== false) {
// $line 包含換行符
processLine(rtrim($line));
}
fclose($handle);
?>
逐字元讀取
<?php
$handle = fopen('data.bin', 'r');
while (($char = fgetc($handle)) !== false) {
// 處理單一字元
}
fclose($handle);
?>
一次讀取全部
<?php
$handle = fopen('config.json', 'r');
$content = fread($handle, filesize('config.json'));
fclose($handle);
// 或更簡潔
$content = file_get_contents('config.json');
?>
CSV 解析
<?php
$handle = fopen('data.csv', 'r');
while (($row = fgetcsv($handle)) !== false) {
// $row 為陣列:['col1', 'col2', 'col3']
}
fclose($handle);
?>
寫入操作
寫入字串
<?php
$handle = fopen('output.txt', 'w');
fwrite($handle, "第一行\n");
fwrite($handle, "第二行\n");
fclose($handle);
// 簡潔寫法
file_put_contents('output.txt', "第一行\n第二行\n");
?>
追加寫入(日誌常用)
<?php
function logMessage(string $message): void {
$line = date('Y-m-d H:i:s') . " $message\n";
file_put_contents('app.log', $line, FILE_APPEND | LOCK_EX);
}
?>
檔案指標控制
| 函數 | 用途 | 範例 |
ftell($h) | 取得目前指標位置(位元組偏移) | $pos = ftell($h); |
fseek($h, $offset, $whence) | 移動指標 | fseek($h, 0, SEEK_SET) 移至開頭 |
rewind($h) | 移至開頭(等同 fseek 0, SEEK_SET) | rewind($h); |
ftruncate($h, $size) | 截斷檔案至指定大小 | ftruncate($h, 0); 清空檔案 |
feof($h) | 檢查是否達檔案結尾 | while (!feof($h)) |
fflush($h) | 刷新輸出緩衝區到磁碟 | fflush($h); |
SEEK 模式常數
SEEK_SET:從檔案開頭計算(預設)
SEEK_CUR:從目前位置計算
SEEK_END:從檔案結尾計算(負值往前)
檔案鎖定:防止競態條件
<?php
function safeWrite(string $file, string $data): bool {
$handle = fopen($file, 'c+'); // 開啟讀寫,不截斷
if (!$handle) return false;
// 獨佔鎖定(阻塞等待)
if (flock($handle, LOCK_EX)) {
ftruncate($handle, 0); // 清空
rewind($handle);
fwrite($handle, $data);
fflush($handle);
flock($handle, LOCK_UN); // 釋放鎖
fclose($handle);
return true;
}
fclose($handle);
return false;
}
// 共享鎖定(讀取時使用,允許並發讀取)
function safeRead(string $file): string|false {
$handle = fopen($file, 'r');
if (!$handle) return false;
if (flock($handle, LOCK_SH)) {
$data = stream_get_contents($handle);
flock($handle, LOCK_UN);
fclose($handle);
return $data;
}
fclose($handle);
return false;
}
?>
常用檔案系統函數速查
| 函數 | 用途 |
file_exists() | 檢查檔案/目錄是否存在 |
is_file() / is_dir() | 判斷檔案/目錄類型 |
filesize() | 取得檔案大小(位元組) |
filemtime() | 取得最後修改時間(時間戳) |
unlink() | 刪除檔案 |
rename() | 重新命名/移動檔案 |
copy() | 複製檔案 |
mkdir() / rmdir() | 建立/刪除目錄 |
scandir() | 列出目錄內容 |
glob() | 模式匹配檔案 |
realpath() | 取得絕對路徑 |
pathinfo() | 解析路徑資訊 |
tempnam() / sys_get_temp_dir() | 暫存檔案處理 |
SplFileObject 物件導向介面(推薦)
<?php
// 讀取 CSV
$file = new SplFileObject('data.csv');
$file->setFlags(SplFileObject::READ_CSV);
foreach ($file as $row) {
// $row 已解析為陣列
}
// 寫入
$file = new SplFileObject('output.txt', 'w');
$file->fwrite("Line 1\n");
$file->fwrite("Line 2\n");
// 逐行處理大檔案(記憶體效率佳)
$file = new SplFileObject('huge.log');
while (!$file->eof()) {
$line = $file->fgets();
process($line);
}
?>
✅ 現代最佳實務: 優先使用 file_get_contents()/file_put_contents() 簡單場景;複雜控制用 SplFileObject;高併發寫入必須 flock();大檔案串流處理用 Generator 或 SplFileObject 避免記憶體爆增。