Manuel PHP

Précédent

 

Suivant

xml_set_external_entity_ref_handler

xml_set_external_entity_ref_handler -- Affecte le gestionnaire d'entité externe

Description

int xml_set_external_entity_ref_handler(int parser, string handler);

Affecte le gestionnaire d'entité externe de l'analyseur XML parser. startElementHandler et endElementHandler sont des chaînes qui contiennent les noms de fonctions qui existent lorsque xml_parse() est appelé pour créer le parser.

La fonction handler doit accepter 5 paramètres, et retourner un entier. Si la valeur retourné par le gestionnaire est false (comme par exemple si aucune valeur n'est retournée), l'analyseur XML s'arrêtera, et la fonction xml_get_error_code() retournera XML_ERROR_EXTERNAL_ENTITY_HANDLING.

int handler(int parser, string openEntityNames, string base, string systemId, string publicId);

parser
Le premier paramètre, parser, est une référence sur l'analyseur XML qui appelle cette fonction.
 
openEntityNames
Le deuxième paramètre, openEntityNames, est i,e liste de noms d'entité, séparés par des espaces. Ces entités sont accessibles à l'analyse par cette entité (y compris le nom de l'entité reférencé).
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()).
publicId
Le cinquième paramètre, publicId, est l'identifiant public comme spécifié dans la déclaration de l'entité, ou une chaîne vide si il n'a pas été spécifié. Les espaces dans le nom de l'identifiant doivent avoir été normalisés comme précisés dans les spécifications XML.

Si un gestionnaire reçoit une chaîne vide, ou faux (false), c'est qu'il est en train d'être désactivé.

Retourne true si le gestionnaire est actif, et false sinon, ou si parser n'est pas un analyseur.

Il n'est pas pour l'instant possible d'utiliser des objets pour servir de gestionnaires

Précédent

Sommaire

Suivant

xml_set_notation_decl_handler

Chapitre

xml_parse