# 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'utilisatio d'inotify

`<?php
// Crée une instance inotify
$fd = inotify_init();
// Surveille les modifications des métadonées du fichier __FILE__ (e.g. 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,     // Egale le $watch_descriptor
        'mask' => 4,   // Le bit IN_ATTRIB est activé
        'cookie' => 0, // identifiant uique 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