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;  
}