XXXIII. Fonctions de monitorage d'altération de fichiers

Introduction

FAM surveille les fichiers et les dossiers, alertant les applications impliquées de changement. Pour plus d'informations sur FAM, voyez le site http://oss.sgi.com/projects/fam/.

Un script PHP peut spécifier une liste de fichiers à FAM pour les surveiller en utilisant les fonctions fournies par cette extension.

Le processus FAM est démarré lorsque la première connexion d'une application est ouverte. Il se termine après la fermeture de toutes les connexions.

Note : Cette extension n'est pas disponible sur les plates-formes Windows.

Pré-requis

Cette extension utilise les fonctions de la bibliothèque FAM, développée par SGI. Vous devez la télécharger et installer la bibliothèque FAM.

Configuration à l'exécution

Cette extension ne définit aucune directive de configuration.

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

Tableau 1. Constantes d'événements FAM

ConstanteDescription
FAMChanged (entier) Une valeur qui a été modifiée pour un fichier ou un dossier. Elle est accessible via fstat(1).
FAMDeleted (entier) Un fichier ou un dossier a été effacé.
FAMStartExecuting (entier) Un fichier exécutable a été lancé.
FAMStopExecuting (entier) Un fichier exécutable a fini de s'exécuter.
FAMCreated (entier) Un fichier a été créé dans un dossier.
FAMMoved (entier) Cet événement ne se produit jamais.
FAMAcknowledge (entier) Evénement survenu en réponse à fam_cancel_monitor().
FAMExists (entier) Un événement survenu suite à une commande de surveillance d'un fichier ou d'un dossier. Lorsque le dossier est sous surveillance, un événement est généré pour ce dossier et tous ses fichiers.
FAMEndExist (entier) Un événement après le dernier événement.
Table des matières
fam_cancel_monitor -- Termine le monitoring
fam_close -- Ferme la connexion FAM
fam_monitor_collection -- Monitore les changements d'une collection de fichiers dans un dossier
fam_monitor_directory -- Monitore un dossier pour les changements
fam_monitor_file -- Monitore un fichier régulier pour les changements
fam_next_event -- Retourne le prochain événement FAM en attente
fam_open -- Ouvre une connexion vers le démon FAM
fam_pending -- Vérifie si des événements FAM sont disponibles
fam_resume_monitor -- Reprend un monitoring suspendu
fam_suspend_monitor -- Suspend temporairement le monitoring