Função set_exception_handler() do PHP
Exemplo
Definir função de tratamento de exceções definida pelo usuário:
<?php // Função de tratamento de exceções definida pelo usuário function myException($exception) { echo "<b>Exception:</b> ", $exception->getMessage(); } // Definir manipulador de exceção personalizado set_exception_handler("myException"); // Lançar exceção throw new Exception("Ocorreu exceção não capturada!"); ?>
A saída do código acima é semelhante a esta:
Exception: Ocorreu exceção não capturada!
Definição e Uso
A função set_exception_handler() define um manipulador de exceção personalizado.
O script para de executar após a chamada deste manipulador de exceção.
Sintaxe
set_exception_handler(exceptionhandler);
Parâmetros | Descrição |
---|---|
exceptionhandler |
Obrigatório. Especifica o nome da função a ser chamada quando uma exceção não capturada ocorrer. Comentário:Também pode passar um valor NULL para resetar a função de manipulação de exceção para o valor padrão. |
Detalhes Técnicos
Retorno: |
Retorna uma string contendo o nome do manipulador de exceção definido anteriormente, ou NULL em caso de erro. Também retorna NULL se um manipulador de erro não foi definido anteriormente. Se NULL foi usado como parâmetro, o manipulador é resetado para o estado padrão e retorna TRUE. |
---|---|
Versão PHP: | 5.0+ |
Registro de Atualizações PHP: |
PHP 7.0.0: Passado para exception_handler O tipo do parâmetro foi alterado de Exception para Throwable. Antes do PHP 5.5, se NULL for passado, a função retorna TRUE. A partir do PHP 5.5, retorna o manipulador anterior. |