SplFileObject
Manuel PHP

SplFileObject::flock

(PHP 5 >= 5.1.0)

SplFileObject::flock — Verrouille ou déverrouille un fichier

Description

public bool SplFileObject::flock ( int $operation [, int &$wouldblock ] )

Verrouille ou déverrouille un fichier, de la même façon que la fonction flock().

Liste de paramètres

operation

Le paramètre operation peut prendre une des constantes suivantes :

  • LOCK_SH pour acquérir un verrou partagé (lecture).
  • LOCK_EX pour acquérir un verrou exclusif (écriture).
  • LOCK_UN pour déverrouiller le fichier (partagé ou exclusif).
  • LOCK_NB pour ne pas bloquer durant le verrouillage (non supporté sous Windows).

wouldblock

Définit à TRUE si le verrou doit être bloquant (condition pour l'errno EWOULDBLOCK).

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Exemples

Exemple #1 Exemple avec SplFileObject::flock()

<?php
$file = new SplFileObject("/tmp/lock.txt", "w");
if ($file->flock(LOCK_EX)) { // verrou exclusif
	$file->ftruncate(0);	 // coupe le fichier
	$file->fwrite("Écrire quelque chose ici\n");
	$file->flock(LOCK_UN);   // libère le verrou
} else {
	echo "Impossible de récupérer le verrou !";
}
?>

Voir aussi

SplFileObject
Manuel PHP
LoadingChargement en cours