(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
trigger_error — Erzeugt eine benutzerdefinierte Fehlermeldung/Warnung/Benachrichtigung
Wird 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.
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
.
Gibt immer true
zurück.
Wenn error_level
nicht einer der Werte E_USER_ERROR
, E_USER_WARNING
, E_USER_NOTICE
, E_USER_DEPRECATED
ist, wirft diese Funktion einen ValueError.
Version | Beschreibung |
---|---|
8.0.0 | Die Funktion wirft nun einen ValueError, wenn ein ungültiges error_level angegeben wird; zuvor gab sie false zurück. |
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);
}
?>
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.