7.109.35 xml_set_unparsed_entity_decl_handler()
Affecte les gestionnaires d'entités non déclarés
[ Exemples avec xml_set_unparsed_entity_decl_handler ] PHP 3>= 3.0.6, PHP 4
bool
xml_set_unparsed_entity_decl_handler (
resource
parser
,
callback
handler
)
xml_set_unparsed_entity_decl_handler
affecte les gestionnaires d'entité non déclaré 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:
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.
-
entityname
-
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.
-
systemid
-
Identifiant système pour cet entité externe.
-
publicid
-
Identifiant public pour cet 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 |
A 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é.
|
|