在高併發場景下,文件操作若無鎖保護會導致數據交錯寫入、讀取不完整、事務不完整等嚴重問題。PHP flock() 提供基於系統調用 flock(2) 的諮詢性文件鎖,是實現文件級並發控制的核心工具。本文深度解析鎖類型、阻塞/非阻塞模式、讀寫鎖策略選擇、Session 底層鎖機制與最佳實踐。
flock(resource $stream, int $operation, int &$wouldBlock = null): bool
// 操作類型(常量,PHP 4.0.1+)
LOCK_SH // 共享鎖(讀鎖),多進程可同時持有
LOCK_EX // 獨占鎖(寫鎖),同一時間僅一進程持有
LOCK_UN // 釋放鎖(共享/獨占通用)
LOCK_NB // 非阻塞模式(與上述 OR 組合),無法獲取鎖立即返回 false
// 組合使用
flock($fp, LOCK_EX | LOCK_NB); // 非阻塞嘗試獲取寫鎖
<?php
// writer.php - 模擬耗時寫入
$file = 'data.txt';
$fp = fopen($file, 'w');
if (flock($fp, LOCK_EX)) { // 獲取獨占寫鎖
fwrite($fp, "abc\n");
sleep(10); // 模擬長耗時寫入
fwrite($fp, "123\n");
flock($fp, LOCK_UN); // 釋放鎖
}
fclose($fp);
// reader.php - 讀取
$fp = fopen($file, 'r');
echo fread($fp, 100); // 若無鎖:寫入期間讀到 "abc\n";寫入完成後讀到 "abc\n123\n"
fclose($fp);
?>
<?php
// reader.php 加鎖版
$fp = fopen($file, 'r');
if (flock($fp, LOCK_SH)) { // 獲取共享讀鎖
echo fread($fp, 100); // 會等待寫鎖釋放,讀到完整數據
flock($fp, LOCK_UN);
} else {
echo "獲取鎖失敗";
}
fclose($fp);
?>
<?php
$fp = fopen($file, 'r');
if (flock($fp, LOCK_SH | LOCK_NB)) { // 非阻塞嘗試讀鎖
echo fread($fp, 100);
flock($fp, LOCK_UN);
} else {
echo "Lock failed, try later"; // 立即返回,不等待
}
fclose($fp);
?>
<?php
// 讀取:'r' 僅讀,文件必須存在
$fp = fopen($file, 'r');
flock($fp, LOCK_SH);
// 寫入:'c' 讀寫、不截斷、不存在則創建(推薦)
// 'w' 會截斷文件,獲取鎖前已清空,極其危險!
$fp = fopen($file, 'c');
flock($fp, LOCK_EX);
ftruncate($fp, 0); // 獲取鎖後手動截斷
fwrite($fp, $data);
flock($fp, LOCK_UN);
// 追加:'a' 或 'c' + fseek 到末尾
$fp = fopen($file, 'a'); // 系統保證追加原子性(O_APPEND)
flock($fp, LOCK_EX); // 仍建議加鎖保證多步操作原子性
fwrite($fp, $data);
flock($fp, LOCK_UN);
?>
血淚教訓:絕不使用 'w' 模式配合 flock!fopen(..., 'w') 在獲取鎖之前就已截斷文件,導致並發讀取者讀到空文件,數據瞬間丟失。
flock($fp, LOCK_UN); // 先釋放鎖
fclose($fp); // 再關閉句柄
// 逆序可能導致鎖未釋放就關閉,行為未定義
<?php
$maxRetries = 5;
$retryDelay = 100000; // 100ms
for ($i = 0; $i < $maxRetries; $i++) {
$fp = fopen($file, 'c');
if (flock($fp, LOCK_EX | LOCK_NB)) {
// 獲取鎖成功,執行寫入
ftruncate($fp, 0);
fwrite($fp, $data);
flock($fp, LOCK_UN);
fclose($fp);
break;
}
fclose($fp);
usleep($retryDelay);
}
if ($i === $maxRetries) {
throw new RuntimeException("獲取文件鎖超時");
}
?>
PHP 預設 Session 處理器(files)在 session_start() 時對 Session 文件加 獨占鎖 (LOCK_EX):
<?php
session_start();
// 讀取所需 Session 數據
$userId = $_SESSION['user_id'];
$prefs = $_SESSION['prefs'];
// 業務邏輯處理(不再需要寫入 Session)
// ...
// 關鍵:提前關閉 Session 寫入,釋放鎖
session_write_close();
// 後續耗時操作:數據庫查詢、外部 API 調用、大文件生成...
// 此期間其他請求可並發訪問 Session
?>
<?php
$lockFile = '/tmp/my_cron.lock';
$fp = fopen($lockFile, 'c');
if (!flock($fp, LOCK_EX | LOCK_NB)) {
die("另一實例正在運行,退出\n");
}
// 註冊關閉釋放
register_shutdown_function(function() use ($fp, $lockFile) {
flock($fp, LOCK_UN);
fclose($fp);
@unlink($lockFile);
});
// 執行定時任務邏輯...
sleep(60);
?>
SET key value NX EX 30,跨服務器、支援自動過期、可重入SELECT ... FOR UPDATE,事務內持有flock() 是 PHP 文件並發控制的基石:
ftruncate()session_write_close() 盡早釋放理解諮詢性鎖的「紳士協定」本質(需所有進程協作遵守),在單機文件場景下正確使用 flock,是 PHP 後端工程師處理並發寫入、緩存一致性、定時任務單例的必備技能。