wincache_unlock

(PECL wincache >= 1.1.0)

wincache_unlock — 指定したキーの排他ロックを解放する

説明

function wincache_unlock(string $key): bool

指定したキーに対して、wincache_lock() を使って取得した排他ロックを解放します。別のプロセスがこのキーに対するロックをブロックされて待機している場合は、そのプロセスがロックを取得できるようになります。

警告

wincache_lock() および wincache_unlock() を使っていると、FastCGI のようなマルチプロセス環境において PHP スクリプトがデッドロックを引き起こすことがあります。本当にそれが必要である場合でない限り、これらの関数は使わないようにしましょう。キャッシュ上でのさまざまな操作の大半は、これらの関数を使う必要のないものです。

パラメータ

key: ロックを解放したいキャッシュ内のキーの名前。

戻り値

成功した場合に true を、失敗した場合に false を返します。

例

例1 wincache_unlock() の使用

<?php
$fp = fopen("/tmp/lock.txt", "r+");
if (wincache_lock(“lock_txt_lock”)) { // 排他ロックを確保します
    ftruncate($fp, 0); // ファイルを切り詰めます
    fwrite($fp, "Write something here\n");
    wincache_unlock(“lock_txt_lock”); // ロックを解放します
} else {
    echo "Couldn't get the lock!";
}
fclose($fp);
?>

参考

wincache_lock() - 指定したキーで排他ロックを確保する
wincache_ucache_set() - 変数をユーザーキャッシュに追加し、変数が既にキャッシュに存在する場合はそれを上書きする
wincache_ucache_get() - ユーザーキャッシュに格納された変数を取得する
wincache_ucache_delete() - 変数をユーザーキャッシュから削除する
wincache_ucache_clear() - ユーザーキャッシュの中身全体を削除する
wincache_ucache_exists() - 変数がユーザーキャッシュに存在するかどうかを調べる
wincache_ucache_meminfo() - ユーザーキャッシュのメモリ使用状況についての情報を取得する
wincache_ucache_info() - ユーザーキャッシュにキャッシュされたファイルについての情報を取得する
wincache_scache_info() - セッションキャッシュにキャッシュされたファイルについての情報を取得する

関連キーワード:

wincache キャッシュロック lock ucache キー排他解放 unlock 変数確保 info Windows ビルド WinCache ブロック待機 FastCGI マルチプロセス環境スクリプトデッドロック本当操作大半