SplFileObject::flock
(PHP 5 >= 5.1.0, PHP 7)
SplFileObject::flock — Портируемая блокировка файла
Описание
$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 "Не удалось получить блокировку!";
}
?>