(PHP 5 >= 5.1.0, PHP 7, PHP 8)
SplFileObject::flock — Verrouille ou déverrouille un fichier
Description
public
SplFileObject::flock(int
$operation
, int
&$wouldBlock
=
null
): bool
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).
Il est aussi possible d'ajouter LOCK_NB
en tant qu'un
masque binaire à l'une des opérations ci-dessus, si
flock() ne devrait pas bloquer lors de la tentative
de vérrouillage.
-
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
- flock() - Verrouille le fichier