PHP flock() 函數(shù)
定義和用法
flock() 函數(shù)鎖定或釋放文件。
若成功,則返回 true。若失敗,則返回 false。
語法
flock(file,lock,block)
參數(shù) | 描述 |
---|---|
file | 必需。規(guī)定要鎖定或釋放的已打開的文件。 |
lock | 必需。規(guī)定要使用哪種鎖定類型。 |
block | 可選。若設(shè)置為 1 或 true,則當(dāng)進(jìn)行鎖定時(shí)阻擋其他進(jìn)程。 |
說明
flock() 操作的 file 必須是一個(gè)已經(jīng)打開的文件指針。
lock 參數(shù)可以是以下值之一:
- 要取得共享鎖定(讀取的程序),將 lock 設(shè)為 LOCK_SH(PHP 4.0.1 以前的版本設(shè)置為 1)。
- 要取得獨(dú)占鎖定(寫入的程序),將 lock 設(shè)為 LOCK_EX(PHP 4.0.1 以前的版本中設(shè)置為 2)。
- 要釋放鎖定(無論共享或獨(dú)占),將 lock 設(shè)為 LOCK_UN(PHP 4.0.1 以前的版本中設(shè)置為 3)。
- 如果不希望 flock() 在鎖定時(shí)堵塞,則給 lock 加上 LOCK_NB(PHP 4.0.1 以前的版本中設(shè)置為 4)。
提示和注釋
提示:可以通過 fclose() 來釋放鎖定操作,代碼執(zhí)行完畢時(shí)也會(huì)自動(dòng)調(diào)用。
注釋:由于 flock() 需要一個(gè)文件指針, 因此可能不得不用一個(gè)特殊的鎖定文件來保護(hù)打算通過寫模式打開的文件的訪問(在 fopen() 函數(shù)中加入 "w" 或 "w+")。
例子
<?php
$file = fopen("test.txt","w+");
// 排它性的鎖定
if (flock($file,LOCK_EX))
{
fwrite($file,"Write something");
// release lock
flock($file,LOCK_UN);
}
else
{
echo "Error locking file!";
}
fclose($file);
?>