PHP Heredoc/Nowdoc 語法完整指南：大段字串優雅輸出與模板嵌入

Heredoc 與 Nowdoc 是 PHP 處理大段多行字串的專用語法，避免繁瑣的引號轉義與串接，特別適合 HTML 模板、SQL 語句、文檔生成等場景。

Heredoc 語法 (雙引號語義：解析變量、轉義)

<?php
$name = '張三';
$html = <<<HTML
<div class="user-card">
    <h2>歡迎，{$name}</h2>
    <p>今天是 <?= date('Y-m-d') ?></p>
</div>
HTML;

echo $html;
// 輸出解析後的 HTML，變量 {$name} 被替換
?>

Nowdoc 語法 (單引號語義：不解析、不轉義，PHP 5.3+)

<?php
$code = <<<'PHP'
<?php
echo "這裡的 \$var 不會被解析";
echo '單引號也原樣輸出';
?>
PHP;

echo $code; // 原樣輸出，適合嵌入代碼片段
?>

語法規則嚴格要求 (違反即語法錯誤)

常見錯誤示範

<?php
// ❌ 錯誤：結束標記有縮進
$str = <<<EOF
content
    EOF; // Parse error

// ❌ 錯誤：結束標記後有空格
$str = <<<EOF
content
EOF ; // Parse error

// ❌ 錯誤：開始標記與內容同行
$str = <<<EOF content EOF; // Parse error

// ✅ 正確
$str = <<<EOF
content
EOF;
?>

變量解析細節

<?php
$arr = ['name' => 'John'];
$obj = new class { public $age = 25; };

$str = <<<EOT
簡單變量：$name
陣列元素：{$arr['name']}     // 必須用大括號
物件屬性：{$obj->age}       // 必須用大括號
複雜表達式：{$arr['name'] . '!'}

這些不解析：$arr[name], $obj->age (無大括號)
EOT;
?>

實戰應用場景

效能與替代方案

• Heredoc/Nowdoc 編譯期解析，執行效能等同雙引號/單引號字串
• 大量模板渲染建議使用專用模板引擎
• PHP 8.1+ readonly 類屬性配合建構式替代大段字串拼裝

最佳實踐

1. 標記語義化：HTML、SQL、JSON、EMAIL
2. 變量必須用 {$var} 包裹，避免歧義
3. 結束標記獨佔行、頂格、分號結尾
4. Nowdoc 用於包含 PHP 代碼、正則、含大量 $ 的字串
5. 超長字串考慮外部檔案 file_get_contents()

Heredoc/Nowdoc 是 PHP 字串處理的「瑞士刀」，善用能大幅提升模板、SQL、文檔生成代碼的可讀性與維護性。