# xml_set_unparsed_entity_decl_handler

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_set_unparsed_entity_decl_handler — Configura el manejador de declaración de entidades no analizadas

### Descripción

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

Configura la función del manejador de declaración de entidades no analizadas para el intérprete XML `parser`.

El `handler` será llamado si el intérprete XML encuentra una declaración de entidad externa con una declaración NDATA, como la siguiente:

    <!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>}
            NDATA <parameter>notationName</parameter>

Para la definición de notación de NDATA ver » sección 4.2.2 de las especificaciones XML 1.0.

### Parámetros

`parser`

  Identificador del recurso del intérprete XML para el que se va a configurar la función del manejador de declaración de entidades no analizadas.

`handler`

  `handler` es un string que contiene el nombre de una función que debe existir cuando xml_parse() es llamado por `parser`.

  La función llamada mediante `handler` debe aceptar seis parámetros:

  handler(
  XMLParser `$parser`,
  string `$entity_name`,
  string `$base`,
  string `$system_id`,
  string `$public_id`,
  string `$notation_name`
  )
  `parser`
    El primer parámetro, parser, hace referencia al intérprete XML que llama al manejador.
  `entity_name`
    El nombre de la entidad que está a punto de definirse.
  `base`
    Esta es la base para resolver el identificador de sistema (`system_id`) de la declaración de notación. Actualmente este parámetro siempre se establecerá como una cadena vacia.
  `system_id`
    Identificador de sistema de la declaración de notación externa.
  `public_id`
    Identificador público de la declaración de notación externa.
  `notation_name`
    Nombre de la notación de esta entidad (ver xml_set_notation_decl_handler()).

  Si la función del manejador se configura como una cadena vacia, o `false`, el manejador en cuestión se deshabilita.

  > Nota: En lugar del nombre de una función, se puede asignar un array que contenga la referencia a un objeto o el nombre de un método.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `parser` expects an XMLParser instance now; previously, a valid `xml` resource was expected.