XXXIII. Funções para monitoramento de alterações em arquivos (FAM)

Introdução

FAM monitora arquivos e diretórios, notificando alterações relevantes na aplicação. Maiores informações sobre FAM estão disponíveis em http://oss.sgi.com/projects/fam/.

Um script PHP deve especificar uma lista de arquivos para o monitor FAM, usando as funções disponíveis por essa extensão.

O processo FAM é iniciado quando a primeira conexão de alguma aplicação está aberta. E fecha após todas as conexões feitas por ele terminarem.

Nota: Esta extensão não está disponível na plataforma Windows.

Dependências

Essa extensão usa as funções da biblioteca FAM, desenvolvida por SGI. Portanto, você deverá fazer o download e instalar a biblioteca FAM. ======= This extension uses the functions of the FAM library, developed by SGI. Therefore you have to download and install the FAM library. >>>>>>> 1.6

Instalação

Para ter suporte ao FAM no php você deve compilar o PHP com --with-fam[=DIR] onde DIR é a localização do diretório contendo a biblioteca e diretório de includes.

Configurações em execução

Esta extensão não define nenhum parâmetro de configuração no php.ini.

Constantes pré-definidas

As contantes abaixo são definidas por esta extensão e somente estarão disponíveis quando a extensão foi compilada com o PHP ou carregada dinamicamente durante a execução.

Tabela 1. Constantes de eventos do FAM

ConstantesDescrição
FAMChanged (integer) Algum valor que pode ser obtido com fstat(1) alterado para um arquivo ou diretório.
FAMDeleted (integer) Um arquivo que foi deletado ou renomeado.
FAMStartExecuting (integer) Um arquivo executável que acabou de ser iniciado.
FAMStopExecuting (integer) Um arquivo executável que foi executado.
FAMCreated (integer) Um arquivo foi criado no diretório.
FAMMoved (integer) Esse evento nunca ocorre.
FAMAcknowledge (integer) Um evento em resposta para fam_cancel_monitor().
FAMExists (integer) Um evento acima de uma requisição para monitorar um arquivo ou diretório. Quando um diretório é monitorado, um evento para esse diretório e cada arquivo contido nele é usado.
FAMEndExist (integer) Evento após o último evento FAMEExists.
Índice
fam_cancel_monitor -- Finalizando monitoramento
fam_close -- Fecha uma conexão FAM
fam_monitor_collection -- Monitora alterações de uma coleção de arquivos em um diretório
fam_monitor_directory -- Monitora alterações em diretórios
fam_monitor_file -- Monitora alterações em um arquivo
fam_next_event -- Pega o próximo evento FAM pendente
fam_open -- Abre uma conexão para o daemon FAM
fam_pending -- Verifica por eventos FAM pendentes
fam_resume_monitor -- Recomeça um monitoramento suspendido
fam_suspend_monitor -- Suspende monitoramento temporariamente