set_exception_handler
(PHP 5, PHP 7, PHP 8)
set_exception_handler — Installiert einen benutzerdefinierten Exceptionhandler
Beschreibung
Setzt den Standard-Exceptionhandler für Exceptions, die nicht von einem
try/catch-Block aufgefangen wurden. Nach dem Aufruf von
callback wird die Ausführung angehalten.
Parameter-Liste
-
callback -
Die Funktion, die aufgerufen werden soll, wenn eine nicht aufgefangene Exception auftritt. Diese Handler-Funktion muss einen Parameter akzeptieren, und zwar das Throwable-Objekt, das ausgelöst wurde. Sowohl Error als auch Exception implementieren das Throwable-Interface. Dies ist die Handler-Signatur:
Stattdessen kann
nullübergeben werden, um den Handler auf seinen Standardwert zurückzusetzen.
Rückgabewerte
Gibt den zuvor definierten Exception-Handler zurück oder null bei
Fehlern oder wenn kein vorheriger Exception-Handler definiert war.
Beispiele
Beispiel #1 set_exception_handler()-Beispiel
<?php
function exception_handler(Throwable $exception) {
echo "Nicht aufgefangene Exception: " , $exception->getMessage(), "\n";
}
set_exception_handler('exception_handler');
throw new Exception('Nicht aufgefangene Exception');
echo "Nicht ausgeführt.\n";
?>
Siehe auch
- restore_exception_handler() - Stellt den vorherigen Exceptionhandler wieder her
- restore_error_handler() - Rekonstruiert die zuvor benutzte Fehlerbehandlungsfunktion
- error_reporting() - Gibt an, welche PHP-Fehlermeldungen gemeldet werden
- PHP 5 Exceptions
