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 עם ערכים בתוכו, כי ה-markup שומר על הצורה שלו ושום דבר לא צריך בריחה. הפלט הוא 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 ל-markup או SQL לשאילתה.