Heredoc et nowdoc en PHP : chaînes sur plusieurs lignes

Un heredoc est une chaîne sur plusieurs lignes. Commencez-le par <<<EOT, écrivez le texte sur les lignes suivantes, et terminez-le par EOT; seul sur sa ligne. Les variables à l'intérieur sont remplacées comme dans une chaîne entre guillemets doubles.

<?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'identifiant (ici EOT) est une lettre ou un tiret bas suivi de lettres, chiffres ou tirets bas. On choisit en général un nom qui dit ce qu'est le texte : HTML, SQL, TEXT. Certains éditeurs, dont PhpStorm, colorent le corps dans ce langage quand le nom est HTML ou SQL.

Construire un template HTML avec heredoc

Le heredoc est la façon la plus claire d'écrire un bloc de HTML contenant des valeurs, car le balisage garde sa forme et rien n'a besoin d'être échappé. La sortie est du HTML, donc l'éditeur l'affiche dans l'onglet 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;

Deux détails dans ce bloc : l'élément de tableau est entouré d'accolades, {$product['name']}, et le signe dollar littéral avant le prix est échappé en \$. Changez le nom ou ajoutez une balise et relancez.

Les valeurs venant des utilisateurs doivent être échappées avant d'aller dans du HTML. Voir htmlspecialchars pour savoir pourquoi et comment.

Nowdoc : du texte sans interpolation

Un nowdoc met l'identifiant entre guillemets simples : <<<'EOT'. Rien n'est remplacé à l'intérieur, donc les signes dollar et les barres obliques inverses restent tels quels. Utilisez-le pour des exemples de code, des expressions régulières et tout texte contenant $.

<?php
$name = "Ada";

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

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

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

Indenter le marqueur de fin

Depuis PHP 7.3, le marqueur de fin peut être indenté, et cette indentation est retirée de chaque ligne du corps. Un heredoc placé dans une fonction ou un if peut ainsi suivre l'indentation du code sans que les espaces se retrouvent dans la chaîne.

<?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 ligne json_encode rend le résultat visible caractère par caractère : 8 espaces ont été retirés de chaque ligne, car le TEXT; final est indenté de 8.

Une ligne du corps moins indentée que le marqueur de fin est une erreur de syntaxe :

$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

Tableaux, objets et appels de méthode dans un heredoc

Le heredoc suit les mêmes règles que les guillemets doubles. Les variables simples fonctionnent seules ; pour les clés de tableau entre guillemets, les tableaux imbriqués, les propriétés et les appels de méthode, utilisez des accolades.

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

Un heredoc comme argument de fonction

Depuis PHP 7.3, le marqueur de fin peut être suivi d'autre code sur la même ligne, donc un heredoc peut être passé directement à une fonction ou placé dans un tableau. Avec sprintf, vous obtenez un template dont les marqueurs sont remplis plus tard.

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

Erreur fréquente : point-virgule manquant ou texte en trop après le marqueur

L'identifiant de fin doit être écrit exactement comme à l'ouverture (même casse), et ce qui le suit sur cette ligne doit avoir un sens en PHP. EOT; termine une instruction, EOT, continue une liste d'arguments. Une lettre ou un chiffre juste après le marqueur (EOTX;) le masque, donc la chaîne continue jusqu'à la fin du fichier et PHP signale syntax error, unexpected end of file. Le piège inverse est une ligne du corps qui commence par l'identifiant suivi d'un espace ou d'une ponctuation, comme EOT is the marker : elle termine la chaîne trop tôt, et le reste de la ligne est lu comme du PHP (syntax error, unexpected identifier "is"). Choisissez un identifiant qui n'apparaît jamais en début de ligne dans le texte, comme HTML pour du balisage ou SQL pour une requête.