set_exception_handler - Задает пользовательский обработчик исключений
Вернуться к: Функции обработки ошибок
set_exception_handler
(PHP 5, PHP 7)
set_exception_handler — Задает пользовательский обработчик исключений
Описание
Задает обработчик по умолчанию для случаев, когда исключение выброшено
вне блока try/catch. После вызова exception_handler
выполнение будет остановлено.
Список параметров
-
exception_handler -
Имя функции, которая будет вызываться каждый раз, когда выбрасывается неперехватываемое исключение. Функция-обработчик должна принимать один аргумент - объект, представляющий выброшенное исключение.
В качестве этого аргумента можно передать
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";
?>
Смотрите также
- restore_exception_handler() - Восстанавливает предыдущий обработчик исключений
- restore_error_handler() - Восстанавливает предыдущий обработчик ошибок
- error_reporting() - Задает, какие ошибки PHP попадут в отчет
- информация о типе callback
- Исключения PHP 5
Вернуться к: Функции обработки ошибок