mitmario.dev

Fehler lesen

PHP Sandbox 4 Min Lesezeit 3 BeispieleLektion 4 von 6

In der ersten Zeile einer Fehlermeldung von PHP steht, welche Art Fehler es ist, was passiert ist und wo. Wenn du sie überspringst und im Code auf Verdacht etwas änderst, triffst du leicht die falsche Stelle. Und selbst die genannte Zeile ist nicht immer die, in der der Fehler steckt.

Der Parse-Fehler

Ein Parse-Fehler heißt, dass PHP deine Datei nicht einmal verstehen konnte. PHP liest sie einmal komplett, bevor irgendetwas passiert. Geht dabei etwas nicht auf, hört es sofort auf.

Ein Parse-Fehler startet die Datei gar nicht erst
<?php

echo "Diese Zeile siehst du nie.\n";

$preis = 10 * 3
echo "Preis: $preis Euro\n";

Hier fehlt die Ausgabe. Sie bleibt komplett leer, obwohl in der dritten Zeile ein völlig korrektes echo steht, denn gelaufen ist keine einzige Zeile.

Im Terminal steht PHP Parse error: syntax error, unexpected token "echo", dahinter Datei und Zeile 6. In Zeile 6 ist aber alles in Ordnung. Der Fehler steckt in Zeile 5, dort fehlt das Semikolon. PHP liest weiter, bis es merkt, dass etwas nicht passt, und meldet die Stelle, an der es das gemerkt hat, nicht die, an der es passiert ist.

Bei einem Parse-Fehler schaue ich in die genannte Zeile und in die davor. Dort suche ich nach einem fehlenden Semikolon, einer schließenden Klammer oder einem Anführungszeichen.

Ob eine Datei überhaupt startet, kannst du auch fragen, ohne sie laufen zu lassen. php -l index.php prüft nur die Syntax. Bei diesem Beispiel kommt danach dieselbe Meldung wie beim Lauf, dazu Errors parsing index.php.

Der Fatal error

Ein Fatal error passiert erst beim Laufen. Die Datei ist in Ordnung, aber irgendwo verlangt sie etwas, das es nicht gibt.

Ein Fatal error bricht mitten im Lauf ab
<?php

echo "vorher\n";
echo grossschreiben("hallo") . "\n";
echo "nachher\n";

Diesmal steht vorher in der Ausgabe, nachher nicht. Das Programm ist bis Zeile 4 gekommen und dort stehen geblieben. Eine Funktion grossschreiben gibt es in PHP nicht, sie heißt strtoupper. php -l index.php meldet für diese Datei No syntax errors detected in index.php, denn an der Schreibweise ist nichts falsch.

Die Meldung fängt mit PHP Fatal error: Uncaught Error: Call to undefined function grossschreiben() an, und am Ende der Zeile stehen Datei und Zeilennummer. So ist die erste Zeile jeder Meldung von PHP gebaut. Vorn die Art, dann was passiert ist, hinten der Ort. Von hinten gelesen heißt das hier, dass in Zeile 4 eine Funktion aufgerufen wird, die es nicht gibt. Uncaught bedeutet, dass niemand den Fehler abgefangen hat, und wie man das macht, kommt in Abschnitt 7.

Unter der Meldung stehen noch ein paar Zeilen mit Stack trace. Die brauchst du hier noch nicht. Interessant werden sie erst, wenn deine Funktionen sich gegenseitig aufrufen und du wissen willst, wer wen gerufen hat.

Die Warnung

Eine Warnung lässt das Programm weiterlaufen
<?php

$daten = ["name" => "Kaffee"];

echo "Artikel: " . $daten["name"] . "\n";
echo "Menge: " . $daten["menge"] . "\n";
echo "fertig\n";

Das Programm läuft komplett durch und meldet am Ende fertig. Trotzdem stimmt etwas nicht, denn bei Menge: steht nichts. Den Schlüssel menge gibt es in dem Array nicht. PHP schreibt dazu eine Warnung (englisch warning, in der Meldung steht Warning), hier PHP Warning: Undefined array key "menge" mit Datei und Zeile. Dann macht es weiter, als wäre nichts gewesen.

Ein Parse-Fehler und ein Fatal error fallen auf, weil nichts mehr geht. Eine Warnung fällt niemandem auf, bis irgendwann jemand eine Rechnung über 0 Euro bekommt. Deshalb ist sie gefährlicher als die anderen beiden. In fast jeder Aufgabe dieses Kurses gibt es eine eigene Prüfung dafür, dass auf dem Fehlerkanal nichts liegt, auch keine Warnung.

Wo die Meldungen landen

Auf der Kommandozeile stehen Fehlermeldungen in diesem Kurs auf dem Fehlerkanal (englisch stderr) und nicht in der Ausgabe. Das sind zwei getrennte Kanäle. Im Terminal siehst du beide, den Fehlerkanal in Rot.

Das hängt an zwei Einstellungen. display_errors ist hier auf der Kommandozeile aus, also landet keine Meldung in der Ausgabe. log_errors ist an und schreibt sie auf den Fehlerkanal. So bleibt deine Ausgabe sauber, denn eine Warnung mitten in der Programmausgabe würde jeden genauen Vergleich zerschießen. In Abschnitt 7 wird die Anzeige in einem Beispiel einmal eingeschaltet, und dort steht auch, warum man sie im Betrieb auslässt. Der Server, der ab Abschnitt 10 läuft, hat sie an. Dort steht eine Meldung zusätzlich mitten auf der Seite.

Die Zahl am Ende

Jedes Programm hinterlässt beim Beenden eine Zahl, den Exit-Code. Daran sieht man, ob es geklappt hat. Ein Programm, das durchläuft, endet mit 0. Ein Parse-Fehler und ein Fatal error enden in PHP beide mit 255. Eine Warnung ändert am Exit-Code nichts, denn das Programm ist ja ordentlich zu Ende gegangen. Auch deshalb übersieht man sie so leicht.

Von selbst schreibt das Terminal die Zahl nicht hin. In der Prüfliste steht sie, wenn eine Prüfung auf den Exit-Code rot wird. Sonst hängst du ein echo $? an den Befehl. In php index.php; echo $? trennt das Semikolon zwei Befehle, und $? ist der Exit-Code des Befehls davor. Bei den drei Beispielen dieser Lektion kommt dann zweimal 255 und einmal 0 heraus. Der Befehl liegt jedes Mal in der Befehlsleiste bereit.

Von jeder der drei Sorten steckt ein Fehler in der Aufgabe.

Zum Mitnehmen

Ein Parse-Fehler lässt gar nichts laufen, ein Fatal error hält das Programm mitten im Lauf an, und beide enden mit dem Exit-Code 255. Nach einer Warnung läuft es weiter und endet mit 0. Die Zeilennummer in einer Meldung ist ein Hinweis, und bei einem Parse-Fehler steckt das Problem manchmal eine Zeile weiter oben.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.

Was in dieser Lektion steckt

  • Artikel mit 3 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.