stream_get_meta

stream_get_meta_data

8.118 Flux
8 Référence des fonctions
Manuel PHP

. Introduction
. Filtres de flux
. Contextes de flux
. Installation
. Classes Stream
. Constantes pré-définies
. Erreurs de flux
. Exemples
. stream_context_create
. stream_context_get_default
. stream_context_get_options
. stream_context_set_option
. stream_context_set_params
. stream_copy_to_stream
. stream_filter_append
. stream_filter_prepend
. stream_filter_register
. stream_filter_remove
. stream_get_contents
. stream_get_filters
. stream_get_line
->stream_get_meta_data
. stream_get_transports
. stream_get_wrappers
. stream_register_wrapper
. stream_select
. stream_set_blocking
. stream_set_timeout
. stream_set_write_buffer
. stream_socket_accept
. stream_socket_client
. stream_socket_enable_crypto
. stream_socket_get_name
. stream_socket_pair
. stream_socket_recvfrom
. stream_socket_sendto
. stream_socket_server
. stream_wrapper_register
. stream_wrapper_restore
. stream_wrapper_unregister

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

[ Exemples avec stream_get_meta_data ] PHP 4 >= 4.3.0, PHP 5

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 :

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, 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 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:

mode ( chaîne de caractères ) - le mode (ou permissions) de l'URI associé au flux.
seakable ( booléen ) - si on peut rechercher dans le flux courant.
uri ( chaîne de caractères ) - l'URI/nom de fichier associé avec ce flux.

<<	stream_get_meta_data	>>
stream_get_line	Flux	stream_get_transports