7.100.3 Contextes de flôts
Un
contexte
est un jeu de paramètres et d'options
spécifiques à un gestionnaire qui modifie ou améliore le comportement
d'un flôt. Les contextes sont créés en utilisant la fonction
stream_context_create
et peuvent être donné aux
fonctions de créations de flôts sur le système de fichier
(i.e.
fopen
,
file
,
file_get_contents
, etc...).
Les options peuvent être spécifiées en appelant
stream_context_create
, ou plus tard, avec
stream_context_set_option
.
Une liste des options spécifiques à des gestionnaires est disponible
dans la liste des gestionnaires intégrés (voyez Liste des protocoles supportés ).
De plus, les paramètres peuvent être envoyés à un contexte en utilisant
la fonction
stream_context_set_params
. Actuellement, le
seul paramètre de contexte supporté par
PHP
est
notification
.
La valeur de ce paramètre doit être le nom d'une fonction qui sera appelée
lorsqu'un événement survient pour un flôt. La fonction d'alerte
est appelé durant la reception de l'événement, et doit accepter 6 paramètres :
void
my_notifier (
int
notification_code
,
int
severity
,
string
message
,
int
message_code
,
int
bytes_transferred
,
int
bytes_max
)
notification_code
et
severity
sont des valeurs numériques qui correspondent aux constantes
STREAM_NOTIFY_*
listées ci-dessous. Si un message descriptif est disponible dans un flôt, les
paramètre
message
et
message_code
en seront équipé. La signification de ces valeurs est dépendante du gestionnaire.
bytes_transferred
et
bytes_max
seront
fournies lorsque possible.
|