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.

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.