array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.wincache-lock.php', 1 => 'wincache_lock', 2 => 'Obtiene un bloqueo exclusivo en una clave dada', ), 'up' => array ( 0 => 'ref.wincache.php', 1 => 'Funciones de WinCache', ), 'prev' => array ( 0 => 'function.wincache-fcache-meminfo.php', 1 => 'wincache_fcache_meminfo', ), 'next' => array ( 0 => 'function.wincache-ocache-fileinfo.php', 1 => 'wincache_ocache_fileinfo', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/wincache/functions/wincache-lock.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

wincache_lock

(PECL wincache >= 1.1.0)

wincache_lock — Obtiene un bloqueo exclusivo en una clave dada

Descripción

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

Obtiene un bloqueo exclusivo sobre una clave dada. La ejecución del script actual quedará en espera que se pueda obtener el bloqueo. Una vez obtenido el bloqueo, el otro script que intente solicitar dicho bloqueo utilizando la misma clave quedará en espera, hasta que el script actual libere el bloqueo con wincache_unlock().

Advertencia

El uso de wincache_lock() y wincache_unlock() puede causar bloqueos de punto muerto al ejecutar scripts de PHP en un entorno multiproceso como FastCGI. No emplear estas funciones a menos que se esté absolutamente seguro de que son necesarias. Para la mayoría de las operaciones en la caché de usuario no es necesario usar esar estas funciones.

Parámetros

key

Nombre de la clave en la cahcé para adquirir el bloqueo.

isglobal

Controla si el ámbito del bloqueo es a nivel de sistema o local. Los bloqueos locales tienen alcance para la «pool» de la aplicación en el caso de FastCGI de IIS o a todos los procesos de php que tengan el mismo identificador de proceso padre.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Ejemplos

Ejemplo #1 Empleo de wincache_lock()

<?php
$fp = fopen("/tmp/lock.txt", "r+");
if (wincache_lock(“lock_txt_lock”)) { // realizar un bloqueo exclusivo
ftruncate($fp, 0); // truncate file
fwrite($fp, "Write something here\n");
wincache_unlock(“lock_txt_lock”); // liberar el bloqueo
} else {
echo "No se pudo obtener el bloqueo";
}
fclose($fp);
?>

Ver también