# SplFileObject::flock

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

SplFileObject::flock — Bloqueo de ficheros portable

### Descripción

public SplFileObject::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