xml_set_start_namespace_decl_handler
(PHP 4 >= 4.0.5, PHP 5)
xml_set_start_namespace_decl_handler — Configure le gestionnaire de caractères
Description
Définit le gestionnaire à appeler lorsque l'espace de noms 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
-
Une référence vers l'analyseur XML.
-
handler
-
handler
est une chaîne contenant le nom d'une fonction devant exister lorsque la fonction xml_parse() est appelé pour l'analyseurparser
.La fonction nommée par le paramètre
handler
doit accepter 3 paramètres, et doit retourner une valeur entière. Si la valeur retournée par le gestionnaire vautFALSE
(ce qui sera le cas lorsqu'aucune valeur n'est retourné), l'analyseur XML arrêtera l'analyse et la fonction xml_get_error_code() retourneraXML_ERROR_EXTERNAL_ENTITY_HANDLING
.handler ( resource$parser
, string$prefix
, string$uri
)-
parser
-
Le premier paramètre,
parser
, est une référence à l'analyseur XML appelée par le gestionnaire. -
prefix
- Le préfixe est une chaîne de caractères utilisée pour référencer l'espace de noms d'un objet XML.
-
uri
- Identifiant de ressource uniforme (URI) d'un espace de noms.
Si une chaîne vide, ou la valeur
FALSE
, est passée en guise de fonction pour le gestionnaire, il sera 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.