(PHP 3 >= 3.0.7, PHP 4, PHP 5)
flock -- Verrouille le fichier
Description
bool
flock ( resource handle, int operation [, int &wouldblock] )
PHP dispose d'un système complet de verrouillage de fichiers.
Tous les programmes qui accèdent au fichier doivent utiliser la
même méthode de verrouillage pour qu'il soit efficace.
Note :
flock() est obligatoire sous Windows.
flock() agit sur le fichier handle
qui doit avoir été ouvert au préalable.
operation est une des valeurs suivantes :
Acquisition d'un verrou en lecture :
operation = LOCK_SH
(valeur de 1 pour les versions plus anciennes que PHP 4.0.1).
Acquisition d'un verrou exclusif en écriture :
operation = LOCK_EX
(valeur de 2 pour les versions plus anciennes que PHP 4.0.1).
Libération d'un verrou partagé ou exclusif,
operation = LOCK_UN
(valeur de 3 pour les versions plus anciennes que PHP 4.0.1).
Si vous voulez que flock() ne se bloque pas durant
le verrouillage, ajoutez LOCK_NB Ã
operation
(valeur de 4 pour les versions plus anciennes que PHP 4.0.1).
flock() permet de réaliser un système simple de
verrous écriture/lecture, qui peut être utilisé sur
n'importe quelle plate-forme (Unix et Windows compris). Le troisième
paramètre optionnel &wouldblock vaut par défaut TRUE,
si le verrou doit bloquer le script (condition d'erreur
EWOULDBLOCK). Le verrou est également levé avec la
fonction fclose()
(qui est également automatiquement appelée lors de la fin du script).
Cette fonction retourne TRUE en cas de
succès, FALSE en cas d'échec.
Exemple 1. Exemple avec flock()
<?php
$fp = fopen("/tmp/lock.txt", "w+");
if (flock($fp, LOCK_EX)) { // pose un verrou exclusif
fwrite($fp, "Ecrire dans le fichier\n");
flock($fp, LOCK_UN); // libère le verrou
} else {
echo "Impossible de verrouiller le fichier!";
}
fclose($fp);
?>
|
|
Note :
Comme flock() requiert un pointeur de fichier, vous
aurez peut être à utiliser un verrou spécial pour protéger l'accès au fichier
que vous voulez tronquer en l'ouvrant en mode d'écriture (avec "w" ou "w+"
comme argument de fopen()).
| Avertissement |
flock() ne fonctionne pas sur NFS ou sur les autres
systèmes de fichiers réseaux. Vérifiez la documentation de votre
système d'exploitation pour plus de détails.
Sur certains systèmes d'exploitation, flock() est implémenté
au niveau processus. Lorsque vous utilisez une API multi-thread comme
ISAPI, vous risquez de ne pas pouvoir avoir confiance en flock()
pour protéger vos fichiers contre d'autres scripts PHP qui fonctionnent
en parallèle sur d'autres threads du même serveur.
flock() n'est pas supporté sur les vieux systèmes de fichiers
comme FAT et ses dérivés, et elle retournera forcément
FALSE sous ces environnements (ceci est particulièrement vrai pour les
utilisateurs de Windows 98).
|
