多進程/多執行緒環境下安全讀寫檔案是並發系統的基礎。本文實作基於 `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 鎖 |
| Windows | flock() 僅支援建議性鎖,強制性鎖需 `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); }
}
總結建議
- 單機、低併發、簡單邏輯:`flock()` + 安全封裝函數
- 單機、高併發、需行級鎖:資料庫 `SELECT ... FOR UPDATE` 或 Redis 鎖
- 分散式、多伺服器:Redis Redlock、ZooKeeper、etcd、Consul
- 資料一致性關鍵:資料庫事務 > 檔案鎖 > 無鎖
- 日誌/快取等非關鍵寫入:`file_put_contents(..., LOCK_EX)` 簡單足夠