set_exception_handler

(PHP 5, PHP 7, PHP 8)

set_exception_handler Define una función de usuario para gestionar excepciones

Descripción

set_exception_handler(?callable $callback): ?callable

set_exception_handler() define el manejador de excepciones por defecto si una excepción no es capturada con un bloque de prueba/atrapa. La ejecución se detendrá después de la llamada a la función callback.

Parámetros

callback

La función a llamar cuando ocurre una excepción no capturada. Esta función de gestión debe aceptar un argumento, que será el objeto Throwable que fue lanzado. Las clases Error y Exception implementan la interfaz Throwable. Esta es la firma del manejador:

handler(Throwable $ex): void

null puede ser pasado en su lugar, para re-initializar este manejador a su estado inicial.

Valores devueltos

Retorna el manejador previamente definido o null en caso de error. Si ningún manejador fue previamente definido, null es también retornado.

Ejemplos

Ejemplo #1 Ejemplo con set_exception_handler()

<?php
function exception_handler(Throwable $exception) {
echo
"Excepción no capturada: " , $exception->getMessage(), "\n";
}

set_exception_handler('exception_handler');

throw new
Exception('Excepción no capturada');
echo
"No ejecutado\n";
?>

Ver también