set_exception_handler

(PHP 5, PHP 7, PHP 8)

set_exception_handler — Installiert einen benutzerdefinierten Exceptionhandler

Beschreibung

set_exception_handler(?callable $callback): ?callable

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:

handler(Throwable $ex): void

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