Fehlerbehandlungsfunktionen
PHP-Handbuch

error_reporting

Gibt an, welche PHP-Fehlermeldungen gemeldet werden

Beschreibung

int error_reporting ([ int $level ] )

Mit error_reporting wird die error_reporting Direktive zur Laufzeit des Programms gesetzt. In PHP gibt es viele Stufen für die Anzeige von Fehlermeldungen, die mit dieser Funktion für die Dauer der Programmausführung eingestellt werden kann. Wenn das optionale level Argument nicht übergeben wird, gibt error_reporting das aktuelle Error Level zurück.

Parameter-Liste

level

Das neue error_reporting Level. Es können sowohl eine numerische Bitmaske als auch benannte Konstanten übergeben werden. Der Einsatz benannter Konstanten wird empfohlen um die Kompatibilität mit zukünftigen Versionen sicherzustellen. Wann immer Error Level Konstanten hinzugefügt werden erweitert sich der genutzte Integerbereich so das ältere Integerkonstanten nicht unbedingt weiter das erwartete Verhalten zeigen.

Die verfügbaren Konstanten und die Bedeutungen der jeweiligen Error Level sind im Abschnitt Vordefinierte Konstanten beschrieben.

Rückgabewerte

Gibt den bisherigen error_reporting Wert zurück oder das aktuelle Level, wenn level nicht übergeben wurde.

Changelog

Version Beschreibung
5.4.0 E_STRICT ist nun in E_ALL enthalten.
5.3.0 E_DEPRECATED und E_USER_DEPRECATED wurden hinzugefügt.
5.2.0 E_RECOVERABLE_ERROR wurde hinzugefügt.
5.0.0 E_STRICT wurde hinzugefügt (ist aber nicht Teil von E_ALL).

Beispiele

Beispiel #1 error_reporting Beispiel

<?php

// Error Reporting komplett abschalten
error_reporting(0);

// Nur einfache Fehler melden
error_reporting(E_ERROR | E_WARNING | E_PARSE);

// E_NOTICE ist sinnvoll um uninitialisierte oder
// falsch geschriebene Variablen zu entdecken
error_reporting(E_ERROR | E_WARNING | E_PARSE | E_NOTICE);

// Melde alle Fehler außer E_NOTICE
error_reporting(E_ALL & ~E_NOTICE);

// Melde alle PHP Fehler (siehe Changelog)
error_reporting(E_ALL);

// Melde alle PHP Fehler
error_reporting(-1);

// Dies entspricht error_reporting(E_ALL);
ini_set('error_reporting', E_ALL);

?>

Anmerkungen

Warnung

Der Großteil der E_STRICT Fehler werden zur Compile-Zeit generiert und werden somit nicht angezeigt, wenn E_STRICT zur Laufzeit zu error_reporting hinzugefügt wird (und auch andersrum).

Tipp

Durch Übergeben des Wertes -1 werden alle möglichen Fehler angezeigt, auch wenn neue Level in zukünftigen PHP-Versionen hinzugefügt werden. Die E_ALL Konstante verhält sich seit PHP 5.4 ebenfalls so.

Siehe auch