flock
(PHP 4, PHP 5)
flock — 輕便的諮詢檔案鎖定
說明
bool flock ( int $handle , int $operation [, int &$wouldblock ] )
PHP 支援以諮詢方式(也就是說所有訪問程式必須使用同一方式鎖定, 否則它不會工作)鎖定全部檔案的一種輕便方法。
Note:
在 Windows 下 flock() 將會強制執行。
flock() 操作的 handle 必須是一個已經開啟的檔案指標。operation 可以是以下值之一:
要取得共用鎖定定(讀取的程式),將 operation 設為 LOCK_SH(PHP 4.0.1 以前的版本設定為 1)。
要取得獨佔鎖定(寫入的程式),將 operation 設為 LOCK_EX(PHP 4.0.1 以前的版本中設定為 2)。
要釋放鎖定(無論共用或獨佔),將 operation 設為 LOCK_UN(PHP 4.0.1 以前的版本中設定為 3)。
如果不希望 flock() 在鎖定時堵塞,則給 operation 加上 LOCK_NB(PHP 4.0.1 以前的版本中設定為 4)。
flock() 允許執行一個簡單的可以在任何平台中使用的讀取/寫入模型(包括大部分的 Unix 派生版和甚至是 Windows)。如果鎖定會堵塞的話(EWOULDBLOCK 錯誤碼情況下),可選的第三個參數會被設定為 TRUE。鎖定操作也可以被 fclose() 釋放(代碼執行完畢時也會自動調用)。
成功時返回 TRUE, 或者在失敗時返回 FALSE.
Example #1 flock() 例子 複製代碼 代碼如下:<?php
$fp = fopen("/tmp/lock.txt", "w+");
if (flock($fp, LOCK_EX)) { // 進行排它型鎖定
fwrite($fp, "Write something here ");
flock($fp, LOCK_UN); // 釋放鎖定
} else {
echo "Couldn't lock the file !";
}
fclose($fp);
?>
Note:
由於 flock() 需要一個檔案指標, 因此可能不得不用一個特殊的鎖定檔案來保護打算通過寫入模式開啟的檔案的訪問(在 fopen() 函數中加入 "w" 或 "w+")。
Warning
flock() 不能用於 NFS 以及其它一些網路檔案系統。詳細資料查看自己作業系統的文檔。
在部分作業系統中 flock() 以進程級實現。當用一個多線程伺服器 API(比如 ISAPI)時,可能不可以依靠 flock() 來保護檔案,因為運行於同一伺服器執行個體中其它並行線程的 PHP 指令碼可以對該檔案進行處理。
flock() 不支援舊的檔案系統,如 FAT 以及它的派生系統。因此,此環境下總是返回 FALSE(尤其是對 Windows 98 使用者來說)。
php中檔案鎖函數flock函數用法簡介:
文法:
bool flock ( int $handle , int $operation [, int &$wouldblock ] )
flock() 操作的 handle 必須是一個已經開啟的檔案指標。operation 可以是以下值之一:
1. 要取得共用鎖定定(讀取程式),將 operation 設為 LOCK_SH(PHP 4.0.1 以前的版本設定為 1)
2. 要取得獨佔鎖定(寫入程式),將 operation 設為 LOCK_EX(PHP 4.0.1 以前的版本中設定為 2)
3. 要釋放鎖定(無論共用或獨佔),將 operation 設為 LOCK_UN(PHP 4.0.1 以前的版本中設定為 3)
4. 如果你不希望 flock() 在鎖定時堵塞,則給 operation 加上 LOCK_NB(PHP 4.0.1 以前的版本中設定為 4)
看下面代碼:
a.php 複製代碼 代碼如下:<?php
$file = “temp.txt”;
$fp = fopen($file , 'w‘);
if(flock($fp , LOCK_EX)){
fwrite($fp , “abc”);
sleep(10);
fwrite($fp , “123”);
flock($fp , LOCK_UN);
}
fclose($fp);
?>
b.php 複製代碼 代碼如下:<?php
$file = “temp.txt”;
$fp = fopen($file , 'r');
echo fread($fp , 100);
fclose($fp);
?>
運行 a.php 後,馬上運行 b.php ,可以看到輸出:
abc
等 a.php 運行完後運行 b.php ,可以看到輸出:
abc
123
顯然,當 a.php 寫檔案時資料太大,導致時間比較長時,這時 b.php 讀取資料不完整,在對b.php做修改
修改 b.php 為: 複製代碼 代碼如下:<?php
$file = “temp.txt”;
$fp = fopen($file , 'r‘);
if(flock($fp , LOCK_EX)){
echo fread($fp , 100);
flock($fp , LOCK_UN);
} else{
echo “Lock file failed…”;
}
fclose($fp);
?>
運行 a.php 後,馬上運行 b.php ,可以發現 b.php 會等到 a.php 運行完成後(即 10 秒後)才顯示:
abc
123
讀取資料完整,但時間過長,他要等待寫鎖釋放,再對b.php做修改。
修改 b.php 為: 複製代碼 代碼如下:<?php
$file = “temp.txt”;
$fp = fopen($file , 'r');
if(flock($fp , LOCK_SH | LOCK_NB)){
echo fread($fp , 100);
flock($fp , LOCK_UN);
} else{
echo “Lock file failed…”;
}
fclose($fp);
?>
運行 a.php 後,馬上運行 b.php ,可以看到輸出:
Lock file failed…
證明可以返回鎖檔案失敗狀態,而不是向上面一樣要等很久。
指令碼之家小編結論:
建議作檔案快取時,選好相關的鎖,不然可能導致讀取資料不完整,或重複寫入資料。
file_get_contents 好像選擇不了鎖,不知道他預設用的什麼鎖,反正和不鎖得到的輸出一樣,是不完整的資料。