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 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.
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.
Cette extension ne définit aucune directive de
configuration.
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.
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
| 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. |