在高併發環境下,多行程同時讀寫同一檔案會導致資料競爭、內容交錯甚至遺失。PHP 提供 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);
// 結果:兩行程資料交錯寫入
<?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);
<?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');
<?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 "任務完成";
PHP 預設 Session 處理器使用檔案鎖:session_start() 會對 Session 檔案加獨佔鎖,直到腳本結束或呼叫 session_write_close()。同一用戶同時請求會排隊執行。建議: 讀取 Session 後盡早呼叫 session_write_close() 釋放鎖,提升併發效能。
flock() 依賴所有行程合作遵守。若有行程直接 fopen() 寫入而不加鎖,鎖機制失效。'a' (append) 模式時,flock() 在 Linux/Unix 上通常正常;Windows 上 LOCK_EX 可能不阻塞 'a' 模式寫入。建議關鍵區段使用 'c+' 或 'r+'。flock() 在 NFS 上可靠性較差,需啟用 lockd 服務或改用資料庫鎖。fclose()、腳本結束、flock($fp, LOCK_UN) 會釋放鎖。不要 在鎖住期間關閉檔案再重開(會釋放鎖)。| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| flock() 檔案鎖 | 無額外依賴、跨平台、簡單 | 僅限單機、NFS 不穩、效能受磁碟 I/O 限制 | 單機簡單計數器、單一實例鎖、低併發日誌 |
| Redis SETNX / Redlock | 高效能、分散式支援、TTL 自動過期 | 需 Redis 基礎設施 | 分散式鎖、高併發、跨伺服器協調 |
| 資料庫行鎖 (SELECT ... FOR UPDATE) | ACID 保證、整合既有 DB | 需資料庫連線、效能較低 | 業務邏輯強一致性、已用資料庫 |
| Semaphore (sysvsem) | 系統級、進程間同步 | Linux 僅支援 System V、配置複雜 | 多進程 CLI 任務同步 |
PHP flock() 是單機環境下實現行程同步的輕量工具。核心原則:
LOCK_EXLOCK_SH(避免讀到半寫入資料)正確使用檔案鎖,能有效避免資料競爭導致的難以重現的 Bug,是 PHP 開發者必備技能。