PHP xml_set_external_entity_ref_handler() Fonction

❮ Référence du parseur XML PHP

Exemple

Créez un parseur XML, définissez un gestionnaire de données de caractères, un gestionnaire de référence d'entité externe et analysez un document XML :

<?php
// Créer un parseur XML
$parser=xml_parser_create();

function char($parser,$data) {
echo $data;
}

function ext_ent_handler($parser,$ent,$base,$sysID,$pubID) {
echo "$ent<br>";
echo "$sysID<br>";
echo "$pubID<br>";
}

// Définir le gestionnaire de données de caractères
xml_set_character_data_handler($parser,"char");

// Définir le gestionnaire de référence d'entité externe
xml_set_external_entity_ref_handler($parser, "ext_ent_handler");

$fp=fopen("note_entity.xml","r");

while ($data=fread($fp,4096)) {
// Analyser les données XML
xml_parse($parser,$data,feof($fp)) or
die (sprintf("Erreur XML: %s à la ligne %d",
xml_error_string(xml_get_error_code($parser)),
xml_get_current_line_number($parser)));
}

xml_parser_free($parser);
fclose($fp);
?>


Définition et Utilisation

La fonction xml_set_external_entity_ref_handler() spécifie une fonction à appeler lorsque le parseur trouve une entité externe dans le document XML.

Remarque : Le paramètre gestionnaire peut également être un tableau contenant une référence d'objet et un nom de méthode.

Syntaxe

xml_set_external_entity_ref_handler( parser , handler )

Valeurs des Paramètres

Paramètre Description
parser Requis. Spécifie le parseur XML à utiliser.
handler Requis. Spécifie une fonction à utiliser comme gestionnaire d'événements. La fonction doit accepter cinq paramètres :
  • $parser - Une variable contenant le parseur XML appelant le gestionnaire
  • $name - Une variable contenant le nom de l'entité externe
  • $base - La base pour résoudre l'identifiant système (system_id) de l'entité externe. Actuellement, c'est toujours une chaîne vide
  • $system_id - L'identifiant système tel que spécifié dans la déclaration de l'entité
  • $public_id - L'identifiant public tel que spécifié dans la déclaration de l'entité


Détails Techniques

Valeur de Retour : TRUE en cas de succès. FALSE en cas d'échec.
Version PHP : 4.0+

❮ Référence du parseur XML PHP