Heredoc và nowdoc trong PHP: chuỗi nhiều dòng

Heredoc là một chuỗi nhiều dòng. Bắt đầu bằng <<<EOT, viết văn bản ở các dòng tiếp theo, và kết thúc bằng EOT; trên một dòng riêng. Biến bên trong được thay thế như trong chuỗi ngoặc kép.

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

Định danh (ở đây là EOT) là một chữ cái hoặc dấu gạch dưới, theo sau là chữ cái, chữ số hoặc dấu gạch dưới. Người ta thường chọn tên nói lên nội dung văn bản: HTML, SQL, TEXT. Một số trình soạn thảo, trong đó có PhpStorm, tô màu phần thân theo ngôn ngữ đó khi tên là HTML hoặc SQL.

Tạo template HTML với heredoc

Heredoc là cách rõ ràng nhất để viết một khối HTML có chèn giá trị, vì mã HTML giữ nguyên hình dạng và không cần escape gì cả. Đầu ra là HTML, nên trình soạn thảo hiển thị nó ở tab Trang.

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

Có hai chi tiết trong khối code đó: phần tử mảng được bọc trong ngoặc nhọn, {$product['name']}, và ký hiệu đô la trước giá được escape thành \$. Hãy đổi tên hoặc thêm một thẻ rồi chạy lại.

Giá trị đến từ người dùng phải được escape trước khi đưa vào HTML. Xem htmlspecialchars để biết lý do và cách làm.

Nowdoc: văn bản không chèn biến

Nowdoc đặt định danh trong nháy đơn: <<<'EOT'. Không có gì bên trong bị thay thế, nên ký hiệu đô la và dấu gạch chéo ngược giữ nguyên như khi viết. Hãy dùng nó cho code mẫu, biểu thức chính quy và mọi văn bản có chứa $.

<?php
$name = "Ada";

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

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

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

Thụt lề dấu kết thúc

Từ PHP 7.3, dấu kết thúc có thể được thụt lề, và phần thụt lề đó sẽ bị bỏ khỏi mọi dòng của thân chuỗi. Nhờ vậy, heredoc nằm trong một hàm hay một câu lệnh if có thể theo đúng thụt lề của code mà khoảng trắng không lọt vào chuỗi.

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

Dòng json_encode cho thấy kết quả đến từng ký tự: mỗi dòng bị bỏ 8 khoảng trắng, vì TEXT; ở cuối được thụt lề 8.

Một dòng trong thân thụt lề ít hơn dấu kết thúc là lỗi parse:

$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

Mảng, đối tượng và lời gọi phương thức trong heredoc

Heredoc tuân theo cùng quy tắc với chuỗi ngoặc kép. Biến đơn giản dùng trực tiếp được; với khóa mảng có nháy, mảng lồng nhau, thuộc tính và lời gọi phương thức, hãy dùng ngoặc nhọn.

<?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 làm đối số của hàm

Từ PHP 7.3, sau dấu kết thúc có thể viết tiếp code trên cùng dòng, nên heredoc có thể được truyền thẳng vào một hàm hoặc đặt trong một mảng. Kết hợp với sprintf, bạn có một template mà các placeholder sẽ được điền sau.

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

Lỗi thường gặp: thiếu dấu chấm phẩy hoặc thừa ký tự sau dấu kết thúc

Định danh kết thúc phải viết đúng y như lúc mở (cùng chữ hoa chữ thường), và những gì theo sau nó trên dòng đó phải hợp lệ trong PHP. EOT; kết thúc một câu lệnh, EOT, tiếp tục một danh sách đối số. Một chữ cái hoặc chữ số ngay sau dấu kết thúc (EOTX;) sẽ làm nó không còn được nhận ra, nên chuỗi kéo dài đến cuối tệp và PHP báo syntax error, unexpected end of file. Cái bẫy ngược lại là một dòng trong thân bắt đầu bằng định danh rồi theo sau là khoảng trắng hoặc dấu câu, như EOT is the marker: nó kết thúc chuỗi quá sớm, và phần còn lại của dòng bị đọc như code PHP (syntax error, unexpected identifier "is"). Hãy chọn một định danh không bao giờ xuất hiện ở đầu dòng trong văn bản, như HTML cho mã HTML hoặc SQL cho truy vấn.