xml_set_element_handler

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_set_element_handlerAffecte les gestionnaires de début et de fin de balise XML

Description

xml_set_element_handler(XMLParser$parser, callable$start_handler, callable$end_handler): true

Affecte les gestionnaires de début et de fin de l'analyseur XML parser.

start_handler est appelé quand un nouvel élément XML est ouvert. end_handler est appelé quand un élément XML est fermé.

Liste de paramètres

parser

Le parseur XML.

start_handler

Si null ou une chaîne vide est passée, le gestionnaire est réinitialisé à son état par défaut.

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().

La signature du gestionnaire doit être :

start_element_handler(XMLParser$parser, string$name, array$attributes): void
parser
Le parseur XML appelant le gestionnaire.
name
Contient le nom de l'élément qui a provoqué l'appel du gestionnaire. Si l'analyseur gère la casse, cet élément sera en majuscules.
attributes
Un tableau associatif avec les attributs de l'élément. Le tableau est vide s'il n'y a pas d'attributs. Les clés de ce tableau seront les noms des attributs, et les valeurs seront les valeurs correspondantes des attributs. Les noms des attributs seront mis en majuscules si l'analyseur gère la casse. Les valeurs des attributs seront inchangées. L'ordre dans lequel attributes est traversé est identique à l'ordre dans lequel les attributs ont été déclaré.
end_handler

Si null ou une chaîne vide est passée, le gestionnaire est réinitialisé à son état par défaut.

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().

La signature du gestionnaire doit être :

end_element_handler(XMLParser$parser, string$name): void
parser
Le parseur XML appelant le gestionnaire.
name
Contient le nom de l'élément qui a provoqué l'appel du gestionnaire. Si l'analyseur gère la casse, cet élément sera en majuscules.

Valeurs de retour

Retourne toujours true.

Historique

VersionDescription
8.0.0parser attend une instance de XMLParser désormais; auparavent, une resourcexml était attendue.
To Top