XXXV. 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.
注: 本增加已被搬移到 PECL 庫中且自以下版本起不再被綁定到 PHP 中：5.1.0.
注: 本增加模組在 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.
運行時配置
本增加模組在 php.ini 中未定義任何配置選項。
預定義常量
以下常量由本增加模組定義，因此只有在本增加模組被編譯到 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