set_exception_handler

(PHP 5)

set_exception_handler --  Define uma função definida pelo usuário para tratamento de exceções

Descrição

string set_exception_handler ( callback exception_handler )

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.

A função exception_handler deve ser definida antes da chamada de set_exception_handler(). Essa função de tratamento precisa aceitar um parâmetro, que será o objeto da exceção que foi disparado.

Parâmetros

exception_handler

Nome da função à ser chamada quando uma exceção não pega ocorrer.

Valores de 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

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