(PHP 4 >= 4.3.0, PHP 5)
stream_get_meta_data — Lit les en-têtes et données méta des flux
stream_get_meta_data() retourne les informations disponibles sur le flux stream .
Le flux peut être n'importe quel flux créé par les fonctions fopen(), fsockopen() ou 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.
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.
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.
Version | Description |
---|---|
5.0.0 | Les élément suivants ont été ajoutés dans le tableau retourné : mode, seekable, et uri. |
4.3.0 | Les éléments suivants ont été ajoutés dans le tableau retourné : stream_type, wrapper_type, wrapper_data et filters. |
4.3.0 | socket_get_status() est un alias de cette fonction. Avant PHP 4.3.0, elle était utilisée pour obtenir les quatre premiers éléments, uniquement pour les flux de sockets. |
Note: Cette fonction ne fonctionne pas sur les sockets créées avec l'extension socket.