Rechercher une fonction PHP

SplFileObject::flock

Table des matières

(PHP 5 >= 5.1.0, PHP 7)

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

Description

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

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

Retour à la première page de Manuel PHP  Table des matières Haut

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.

wouldblock

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

Retour à la première page de Manuel PHP  Table des matières Haut

Valeurs de retour

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

Retour à la première page de Manuel PHP  Table des matières Haut

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 !";
}
?>

Retour à la première page de Manuel PHP  Table des matières Haut

Historique

Version Description
5.5.22, 5.6.6 Ajout du support du paramètre wouldblock sur Windows.
5.3.2 Le déverrouillage automatique lorsque le handle de ressource du fichier est fermé a été supprimé. Déverrouiller maintenant doit toujours être fait manuellement.

Rechercher une fonction PHP

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-splfileobject.flock.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut