Affecte les gestionnaires d'entités non déclarées

Description

xml_set_unparsed_entity_decl_handler(XMLParser $parser, callable $handler): true

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éer parser.

La fonction handler doit accepter six paramètres :

handler(
    XMLParser $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

Retourne toujours true.

Historique

Version	Description
8.0.0	`parser` attend une instance de XMLParser désormais; auparavent, une resource `xml` était attendue.