Heredoc e nowdoc no PHP: strings de várias linhas

Um heredoc é uma string de várias linhas. Comece com <<<EOT, escreva o texto nas linhas seguintes e termine com EOT; numa linha só dele. As variáveis dentro são substituídas como numa string entre aspas duplas.

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

O identificador (EOT aqui) é uma letra ou um underscore seguido de letras, dígitos ou underscores. As pessoas escolhem nomes que dizem o que é o texto: HTML, SQL, TEXT. Alguns editores, o PhpStorm entre eles, destacam o corpo como aquela linguagem quando o nome é HTML ou SQL.

Montar um template HTML com heredoc

O heredoc é o jeito mais claro de escrever um bloco de HTML com valores dentro, porque a marcação mantém o formato e nada precisa de escape. A saída é HTML, então o editor a mostra na aba 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;

Dois detalhes nesse bloco: o elemento do array está entre chaves, {$product['name']}, e o cifrão literal antes do preço está escapado como \$. Mude o nome ou adicione uma tag e rode de novo.

Valores vindos de usuários precisam ser escapados antes de entrar no HTML. Veja htmlspecialchars para entender por que e como.

Nowdoc: texto sem interpolação

Um nowdoc coloca o identificador entre aspas simples: <<<'EOT'. Nada dentro é substituído, então cifrões e barras invertidas ficam como estão. Use para exemplos de código, expressões regulares e qualquer texto que contenha $.

<?php
$name = "Ada";

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

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

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

Indentar o marcador final

Desde o PHP 7.3 o marcador final pode ser indentado, e essa indentação é removida de todas as linhas do corpo. Assim, um heredoc dentro de uma função ou de um if pode seguir a indentação do código sem que os espaços acabem na string.

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

A linha com json_encode deixa o resultado visível caractere por caractere: 8 espaços foram removidos de cada linha, porque o TEXT; final está indentado em 8.

Uma linha do corpo indentada menos que o marcador final é um erro de sintaxe:

$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 e chamadas de métodos dentro do heredoc

O heredoc segue as mesmas regras das aspas duplas. Variáveis simples funcionam sozinhas; para chaves de array entre aspas, arrays aninhados, propriedades e chamadas de métodos, use chaves.

<?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 função

Desde o PHP 7.3, o marcador final pode ser seguido de mais código na mesma linha, então um heredoc pode ser passado direto para uma função ou colocado num array. Com sprintf você tem um template cujos marcadores são preenchidos depois.

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

Erro comum: ponto e vírgula faltando ou texto a mais depois do marcador

O identificador final precisa ser escrito exatamente como foi aberto (mesmas maiúsculas e minúsculas), e o que vier depois dele naquela linha precisa fazer sentido como PHP. EOT; encerra uma instrução, EOT, continua uma lista de argumentos. Uma letra ou um dígito logo depois do marcador (EOTX;) o esconde, então a string vai até o fim do arquivo e o PHP informa syntax error, unexpected end of file. A armadilha oposta é uma linha do corpo que começa com o identificador seguido de espaço ou pontuação, como EOT is the marker: ela encerra a string antes da hora, e o resto daquela linha é lido como PHP (syntax error, unexpected identifier "is"). Escolha um identificador que nunca aparece no início de uma linha do texto, como HTML para marcação ou SQL para uma consulta.