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 » https://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 a été déplacée dans le module » PECL et ne sera plus intégrée dans PHP à partir de PHP 5.1.0.
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.
Installation
Configuration à l'exécution
Cette extension ne définit aucune directive de configuration.
Types de ressources
Il y a deux types de ressources utilisés dans le module FAM. Le premier est la connexion au service FAM retournée par la fonction fam_open(), la seconde, une ressource de surveillace retournée par les fonctions fam_monitor_XXX.
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.
Constante | Description |
---|---|
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 of Contents
- 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