Abschnitt 3 · Lektion 3
Längere Texte
Ein Text über mehrere Zeilen, mit Anführungszeichen darin, und mittendrin soll ein Name eingesetzt
werden. Mit den Mitteln aus Lektion 2.2 wird das schnell unleserlich. Überall stehen Backslashes,
die ein Anführungszeichen maskieren (englisch escaping), also zu einem gewöhnlichen Zeichen machen.
Dazu kommt überall \n, und am Ende sieht der Code nicht mehr aus wie der Text, den er erzeugt.
Für so etwas hat PHP eine eigene Schreibweise, mit einem etwas sperrigen Namen.
Heredoc, der Text am Stück
<?php
$name = "Mia";
$nummer = "4711";
$brief = <<<BRIEF
Hallo $name,
deine Bestellung $nummer ist unterwegs. Wir haben sie heute
dem Versand übergeben.
Viele Grüße
Bergblick GmbH
BRIEF;
echo $brief, "\n"; Ein Heredoc fängt mit drei spitzen Klammern und einem selbst gewählten Namen an, hier BRIEF.
Danach kommt der Text so, wie er aussehen soll, über beliebig viele Zeilen. Beendet wird er durch
denselben Namen in einer eigenen Zeile, gefolgt vom Semikolon.
In diesem Text gilt alles, was auch für doppelte Anführungszeichen gilt, also werden $name und
$nummer eingesetzt. Einen Backslash zum Maskieren brauchst du dagegen nicht. Ein Anführungszeichen
ist hier ein ganz gewöhnliches Zeichen, und ein Zeilenumbruch entsteht einfach dadurch, dass eine
neue Zeile anfängt.
Für die Endmarke gibt es zwei Regeln. Erstens fängt sie eine eigene Zeile an, und vor ihr darf nur Leerraum stehen. Was hinter ihr kommt, ist seit PHP 7.3 frei. Ein Heredoc darf also mitten in einem Funktionsaufruf stehen, und die Endmarke trägt dann direkt eine schließende Klammer. Vor PHP 7.3 musste die Zeile hinter der Endmarke gleich zu Ende sein, nur ein Semikolon durfte noch dazwischenstehen. Ein Komma oder eine Klammer kam in die nächste Zeile, und deshalb sieht man das Muster in altem Code kaum. Zweitens steht der Name in Großbuchstaben. Das ist bloß eine Verabredung, damit man die Endmarke beim Überfliegen sofort findet.
Nowdoc, wenn wirklich alles stehen bleiben soll
<?php
$name = "Mia";
$hinweis = <<<'ANLEITUNG'
Schreib $name in doppelte Anführungszeichen, dann setzt PHP
den Wert ein. In einfachen bleibt der Name stehen.
Ein Backslash-n sieht so aus: \n
ANLEITUNG;
echo $hinweis, "\n";
echo "Zum Vergleich mit Ersetzung: $name\n"; Manchmal brauchst du das Gegenteil, einen Text, in dem ein Dollarzeichen ein Dollarzeichen bleibt. Ein Hilfetext über PHP zum Beispiel, ein Stück Beispielcode oder eine Vorlage, in die später jemand anderes Werte einsetzt.
Dafür steht der Name hinter den spitzen Klammern in einfachen Anführungszeichen, <<<'ANLEITUNG'.
Das ist die einzige Änderung. Sie schaltet jede Ersetzung ab. Im Beispiel bleibt $name als $name
stehen, und das \n in der letzten Zeile erscheint als Backslash und n.
Die beiden verhalten sich zueinander wie doppelte und einfache Anführungszeichen. Die eine Sorte denkt mit, die andere nicht, und an den einfachen Anführungszeichen siehst du hier wie dort, dass nichts ersetzt wird.
Der Einzug in der Endmarke
<?php
$stand = "offen";
$bericht = <<<TEXT
Stand: $stand
Geprüft am 25.08.2026
TEXT;
echo $bericht, "\n";
echo "Vom Einzug im Code ist nichts übrig.\n"; Seit PHP 7.3 darf die Endmarke eingerückt sein, und das ist praktischer, als es klingt. Ihr Einzug bestimmt nämlich, wie viel Einzug PHP von jeder Zeile des Textes abzieht.
Im Beispiel stehen Text und Endmarke vier Leerzeichen weit rechts, und in der Ausgabe ist davon nichts mehr übrig. Dein Code darf also ordentlich eingerückt bleiben, ohne dass die Einrückung mitgeschickt wird. Vor PHP 7.3 musste ein Heredoc ganz links kleben, mitten im schönsten eingerückten Block. So steht er in älteren Projekten auch heute noch oft da.
Steht eine Zeile des Textes weniger weit eingerückt als die Endmarke, startet das Skript gar nicht. Dann gibt es einen Parse-Fehler. Ausnahmsweise hilft die Meldung sogar weiter, weil sie den Einzug nennt, den PHP erwartet hätte. Bei einer Endmarke mit vier Leerzeichen davor lautet sie so:
PHP Parse error: Invalid body indentation level (expecting an indentation level of at least 4)
Wofür man das wirklich nimmt
<?php
$name = "Mia";
$punkte = 240;
echo <<<SEITE
<h1>Hallo $name</h1>
<p>Du hast $punkte Punkte gesammelt.</p>
<p>Weiter so.</p>
SEITE; Im Alltag kommen drei Fälle ständig vor, der Text einer E-Mail, eine SQL-Abfrage über mehrere Zeilen und ein Block HTML. Der letzte ist der häufigste, und er ist zugleich ein erster Blick auf das, worum es in diesem Kurs ab Abschnitt 10 eigentlich die ganze Zeit geht.
Für dieses eine Beispiel läuft ein Server, im Reiter Browser steht also eine Seite mit einer echten
Überschrift. Mit php index.php aus der Befehlsleiste siehst du dieselbe Ausgabe im Terminal als
Zeichen, eine spitze Klammer, ein h, eine Eins.
Was PHP ausgibt, ist erst einmal nur Text, wie schon in Lektion 1.3. Ob daraus eine Seite wird, entscheidet sich woanders. In den anderen Lektionen dieses Abschnitts steht die Ausgabe im Terminal. Dort geht es um Textdetails, und die verschwinden im Browser.
Die vier echo-Zeilen der Aufgabe, eine davon voller Backslashes, sollen zu einem einzigen Heredoc
werden.
Zum Mitnehmen
Ein Heredoc schreibt einen Text über mehrere Zeilen am Stück und setzt Variablen ein, ein Nowdoc nimmt alles wörtlich. Die Endmarke darf eingerückt sein, und genau so viel Einzug verliert dann der ganze Text in der Ausgabe.
Jetzt du
Basis Konto, kostenlosZu 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 4 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe, dein Code läuft auf einem Server
Öffnet sich mit dem Basis Konto.