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

get_exception_handler() - Devuelve la función de gestión de excepciones definida por el usuario
restore_exception_handler() - Reactiva la antigua función de gestión de excepciones
restore_error_handler() - Restaura la función anterior de manejo de errores
error_reporting() - Establece el nivel de reporte de errores de PHP
Las excepciones