xml_set_default_handler
En esta página
xml_set_default_handler
Establece el gestor XML por defecto
Descripción#
xml_set_default_handler(XMLParser $parser, callable $handler): true
```php
Establece el gestor por defecto del analizador XML `parser`.
## Parámetros
`parser`
El analizador XML.
`handler`
Si `null` se pasa, el controlador se reinicia a su estado predeterminado.
> [!WARNING]
> Una cadena vacía también reiniciará el controlador, sin embargo esta funcionalidad está deprecada a partir de PHP 8.4.0.
Si `handler` es un `callable`, el callable se define como el controlador.
Si `handler` es una `string`, puede ser el nombre de un método de un objeto definido con `xml_set_object`.
> [!WARNING]
> Esta funcionalidad está deprecada a partir de PHP 8.4.0.
> [!WARNING]
> A partir de PHP 8.4.0, se verifica la validez del callable durante la configuración del controlador, y no en el momento de su llamada. Esto significa que `xml_set_object` debe ser llamado antes de definir un método como cadena como devolución de llamada. Sin embargo, como este comportamiento también está deprecado a partir de PHP 8.4.0, se recomienda utilizar un `callable` adecuado para el método.
La firma del gestor debe ser:
```php
handler(XMLParser $parser, string $data): void
parser
El analizador XML que llama al controlador.
data
data contiene los caracteres en forma de string. Puede ser una declaración XML, un tipo de documento, una entidad u otros datos para los cuales no se prevé ningún gestor.
Valores devueltos#
Retorna siempre true.
Historial de cambios#
| Versión | Descripción |
|---|---|
| 8.4.0 | Pasar un valor no callable de tipo string a handler ahora está obsoleto; utilice un callable apropiado para los métodos, o null para reinicializar el gestor. |
| 8.4.0 | La validez de handler como callable ahora se verifica al definir el gestor en lugar de verificarse al invocarlo. |
| 8.0.0 | parser ahora espera una instancia de XMLParser ; anteriormente, se esperaba un recurso xml de tipo resource válido. |