streamWrapper::stream_lock

(PHP 5, PHP 7, PHP 8)

streamWrapper::stream_lock — Bloqueo de archivos asesorado

Descripción

public streamWrapper::stream_lock(int $operation): bool

Este método es llamado en respuesta a flock(), cuando se utiliza file_put_contents() (cuando el parámetro flags contiene LOCK_EX), stream_set_blocking() y cuando se cierra el flujo (LOCK_UN).

Parámetros

operation

operation es una de las operaciones siguientes:

  • LOCK_SH para adquirir un bloqueo compartido (lectura).
  • LOCK_EX para adquirir un bloqueo exclusivo (escritura).
  • LOCK_UN para liberar un bloqueo (compartido o exclusivo).

También es posible añadir LOCK_NB como máscara de bits a una de las operaciones anteriores, si el bloqueo no debe bloquear durante el intento de bloqueo (no soportado en Windows).

Valores devueltos

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

Errores/Excepciones

Emite un E_WARNING si la llamada a este método falla (es decir, no implementado).

Ver también