萬盛學電腦網

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

PHP 檔案操作完全手冊:讀寫、逐行處理與最佳實踐

檔案操作是後端開發的基石。無論是處理日誌、匯入匯出資料、快取機制,還是處理使用者上傳,扎實的檔案 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唯寫(不截斷)開頭是否

實作範例 1:基本寫入與讀取

<?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;

實作範例 2:逐行處理大型檔案(記憶體友善)

<?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 與錯誤。

實作範例 3:現代簡潔寫法(PHP 5.4+)

<?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() 驗證路徑在允許目錄內,拒絕 ../ 等相對路徑。
  • 檔案上傳驗證:檢查 MIME 類型、副檔名、檔案大小;使用 move_uploaded_file() 移動暫存檔。
  • 權限最小化:儲存目錄設為不可執行(Nginx/Apache 設定 php_admin_flag engine off)。
  • 輸出編碼:讀取檔案輸出到 HTML 前,務必 htmlspecialchars() 防 XSS。

常見錯誤與除錯技巧

  1. 權限被拒絕:檢查 PHP 執行身分(php-fpm user/www-data)對目錄是否有 r/w/x 權限。
  2. 開啟檔案失敗:路徑拼寫、相對/絕對路徑混淆、檔案被其他程序獨佔鎖定。
  3. 編碼問題:中文檔名在 Windows/Linux 間移動常發生亂碼,建議統一使用 UTF-8 並 mb_convert_encoding() 處理。
  4. 大檔案上傳中斷:調整 php.ini 的 upload_max_filesize、post_max_size、max_execution_time。

效能優化建議

  • 大量小檔案讀寫:考慮使用 SQLite 或 Redis 替代檔案系統。
  • 頻繁讀取靜態資料:使用 OPcache、APCu 或檔案快取(filemtime() 檢查更新)。
  • 串流處理:處理 GB 級檔案時,使用 fread($fp, 8192) 分塊讀取,配合 Generator 實作迭代器。

檔案操作看似基礎,細節卻決定系統穩定度。掌握資源管理、鎖定機制、編碼處理與安全防護,才能在高併發、大數據場景下從容應對。建議收藏本文作為開發隨身查閱手冊!

copyright © 萬盛學電腦網 all rights reserved