萬盛學電腦網

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

PHP 多進程檔案讀寫鎖機制完整實作

多進程/多執行緒環境下安全讀寫檔案是並發系統的基礎。本文實作基於 `flock()` 建議性鎖的讀寫函數,支援重試機制、超時控制、獨佔/共享鎖、大檔案分塊讀取,並分析 NFS、Windows 相容性問題。

核心鎖機制:flock() 詳解

操作常數說明
共享鎖(讀鎖)LOCK_SH多進程可同時持有,阻擋獨佔鎖
獨佔鎖(寫鎖)LOCK_EX僅一進程持有,阻擋所有其他鎖
釋放鎖LOCK_UN釋放當前進程持有的鎖
非阻塞LOCK_NB組合使用:`LOCK_EX \| LOCK_NB` 立即返回失敗不等待

生產級讀寫函數

<?php
/**
 * 安全寫入檔案(支援多進程併發)
 * @param string $path 檔案路徑
 * @param string $data 寫入資料
 * @param string $mode 檔案模式:'a+' 追加、'w' 覆寫、'c' 保留內容開啟
 * @param int $maxRetries 最大重試次數
 * @param int $retryDelayUs 重試基礎延遲(微秒)
 * @return bool 成功與否
 */
function safeFileWrite(string $path, string $data, string $mode = 'a+', int $maxRetries = 100, int $retryDelayUs = 10000): bool {
    $fp = fopen($path, $mode);
    if (!$fp) {
        trigger_error("無法開啟檔案: $path", E_USER_WARNING);
        return false;
    }
    
    $retries = 0;
    // 非阻塞嘗試獲取獨佔鎖
    while (!flock($fp, LOCK_EX | LOCK_NB)) {
        if ($retries >= $maxRetries) {
            fclose($fp);
            return false;
        }
        $retries++;
        // 指數退避 + 隨機抖動,減少驚群效應
        usleep($retryDelayUs * (1 + $retries * 0.1) * (0.5 + mt_rand() / MT_RAND_MAX));
    }
    
    // 寫入資料
    $bytes = fwrite($fp, $data);
    if ($bytes === false || $bytes !== strlen($data)) {
        flock($fp, LOCK_UN);
        fclose($fp);
        return false;
    }
    
    // 確保寫入磁碟(可選,效能代價)
    // fflush($fp);
    // fsync($fp); // PHP 8.1+
    
    flock($fp, LOCK_UN);
    fclose($fp);
    return true;
}

/**
 * 安全讀取檔案(共享鎖,允許並發讀取)
 * @param string $path 檔案路徑
 * @param string $mode 讀取模式:'r' 唯讀、'r+' 讀寫
 * @param int|null $maxLength 最大讀取長度,null 讀取整檔
 * @return string|false 內容或失敗
 */
function safeFileRead(string $path, string $mode = 'r', ?int $maxLength = null): string|false {
    $fp = fopen($path, $mode);
    if (!$fp) return false;
    
    $retries = 0;
    $maxRetries = 50; // 讀鎖通常較快獲得
    
    while (!flock($fp, LOCK_SH | LOCK_NB)) {
        if ($retries >= $maxRetries) {
            fclose($fp);
            return false;
        }
        $retries++;
        usleep(10000); // 10ms
    }
    
    $content = $maxLength ? fread($fp, $maxLength) : stream_get_contents($fp);
    
    flock($fp, LOCK_UN);
    fclose($fp);
    
    return $content;
}

/**
 * 原子性讀取-修改-寫入(Compare-And-Swap 模式)
 * @param string $path
 * @param callable $callback 接收當前內容,回傳新內容(false 表示取消)
 * @return bool
 */
function atomicFileUpdate(string $path, callable $callback): bool {
    $fp = fopen($path, 'c+'); // 開啟讀寫,不截斷
    if (!$fp) return false;
    
    if (!flock($fp, LOCK_EX)) {
        fclose($fp);
        return false;
    }
    
    $current = stream_get_contents($fp);
    $newContent = $callback($current);
    
    if ($newContent === false) {
        flock($fp, LOCK_UN);
        fclose($fp);
        return false; // 取消操作
    }
    
    // 截斷並寫入新內容
    ftruncate($fp, 0);
    rewind($fp);
    fwrite($fp, $newContent);
    fflush($fp);
    
    flock($fp, LOCK_UN);
    fclose($fp);
    return true;
}

// 使用範例:計數器原子遞增
atomicFileUpdate('counter.txt', function($current) {
    $count = (int) $current + 1;
    return (string) $count;
});

大檔案分塊讀寫

<?php
/**
 * 大檔案分塊讀取(記憶體友善)
 */
function readLargeFileChunks(string $path, int $chunkSize = 8192, callable $processor): void {
    $fp = fopen($path, 'r');
    if (!$fp) return;
    
    flock($fp, LOCK_SH);
    try {
        while (!feof($fp)) {
            $chunk = fread($fp, $chunkSize);
            if ($chunk === false) break;
            $processor($chunk);
        }
    } finally {
        flock($fp, LOCK_UN);
        fclose($fp);
    }
}

