Forum und email

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.

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.

Table of Contents