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
Affecte les gestionnaires d'entités non déclarées de
l'analyseur XML parser
.
Le gestionnaire parser
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.
Liste de paramètres
-
parser
-
Une référence à l'analyseur XML à définir à la fonction utilisée par traiter les déclarations d'entités non-analysées.
-
handler
-
handler
est une chaîne qui contient le nom d'une fonction qui existe lorsque xml_parse() est appelé pour créerparser
.La fonction
handler
doit accepter six paramètres :handler ( resource$parser
, string$entity_name
, string$base
, string$system_id
, string$public_id
, string$notation_name
)-
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.
-
notation_name
- 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é.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é.
-
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.