/**
 * 大檔案分塊寫入
 */
function writeLargeFileChunks(string $path, iterable $chunks, string $mode = 'w'): bool {
    $fp = fopen($path, $mode);
    if (!$fp) return false;
    
    if (!flock($fp, LOCK_EX)) {
        fclose($fp);
        return false;
    }
    
    try {
        foreach ($chunks as $chunk) {
            if (fwrite($fp, $chunk) === false) {
                return false;
            }
        }
        return true;
    } finally {
        flock($fp, LOCK_UN);
        fclose($fp);
    }
}

進階:記錄鎖(Record Locking)模擬資料庫行鎖

<?php
class FileRecordLock {
    private string $lockFile;
    private array $locks = []; // 檔案指標快取
    
    public function __construct(string $lockFile = '/tmp/app_locks.dat') {
        $this->lockFile = $lockFile;
        // 確保鎖檔案存在
        if (!file_exists($lockFile)) {
            file_put_contents($lockFile, '');
        }
    }
    
    // 鎖定特定記錄(用字串鍵)
    public function lockRecord(string $key, bool $exclusive = true): bool {
        $fp = $this->getLockFp();
        $offset = $this->keyToOffset($key);
        
        // 使用 fcntl 實現記錄鎖(Linux/Unix)
        // PHP 無直接 fcntl,模擬:每個 key 一個獨立鎖檔案
        $recordLockFile = $this->lockFile . '_' . md5($key);
        $lockFp = fopen($recordLockFile, 'c+');
        if (!$lockFp) return false;
        
        $op = $exclusive ? LOCK_EX : LOCK_SH;
        if (flock($lockFp, $op | LOCK_NB)) {
            $this->locks[$key] = $lockFp;
            return true;
        }
        fclose($lockFp);
        return false;
    }
    
    public function unlockRecord(string $key): void {
        if (isset($this->locks[$key])) {
            flock($this->locks[$key], LOCK_UN);
            fclose($this->locks[$key]);
            unset($this->locks[$key]);
        }
    }
    
    private function getLockFp(): resource {
        // 主鎖檔案指標快取
    }
    
    private function keyToOffset(string $key): int {
        // 雜湊映射到固定範圍
        return crc32($key) % 10000 * 100;
    }
}

// 使用
$locker = new FileRecordLock();
if ($locker->lockRecord('user_123', true)) {
    try {
        // 更新用戶 123 資料
        updateUser(123, ['balance' => 100]);
    } finally {
        $locker->unlockRecord('user_123');
    }
}

平台相容性與陷阱

平台/情境問題解決方案
NFS 掛載flock() 可能不可靠使用 `fcntl()` (需擴充)、或避免 NFS 存放鎖檔、改用資料庫/Redis 鎖
Windowsflock() 僅支援建議性鎖,強制性鎖需 `LOCK_EX`PHP 5.3+ Windows 支援良好,但網路磁碟同 NFS 問題
多執行緒 (pthreads)flock() 進程級,執行緒間不互斥使用 `pthreads` 同步機制或進程隔離
檔案截斷競態`fopen($f, 'w')` 先截斷再鎖用 `'c+'` 模式:開啟讀寫、不截斷、指標在開頭
鎖檔案刪除其他進程刪除鎖檔導致邏輯錯誤鎖檔案設為不可刪除、或使用目錄鎖 `mkdir()` 原子性

替代方案:更強健的分散式鎖

<?php
// Redis 分散式鎖(Redlock 算法簡化版)
class RedisLock {
    private \Redis $redis;
    private string $prefix = 'lock:';
    
    public function __construct(\Redis $redis) { $this->redis = $redis; }
    
    public function acquire(string $key, int $ttl = 10): bool {
        $lockKey = $this->prefix . $key;
        // SET NX EX 原子操作
        return $this->redis->set($lockKey, uniqid(), ['nx', 'ex' => $ttl]);
    }
    
    public function release(string $key, string $token): bool {
        // Lua 腳本原子檢查並刪除
        $script = "if redis.call('get', KEYS[1]) == ARGV[1] then return redis.call('del', KEYS[1]) else return 0 end";
        return $this->redis->eval($script, 1, $this->prefix . $key, $token);
    }
}

// 使用
$redis = new Redis(); $redis->connect('127.0.0.1');
$lock = new RedisLock($redis);
$token = uniqid();
if ($lock->acquire('order_123', 30)) {
    try { processOrder(123); }
    finally { $lock->release('order_123', $token); }
}

總結建議

  1. 單機、低併發、簡單邏輯:`flock()` + 安全封裝函數
  2. 單機、高併發、需行級鎖:資料庫 `SELECT ... FOR UPDATE` 或 Redis 鎖
  3. 分散式、多伺服器:Redis Redlock、ZooKeeper、etcd、Consul
  4. 資料一致性關鍵:資料庫事務 > 檔案鎖 > 無鎖
  5. 日誌/快取等非關鍵寫入:`file_put_contents(..., LOCK_EX)` 簡單足夠
copyright © 萬盛學電腦網 all rights reserved