trigger_error
(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
trigger_error — Erzeugt eine benutzerdefinierte Fehlermeldung/Warnung/Benachrichtigung
Beschreibung
$message, int $error_level = E_USER_NOTICE): boolWird verwendet, um eine benutzerdefinierte Fehlerbedingung auszulösen und kann in Verbindung mit der eingebauten Fehlerbehandlung verwendet werden oder mit einer benutzerdefinierten Funktion, die mittels set_error_handler() als neue Fehlerbehandlung festgelegt wurde.
Diese Funktion ist nützlich, wenn Sie zur Laufzeit eine bestimmte Rückmeldung bei einer Ausnahme brauchen.
Parameter-Liste
-
message -
Die gewünschte Fehlermeldung für diesen Fehler. Die Länge ist auf 1024 Bytes begrenzt, darüber hinausgehende Zeichen werden abgeschnitten.
-
error_level -
Der gewünschte Fehlertyp für diesen Fehler. Es können nur Konstanten der E_USER-Familie gewählt werden, der Vorgabewert ist
E_USER_NOTICE.
Rückgabewerte
Die Funktion gibt false zurück, wenn ein falsches
error_level übergeben wurde, sonst true
Beispiele
Beispiel #1 trigger_error()-Beispiel
Siehe auch set_error_handler() für ein ausführlicheres Beispiel.
<?php
if ($divisor == 0) {
trigger_error("Kann nicht durch 0 teilen", E_USER_ERROR);
}
?>
Anmerkungen
Die HTML-Entities in der error_msg werden nicht
automatisch maskiert. Wenn die Fehlermeldung in einem Browser ausgegeben
werden soll, so sollten Sie diese mit htmlentities()
vorverarbeiten.
Siehe auch
- error_reporting() - Gibt an, welche PHP-Fehlermeldungen gemeldet werden
- set_error_handler() - Bestimmt eine benutzerdefinierte Funktion zur Fehlerbehandlung
- restore_error_handler() - Rekonstruiert die zuvor benutzte Fehlerbehandlungsfunktion
- Die Error Level Konstanten
