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


(PHP 5)

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

Описание

callable set_exception_handler ( callable $exception_handler )

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

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

exception_handler

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

void handler ( Exception $ex )

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

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

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

Список изменений

Версия Описание
5.5.0 Раньше, если был передан 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";
?>

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