array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.xml-set-start-namespace-decl-handler.php', 1 => 'xml_set_start_namespace_decl_handler', 2 => 'Configure le gestionnaire de début de déclaration de namespace', ), 'up' => array ( 0 => 'ref.xml.php', 1 => 'Fonctions d\'analyse de fichier XML', ), 'prev' => array ( 0 => 'function.xml-set-processing-instruction-handler.php', 1 => 'xml_set_processing_instruction_handler', ), 'next' => array ( 0 => 'function.xml-set-unparsed-entity-decl-handler.php', 1 => 'xml_set_unparsed_entity_decl_handler', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/xml/functions/xml-set-start-namespace-decl-handler.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

xml_set_start_namespace_decl_handler

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

xml_set_start_namespace_decl_handler — Configure le gestionnaire de début de déclaration de namespace

Description

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

Définit le gestionnaire à appeler lorsque le namespace est déclaré. Les déclarations d'espace de noms surviennent dans les balises de départ. Mais le gestionnaire de départ, appelé lors de la déclaration de l'espace de noms, est appelé avant le gestionnaire de la balise de départ pour chaque espace de noms déclaré dans cette balise.

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 :

handler(XMLParser $parser, string|false $prefix, string $uri): void
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 d'un objet XML. false si aucun préfixe n'existe.
uri
Identifiant de ressource uniforme (URI) d'un espace de noms.

Valeurs de retour

Retourne toujours true.

Historique

Version Description
8.4.0 Passing a non-callable string to handler is now deprecated, use a proper callable for methods, or null to reset the handler.
8.4.0 The validity of handler as a callable is now checked when setting the handler instead of checking when calling it.
8.0.0 parser attend une instance de XMLParser désormais; auparavent, une resource xml était attendue.

Voir aussi