restore_exception_handler

(PHP 5, PHP 7, PHP 8)

restore_exception_handler — Restaura la función de gestión de excepciones previamente definida

Descripción

restore_exception_handler(): true

Usada después de cambiar la función de gestión de excepciones al utilizar set_exception_handler(), para volver al gestor de excepciones anterior (el cuál puede ser la función interna o una definida por el usuario).

Parámetros

Esta función no tiene parámetros.

Valores devueltos

Siempre devuelve true.

Ejemplos

Ejemplo #1 Ejemplo de restore_exception_handler()

<?php
    function gestor_excepciones_1(Exception $e)
    {
        echo '[' . __FUNCTION__ . '] ' . $e->getMessage();
    }

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

    set_exception_handler('gestor_excepciones_1');
    set_exception_handler('gestor_excepciones_2');

    restore_exception_handler();

    throw new Exception('Esto dispara el primer gestor de excepciones...');
?>

El resultado del ejemplo sería:

[gestor_excepciones_1] Esto dispara el primer gestor de excepciones...

Ver también

set_exception_handler() - Establece una función de gestión de excepciones definida por el usuario
set_error_handler() - Establecer una función de gestión de errores definida por el usuario
restore_error_handler() - Recupera la función de gestión de errores previa
error_reporting() - Establece cuáles errores de PHP son notificados

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

rl7 at shinyblue dot net ¶

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

?>

＋add a note