檔案操作是後端開發的基石。無論是處理日誌、匯入匯出資料、快取機制,還是處理使用者上傳,扎實的檔案 I/O 技能不可或缺。本文系統整理 PHP 檔案操作核心函數、常見模式與現代最佳實踐,助你寫出更安全、高效的程式碼。
| 函數 | 用途 | 回傳值 |
|---|---|---|
fopen() | 開啟檔案/URL,回傳資源控制代碼 | resource 或 false |
fclose() | 關閉開啟的檔案指標 | bool |
fwrite() | 寫入資料(二進位安全) | 寫入位元組數或 false |
fread() | 讀取指定長度資料 | 字串或 false |
fgets() | 讀取一行(含換行符) | 字串或 false |
feof() | 檢查是否到達檔案末尾 | bool |
file_get_contents() | 一次讀取整個檔案到字串 | 字串或 false |
file_put_contents() | 一次寫入字串到檔案 | 寫入位元組數或 false |
file() | 將檔案讀入陣列(每行一元素) | 陣列或 false |
glob() | 依模式尋找檔案路徑 | 陣列 |
| 模式 | 說明 | 指標位置 | 建立檔案 | 截斷檔案 |
|---|---|---|---|---|
r | 唯讀 | 開頭 | 否 | 否 |
r+ | 讀寫 | 開頭 | 否 | 否 |
w | 唯寫 | 開頭 | 是 | 是 |
w+ | 讀寫 | 開頭 | 是 | 是 |
a | 唯寫(附加) | 結尾 | 是 | 否 |
a+ | 讀寫(附加) | 結尾 | 是 | 否 |
x | 唯寫(獨佔建立) | 開頭 | 僅不存在時 | 否 |
c | 唯寫(不截斷) | 開頭 | 是 | 否 |
<?php
$file = 'data.txt';
$data = "Hello PHP\n第二行資料\n第三行資料";
// 寫入(覆蓋模式)
$fp = fopen($file, 'w');
if ($fp) {
fwrite($fp, $data);
fclose($fp);
echo "寫入成功";
}
// 讀取全部內容
$content = file_get_contents($file);
echo $content;
<?php
$file = 'large_log.txt';
$fp = fopen($file, 'r');
if ($fp) {
$lineNum = 0;
while (($line = fgets($fp)) !== false) {
$lineNum++;
// 處理每一行,例如解析日誌、過濾關鍵字
if (strpos($line, 'ERROR') !== false) {
error_log("第 {$lineNum} 行發現錯誤:{$line}");
}
}
if (!feof($fp)) {
echo "讀取過程發生錯誤";
}
fclose($fp);
}
關鍵點: 使用 fgets() 逐行讀取,避免一次載入巨大檔案導致記憶體耗盡。搭配 feof() 判斷結尾,並檢查 fgets() 回傳 false 區分 EOF 與錯誤。
<?php
// 一次讀取整個檔案到陣列(自動去除換行符)
$lines = file('data.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
foreach ($lines as $line) {
// 處理邏輯
}
// 追加寫入(自動處理開啟/關閉/鎖定)
file_put_contents('log.txt', date('Y-m-d H:i:s') . " 使用者登入\n", FILE_APPEND | LOCK_EX);
// 取得檔案資訊
$stat = stat('data.txt');
echo "大小:{$stat['size']} 位元組\n";
echo "修改時間:" . date('Y-m-d H:i:s', $stat['mtime']) . "\n";
<?php
function atomicWrite(string $file, string $data): bool {
$temp = $file . '.tmp.' . uniqid();
$fp = fopen($temp, 'w');
if (!$fp) return false;
// 獨佔鎖定
if (!flock($fp, LOCK_EX)) {
fclose($fp);
@unlink($temp);
return false;
}
fwrite($fp, $data);
fflush($fp); // 確保寫入磁碟
flock($fp, LOCK_UN);
fclose($fp);
// 原子性重命名(POSIX 系統保證原子性)
return rename($temp, $file);
}
// 使用範例
$config = ['db' => 'mysql', 'debug' => true];
atomicWrite('config.json', json_encode($config, JSON_PRETTY_PRINT));
realpath() 驗證路徑在允許目錄內,拒絕 ../ 等相對路徑。move_uploaded_file() 移動暫存檔。php_admin_flag engine off)。htmlspecialchars() 防 XSS。mb_convert_encoding() 處理。php.ini 的 upload_max_filesize、post_max_size、max_execution_time。filemtime() 檢查更新)。fread($fp, 8192) 分塊讀取,配合 Generator 實作迭代器。檔案操作看似基礎,細節卻決定系統穩定度。掌握資源管理、鎖定機制、編碼處理與安全防護,才能在高併發、大數據場景下從容應對。建議收藏本文作為開發隨身查閱手冊!