SplFileObject::flock

    (PHP 5 >= 5.1.0, PHP 7, PHP 8)

    SplFileObject::flock — Bloqueo de ficheros portable

    Descripción

    publicSplFileObject::flock(int$operation, int&$wouldBlock = null): bool

    Bloquea o desbloquea el fichero de la misma manera portable que flock().

    Parámetros

    operation

    operation es una operación de las 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 flock() no debe bloquearse durante el intento de bloqueo.

    wouldBlock

    Establecer a true si el bloqueo hará que la función quede esperando (condición de errno EWOULDBLOCK).

    Valores devueltos

    Devuelve true en caso de éxito o false en caso de error.

    Ejemplos

    Ejemplo #1 Ejemplo de SplFileObject::flock()

    <?php
    $file     = new SplFileObject("/tmp/bloqueado.txt", "w");
    if (    $file->flock(LOCK_EX)) { // adquirir un bloqueo exclusivo
    $file->ftruncate(0); // truncar el fichero
    $file->fwrite("Escribir alguna cosa\n");
    $file->flock(LOCK_UN); // liberar el bloqueo
    } else {
    echo     "¡No se pudo obtener el bloqueo!";
    }
    ?>

    Ver también

    • flock() - Bloqueo de ficheros recomendado y portable
    To Top