PHP 8.5.8 Released!

xml_set_end_namespace_decl_handler

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

xml_set_end_namespace_decl_handlerConfigure le gestionnaire de fin de déclaration de namespace

Description

function xml_set_end_namespace_decl_handler(XMLParser $parser, callable|string|null $handler): true

Définit un gestionnaire à appeler lorsque l'on quitte le contexte d'un espace de noms. Il peut être appelé, pour chaque déclaration du namespace, après le gestionnaire de la dernière balise de l'élément dont l'espace de noms a été déclaré.

Attention

Cet évènement n'est pas supporté sous libXML, aussi, un gestionnaire enregistré ne sera pas appelé.

Liste de paramètres

parser
Le parseur XML.
handler

Si null est passé, le gestionnaire est réinitialisé à son état par défaut.

Avertissement

Une chaîne vide réinitialisera également le gestionnaire, cependant cette fonctionnalité est dépréciée à partir de PHP 8.4.0.

Si handler est un callable, l'appelable est défini comme le gestionnaire.

Si handler est une string, il peut s'agir du nom d'une méthode d'un objet défini avec xml_set_object().

Avertissement

Cette fonctionnalité est dépréciée à partir de PHP 8.4.0.

Avertissement

À partir de PHP 8.4.0, la validité du callable est vérifiée lors de la configuration du gestionnaire, et non au moment de son appel. Cela signifie que xml_set_object() doit être appelé avant de définir une méthode sous forme de chaîne comme rappel. Cependant, comme ce comportement est également déprécié à partir de PHP 8.4.0, il est recommandé d'utiliser un callable approprié pour la méthode.

La signature du gestionnaire doit être :

function handler(XMLParser $parser, string|false $prefix)
parser
Le parseur XML appelant le gestionnaire.
prefix
Le préfixe est une chaîne de caractères utilisée pour référencer le namespace dans un objet. false si aucun préfixe n'existe.

Valeurs de retour

Retourne toujours true.

Historique

Version Description
8.4.0 Passer une string non-callable à handler est désormais obsolète, utiliser un callable adéquat pour les méthodes, ou null pour réinitialiser le gestionnaire.
8.4.0 La validité de handler en tant que callable est désormais vérifiée lors de la définition du gestionnaire au lieu d'être vérifiée lors de son appel.
8.0.0 parser attend une instance de XMLParser désormais; auparavent, une resource xml était attendue.

Voir aussi

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top