(PHP 5, PHP 7, PHP 8)

restore_exception_handler — Restores the previously defined exception handler function

Description

function restore_exception_handler(): true

Parameters

This function has no parameters.

Return Values

Always returns true.

Examples

<?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('This triggers the first exception handler...');
?>

[exception_handler_1] This triggers the first exception handler...

See Also

• set_exception_handler() - Sets a user-defined exception handler function
• get_exception_handler() - Gets the user-defined exception handler function
• set_error_handler() - Sets a user-defined error handler function
• restore_error_handler() - Restores the previous error handler function
• error_reporting() - Sets which PHP errors are reported

13

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
*/
?>