萬盛學電腦網

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

PHP 文件操作完整實戰:fopen 模式、鎖機制、流上下文與現代最佳實踐

文件操作是後端開發基礎技能。PHP 提供豐富的文件系統函數族,本文系統梳理打開模式、讀寫函數、鎖機制、流上下文、目錄遍歷,並給出生產環境最佳實踐清單。

fopen 模式完全解析

模式讀寫指針位置截斷創建備註
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 非阻塞。
  • Windows 強制鎖,Linux 建議性鎖(需所有進程協作)。
  • 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,
    ]
]);

現代最佳實踐:SplFileObject 物件化介面

<?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)。
  • ✅ 文件上傳:見 177373 完整方案。
  • ✅ 權限最小化:目錄 0755,文件 0644,上傳目錄禁用執行權限。
  • ✅ 錯誤處理:fopen 返回 false 必須檢查,flock 返回值必須驗證。

結語

文件操作看似基礎,實則關係數據完整性與系統安全。掌握模式選擇、流式處理大文件、鎖機制保證併發一致性、SplFileObject 現代化介面、流上下文擴展網絡協議,構建健壯的文件交互層。

copyright © 萬盛學電腦網 all rights reserved