Heredoc e nowdoc in PHP: stringhe su più righe

Un heredoc è una stringa su più righe. Inizialo con <<<EOT, scrivi il testo nelle righe successive e terminalo con EOT; su una riga a sé. Le variabili all'interno vengono sostituite come in una stringa tra virgolette doppie.

<?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;

L'identificatore (qui EOT) è una lettera o un underscore seguiti da lettere, cifre o underscore. Di solito si sceglie un nome che dice cos'è il testo: HTML, SQL, TEXT. Alcuni editor, tra cui PhpStorm, evidenziano il corpo in quel linguaggio quando il nome è HTML o SQL.

Costruire un template HTML con heredoc

L'heredoc è il modo più chiaro per scrivere un blocco di HTML con dei valori dentro, perché il markup mantiene la sua forma e non serve fare escape di nulla. L'output è HTML, quindi l'editor lo mostra nella scheda 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;

Due dettagli in quel blocco: l'elemento dell'array è racchiuso tra graffe, {$product['name']}, e il simbolo del dollaro letterale prima del prezzo è escapato come \$. Cambia il nome o aggiungi un tag ed esegui di nuovo.

I valori che arrivano dagli utenti vanno escapati prima di finire nell'HTML. Vedi htmlspecialchars per il perché e il come.

Nowdoc: testo senza interpolazione

Un nowdoc mette l'identificatore tra virgolette singole: <<<'EOT'. Niente all'interno viene sostituito, quindi i simboli del dollaro e le barre rovesciate restano come sono scritti. Usalo per esempi di codice, espressioni regolari e qualsiasi testo che contenga $.

<?php
$name = "Ada";

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

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

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

Indentare il marcatore di chiusura

Da PHP 7.3 il marcatore di chiusura può essere indentato, e quell'indentazione viene rimossa da ogni riga del corpo. Così un heredoc dentro una funzione o un if può seguire l'indentazione del codice senza che gli spazi finiscano nella stringa.

<?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"));

La riga con json_encode rende il risultato visibile carattere per carattere: da ogni riga sono stati rimossi 8 spazi, perché la chiusura TEXT; è indentata di 8.

Una riga del corpo indentata meno del marcatore di chiusura è un errore di sintassi:

$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

Array, oggetti e chiamate di metodo dentro un heredoc

L'heredoc segue le stesse regole delle virgolette doppie. Le variabili semplici funzionano da sole; per chiavi di array tra virgolette, array annidati, proprietà e chiamate di metodo, usa le graffe.

<?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;

L'heredoc come argomento di una funzione

Da PHP 7.3 il marcatore di chiusura può essere seguito da altro codice sulla stessa riga, quindi un heredoc si può passare direttamente a una funzione o mettere in un array. Con sprintf ottieni un template i cui segnaposto vengono riempiti dopo.

<?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);

Errore comune: punto e virgola mancante o testo in più dopo il marcatore

L'identificatore di chiusura deve essere scritto esattamente come in apertura (stesse maiuscole), e ciò che lo segue su quella riga deve avere senso come PHP. EOT; termina un'istruzione, EOT, continua una lista di argomenti. Una lettera o una cifra subito dopo il marcatore (EOTX;) lo nasconde, quindi la stringa prosegue fino alla fine del file e PHP segnala syntax error, unexpected end of file. La trappola opposta è una riga del corpo che inizia con l'identificatore seguito da uno spazio o da punteggiatura, come EOT is the marker: chiude la stringa in anticipo, e il resto di quella riga viene letto come PHP (syntax error, unexpected identifier "is"). Scegli un identificatore che non compaia mai all'inizio di una riga del testo, come HTML per il markup o SQL per una query.