需讀取 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):保留中文可讀性。.tmp 文件,成功後 rename() 覆蓋原文件(原子操作,POSIX 系統保證),無需顯式鎖,但需處理併發衝突(如文件已被他人更新)。