Funciones de Manejo de Errores
PHP Manual

set_exception_handler

(PHP 5)

set_exception_handler Establece una función de gestión de excepciones definida por el usuario

Descripción

callable set_exception_handler ( callable $exception_handler )

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. Esta función debe ser definida antes de llamar a set_exception_handler(). Esta función de gestión necesita aceptar un parámetro, que será el objeto de excepción que fue lanzado. Esta es la firma del gestor:

void handler ( Exception $ex )

NULL podrí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


Funciones de Manejo de Errores
PHP Manual