XXX. File Alteration Monitor Functions

简介

FAM monitors files and directories, notifying interested applications of changes. More information about FAM is available at http://oss.sgi.com/projects/fam/.

A PHP script may specify a list of files for FAM to monitor using the functions provided by this extension.

The FAM process is started when the first connection from any application to it is opened. It exits after all connections to it have been closed.

注: 该扩展模块不适用于 Windows 平台！

需求

This extension uses the functions of the FAM library, developed by SGI. Therefore you have to download and install the FAM library.

安装

To use PHP's FAM support you must compile PHP --with-fam[=DIR] where DIR is the location of the directory containing the lib and include directories.

运行时配置

该扩展模块未定义任何设置指令。

资源类型

FAM resource

预定义常量

由于这些常量是由该扩展模块定义的，因此只有在该扩展模块被编译到 PHP 中，或者在运行时被动态加载后，这些常量才有效。

表格 1. FAM event constants

Constant	Description
`FAMChanged` (integer)	Some value which can be obtained with fstat(1) changed for a file or directory.
`FAMDeleted` (integer)	A file or directory was deleted or renamed.
`FAMStartExecuting` (integer)	An executable file started executing.
`FAMStopExecuting` (integer)	An executable file that was running finished.
`FAMCreated` (integer)	A file was created in a directory.
`FAMMoved` (integer)	This event never occurs.
`FAMAcknowledge` (integer)	An event in response to fam_cancel_monitor().
`FAMExists` (integer)	An event upon request to monitor a file or directory. When a directory is monitored, an event for that directory and every file contained in that directory is issued.
`FAMEndExist` (integer)	Event after the last FAMEExists event.

目录
fam_cancel_monitor -- Terminate monitoring
fam_close -- Close FAM connection
fam_monitor_collection -- Monitor a collection of files in a directory for changes
fam_monitor_directory -- Monitor a directory for changes
fam_monitor_file -- Monitor a regular file for changes
fam_next_event -- Get next pending FAM event
fam_open -- Open connection to FAM daemon
fam_pending -- Check for pending FAM events
fam_resume_monitor -- Resume suspended monitoring
fam_suspend_monitor -- Temporarily suspend monitoring

add a note User Contributed Notes
File Alteration Monitor Functions

sergiopaternoster at no_spam_tiscali dot it
22-May-2004 12:20

Here is a simple script to check changes etc. to a
file.
<?php

/* opens a connection to the FAM service daemon
*/
$fam_res = fam_open ();

/* 
 * The second argument is the
full pathname 
 * of the file to monitor. 
 * Note that you can't use
relative pathnames.
*/
$nres = fam_monitor_file ( $fam_res,
'/home/sergio/test/fam/file_to_monitor.log');

while(1){
	if(
fam_pending ( $fam_res ) ) $arr = (fam_next_event($fam_res)) ;
	switch
($arr['code']){
		case 1:
			echo
"FAMChanged\n";
			break;
		case 2:
			echo
"FAMDeleted\n";
			break;
		case 3:
			echo
"FAMStartExecuting\n";
			break;
		case 4:
			echo
"FAMStopExecuting\n";
			break;
		case 5:
			echo
"FAMCreated\n";
			break;
		case 6:
			echo
"FAMMoved\n";
			break;
		case 7:
			echo
"FAMAcknowledge\n";
			break;
		case 8:
			echo
"FAMExists\n";
			break;
		case 9:
			echo
"FAMEndExist\n";
			break;
		default:
			break;
	}

	if(isset($arr)) unset($arr);
	
	/* In order to avoid too much
CPU load */
	usleep(5000);
}

/* Close FAM connection
*/
fam_close($fam_res); 

?>
Hope this could help.
God
Belss PHP!
regards
Sergio Paternoster

add a note