inotify_init

(PECL inotify >= 0.1.2)

inotify_initИнициализирует экземпляр inotify

Описание

inotify_init ( ) : resource

Инициализирует экземпляр inotify для использования в inotify_add_watch()

Возвращаемые значения

Потоковый ресурс или false.

Примеры

Пример #1 Пример использования inotify

<?php
// Создаём экземпляр inotify
$fd inotify_init();

// Отслеживаем __FILE__ на предмет изменения метаданных (например mtime)
$watch_descriptor inotify_add_watch($fd__FILE__IN_ATTRIB);

// создаём событие
touch(__FILE__);

// Читаем события
$events inotify_read($fd);
print_r($events);

// Следующие функции позволяют использовать функции inotify без блокировки на inotify_read():

// - Используем stream_select() для $fd:
$read = array($fd);
$write null;
$except null;
stream_select($read,$write,$except,0);

// - Используем stream_set_blocking() для $fd
stream_set_blocking($fd0);
inotify_read($fd); // Не блокируем и возвращаем false если нет ожидающих событий

// - Используем inotify_queue_len() для проверки, что очередь событий не пуста
$queue_len inotify_queue_len($fd); // Если > 0, inotify_read() то не блокируем

// Заканчиваем наблюдать за __FILE__
inotify_rm_watch($fd$watch_descriptor);

// Закрываем экземпляр inotify
// Все не закрытые наблюдатели будут закрыты
fclose($fd);

?>

Результатом выполнения данного примера будет что-то подобное:

array(
  array(
    'wd' => 1,     // Equals $watch_descriptor
    'mask' => 4,   // IN_ATTRIB bit is set
    'cookie' => 0, // unique id to connect related events (e.g.
                   // IN_MOVE_FROM and IN_MOVE_TO events)
    'name' => '',  // the name of a file (e.g. if we monitored changes
                   // in a directory)
  ),
);

Смотрите также

  • inotify_add_watch() - Добавить наблюдателя для экземпляра inotify
  • inotify_rm_watch() - Удалить наблюдателя
  • inotify_queue_len() - Возвращает число ожидающих событий в очереди
  • inotify_read() - Читает ожидающие сообщения из очереди
  • fclose() - Закрывает открытый дескриптор файла

add a note add a note

User Contributed Notes 1 note

up
11
david dot schueler at tel-billig dot de
10 years ago
Example for tailing a file (like tail -f) using inotify.
<?php
/**
* Tail a file (UNIX only!)
* Watch a file for changes using inotify and return the changed data
*
* @param string $file - filename of the file to be watched
* @param integer $pos - actual position in the file
* @return string
*/
function tail($file,&$pos) {
   
// get the size of the file
   
if(!$pos) $pos = filesize($file);
   
// Open an inotify instance
   
$fd = inotify_init();
   
// Watch $file for changes.
   
$watch_descriptor = inotify_add_watch($fd, $file, IN_ALL_EVENTS);
   
// Loop forever (breaks are below)
   
while (true) {
       
// Read events (inotify_read is blocking!)
       
$events = inotify_read($fd);
       
// Loop though the events which occured
       
foreach ($events as $event=>$evdetails) {
           
// React on the event type
           
switch (true) {
               
// File was modified
               
case ($evdetails['mask'] & IN_MODIFY):
                   
// Stop watching $file for changes
                   
inotify_rm_watch($fd, $watch_descriptor);
                   
// Close the inotify instance
                   
fclose($fd);
                   
// open the file
                   
$fp = fopen($file,'r');
                    if (!
$fp) return false;
                   
// seek to the last EOF position
                   
fseek($fp,$pos);
                   
// read until EOF
                   
while (!feof($fp)) {
                       
$buf .= fread($fp,8192);
                    }
                   
// save the new EOF to $pos
                   
$pos = ftell($fp); // (remember: $pos is called by reference)
                    // close the file pointer
                   
fclose($fp);
                   
// return the new data and leave the function
                   
return $buf;
                   
// be a nice guy and program good code ;-)
                   
break;

                   
// File was moved or deleted
               
case ($evdetails['mask'] & IN_MOVE):
                case (
$evdetails['mask'] & IN_MOVE_SELF):
                case (
$evdetails['mask'] & IN_DELETE):
                case (
$evdetails['mask'] & IN_DELETE_SELF):
                   
// Stop watching $file for changes
                   
inotify_rm_watch($fd, $watch_descriptor);
                   
// Close the inotify instance
                   
fclose($fd);
                   
// Return a failure
                   
return false;
                    break;
            }
        }
    }
}

// Use it like that:
$lastpos = 0;
while (
true) {
    echo
tail($file,$lastpos);
}
?>
To Top