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

    Exemplo #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

    To Top