array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'splfileobject.flock.php', 1 => 'SplFileObject::flock', 2 => 'Bloqueio de arquivo portável', ), 'up' => array ( 0 => 'class.splfileobject.php', 1 => 'SplFileObject', ), 'prev' => array ( 0 => 'splfileobject.fgetss.php', 1 => 'SplFileObject::fgetss', ), 'next' => array ( 0 => 'splfileobject.fpassthru.php', 1 => 'SplFileObject::fpassthru', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/spl/splfileobject/flock.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

SplFileObject::flock

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

SplFileObject::flock — Bloqueio de arquivo portável

Descrição

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

Bloqueia ou desbloqueia o arquivo da mesma forma portável que flock().

Parâmetros

operation

operation é uma das seguintes:

  • LOCK_SH para adquirir um bloqueio compartilhado (leitor).
  • LOCK_EX para adquirir um bloqueio exclusivo (escritor).
  • LOCK_UN para liberar um bloqueio (compartilhado ou exclusivo).

Também é possível adicionar LOCK_NB como uma máscara de bits para uma das operações acima, se flock() não deve bloquear durante a tentativa de bloqueio.

wouldBlock

Definido como true se o bloqueio bloqueasse (condição de errno EWOULDBLOCK).

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Exemplo #1 Exemplo de SplFileObject::flock()

<?php
$file = new SplFileObject("/tmp/lock.txt", "w");
if ($file->flock(LOCK_EX)) { // faz um bloqueio exclusivo
$file->ftruncate(0); // trunca o arquivo
$file->fwrite("Escrevendo algo aqui\n");
$file->flock(LOCK_UN); // libera o bloqueio
} else {
echo "Não foi possível obter o bloqueio!";
}
?>

Veja Também