set_exception_handler
(PHP 5)
set_exception_handler — Establece una función de gestión de excepciones definida por el usuario
Descripción
Establece el gestor de excepciones predeterminado si una excepción no es capturada dentro de un
bloque try/catch. La ejecución se detendrá después de la
llamada a exception_handler.
Parámetros
-
exception_handler -
Nombre de la función a llamar cuando ocurra una excepción no capturada. Es necesario que esta función de gestión acepte un parámetro, que será el objeto de excepción que fue lanzado. Esta es la firma del gestor:
NULLpodría pasarse en su lugar para reiniciar este gestor a su estado predeterminado.
Valores devueltos
Devuelve el nombre del gestor de excepciones definido anteriormente, o NULL en caso de error. Si
no se definió un gestor anterior también devolverá NULL.
Historial de cambios
| Versión | Descripción |
|---|---|
| 5.5.0 |
Anteriormente, si se pasaba NULL, esta función devolvía TRUE.
Devuelve el gestor anterior desde PHP 5.5.0.
|
Ejemplos
Ejemplo #1 Ejemplo de set_exception_handler()
<?php
function gestor_excepciones($excepción) {
echo "Excepción no capturada: " , $excepción->getMessage(), "\n";
}
set_exception_handler('gestor_excepciones');
throw new Exception('Excepción No Capturada');
echo "No Ejecutado\n";
?>
Ver también
- restore_exception_handler() - Restaura la función de gestión de excepciones previamente definida
- restore_error_handler() - Recupera la función de gestión de errores previa
- error_reporting() - Establece cuáles errores de PHP son notificados
- información acerca de tipos de llamada de retorno
- Excepciones de PHP 5