flock

Descripción

bool flock ( resource gestor, int operacion [, int &bloquearia] )

PHP soporta una manera portable de bloquear archivos enteros de por medio de avisos (lo que quiere decir que todos los programas que acceden al archivo deben usar el mismo mecanismo de bloqueo, o no funcionará).

flock() opera sobre gestor, que debe ser un apuntador a un archivo abierto. operacion es uno de los siguientes valores:

• Para adquirir un bloqueo compartido (de lectura), defina operacion a LOCK_SH (o use 1 antes de PHP 4.0.1).

• Para adquirir un bloqueo exclusizo (de escritura), defina operacion a LOCK_EX (o use 2 antes de PHP 4.0.1).

• Para liberar un bloqueo (compartido o exclusivo), defina operacion a LOCK_UN (o use 3 antes de PHP 4.0.1).

• Si no desea que flock() bloquee mientras opera, agregue LOCK_NB (4 antes de PHP 4.0.1) a operacion.

flock() le permite ejecutar un modelo de lectura/escritura simple que puede ser usado en prácticamente cualquier plataforma (incluyendo la mayoría de derivaciones de Unix e incluso Windows). El tercer argumento opcional recibe el valor TRUE si el aviso produciría un bloqueo (la condición EWOULDBLOCK). El bloqueo es liberado también por fclose() (el cual es llamado automáticamente cuando el script finaliza).

Devuelve TRUE si todo se llevó a cabo correctamente, FALSE en caso de fallo.

Ejemplo 1. Ejemplo de flock() <?php $aa = fopen("/tmp/bloqueo.txt", "w+"); if (flock($aa, LOCK_EX)) { // realizar un bloqueo exclusivo     fwrite($aa, "Escribir algo aqui\n");     flock($aa, LOCK_UN); // liberar el aviso } else {     echo "&iexcl;No se pudo bloquear el archivo!"; } fclose($aa); ?>