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

# 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

function 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:

  function handler(Throwable `$ex`): void

  `null` pode ser passado 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

- get_exception_handler() - Obtém a função de manipulação de exceção definida pelo usuário
- restore_exception_handler() - Restaura a função de manipulação de exceção anteriormente definida
- restore_error_handler() - Restaura a função anterior de gerenciamento de erro
- error_reporting() - Define quais erros do PHP são relatados
- Exceções

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open