xml_set_unparsed_entity_decl_handler
(PHP 4, PHP 5)
xml_set_unparsed_entity_decl_handler — Affecte les gestionnaires d'entités non déclarées
Description
xml_set_unparsed_entity_decl_handler() affecte les gestionnaires d'entités non déclarées de l'analyseur XML parser . handler est une chaîne qui contient le nom d'une fonction qui existe lorsque xml_parse() est appelé pour créer parser .
Ce gestionnaire sera appelé si l'analyseur XML rencontre une déclaration d'entité externe avec une déclaration de NDATA, comme suit :
<!ENTITY <parameter>name</parameter> {<parameter>publicid</parameter> | <parameter>systemid</parameter>} NDATA <parameter>notationname</parameter>
Reportez-vous à la section » des spécifications XML 1.0 pour connaître les notations des entités externes.
La fonction handler doit accepter six paramètres:
- parser
- Le premier paramètre, parser, est une référence sur l'analyseur XML qui appelle cette fonction.
- entity_name
- Le nom de l'entité qui va être définie
- base
- La meilleure base de résolution de l'identifiant système de cette entité externe. Actuellement, ce paramètre est toujours une chaîne vide.
- system_id
- Identifiant système pour cette entité externe.
- public_id
- Identifiant public pour cette entité externe.
- notationname
- Nom de la notation de cette entité. (Voir xml_set_notation_decl_handler().)
Si un gestionnaire reçoit une chaîne vide ou FALSE, c'est qu'il est en train d'être désactivé.
xml_set_unparsed_entity_decl_handler() retourne TRUE si le gestionnaire est actif, et FALSE sinon, ou si parser n'est pas un analyseur.
Note: À la place d'un nom de fonction, un tableau contenant une référence d'objet et un nom de méthode peut aussi être utilisé.