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.

Warnung

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 dieses (bitweisen) Ausdrucks zurück: E_ERROR | E_CORE_ERROR | E_COMPILE_ERROR | E_USER_ERROR | E_RECOVERABLE_ERROR | E_PARSE.

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 wie if und foreach und so weiter.

Warnung

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.

Siehe auch