PHP 8.1.0 RC 2 available for testing

wincache_lock

(PECL wincache >= 1.1.0)

wincache_lock Получает эксклюзивную блокировку для данного ключа

Описание

wincache_lock(string $key, bool $isglobal = false): bool

Получает эксклюзивную блокировку для данного ключа. Выполнение текущего скрипта будет заблокировано до тех пор, пока блокировка не будет получена. После получения блокировки другие сценарии, которые пытаются запросить блокировку с помощью того же ключа, будут заблокированы до тех пор, пока текущий скрипт не снимет блокировку с помощью wincache_unlock().

Внимание

Использование wincache_lock() и wincache_unlock() может вызвать взаимную блокировку при выполнении скриптов PHP в многопроцессорной среде, такой как FastCGI. Не используйте эти функции, если вы не уверены, что вам это нужно. Для большинства операций с пользовательским кешем эти функции использовать не обязательно.

Список параметров

key

Имя ключа в кеше для включения блокировки.

isglobal

Определяет, является ли область блокировки общесистемной или локальной. Локальные блокировки относятся к пулу приложений в случае IIS FastCGI или ко всем процессам PHP, которые имеют один и тот же идентификатор родительского процесса.

Возвращаемые значения

Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования wincache_lock()

<?php
$fp 
fopen("/tmp/lock.txt""r+");
if (
wincache_lock(“lock_txt_lock”)) { // получить эксклюзивную блокировку
    
ftruncate($fp0); // обрезать файл
    
fwrite($fp"Напишите что-нибудь здесь\n");
    
wincache_unlock(“lock_txt_lock”); // снять блокировку
} else {
    echo 
"Не удалось получить блокировку!";
}
fclose($fp);
?>

Смотрите также

  • wincache_unlock() - Снимает эксклюзивную блокировку данного ключа
  • wincache_ucache_set() - Adds a variable in user cache and overwrites a variable if it already exists in the cache
  • wincache_ucache_get() - Получает переменную, хранящуюся в пользовательском кеше
  • wincache_ucache_delete() - Удаляет переменные из пользовательского кеша
  • wincache_ucache_clear() - Deletes entire content of the user cache
  • wincache_ucache_exists() - Проверяет, существует ли переменная в пользовательском кеше
  • wincache_ucache_meminfo() - Получает информацию об использовании памяти пользовательского кеша
  • wincache_ucache_info() - Получает информацию о данных, хранящихся в пользовательском кеше
  • wincache_scache_info() - Retrieves information about files cached in the session cache

add a note add a note

User Contributed Notes 2 notes

up
1
PrisonDoom
2 years ago
The external link was off and the backslash "\" most of time are used for "scape character". Anyway, regards.
up
-1
donraman at microsoft dot com
11 years ago
User should be aware that character '\' is not allowed as part of lock name. The reason why backslash is not allowed is because we are using CreateMutex call as described at http://msdn.microsoft.com/en-us/library/ms682411(VS.85).aspx. As per this article third parameter cannot have '\' character which is the lock name.

This means below code will not work.

<?php

   $ret_val
= wincache_lock("C:\WINDOWS\Temp/cache");
   echo
$ret_val . '<br>';
  
$ret_val = wincache_unlock("C:\WINDOWS\Temp/cache");
   echo
$ret_val . '<br>';

?>
To Top