Heredoc dan Nowdoc PHP: String Multibaris

Heredoc adalah string multibaris. Mulai dengan <<<EOT, tulis teksnya di baris-baris berikutnya, lalu akhiri dengan EOT; di barisnya sendiri. Variabel di dalamnya diganti seperti di string dengan tanda kutip ganda.

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

Identifier-nya (di sini EOT) berupa huruf atau underscore yang diikuti huruf, angka, atau underscore. Orang biasanya memilih nama yang menjelaskan isi teksnya: HTML, SQL, TEXT. Beberapa editor, termasuk PhpStorm, menyorot body-nya sebagai bahasa tersebut jika namanya HTML atau SQL.

Membuat template HTML dengan heredoc

Heredoc adalah cara paling jelas untuk menulis blok HTML yang berisi nilai, karena markup-nya tetap berbentuk aslinya dan tidak ada yang perlu di-escape. Output-nya berupa HTML, jadi editor menampilkannya di tab Halaman.

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

Ada dua detail di blok itu: elemen array dibungkus kurung kurawal, {$product['name']}, dan tanda dolar literal sebelum harga di-escape sebagai \$. Ubah namanya atau tambahkan tag, lalu jalankan lagi.

Nilai dari pengguna harus di-escape sebelum dimasukkan ke HTML. Lihat htmlspecialchars untuk alasan dan caranya.

Nowdoc: teks tanpa interpolasi

Nowdoc menaruh identifier di dalam tanda kutip tunggal: <<<'EOT'. Tidak ada yang diganti di dalamnya, jadi tanda dolar dan backslash tetap seperti yang ditulis. Pakai untuk contoh kode, regular expression, dan teks apa pun yang berisi $.

<?php
$name = "Ada";

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

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

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

Memberi indentasi pada penanda penutup

Sejak PHP 7.3, penanda penutup boleh diberi indentasi, dan indentasi itu dihapus dari setiap baris body. Dengan begitu heredoc di dalam fungsi atau if bisa mengikuti indentasi kode tanpa spasinya ikut masuk ke 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"));

Baris json_encode membuat hasilnya terlihat karakter demi karakter: 8 spasi dihapus dari setiap baris, karena TEXT; penutupnya diberi indentasi 8 spasi.

Baris body yang indentasinya lebih sedikit daripada penanda penutup adalah parse error:

$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

Array, object, dan pemanggilan method di dalam heredoc

Heredoc mengikuti aturan yang sama dengan tanda kutip ganda. Variabel sederhana bisa ditulis begitu saja; untuk key array di dalam tanda kutip, array bersarang, property, dan pemanggilan method, pakai kurung kurawal.

<?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 sebagai argumen fungsi

Sejak PHP 7.3, penanda penutup boleh diikuti kode lain di baris yang sama, jadi heredoc bisa langsung diberikan ke fungsi atau dimasukkan ke array. Dengan sprintf, kamu mendapatkan template yang placeholder-nya diisi belakangan.

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

Kesalahan umum: titik koma hilang atau teks tambahan setelah penanda

Identifier penutup harus ditulis persis seperti saat dibuka (huruf besar dan kecilnya sama), dan apa pun yang mengikutinya di baris itu harus masuk akal sebagai PHP. EOT; mengakhiri pernyataan, EOT, melanjutkan daftar argumen. Huruf atau angka tepat setelah penanda (EOTX;) menyembunyikannya, sehingga string berlanjut sampai akhir file dan PHP melaporkan syntax error, unexpected end of file. Jebakan sebaliknya adalah baris body yang diawali identifier lalu diikuti spasi atau tanda baca, seperti EOT is the marker: baris itu mengakhiri string terlalu cepat, dan sisa barisnya dibaca sebagai PHP (syntax error, unexpected identifier "is"). Pilih identifier yang tidak pernah muncul di awal baris dalam teksnya, seperti HTML untuk markup atau SQL untuk query.