Standardfehler

Headervorgänge und „Headers already sent
Kontrollstrukturen: Zuweisung statt Vergleich
Kontrollstrukturen: Vorzeitige Beendigung durch Anweisungsende
Kontrollstrukturen: Fehlende Blöcke

Headervorgänge und „Headers already sent“

Problem

Bei einer Sessioninitialisierung (session_start()), einem Cookiesetzen oder einer versuchten Header-Weiterleitung (header("Location: ... ")) erfolgt eine Fehlermeldung („Headers already sent“) und die Aktion bleibt aus.

Fehler

Der Fehler kann mannigfaltige Ursachen haben, die aber alle die Gemeinsamkeit besitzen, dass sie vor der jeweiligen Headerausgabe Zeichenausgaben erzeugen.

Liste möglicher Ursachen im Hauptartikel zu Headers already sent.

Lösung

Es gibt zwei prinzipielle Lösungsansätze. Der erste besteht darin, die gesamte Scriptstruktur (aller beteiligten Scripte) so zu strukturieren, dass vor einer Aktion wie Sessionstart oder Header-Weiterleitung keine Ausgabe erfolgen kann. Dies kann im allgemeinen durch Ergänzen von Bedingungen oder Anlegen von Variablen für Ausgabestrings erreicht werden. Eine wichtige Maßnahme ist auch, alle Funktionen so einzurichten, dass sie keine Bildschirmausgabe erzeugen, sondern Code mittels return als String zurückgeben.

Näheres findet man im Hauptartikel zum EVA Prinzip.

Variante zwei nutzt den sogenannten Ausgabepuffer, den man nutzen kann, um Bildschirmausgaben vorübergehend in eine Variable umzuleiten. Das funktioniert sogar mit Inline-HTML:

<?php

// Ausgabepuffer starten
ob_start ();

// nachfolgende Ausgaben werden jetzt gepuffert

?><html>
...
<body>
<?php

if (empty ($_GET['navigation'])) {
    header('Location: http://www.example.com/error.php');
    exit;
}

// weitere PHP Aktionen, die evtl. Ausgaben erzeugen
// ..

$output = ob_get_clean(); // nur exemplarisch

// weitere PHP Aktionen, die keine (!) Ausgaben erzeugen
// ..

// Hier erfolgt die Ausgabe <html> … etc.
echo $output;
?>
</body>
</html>

Prinzipiell ist der ersten Variante der Vorrang zu geben. Der Ausgabepuffer ist kein Allheilmittel gegen schlechte Programmstrukturen!

Kontrollstrukturen: Zuweisung statt Vergleich

Problem

if ($a = 5) {
  do_something();
}

Der Code erzeugt unerwartete Ergebnisse.

Ziel

In 95% aller Fälle soll hier der Wert in $a mit dem konstanten Wert „5“ verglichen werden und bei Erfolg ein Ausdruck ausgeführt werden. do_something soll dann abhängig von der Bedingung ausgeführt werden.

Fehler

In der Bedingung wird eine Zuweisung (=-Operator) statt eines Vergleichs (== bzw. ===-Operator) benutzt. In einigen Sprachen ist „=“ ein Vergleichsoperator, in PHP jedoch nicht.

Lösung

Der PHP-Parser kann diesen Fall nicht erkennen, weil if( ) nur einen Ausdruck mit einem Rückgabewert erfordert. Eine Zuweisung hat einen Rückgabewert (den zugewiesenen Wert) und ist damit erfüllt (bzw. nicht erfüllt, je nach zugewiesenem Wert). Die Lösung besteht in der Benutzung der korrekten Vergleichsoperatoren:

if ($a == 5) {
  do_something();
}

Die bessere Lösung besteht darin, zusätzlich die Reihenfolge der Argumente umzukehren.

if (5 == $a) {
  do_something();
}

Wird in diesem Fall ein „=“ vergessen, erzeugt dies einen Parser Fehler, weil Zuweisungen an Werte nicht möglich sind. In Fällen, wo zwei Variablen auf Gleichheit verglichen werden, klappt dieser Trick natürlich nicht.

Kontrollstrukturen: Vorzeitige Beendigung durch Anweisungsende

Problem

if ($a == 5);
{
  do_something();
}

Der Code erzeugt unerwartete Ergebnisse. Die geklammerten Anweisungen werden immer ausgeführt.

Ziel

Die geklammerten Anweisungen (do_something) sollen abhängig von der Bedingung ausgeführt werden.

Fehler

Hinter der Bedingung wurde versehentlich ein Semikolon notiert. Semikolons schließen Anweisungen ab, das if wird also für einen leeren Ausdruck ausgewertet. {}-Blöcke dürfen in PHP auch alleinstehend existieren, auch wenn sie keinen Zweck erfüllen. Daher reagiert der PHP-Parser hier mit keiner Meldung.

Lösung

Ein geeignetes Syntaxhighlighting und eine andere Einrückformatierung können zur Vermeidung dieses Schreibfehlers beitragen:

if ($a == 5) {
  do_something();
}

Verwandte Probleme Auch für andere Kontrollstrukturen wird dieser Fehler gerne gemacht:

// „do_something“ wird nur einmal ausgeführt
for ($i = 0; $i < 5 ; $i++);
{
  do_something();
}

$x = 5;
// Endlosschleife, „do_something“ und $x-Dekrement werden nie erreicht
while ($x > 0);
{
  do_something();
  $x--;
}

Kontrollstrukturen: Fehlende Blöcke

Problem

if ($a == 5)
  do_something_1();
  do_something_2();

Der Code erzeugt unerwartete Ergebnisse. Die erste Anweisung (do_something_1) wird korrekt, die zweite (do_something_2) immer ausgeführt.

Ziel

Alle eingerückten Befehle sollen abhängig von der Bedingung ausgeführt werden.

Fehler

PHP nutzt eine Blocksyntax, um Ausdrücke einer Kontrollstruktur zuzuordnen. Fehlen nach der Kontrollstruktur geschweifte Klammern, wird lediglich der erste nachfolgende Ausdruck der Bedingung oder Schleife zugeordnet. Einrückungen haben dagegen keine Bedeutung für die Zugehörigkeit von Ausdrücken zu Kontrollstrukturen. Das ist bspw. bei Python anders.

Lösung

Die konditionalen Ausdrücke (auch einzeilige!) von Bedingungen und Schleifen sollten immer in geschweiften Klammern als Block gefasst werden.

if ($a == 5) {
  do_something_1();
  do_something_2();
}