萬盛學電腦網

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

PHP 文件讀取、追加內容並清空重寫的並發安全實現

場景

需讀取 JSON 文件、解碼、追加新資料、編碼寫回。多程序併發時必須加鎖,防止資料競爭導致內容損壞或丟失。

標準流程與關鍵函數

<?php
$path = 'data.json';
$newContent = ['new_item' => time()]; // 要追加的資料

$fh = fopen($path, 'c+'); // 'c+' 開啟讀寫,不截斷,不存在則建立
if (!$fh) {
    throw new RuntimeException("無法開啟文件: $path");
}

if (flock($fh, LOCK_EX)) { // 獨佔鎖(寫鎖)
    // 1. 讀取現有內容
    $currentContent = '';
    while (!feof($fh)) {
        $currentContent .= fread($fh, 8192);
    }
    $data = $currentContent ? json_decode($currentContent, true) : [];
    if (json_last_error() !== JSON_ERROR_NONE) {
        $data = []; // 損壞則重置
    }

    // 2. 追加新資料
    $data[] = $newContent;

    // 3. 截斷文件、指針歸零、寫入新內容
    ftruncate($fh, 0);
    rewind($fh);
    fwrite($fh, json_encode($data, JSON_UNESCAPED_UNICODE));

    // 4. 釋放鎖
    flock($fh, LOCK_UN);
} else {
    throw new RuntimeException('無法獲取文件鎖');
}
fclose($fh);
?>

關鍵點解析

  • fopen($path, 'c+'):讀寫模式,指針在開頭,**不截斷**文件(w+ 會先清空,導致讀不到舊資料)。
  • flock($fh, LOCK_EX):阻塞式獨佔鎖,確保同一時間只有一個進程寫入。Windows 上強制鎖定,Linux 預設建議性鎖定(需所有進程配合使用 flock)。
  • ftruncate($fh, 0) + rewind($fh):先清空文件內容再將指針移回開頭,然後寫入新內容。若新內容比舊內容短,殘留舊資料會被截斷移除。
  • json_encode(..., JSON_UNESCAPED_UNICODE):保留中文可讀性。

替代方案

  • 資料庫:SQLite / MySQL 內建 ACID,更適合高併發結構化資料。
  • 臨時文件 + rename:寫入 .tmp 文件,成功後 rename() 覆蓋原文件(原子操作,POSIX 系統保證),無需顯式鎖,但需處理併發衝突(如文件已被他人更新)。
  • Redis / Memcached:高頻讀寫場景首選記憶體存儲。
copyright © 萬盛學電腦網 all rights reserved