Heredoc y nowdoc en PHP: cadenas de varias líneas

Un heredoc es una cadena de varias líneas. Empiézalo con <<<EOT, escribe el texto en las líneas siguientes y termínalo con EOT; en su propia línea. Las variables de dentro se sustituyen como en una cadena entre comillas dobles.

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

El identificador (aquí EOT) es una letra o un guion bajo seguido de letras, dígitos o guiones bajos. Se suelen elegir nombres que digan qué es el texto: HTML, SQL, TEXT. Algunos editores, entre ellos PhpStorm, resaltan el cuerpo en ese lenguaje cuando el nombre es HTML o SQL.

Crear una plantilla HTML con heredoc

Heredoc es la forma más clara de escribir un bloque de HTML con valores dentro, porque el marcado conserva su forma y no hay que escapar nada. La salida es HTML, así que el editor la muestra en la pestaña Página.

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

Dos detalles de ese bloque: el elemento del array va entre llaves, {$product['name']}, y el signo de dólar literal antes del precio se escapa como \$. Cambia el nombre o añade una etiqueta y vuelve a ejecutarlo.

Los valores que vienen de los usuarios deben escaparse antes de entrar en el HTML. Consulta htmlspecialchars para saber por qué y cómo.

Nowdoc: texto sin interpolación

Un nowdoc pone el identificador entre comillas simples: <<<'EOT'. No se sustituye nada de su interior, así que los signos de dólar y las barras invertidas se quedan como están. Úsalo para ejemplos de código, expresiones regulares y cualquier texto que contenga $.

<?php
$name = "Ada";

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

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

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

Indentar el marcador de cierre

Desde PHP 7.3 el marcador de cierre puede ir indentado, y esa indentación se elimina de cada línea del cuerpo. Así un heredoc dentro de una función o de un if puede seguir la indentación del código sin que los espacios acaben en la cadena.

<?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 línea con json_encode hace visible el resultado carácter a carácter: se eliminaron 8 espacios de cada línea, porque el TEXT; de cierre está indentado 8 espacios.

Una línea del cuerpo con menos indentación que el marcador de cierre es un error de sintaxis:

$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, objetos y llamadas a métodos dentro de un heredoc

Heredoc sigue las mismas reglas que las comillas dobles. Las variables simples funcionan solas; para claves de array entre comillas, arrays anidados, propiedades y llamadas a métodos, usa llaves.

<?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 como argumento de una función

Desde PHP 7.3 el marcador de cierre puede ir seguido de más código en la misma línea, así que un heredoc se puede pasar directamente a una función o meter en un array. Con sprintf obtienes una plantilla cuyos marcadores se rellenan después.

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

Error frecuente: falta el punto y coma o hay texto de más tras el marcador

El identificador de cierre debe escribirse exactamente igual que al abrir (mismas mayúsculas y minúsculas), y lo que le siga en esa línea debe tener sentido como PHP. EOT; termina una sentencia, EOT, continúa una lista de argumentos. Una letra o un dígito justo después del marcador (EOTX;) lo oculta, de modo que la cadena llega hasta el final del archivo y PHP informa de syntax error, unexpected end of file. La trampa contraria es una línea del cuerpo que empieza por el identificador seguido de un espacio o un signo de puntuación, como EOT is the marker: termina la cadena antes de tiempo y el resto de esa línea se lee como PHP (syntax error, unexpected identifier "is"). Elige un identificador que nunca aparezca al principio de una línea del texto, como HTML para marcado o SQL para una consulta.