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

# xml_set_unparsed_entity_decl_handler

(PHP 4, PHP 5, PHP 7)

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

### Description

xml_set_unparsed_entity_decl_handler ( resource `$parser` , callable `$handler` ) : bool

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 ( 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.
  `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

Cette fonction retourne `TRUE` en cas de succès ou `FALSE` si une erreur survient.