Releases an exclusive lock on a given key

- « wincache_ucache_set

- Building for Windows »

- PHP Manual
- WinCache Functions
- Releases an exclusive lock on a given key

# wincache_unlock

(PECL wincache >= 1.1.0)

wincache_unlock — Releases an exclusive lock on a given key

### Description

wincache_unlock(string `$key`): bool

Releases an exclusive lock that was obtained on a given key by using wincache_lock(). If any other process was blocked waiting for the lock on this key, that process will be able to obtain the lock.

Warning

Using of the wincache_lock() and wincache_unlock() can cause deadlocks when executing PHP scripts in a multi-process environment like FastCGI. Do not use these functions unless you are absolutely sure you need to use them. For the majority of the operations on the user cache it is not necessary to use these functions.

### Parameters

`key`

  Name of the key in the cache to release the lock on.

### Return Values

Returns `true` on success or `false` on failure.

### Examples

Example #1 Using wincache_unlock()

    <?php$fp = fopen("/tmp/lock.txt", "r+");if (wincache_lock(“lock_txt_lock”)) { // do an exclusive lock    ftruncate($fp, 0); // truncate file    fwrite($fp, "Write something here\n");    wincache_unlock(“lock_txt_lock”); // release the lock} else {    echo "Couldn't get the lock!";}fclose($fp);?>

### See Also

- wincache_lock() - Acquires an exclusive lock on a given key
- wincache_ucache_set() - Adds a variable in user cache and overwrites a variable if it already exists in the cache
- wincache_ucache_get() - Gets a variable stored in the user cache
- wincache_ucache_delete() - Deletes variables from the user cache
- wincache_ucache_clear() - Deletes entire content of the user cache
- wincache_ucache_exists() - Checks if a variable exists in the user cache
- wincache_ucache_meminfo() - Retrieves information about user cache memory usage
- wincache_ucache_info() - Retrieves information about data stored in the user cache
- wincache_scache_info() - Retrieves information about files cached in the session cache