PHP Heredoc ve Nowdoc: Çok Satırlı Stringler

Heredoc çok satırlı bir stringdir. <<<EOT ile başlatın, metni sonraki satırlara yazın ve kendi satırında EOT; ile bitirin. İçindeki değişkenler çift tırnaklı bir stringdeki gibi değiştirilir.

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

Tanımlayıcı (burada EOT) bir harf veya alt çizgi ve ardından gelen harfler, rakamlar veya alt çizgilerden oluşur. İnsanlar metnin ne olduğunu söyleyen adlar seçer: HTML, SQL, TEXT. Aralarında PhpStorm'un da bulunduğu bazı editörler, ad HTML veya SQL olduğunda gövdeyi o dilde renklendirir.

Heredoc ile HTML şablonu oluşturmak

Heredoc, içinde değerler olan bir HTML bloğu yazmanın en açık yoludur, çünkü işaretleme şeklini korur ve hiçbir şeyin kaçırılması gerekmez. Çıktı HTML olduğu için editör onu Page sekmesinde gösterir.

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

O bloktaki iki ayrıntı: dizi elemanı süslü parantez içine alınmıştır, {$product['name']}, ve fiyattan önceki gerçek dolar işareti \$ olarak kaçırılmıştır. Adı değiştirin ya da bir etiket ekleyip tekrar çalıştırın.

Kullanıcılardan gelen değerler HTML'e girmeden önce kaçırılmalıdır. Nedenini ve nasıl yapılacağını htmlspecialchars sayfasında görün.

Nowdoc: interpolasyonsuz metin

Nowdoc tanımlayıcıyı tek tırnak içine koyar: <<<'EOT'. İçindeki hiçbir şey değiştirilmez, bu yüzden dolar işaretleri ve ters eğik çizgiler yazıldığı gibi kalır. Kod örnekleri, düzenli ifadeler ve $ içeren her metin için kullanın.

<?php
$name = "Ada";

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

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

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

Kapanış işaretini girintilemek

PHP 7.3'ten beri kapanış işareti girintili olabilir ve bu girinti gövdenin her satırından kaldırılır. Bu sayede bir fonksiyonun veya bir if bloğunun içindeki heredoc, boşluklar stringe girmeden kodun girintisini takip edebilir.

<?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 satırı sonucu karakter karakter görünür kılar: her satırdan 8 boşluk kaldırıldı, çünkü kapanıştaki TEXT; 8 boşlukla girintilidir.

Kapanış işaretinden daha az girintili bir gövde satırı ayrıştırma hatasıdır:

$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 içinde diziler, nesneler ve metot çağrıları

Heredoc çift tırnakla aynı kuralları izler. Basit değişkenler tek başına çalışır; tırnaklı dizi anahtarları, iç içe diziler, özellikler ve metot çağrıları için süslü parantez kullanı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;

Fonksiyon argümanı olarak heredoc

PHP 7.3'ten beri kapanış işaretinin ardından aynı satırda başka kod gelebilir, bu yüzden bir heredoc doğrudan bir fonksiyona geçirilebilir ya da bir diziye konabilir. sprintf ile yer tutucuları sonradan doldurulan bir şablon elde edersiniz.

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

Sık yapılan hata: eksik noktalı virgül veya işaretten sonra fazladan metin

Kapanış tanımlayıcısı tam açıldığı gibi (aynı büyük/küçük harfle) yazılmalıdır ve o satırda ardından gelen her şey PHP olarak anlamlı olmalıdır. EOT; bir ifadeyi bitirir, EOT, bir argüman listesini sürdürür. İşaretten hemen sonra gelen bir harf veya rakam (EOTX;) onu gizler; bu yüzden string dosyanın sonuna kadar devam eder ve PHP syntax error, unexpected end of file bildirir. Ters tuzak, tanımlayıcıyla başlayıp ardından bir boşluk veya noktalama işareti gelen bir gövde satırıdır, örneğin EOT is the marker: stringi erken bitirir ve o satırın geri kalanı PHP olarak okunur (syntax error, unexpected identifier "is"). Metinde hiçbir satırın başında geçmeyen bir tanımlayıcı seçin; örneğin işaretleme için HTML, bir sorgu için SQL.