PHP Nowdoc 與 Heredoc 完整指南：語法陷阱、版本差異與最佳實踐

Heredoc 與 Nowdoc 是 PHP 定義多行字串的兩大語法，雖然手冊說明簡單，但實際開發中「結束標譤必須頂格寫」這一規則極易因縮排導致語法錯誤。本文系統整理兩者差異、版本需求、轉義行為與避坑指南。

核心語法對比

致命陷阱：結束標譤前不可有任何空白

<?php
// ❌ 錯誤：EOD 前有縮排空格
$str = <<<'EOD'
    Example of string
    spanning multiple lines
    EOD; // Parse error

// ✅ 正確：EOD 頂格
$str = <<<'EOD'
Example of string
spanning multiple lines
EOD; // OK

原因：PHP 解析器要求結束標譤必須從行首開始，任何前導空白/Tab 都會導致「找不到結束標譤」的編譯錯誤。

實戰避坑技巧

1. 編輯器設定：啟用「顯示不可見字元」，確認結束標譤行無前導空白。
2. 統一縮排策略：Heredoc/Nowdoc 區塊內容不縮排，或使用 trim() 後處理。
3. 模板引擎替代：大段 HTML/JS/建議改用 Twig/Blade 或單獨 .tpl 檔 file_get_contents() 載入，徹底避開語法陷阱。

進階用法：Heredoc 中的複雜變數語法

<?php
$name = 'World';
$obj = new class { public function greet() { return 'Hello'; } };

echo <<<EOT
{$obj->greet()} {$name}!
// 輸出：Hello World!
EOT;

// 原樣輸出 $ 符號需轉義
echo <<<EOT
Price: \$100
EOT;

版本兼容建議

• PHP 5.3+ 環境：可按需選擇 Nowdoc（靜態模板）或 Heredoc（動態插值）。
• 舊版/共享主機：強制使用 Heredoc，Nowdoc 可能不支援導致 500 錯誤。
• 效能：Nowdoc 略快（無解析開銷），但差異微乎其微，優先考慮可維護性。

總結口訣

Heredoc = 雙引號多行版（動態插值）
Nowdoc = 單引號多行版（靜態字面）
結束標譤頂格寫，縮排空格是大敵
大段模板別硬寫，引擎載入更安穩