trigger_error
Erzeugt eine benutzerdefinierte Fehlermeldung/Warnung/Benachrichtigung
&reftitle.description;
truetrigger_errorstringmessageinterror_levelE_USER_NOTICE
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.
&reftitle.parameters;
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.
Die Übergabe von E_USER_ERROR als
error_level ist nun veraltet.
Stattdessen sollte eine Exception
geworfen oder exit aufgerufen werden.
&reftitle.returnvalues;
&return.true.always;
&reftitle.errors;
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.
&reftitle.changelog;
&Version;&Description;8.4.0
Die Übergabe von E_USER_ERROR als
error_level ist nun veraltet.
Stattdessen sollte eine Exception
geworfen oder exit aufgerufen werden.
8.4.0
Die Funktion hat nun den Rückgabetyp true statt
bool.
8.0.0
Die Funktion wirft nun einen ValueError, wenn
ein ungültiges error_level angegeben wird; zuvor
gab sie &false; zurück.
&reftitle.examples;
trigger_error-Beispiel
Siehe auch set_error_handler für ein ausführlicheres
Beispiel.
]]>
&reftitle.notes;
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.
&reftitle.seealso;
error_reportingset_error_handlerrestore_error_handlerDie Error Level KonstantenDas Attribut Deprecated