SplFileObject::flock

(PHP 5 >= 5.1.0, PHP 7)

SplFileObject::flockПортируемая блокировка файла

Описание

public SplFileObject::flock ( int $operation , int &$wouldblock = ? ) : bool

Блокирует или разблокирует файл тем же портируемым способом, что и flock().

Список параметров

operation

operation может принимать следующие значения:

  • LOCK_SH для получения разделяемой блокировки (чтение).
  • LOCK_EX для получения эксклюзивной блокировки (запись).
  • LOCK_UN для снятия блокировки (разделяемой или эксклюзивной).

Также возможно добавить LOCK_NB в качестве битовой маски к одной из вышеуказанных операций, если flock() не должен блокироваться во время попытки блокировки.

wouldblock

Будет установлен true, если блокировка будет блокирующей (код ошибки EWOULDBLOCK).

Возвращаемые значения

Возвращает true в случае успешного завершения или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования SplFileObject::flock()

<?php
$file 
= new SplFileObject("/tmp/lock.txt""w");
if (
$file->flock(LOCK_EX)) { // выполняем эксклюзивную блокировку
    
$file->ftruncate(0);     // очищаем файл
    
$file->fwrite("Что-нибудь пишем сюда\n");
    
$file->flock(LOCK_UN);   // снимаем блокировку   
} else {
    echo 
"Не удалось получить блокировку!";
}
?>

Смотрите также

  • flock() - Портируемая консультативная блокировка файлов