PHP Heredoc und Nowdoc: mehrzeilige Strings

Ein Heredoc ist ein mehrzeiliger String. Beginne ihn mit <<<EOT, schreib den Text in die folgenden Zeilen und beende ihn mit EOT; in einer eigenen Zeile. Variablen darin werden wie in einem String in doppelten Anführungszeichen ersetzt.

<?php
$name = "Ada";
$items = 3;

$message = <<<EOT
Hello, $name.
You have $items items in your cart.
Quotes "like these" and 'these' need no escaping.
EOT;

echo $message;

Der Bezeichner (hier EOT) ist ein Buchstabe oder Unterstrich, gefolgt von Buchstaben, Ziffern oder Unterstrichen. Üblich sind Namen, die sagen, was der Text ist: HTML, SQL, TEXT. Manche Editoren, darunter PhpStorm, heben den Inhalt in dieser Sprache hervor, wenn der Name HTML oder SQL lautet.

Ein HTML-Template mit Heredoc bauen

Heredoc ist der übersichtlichste Weg, einen Block HTML mit Werten darin zu schreiben, weil das Markup seine Form behält und nichts escapt werden muss. Die Ausgabe ist HTML, deshalb zeigt der Editor sie im Tab Page.

<?php
$product = [
    "name" => "Mechanical keyboard",
    "price" => 89.5,
    "tags" => ["usb-c", "hot-swap", "rgb"],
];

$tagList = "";
foreach ($product["tags"] as $tag) {
    $tagList .= "<li>$tag</li>";
}
$price = number_format($product["price"], 2);

echo <<<HTML
<style>
  .card { font-family: sans-serif; border: 1px solid #ccc; padding: 12px; width: 240px; }
  .price { color: #0a7; font-weight: bold; }
</style>
<div class="card">
  <h2>{$product['name']}</h2>
  <p class="price">\$$price</p>
  <ul>$tagList</ul>
</div>
HTML;

Zwei Details in diesem Block: Das Array-Element steht in geschweiften Klammern, {$product['name']}, und das wörtliche Dollarzeichen vor dem Preis ist als \$ escapt. Ändere den Namen oder füge ein Tag hinzu und führe den Code erneut aus.

Werte von Nutzern müssen escapt werden, bevor sie ins HTML kommen. Warum und wie, steht unter htmlspecialchars.

Nowdoc: Text ohne Interpolation

Ein Nowdoc setzt den Bezeichner in einfache Anführungszeichen: <<<'EOT'. Darin wird nichts ersetzt, Dollarzeichen und Backslashes bleiben also, wie sie sind. Verwende es für Codebeispiele, reguläre Ausdrücke und jeden Text, der $ enthält.

<?php
$name = "Ada";

$heredoc = <<<EOT
Hello, $name\tTab
EOT;

$nowdoc = <<<'EOT'
Hello, $name\tTab
EOT;

echo $heredoc . "\n";
echo $nowdoc . "\n";

Die Endmarke einrücken

Seit PHP 7.3 darf die Endmarke eingerückt sein, und diese Einrückung wird von jeder Zeile des Inhalts entfernt. So kann ein Heredoc in einer Funktion oder einem if der Einrückung des Codes folgen, ohne dass die Leerzeichen im String landen.

<?php
function welcome(string $name): string
{
    return <<<TEXT
        Hi $name,
          this line keeps 2 extra spaces.
        Bye.
        TEXT;
}

echo welcome("Grace");
echo "\n---\n";
echo json_encode(welcome("Grace"));

Die Zeile mit json_encode macht das Ergebnis Zeichen für Zeichen sichtbar: Von jeder Zeile wurden 8 Leerzeichen entfernt, weil das schließende TEXT; um 8 eingerückt ist.

Eine Zeile des Inhalts, die weniger eingerückt ist als die Endmarke, ist ein Parse-Fehler:

$html = <<<HTML
  <p>Hello</p>
    HTML;

PHP Parse error:  Invalid body indentation level (expecting an indentation level of at least 4) in /home/index.php on line 3

Arrays, Objekte und Methodenaufrufe im Heredoc

Heredoc folgt denselben Regeln wie doppelte Anführungszeichen. Einfache Variablen funktionieren allein; für Array-Schlüssel in Anführungszeichen, verschachtelte Arrays, Eigenschaften und Methodenaufrufe verwendest du geschweifte Klammern.

<?php
$order = ["id" => 1042, "items" => ["pen", "ink"]];
$date = new DateTimeImmutable("2026-03-14 09:30");

// A plain function cannot be called inside the string,
// but a variable holding a function name or closure can.
$upper = 'strtoupper';
$count = fn(array $a) => count($a);

echo <<<TEXT
Order #{$order['id']}
First item: {$order['items'][0]}
Placed: {$date->format('Y-m-d H:i')}
Items: {$count($order['items'])}
Shout: {$upper('done')}
TEXT;

Heredoc als Funktionsargument

Seit PHP 7.3 darf nach der Endmarke in derselben Zeile weiterer Code folgen, also kannst du einen Heredoc direkt an eine Funktion übergeben oder in ein Array setzen. Mit sprintf bekommst du ein Template, dessen Platzhalter später gefüllt werden.

<?php
$template = <<<TEXT
Dear %s,
your invoice #%05d for %.2f EUR is due on %s.
TEXT;

echo sprintf($template, "Ada", 42, 129.9, "2026-04-01"), "\n\n";

$lines = [<<<A
    first entry
    A, "second entry"];
print_r($lines);

Typischer Fehler: fehlendes Semikolon oder zusätzlicher Text nach der Marke

Der schließende Bezeichner muss genau so geschrieben werden, wie er geöffnet wurde (gleiche Groß- und Kleinschreibung), und was danach in dieser Zeile folgt, muss als PHP Sinn ergeben. EOT; beendet eine Anweisung, EOT, setzt eine Argumentliste fort. Ein Buchstabe oder eine Ziffer direkt nach der Marke (EOTX;) versteckt sie, sodass der String bis zum Dateiende läuft und PHP syntax error, unexpected end of file meldet. Die umgekehrte Falle ist eine Zeile im Inhalt, die mit dem Bezeichner gefolgt von einem Leerzeichen oder Satzzeichen beginnt, etwa EOT is the marker: Sie beendet den String zu früh, und der Rest der Zeile wird als PHP gelesen (syntax error, unexpected identifier "is"). Wähle einen Bezeichner, der im Text nie am Zeilenanfang steht, etwa HTML für Markup oder SQL für eine Abfrage.