7.101.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 :

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.