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($fp, 0); // обрезать файл
    fwrite($fp, "Напишите что-нибудь здесь\n");
    wincache_unlock(“lock_txt_lock”); // снять блокировку
} else {
    echo "Не удалось получить блокировку!";
}
fclose($fp);
?>

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

wincache_unlock() - Снимает эксклюзивную блокировку данного ключа
wincache_ucache_set() - Добавляет переменную в пользовательский кеш и перезаписывает переменную, если она уже существует в кеше
wincache_ucache_get() - Получает переменную, хранящуюся в пользовательском кеше
wincache_ucache_delete() - Удаляет переменные из пользовательского кеша
wincache_ucache_clear() - Удаляет всё содержимое пользовательского кеша
wincache_ucache_exists() - Проверяет, существует ли переменная в пользовательском кеше
wincache_ucache_meminfo() - Получает информацию об использовании памяти пользовательского кеша
wincache_ucache_info() - Получает информацию о данных, хранящихся в пользовательском кеше
wincache_scache_info() - Получает информацию о файлах, закешированных в кеше сессии

add a note

User Contributed Notes 2 notes

down

PrisonDoom ¶

5 years ago


The external link was off and the backslash "\" most of time are used for "scape character". Anyway, regards.

down

-1

donraman at microsoft dot com ¶

14 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>';

?>

add a note