(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
. 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 Annexe O, 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 Annexe O, 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 la fonction 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 ( oir 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.