8.126.3 Contextes de flux

Un contexte est un jeu de paramètres et d'options spécifiques à un gestionnaire qui modifie ou améliore le comportement d'un flux. Les contextes sont créés en utilisant la fonction stream_context_create et peuvent être donnés aux fonctions de création de flux sur le système de fichiers (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 flux. La fonction d'alerte est appelée durant la réception 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 flux, les paramètres message et message_code en seront équipés. La signification de ces valeurs est dépendante du gestionnaire. bytes_transferred et bytes_max seront fournies si possible.