萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 檔案處理完整指南:fopen 模式、讀寫操作、檔案指標控制

檔案處理是伺服端程式設計核心技能。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 避免記憶體爆增。
copyright © 萬盛學電腦網 all rights reserved