flock — 輕便的咨詢文件鎖定

bool flock  ( resource $handle  , int $operation  [, int &$wouldblock  ] )

handle  
文件系統指針，是典型地由 fopen()  創建的 resource (資源)。

operation  可以是以下值之一：
1. LOCK_SH 取得共享鎖定（讀取的程序）。  
2. LOCK_EX  取得獨占鎖定（寫入的程序。  
3. LOCK_UN  釋放鎖定（無論共享或獨占）。  
4.如果不希望 flock()  在鎖定時堵塞，則是 LOCK_NB （Windows 上還不支持）。

wouldblock  
如果鎖定會堵塞的話（EWOULDBLOCK 錯誤碼情況下），可選的第三個參數會被設置為 TRUE 。（Windows 上不支持）

返回值
成功時返回 TRUE ， 或者在失敗時返回 FALSE 。


在 PHP 5.3.2版本之前，鎖也會被 fclose()  釋放（在腳本結束後會自動調用），現在要解鎖必須手動進行（ flock ( $fp ,  LOCK_UN );// 釋放鎖定）。
當用一個多線程服務器 API（比如 ISAPI）時，可能不可以依靠 flock()  來保護文件，因為運行於同一服務器實例中其它並行線程的 PHP 腳本可以對該文件進行處理。（?）


eg:1
file_get_contents 和 file 有時讀取一非空文件時返回空，如下例
code1鎖定期間，code2輸出的都是空，code3會等待code1釋放鎖定後返回獲取的內容
code1

<?php
$fo = fopen('abc.txt', 'r+');
flock($fo, LOCK_EX);
sleep(10);
flock($fo, LOCK_UN);

code2

<?php
var_dump(file_get_contents('abc.txt'));
var_dump(file('abc.txt'));

code3

<?php
$con = getContents('abc.txt');
print_r($con);

function getContents($path, $waitIfLocked = true) {
    if(!file_exists($path)) {
        throw new Exception('File "'.$path.'" does not exists');
    }
    else {
        $fo = fopen($path, 'r');
        $locked = flock($fo, LOCK_SH, $waitIfLocked);
         
        if(!$locked) {
            return false;
        }
        else {
            $cts = file_get_contents($path);
             
            flock($fo, LOCK_UN);
            fclose($fo);
             
            return $cts;
        }
    }
} 

eg:2
本機運行結果和下面的不一致，LOCK_SH時能寫入(???)
下面的是手冊上的例子
I just spend a long time to understand why write function returns me "0", on a basic file opening and then writing.
I discovered that if you use LOCK_SH and then you write something, that will not work :

<?php
$fp = fopen('file.txt', 'a');

flock($fp,LOCK_SH);

$written = fputs($fp, 'data');

var_dump($written); // 0 and file is not changed

fclose($fp);

eg:3
寫​代​碼​來​解​決​多​進​程​線​程​同​時​讀​寫​一​個​文​件​的​問​題：
PHP是沒有多線程概念的，盡管如此我們仍然可以用“不完美”的方法來模擬多線程。
簡單的說，就是隊列處理。通過對文件進行加鎖和解鎖，來實現。當一個文件被一個用戶操作時，
該文件是被鎖定的，其他用戶只能等待，確實不夠完美，但是也可以滿足一些要求不高的應用

<?php
function T_put($filename,$string){  
$fp = fopen($filename,’a'); //追加方式打開  
if (flock($fp, LOCK_EX)){ //加寫鎖  
fputs($fp,$string); //寫文件  
flock($fp, LOCK_UN); //解鎖  
}  
fclose($fp);  
}  

function T_get($filename,$length){  
$fp = fopen($filename,’r'); //追加方式打開  
if (flock($fp, LOCK_SH)){ //加讀鎖  
$result = fgets($fp,$length); //讀取文件  
flock($fp, LOCK_UN); //解鎖  
}  
fclose($fp);  
return $result;  
}