Operator zur Fehlerkontrolle
PHP unterstützt einen Operator für die Fehlerkontrolle: Das
@
-Symbol. Stellt man das @
in PHP
vor einen Ausdruck werden alle Fehlermeldungen, die von diesem Ausdruck
erzeugt werden könnten, unterdrückt.
Wurde eine benutzerdefinierte Fehlerbehandlungsfunktion mit set_error_handler() definiert, wird sie auch dann aufgerufen, wenn die Diagnose unterdrückt wurde.
Vor PHP 8.0.0 gab die Funktion error_reporting()
bei einem Aufruf innerhalb einer benutzerdefinierten Fehlerbehandlung
immer 0
zurück, wenn Fehler mit dem Operator
@
unterdückt wurden. Seit PHP 8.0.0 gibt sie den Wert
E_ERROR | E_CORE_ERROR | E_COMPILE_ERROR | E_USER_ERROR
| E_RECOVERABLE_ERROR | E_PARSE
zurück.
Alle Fehlermeldungen, die von diesem Ausdruck erzeugt werden, sind im
"message"
-Element des Arrays, das von
error_get_last() zurückgegeben wird, enthalten. Da sich
das Ergebnis dieser Funktion bei jedem Fehlers ändert, sollte es möglichst
früh geprüft werden.
<?php
/* Beabsichtigter Dateifehler */
$my_file = @file ('nicht_vorhandene_Datei') or
die ("Datei konnte nicht geöffnet werden: Fehler war:'" . error_get_last()['message'] . "'");
// Das funktioniert bei jedem Ausdruck, nicht nur bei Funktionen:
$value = @$cache[$key];
// gibt keine Meldung aus, falls der Index $key nicht vorhanden ist.
?>
Hinweis: Der @-Operator funktioniert nur bei Ausdrücken. Eine einfache Daumenregel: wenn der Wert von etwas bestimmt werden kann, dann kann der
@
-Operator davor geschrieben werden. Zum Beispiel kann er vor Variablen gesetzt werden, vor Funktionsaufrufen, vor Aufrufen bestimmter Sprachkonstrukte (z. B. include), und so weiter. Nicht verwendet werden kann er vor Funktions- oder Klassendefinitionen oder vor Kontrollstrukturen wieif
und foreach und so weiter.
Vor PHP 8.0.0 war es möglich, kritische Fehler, die die Skriptausführung
beenden, mit dem @
-Operator zu deaktivieren.
Wenn zum Beispiel @
dem Aufruf einer Funktion
vorangestellt wird, die nicht existiert, weil sie nicht verfügbar ist
oder falsch eingegeben wurde, würde das Skript ohne Hinweis auf die
Ursache abbrechen.