set_exception_handler
(PHP 5)
set_exception_handler — Define uma função definida pelo usuário para tratamento de exceções
Descrição
Define o tratador de exceção padrão se uma exceção não for pega em um bloco try/catch. A Execução não parará depois que exception_handler é chamada.
Parâmetros
- exception_handler
-
Nome da função à ser chamada quando uma exceção não pega ocorrer. Essa função deve ser definida antes de chamar set_exception_handler(). Essa função de tratamento precisa aceitar um parâmetro, que será o objeto da exceção que foi disparado.
Valor Retornado
Retorna o nome do tratador padrão de exceção anterior, ou NULL em caso de erro. Se nenhum tratador anterior foi definido, o retorno também será NULL.
Exemplos
Example#1 Um exemplo de set_exception_handler()
<?php
function exception_handler($exception) {
echo "Uncaught exception: " , $exception->getMessage(), "\n";
}
set_exception_handler('exception_handler');
throw new Exception('Uncaught Exception');
echo "Not Executed\n";
?>
Veja também
restore_exception_handler(), restore_error_handler(), error_reporting(), informações sobre o tipo callback, e Exceções do PHP 5.