萬盛學電腦網

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

PHP 檔案鎖(flock)完整指南:防止併發衝突、確保資料一致性

前言

在高併發環境下,多行程同時讀寫同一檔案會導致資料競爭、內容交錯甚至遺失。PHP 提供 flock() 函數實作建議性檔案鎖,協同多行程有序存取共享資源。本文深入解析檔案鎖機制、操作模式、實戰範例、常見陷阱與替代方案。

一、flock() 函數詳解

語法

flock(resource $handle, int $operation, int &$wouldblock = null): bool

操作模式常數

常數說明適用場景
LOCK_SH (1)共享鎖(讀鎖)多行程同時讀取,互不阻塞;寫入時會阻塞
LOCK_EX (2)獨佔鎖(寫鎖)寫入操作,阻塞其他讀/寫鎖
LOCK_UN (3)釋放鎖操作完成後釋放
LOCK_NB (4)非阻塞模式(位元或)LOCK_EX | LOCK_NB 無法取得鎖立即返回 false

二、基本使用範例:獨佔寫入鎖

錯誤示範:無鎖導致資料交錯

<?php
// process1.php
$fp = fopen('data.txt', 'a');
for ($i = 0; $i < 5; $i++) {
    fwrite($fp, "Process1: $i\n");
    usleep(100000);
}
fclose($fp);

// process2.php (同時執行)
$fp = fopen('data.txt', 'a');
for ($i = 0; $i < 5; $i++) {
    fwrite($fp, "Process2: $i\n");
    usleep(100000);
}
fclose($fp);
// 結果:兩行程資料交錯寫入

正確示範:使用 LOCK_EX 獨佔鎖

<?php
// writer.php
$fp = fopen('data.txt', 'a');
if (flock($fp, LOCK_EX)) {          // 取得獨佔鎖(阻塞等待)
    for ($i = 0; $i < 5; $i++) {
        fwrite($fp, "Writer: $i\n");
        usleep(100000);
    }
    flock($fp, LOCK_UN);            // 釋放鎖
} else {
    echo "無法取得鎖";
}
fclose($fp);

// reader.php (同時讀取)
$fp = fopen('data.txt', 'r');
if (flock($fp, LOCK_SH)) {          // 取得共享鎖
    $content = stream_get_contents($fp);
    flock($fp, LOCK_UN);
    echo $content;
}
fclose($fp);

三、非阻塞模式與超時控制

<?php
$fp = fopen('data.txt', 'a');
$start = microtime(true);
$timeout = 5; // 秒

while (true) {
    // 嘗試非阻塞取得鎖
    if (flock($fp, LOCK_EX | LOCK_NB)) {
        // 成功取得鎖,執行關鍵區段
        fwrite($fp, "Critical section\n");
        flock($fp, LOCK_UN);
        break;
    }
    
    // 未取得鎖,檢查超時
    if (microtime(true) - $start > $timeout) {
        echo "取得鎖超時";
        break;
    }
    
    usleep(100000); // 等待 100ms 重試
}
fclose($fp);

四、進階應用場景

1. 模擬資料庫交易:讀取-修改-寫入原子操作

<?php
function atomicUpdateCounter($file) {
    $fp = fopen($file, 'c+'); // 開啟讀寫,不截斷,指標在開頭
    if (!$fp) throw new Exception("無法開啟檔案");
    
    if (!flock($fp, LOCK_EX)) {
        fclose($fp);
        throw new Exception("無法取得鎖");
    }
    
    $content = fread($fp, filesize($file));
    $count = (int)$content + 1;
    
    ftruncate($fp, 0);      // 清空檔案
    rewind($fp);            // 指標回開頭
    fwrite($fp, (string)$count);
    fflush($fp);            // 確保寫入磁碟
    
    flock($fp, LOCK_UN);
    fclose($fp);
    return $count;
}

// 使用
echo atomicUpdateCounter('counter.txt');

2. 防止重複執行:單一實例鎖

<?php
$lockFile = '/tmp/my_cron.lock';
$fp = fopen($lockFile, 'c');
if (!flock($fp, LOCK_EX | LOCK_NB)) {
    echo "另一實例正在執行,退出";
    exit(1);
}
// 註冊關閉時釋放鎖(雖然腳本結束會自動釋放)
register_shutdown_function(function() use ($fp) {
    flock($fp, LOCK_UN);
    fclose($fp);
});

// 執行長時間任務...
sleep(60);
echo "任務完成";

3. Session 鎖機制

PHP 預設 Session 處理器使用檔案鎖:session_start() 會對 Session 檔案加獨佔鎖,直到腳本結束或呼叫 session_write_close()。同一用戶同時請求會排隊執行。建議: 讀取 Session 後盡早呼叫 session_write_close() 釋放鎖,提升併發效能。

五、關鍵注意事項與陷阱

  1. 建議性鎖:flock() 依賴所有行程合作遵守。若有行程直接 fopen() 寫入而不加鎖,鎖機制失效。
  2. 檔案模式影響:使用 'a' (append) 模式時,flock() 在 Linux/Unix 上通常正常;Windows 上 LOCK_EX 可能不阻塞 'a' 模式寫入。建議關鍵區段使用 'c+' 或 'r+'。
  3. NFS/網路檔案系統:flock() 在 NFS 上可靠性較差,需啟用 lockd 服務或改用資料庫鎖。
  4. 鎖釋放時機:fclose()、腳本結束、flock($fp, LOCK_UN) 會釋放鎖。不要 在鎖住期間關閉檔案再重開(會釋放鎖)。
  5. 目錄權限:鎖檔案所在目錄需可寫入。

六、替代方案比較

方案優點缺點適用場景
flock() 檔案鎖無額外依賴、跨平台、簡單僅限單機、NFS 不穩、效能受磁碟 I/O 限制單機簡單計數器、單一實例鎖、低併發日誌
Redis SETNX / Redlock高效能、分散式支援、TTL 自動過期需 Redis 基礎設施分散式鎖、高併發、跨伺服器協調
資料庫行鎖 (SELECT ... FOR UPDATE)ACID 保證、整合既有 DB需資料庫連線、效能較低業務邏輯強一致性、已用資料庫
Semaphore (sysvsem)系統級、進程間同步Linux 僅支援 System V、配置複雜多進程 CLI 任務同步

七、總結

PHP flock() 是單機環境下實現行程同步的輕量工具。核心原則:

  • 寫入操作必須使用 LOCK_EX
  • 讀取操作建議使用 LOCK_SH(避免讀到半寫入資料)
  • 關鍵區段盡量縮短,避免長時間持有鎖
  • 高併發、分散式場景請改用 Redis 或資料庫鎖

正確使用檔案鎖,能有效避免資料競爭導致的難以重現的 Bug,是 PHP 開發者必備技能。

copyright © 萬盛學電腦網 all rights reserved