文件操作是後端開發基礎技能。PHP 提供豐富的文件系統函數族,本文系統梳理打開模式、讀寫函數、鎖機制、流上下文、目錄遍歷,並給出生產環境最佳實踐清單。
| 模式 | 讀 | 寫 | 指針位置 | 截斷 | 創建 | 備註 |
|---|---|---|---|---|---|---|
r | ✅ | ❌ | 開頭 | ❌ | ❌ | 文件必須存在 |
r+ | ✅ | ✅ | 開頭 | ❌ | ❌ | 可讀寫 |
w | ❌ | ✅ | 開頭 | ✅ | ✅ | 清空文件 |
w+ | ✅ | ✅ | 開頭 | ✅ | ✅ | 可讀寫+清空 |
a | ❌ | ✅ | 結尾 | ❌ | ✅ | 追加寫入 |
a+ | ✅ | ✅ | 結尾 | ❌ | ✅ | 可讀寫+追加 |
x | ❌ | ✅ | 開頭 | ❌ | ✅* | 獨佔創建(失敗若存在) |
c | ❌ | ✅ | 開頭 | ❌ | ✅ | 不截斷創建/打開 |
建議:二進制安全加 b 後綴(rb、wb、ab),跨平台一致行為。
| 需求 | 推薦函數 | 特點 |
|---|---|---|
| 全文讀入字符串 | file_get_contents() | 簡潔、內存映射優化、支援 URL |
| 全文讀入陣列(按行) | file() | 自動去換行符 FILE_IGNORE_NEW_LINES |
| 大文件逐行處理 | fgets() | 流式,恆定內存 |
| CSV 解析 | fgetcsv() | 處理引號、轉義、分隔符 |
| 寫入字符串 | file_put_contents() | 原子寫入支援 LOCK_EX |
| 二進制塊寫入 | fwrite() | 需手動 fopen/fclose |
| 輸出文件到瀏覽器 | readfile() | 直接發送輸出緩衝,不佔 PHP 內存 |
<?php
$fp = fopen('counter.txt', 'c+'); // 不截斷,可讀寫
if (flock($fp, LOCK_EX)) { // 獨佔鎖(寫)
$count = (int)fread($fp, filesize('counter.txt'));
ftruncate($fp, 0); // 清空
rewind($fp); // 指針歸零
fwrite($fp, ++$count);
fflush($fp); // 強制刷新到磁盤
flock($fp, LOCK_UN); // 釋放鎖
} else {
die('獲取鎖失敗');
}
fclose($fp);
LOCK_SH 共享鎖(讀)、LOCK_EX 獨佔鎖(寫)、LOCK_NB 非阻塞。file_put_contents($file, $data, LOCK_EX) 內建原子寫入+鎖,簡單場景首選。<?php
// HTTP POST 上下文
$ctx = stream_context_create([
'http' => [
'method' => 'POST',
'header' => 'Content-Type: application/json',
'content' => json_encode(['key' => 'value']),
'timeout' => 5,
]
]);
$response = file_get_contents('https://api.example.com/endpoint', false, $ctx);
// SSL 驗證控制
$ctx = stream_context_create([
'ssl' => [
'verify_peer' => false, // 僅開發測試
'verify_peer_name' => false,
]
]);
<?php
$file = new SplFileObject('data.csv');
$file->setFlags(
SplFileObject::READ_CSV |
SplFileObject::READ_AHEAD |
SplFileObject::SKIP_EMPTY
);
foreach ($file as $row) {
// $row 已解析為陣列
processRow($row);
}
// 寫入
$out = new SplFileObject('output.csv', 'w');
$out->fputcsv(['col1', 'col2']);
$out->fputcsv(['val1', 'val2']);
優勢:可迭代、自動資源管理、內建 CSV 解析、可 Seek、符合現代 OOP 風格。
<?php
// 遞歸遍歷 (Generator 版,記憶體友好)
function scanFiles(string $dir): Generator {
$it = new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS);
foreach (new RecursiveIteratorIterator($it) as $file) {
if ($file->isFile()) yield $file->getPathname();
}
}
foreach (scanFiles('/var/www') as $path) { /* ... */ }
// 目錄創建/刪除
mkdir('/path/to/dir', 0755, true); // 遞歸創建
rmdir('/path/to/dir'); // 僅空目錄
// 遞歸刪除需自定義或用 Symfony Filesystem
realpath() 解析符號鏈接、.. 遍歷。str_starts_with($realPath, $allowedRoot)。fopen 返回 false 必須檢查,flock 返回值必須驗證。文件操作看似基礎,實則關係數據完整性與系統安全。掌握模式選擇、流式處理大文件、鎖機制保證併發一致性、SplFileObject 現代化介面、流上下文擴展網絡協議,構建健壯的文件交互層。