restore_exception_handler

(PHP 5, PHP 7, PHP 8)

restore_exception_handler — Восстанавливает предыдущую функцию обработчика исключений

Описание

function restore_exception_handler(): true

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

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

Сигнатура функции не содержит параметров.

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

Функция возвращает логическое значение true.

Примеры

Пример #1 Пример восстановления предыдущего обработчика исключений функцией restore_exception_handler()

<?php

function exception_handler_1(Exception $e)
{
    echo '[' . __FUNCTION__ . '] ' . $e->getMessage();
}

function exception_handler_2(Exception $e)
{
    echo '[' . __FUNCTION__ . '] ' . $e->getMessage();
}

set_exception_handler('exception_handler_1');
set_exception_handler('exception_handler_2');

restore_exception_handler();

throw new Exception('Эта инструкция запустит первый обработчик исключений...');

?>

Результат выполнения приведённого примера:

[exception_handler_1] Эта инструкция запустит первый обработчик исключений...

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

set_exception_handler() - Устанавливает пользовательскую функцию обработчика исключений
get_exception_handler() - Получает пользовательскую функцию обработчика исключений
set_error_handler() - Устанавливает пользовательский обработчик ошибок
restore_error_handler() - Восстанавливает предыдущую функцию обработчика ошибок
error_reporting() - Определяет, о каких PHP-ошибках сообщать

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 1 note

down

rl7 at shinyblue dot net ¶

12 years ago

Note that this does not work within an exception handler.

e.g. 

<?php

function handler1(Exception $e) {
    echo "handler1\n";
    restore_exception_handler();
    throw $e;
}
function handler2(Exception $e) {
    echo "handler2\n";
}

set_exception_handler( 'handler2' );
set_exception_handler( 'handler1' );

throw new Exception( 'might expect to see handler1, handler2' );

/* Outputs:
handler1
PHP Fatal error:  Uncaught exception 'Exception' with message 'might expect to see handler1, handler2' in /tmp/demo.php:15
Stack trace:
#0 {main}
  thrown in /tmp/demo.php on line 15
*/

?>

＋Добавить