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 好像選擇不了鎖，不知道他默認用的什麼鎖，反正和不鎖得到的輸出一樣，是不完整的數據。
