Manuel PHP
Précédent |  | Suivant

# XXXVI. 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 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.

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.

Précédent | Sommaire | Suivant
expect_popen | Niveau supérieur | fam_cancel_monitor