inotify_init

(PECL inotify >= 0.1.2)

inotify_init — Initialise une instance inotify

Description

inotify_init(): resource|false

Initialise une instance inotify pour utiliser avec la fonction inotify_add_watch()

Liste de paramètres

Cette fonction ne contient aucun paramètre.

Valeurs de retour

Un flux ou false en cas d'erreur.

Exemples

Exemple #1 Exemple d'utilisation d'inotify

<?php
// Crée une instance inotify
$fd = inotify_init();

// Surveille les modifications des métadonnées du fichier __FILE__ (p. ex. mtime)
$watch_descriptor = inotify_add_watch($fd, __FILE__, IN_ATTRIB);

// Génère un événement
touch(__FILE__);

// Lit les événements
$events = inotify_read($fd);
print_r($events);

// Les méthodes suivantes permettent d'utiliser les fonctions inotify sans bloquer sur inotify_read():

// - Utiliser stream_select() sur $fd:
$read = array($fd);
$write = null;
$except = null;
stream_select($read,$write,$except,0);

// - Utiliser stream_set_blocking() sur $fd
stream_set_blocking($fd, 0);
inotify_read($fd); // Does no block, and return false if no events are pending

// - Utiliser inotify_queue_len() pour vérifier la taille de la file d'attente
$queue_len = inotify_queue_len($fd); // If > 0, inotify_read() will not block

// Arrêt de la surveillance de __FILE__
inotify_rm_watch($fd, $watch_descriptor);

// Destruction de l'instance inotify
// Cela aurait arrêté toutes les surveillances si ce n'était pas déjà fait
fclose($fd);

?>

Résultat de l'exemple ci-dessus est similaire à :

array(
  array(
    'wd' => 1,     // Égale le $watch_descriptor
    'mask' => 4,   // Le bit IN_ATTRIB est activé
    'cookie' => 0, // identifiant unique pour relier des événements (e.g.
                   // IN_MOVE_FROM et IN_MOVE_TO)
    'name' => '',  // Le nom du fichier (e.g. si un dossier était sous surveillance)
  ),
);

Voir aussi

inotify_add_watch() - Ajoute un point de surveillance à une instance inotify
inotify_rm_watch() - Supprime un point de surveillance d'une instance inotify
inotify_queue_len() - Retourne le nombre d'événements qui sont survenus
inotify_read() - Lit les événements dans une instance inotify
fclose() - Ferme un fichier