set_exception_handler

(PHP 5)

set_exception_handler Задает пользовательский обработчик исключений

Описание

callback set_exception_handler ( callback $exception_handler )

Задает обработчик по умолчанию для случаев, когда исключение выброшено вне блока try/catch. После вызова exception_handler выполнение будет остановлено.

Список параметров

exception_handler

Имя функции, которая будет вызываться каждый раз, когда выбрасывается неперехватываемое исключение. Эта функция должна быть определена до вызова set_exception_handler(). Функция-обработчик должна принимать один аргумент - объект, представляющий выброшенное исключение.

Замечание:

В качестве этого аргумента можно передать NULL. В этом случае обработчик вернется к своему изначальному состоянию.

Возвращаемые значения

Возвращает имя предыдущего заданного обработчика или NULL в случае ошибки. Если предыдущих обработчиков определено не было, то также возвращается NULL. Если в качестве аргумента передан NULL, обработчик вернется к изначальному состоянию и будет возвращено значение TRUE.

Примеры

Пример #1 Пример использования set_exception_handler()

<?php
function exception_handler($exception) {
  echo 
"Неперехватываемое исключение: " $exception->getMessage(), "\n";
}

set_exception_handler('exception_handler');

throw new 
Exception('Неперехватываемое исключение');
echo 
"Не выполнено\n";
?>

Смотрите также


Участник рейтинга Тэглайн 2010