stream_get_line
stream_get_transports
Fonctions sur les flux
PHP Manual

# stream_get_meta_data

(PHP 4 >= 4.3.0, PHP 5)

stream_get_meta_data — Lit les en-têtes et données méta des flux

### Description

array stream_get_meta_data ( resource `$stream` )

stream_get_meta_data retourne les informations disponibles sur le flux `stream` . Ce flux peut être n'importe quel flux créé par fopen(), fsockopen() et pfsockopen(). Le tableau résultant peut contenir les éléments suivants :

- `timed_out` (booléen) - `TRUE` si le flux a atteint de délai d'expiration en attendant des données durant le dernier appel aux fonctions fread() et fgets().

- `blocked` (booléen) - `TRUE` si le flux est en mode bloquant. Voir aussi stream_set_blocking().

- `eof` (booléen) - `TRUE` si le flux a atteint la fin du fichier. Notez que pour les sockets, cette valeur peut être `TRUE` même si `unread_bytes` est non nul. Pour déterminer s'il reste des données à lire, utilisez plutôt la fonction feof().

- `unread_bytes` (entier) - le nombre d'octets actuellement placés dans le buffer interne à PHP.

  > Note: Vous ne devriez pas utiliser cette valeur dans un script.

Les éléments suivants ont été ajoutés en PHP 4.3.0 :

- `stream_type` (chaîne de caractères) - un nom, qui décrit l'implémentation sous-jacente de flux.

- `wrapper_type` (chaîne de caractères) - un nom qui décrit le gestionnaire de protocole pour ce flux. Voyez Liste des protocoles supportés pour plus d'informations sur les gestionnaires.

- `wrapper_data` (mixed) - des données spécifiques au gestionnaire liés à ce flux. Voyez Liste des protocoles supportés pour plus d'informations sur les gestionnaires et leurs données.

- `filters` (tableau) - un tableau contenant les noms de tous les filtres qui ont été attachés à ce flux. La documentation sur les filtres peut être trouvée sur l'annexe concernant les filtres.

> Note: Cette fonction a été introduite en PHP 4.3.0, mais avant cette version, socket_get_status() était utilisée pour lire les 4 premiers éléments, uniquement pour les sockets.
> En PHP 4.3.0 et plus récent, socket_get_status() est un alias de cette fonction.

> Note: Cette fonction n'est pas utilisable avec les sockets créées par les fonctions de l'extension socket.

Les éléments suivants ont été ajoutés en PHP 5.0.0:

- `mode` (chaîne de caractères) - le type d'accès requis pour ce flux ( voir le tableau 1 de la référence de la fonction fopen())

- `seakable` (booléen) - si on peut rechercher dans le flux courant.

- `uri` (chaîne de caractères) - l'URI/nom de fichier associé à ce flux.

stream_get_line
stream_get_transports
Fonctions sur les flux
PHP Manual