PHP Fehler anzeigen: error_reporting und display_errors

Um PHP-Fehler anzuzeigen, schreib diese Zeilen an den Anfang deines Skripts: ini_set('display_errors', '1'); und error_reporting(E_ALL);. Die erste sorgt dafür, dass PHP Fehlermeldungen ausgibt, die zweite, dass es jede Art von Fehler meldet, auch Warnungen und Deprecations.

<?php
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);

Damit gibt ein Fehler, etwa das Lesen einer nie gesetzten Variable, eine Meldung mit Datei und Zeilennummer aus, statt still zu scheitern:

Warning: Undefined variable $total in /home/index.php on line 7

error_reporting() ohne Argument liefert die aktuelle Einstellung als Zahl. Klicke auf Run, um eine Stufe zu setzen und sie wieder in Namen zu übersetzen:

<?php
error_reporting(E_ALL & ~E_DEPRECATED);
$level = error_reporting();

echo "Current level: $level (E_ALL is " . E_ALL . ")\n";

foreach (get_defined_constants(true)['Core'] as $name => $value) {
    if (str_starts_with($name, 'E_') && $name !== 'E_ALL') {
        echo str_pad($name, 20), ($level & $value) ? "reported" : "off", "\n";
    }
}

Jeder Fehlertyp ist ein Bit, deshalb bedeutet E_ALL & ~E_DEPRECATED „alles außer Deprecations“. Ändere die erste Zeile in error_reporting(E_ERROR | E_WARNING); und führe den Code erneut aus.

Fehler in der php.ini anzeigen

Eine Einstellung im Skript gilt erst, sobald das Skript läuft. Um Fehler für jedes Skript anzuzeigen, auch Parse-Fehler, änderst du die php.ini (finde sie mit php --ini):

; Development
display_errors = On
display_startup_errors = On
error_reporting = E_ALL

Starte Apache oder PHP-FPM nach dem Bearbeiten neu. Der eingebaute Server php -S und die Kommandozeile lesen die Datei bei jedem Start. Auf Shared Hosting ohne Zugriff auf die php.ini akzeptiert Apache mit mod_php auch Zeilen in der .htaccess:

php_flag display_errors on
php_value error_reporting -1

-1 setzt jedes Bit und ist damit dasselbe wie E_ALL.

Die Fehlerstufen

PHP 8.0 hat viele alte Warnungen in Exceptions umgewandelt: Division durch null mit / und die Übergabe eines falschen Typs an eine eingebaute Funktion werfen jetzt eine Unterklasse von Error, so wie es der Aufruf einer undefinierten Funktion seit PHP 7 tut. Alle drei kannst du abfangen:

<?php
$attempts = [
    fn() => 10 / 0,
    fn() => strlen([]),
    fn() => undefinedFunction(),
];

foreach ($attempts as $attempt) {
    try {
        $attempt();
    } catch (Throwable $e) {
        echo get_class($e), ": ", $e->getMessage(), "\n";
    }
}

Exceptions werden unter try und catch behandelt. Warnungen, Notices und Deprecations laufen weiterhin über das hier beschriebene Fehlersystem.

Fehler protokollieren statt anzeigen

Auf einer Live-Website sollten Besucher nie Fehlermeldungen sehen: Sie verraten Pfade, SQL und Code. Schreib sie stattdessen in eine Logdatei:

; Production
display_errors = Off
log_errors = On
error_log = /var/log/php/app-errors.log
error_reporting = E_ALL

Behalte error_reporting = E_ALL auch in Produktion. Wenn du es herunterdrehst, verschwinden die Fehler nicht, du erfährst nur nichts mehr davon. Eigene Meldungen können mit error_log() ins selbe Log gehen:

<?php
error_log("Payment failed for order 1042");

Beobachte die Datei dann beim Testen: tail -f /var/log/php/app-errors.log.

Warnungen mit set_error_handler in Exceptions umwandeln

set_error_handler ersetzt die Standardbehandlung von Warnungen, Notices und Deprecations durch deine eigene Funktion. Ein gängiges Muster wandelt jede davon in eine ErrorException um, sodass ein vergessener Array-Schlüssel den Code wie jede andere Exception stoppt und abgefangen werden kann:

<?php
set_error_handler(function (int $severity, string $message, string $file, int $line): bool {
    throw new ErrorException($message, 0, $severity, $file, $line);
});

$prices = ['bread' => 4.5, 'milk' => 1.2];

try {
    echo "Bread costs {$prices['bread']}\n";
    echo "Cheese costs {$prices['cheese']}\n";
} catch (ErrorException $e) {
    echo "Caught: ", $e->getMessage(), " on line ", $e->getLine(), "\n";
}

restore_error_handler();

Der Handler bekommt die Fehlerstufe als erstes Argument und kann Stufen deshalb unterschiedlich behandeln. Dieser hier protokolliert nur Deprecations und macht aus allem anderen eine Exception:

<?php
set_error_handler(function (int $severity, string $message): bool {
    if ($severity === E_DEPRECATED || $severity === E_USER_DEPRECATED) {
        echo "[log] deprecated: $message\n";
        return true; // handled, PHP does nothing more
    }
    throw new ErrorException($message, 0, $severity);
});

trigger_error("oldFunction() is deprecated, use newFunction()", E_USER_DEPRECATED);

try {
    trigger_error("Config value 'timeout' is missing", E_USER_WARNING);
} catch (ErrorException $e) {
    echo "Exception: ", $e->getMessage(), "\n";
}

Fatale Fehler und Parse-Fehler erreichen den Handler nie, weil das Skript danach nicht weiterlaufen kann. Um sie aufzuzeichnen, registrierst du eine Shutdown-Funktion, die error_get_last() ausliest.

Den letzten Fehler mit error_get_last lesen

Manche Funktionen geben false zurück und melden den Grund nur als Warnung, zum Beispiel file_get_contents bei einer fehlenden Datei. error_get_last() liefert diese Warnung als Array. Das ist praktisch, wenn du eine eigene Meldung anzeigen willst:

<?php
$content = @file_get_contents('missing-config.json');

if ($content === false) {
    $error = error_get_last();
    echo "Could not read the file.\n";
    echo "Type: ", $error['type'] === E_WARNING ? 'E_WARNING' : $error['type'], "\n";
    echo "Message: ", $error['message'], "\n";
}

Der Operator @ vor dem Aufruf unterdrückt die Meldung für genau diesen einen Ausdruck. Setze ihn sparsam ein und nur, wenn du das Ergebnis direkt danach prüfst, wie hier; ein @ allein versteckt nur Bugs.

Typischer Fehler: Fehlerausgabe ist an, aber die Seite bleibt leer

Wenn du ini_set('display_errors', '1') eingefügt hast und trotzdem eine weiße Seite siehst, ist der Fehler wahrscheinlich ein Parse-Fehler. PHP parst die ganze Datei, bevor die erste Zeile läuft, also stoppt ein fehlendes ; oder } alles, bevor ini_set ausgeführt wird. Prüfe die Datei im Terminal, das die Meldung immer ausgibt:

php -l index.php

Errors parsing index.php
PHP Parse error:  syntax error, unexpected token "," in index.php on line 2

Die Zeilennummer zeigt, wo PHP aufgegeben hat, und das ist oft die Zeile nach dem eigentlichen Fehler. Behebe ihn, führe php -l erneut aus, bis No syntax errors detected erscheint, und lade dann die Seite neu.