Heredoc и Nowdoc в PHP: многострочные строки

Heredoc это многострочная строка. Начните её с <<<EOT, напишите текст на следующих строках и закончите на EOT; в отдельной строке. Переменные внутри подставляются, как в строке в двойных кавычках.

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

Идентификатор (здесь EOT) состоит из буквы или подчёркивания, за которыми идут буквы, цифры или подчёркивания. Обычно выбирают имя, которое говорит, что это за текст: HTML, SQL, TEXT. Некоторые редакторы, например PhpStorm, подсвечивают тело как соответствующий язык, если имя HTML или SQL.

HTML-шаблон на heredoc

Heredoc это самый понятный способ записать блок HTML со значениями внутри: разметка сохраняет свою форму, и ничего не нужно экранировать. Результат это HTML, поэтому редактор показывает его на вкладке 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;

Две детали в этом блоке: элемент массива обёрнут в фигурные скобки, {$product['name']}, а знак доллара перед ценой экранирован как \$. Измените название или добавьте тег и запустите снова.

Значения от пользователей нужно экранировать перед вставкой в HTML. Зачем и как, смотрите в htmlspecialchars.

Nowdoc: текст без интерполяции

В nowdoc идентификатор записывается в одинарных кавычках: <<<'EOT'. Внутри ничего не подставляется, поэтому знаки доллара и обратные слеши остаются как написано. Используйте его для примеров кода, регулярных выражений и любого текста, где есть $.

<?php
$name = "Ada";

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

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

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

Отступ закрывающей метки

Начиная с PHP 7.3 закрывающую метку можно писать с отступом, и этот отступ удаляется из каждой строки тела. Так heredoc внутри функции или if может следовать отступам кода, а пробелы не попадут в строку.

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

Строка с json_encode делает результат видимым посимвольно: из каждой строки удалено 8 пробелов, потому что закрывающая TEXT; имеет отступ 8.

Строка тела с отступом меньше, чем у закрывающей метки, вызывает ошибку разбора:

$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

Массивы, объекты и вызовы методов внутри heredoc

Heredoc подчиняется тем же правилам, что и двойные кавычки. Простые переменные работают сами по себе; для ключей массива в кавычках, вложенных массивов, свойств и вызовов методов используйте фигурные скобки.

<?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 как аргумент функции

Начиная с PHP 7.3 после закрывающей метки на той же строке может идти другой код, поэтому heredoc можно сразу передать в функцию или положить в массив. С sprintf получается шаблон, плейсхолдеры которого заполняются позже.

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

Частая ошибка: нет точки с запятой или лишний текст после метки

Закрывающий идентификатор должен быть написан точно так же, как открывающий (с тем же регистром), а то, что идёт за ним в этой строке, должно иметь смысл как PHP. EOT; завершает инструкцию, EOT, продолжает список аргументов. Буква или цифра сразу после метки (EOTX;) прячет её, строка тянется до конца файла, и PHP сообщает syntax error, unexpected end of file. Обратная ловушка это строка тела, которая начинается с идентификатора, за которым идёт пробел или знак препинания, например EOT is the marker: она досрочно завершает строку, а остаток читается как PHP (syntax error, unexpected identifier "is"). Выбирайте идентификатор, который никогда не встречается в начале строки текста, например HTML для разметки или SQL для запроса.