基本介紹
- 外文名:PHP flock
- 定義:失敗,則返回 false
- 語法:flock
- 說明:操作必須是一個已經打開的
定義和用法,語法,說明,提示和注釋,例子,
定義和用法
PHP flock() 函式鎖定或釋放檔案。
若成功,則返回 true。若失敗,則返回 false。
語法
flock(file,lock,block) |
參數 | 描述 |
file | 必需。規定要鎖定或釋放的已打開的檔案。 |
lock | 必需。規定要使用哪種鎖定類型。 |
block | 可選。若設定為 1 或 true,則當進行鎖定時阻擋其他進程。 |
說明
flock() 操作的 file 必須是一個已經打開的檔案指針。
lock 參數可以是以下值之一:
要取得共享鎖定(讀取的程式),將 lock 設為 LOCK_SH(PHP 4.0.1 以前的版本設定為 1)。 要取得獨占鎖定(寫入的程式),將 lock 設為 LOCK_EX(PHP 4.0.1 以前的版本中設定為 2)。 要釋放鎖定(無論共享或獨占),將 lock 設為 LOCK_UN(PHP 4.0.1 以前的版本中設定為 3)。 如果不希望 flock() 在鎖定時堵塞,則給lock 加上 LOCK_NB(PHP 4.0.1 以前的版本中設定為 4)。
提示和注釋
提示:可以通過 fclose() 來釋放鎖定操作,代碼執行完畢時也會自動調用。
注釋:由於 flock() 需要一個檔案指針, 因此可能不得不用一個特殊的鎖定檔案來保護打算通過寫模式打開的檔案的訪問(在 fopen() 函式中加入 "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); ?> |
PHP Filesystem 函式