set_exception_handler

(PHP 5, PHP 7, PHP 8)

set_exception_handler — Define uma função de manipulação de exceção definida pelo usuário

Descrição

set_exception_handler(?callable $callback): ?callable

Define o manipulador de exceção padrão se uma exceção não for capturada dentro de um bloco try/catch. A execução irá parar após a função definida no parâmetro callback for chamada.

Parâmetros

callback

A função a ser chamada quando uma exceção não capturada ocorrer. Esta função de manipulação precisa aceitar um parâmetro, que será o objeto Throwable que foi lançado. Tanto Error quanto Exception implementam a interface Throwable. Esta é a assinatura do manipulador:

handler(Throwable $ex): void

null pode ser passardo no lugar, para redefinir este manipulador ao seu estado inicial.

Valor Retornado

Retorna o manipulador de exceção anteriormente definido, ou null em caso de erro. Se nenhum manipulador anterior estava definido, null também é retornado.

Exemplos

Example #1 Exemplo de set_exception_handler()

<?php
function exception_handler(Throwable $exception) {
  echo "Exceção não capturada: " , $exception->getMessage(), "\n";
}

set_exception_handler('exception_handler');

throw new Exception('Exceção Não Capturada');
echo "Não Executado\n";
?>

Veja Também