PHP 8.6.0 Released!

restore_exception_handler

(PHP 5, PHP 7, PHP 8)

restore_exception_handler — Ripristina la funzione di gestione delle eccezioni definita in precedenza

Descrizione

function restore_exception_handler(): true

Usata dopo aver cambiato la funzione di gestione delle eccezioni tramite set_exception_handler(), per tornare al gestore delle eccezioni precedente (che può essere quello predefinito o una funzione definita dall'utente).

Nota:

Mentre un gestore delle eccezioni è in esecuzione, nessun gestore delle eccezioni è attivo: a partire da PHP 8.3.0 il motore lo rimuove prima di invocarlo, in modo che un'eccezione lanciata dal gestore non gli venga ripassata.

A partire da PHP 8.3.5 il motore inserisce inoltre nello stack dei gestori il gestore che sta per invocare. Una chiamata a restore_exception_handler() effettuata dall'interno di un gestore delle eccezioni rimuove quindi quella voce e reinstalla il gestore attualmente in esecuzione; è necessaria una seconda chiamata per installare il gestore che era attivo prima di esso.

Il gestore in esecuzione viene reinstallato automaticamente quando termina, ma solo se in quel momento non è attivo alcun gestore delle eccezioni: un gestore che chiama set_exception_handler() or restore_exception_handler() resta responsabile dello stack dei gestori.

Elenco dei parametri

Questa funzione non contiene parametri.

Valori restituiti

Always returns true.

Log delle modifiche

Versione Descrizione
8.3.5 Il gestore delle eccezioni in fase di invocazione viene ora inserito nello stack dei gestori, quindi restore_exception_handler(), chiamata dall'interno di un gestore delle eccezioni, reinstalla il gestore attualmente in esecuzione; per ripristinare il gestore che era attivo prima di esso sono ora necessarie due chiamate.
8.3.0 Il gestore delle eccezioni attivo viene ora rimosso mentre è in esecuzione.

Esempi

Example #1 Esempio di 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('Questo attiva il primo gestore delle eccezioni...');
?>

Il precedente esempio visualizzerà:

[exception_handler_1] Questo attiva il primo gestore delle eccezioni...

Vedere anche:

+add a note

User Contributed Notes 1 note

up
13
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
*/

?>
To Top