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

核心語法對比

基本示例

<?php
$name = 'World';
$arr = ['key' => 'value'];

// Heredoc
$heredoc = <<<EOT
Hello $name!
Array key: {$arr['key']}
Newline: \n
Tab: \t
EOT;

// Nowdoc
$nowdoc = <<<'EOT'
Hello $name!
Array key: {$arr['key']}
Literal: \n \$ \t
EOT;

echo "Heredoc:\n$heredoc\n---\nNowdoc:\n$nowdoc";
/*
Heredoc:
Hello World!
Array key: value
Newline: 
Tab:    
---
Nowdoc:
Hello $name!
Array key: {$arr['key']}
Literal: \n \$ \t
*/

致命陷阱：結束標識縮進

<?php
function test() {
    $str = <<<EOT
    內容行 1
    內容行 2
    EOT; // ❌ 錯誤：EOT 前有空格，必須頂格寫在行首
    // 正確寫法：
    $str = <<<EOT
    內容行 1
    內容行 2
EOT;
}

PHP 7.3+ 允許結束標識縮進，但要求：

1. 結束標識的縮進**不超過**內容行的最小縮進
2. 內容行的縮進會被自動移除（strip）

<?php
// PHP 7.3+ 正確縮進寫法
$str = <<<EOT
    這行有 4 空格縮進
    這行也有 4 空格
  EOT; // 結束標識縮進 2 空格 ≤ 4，合法
// 結果字符串不包含前導縮進

變量解析進階技巧

<?php
class User { public $name = 'Tom'; }
$user = new User();
$arr = ['a' => 1];

// 複雜表達式必須用大括號
echo <<<EOT
{$user->name}           // 對象屬性
{$arr['a']}             // 數組元素
{${'var_' . 'name'}}    // 變量變量
{foo()}                 // 函數調用（PHP 8.0+）
{$obj->method()}        // 方法調用
EOT;

性能對比（100 萬次循環，PHP 8.2）

結論：**Nowdoc 性能最優**，適合大段靜態文本（SQL、HTML 模板、配置文件）；Heredoc 適合需插值的模板。

實際應用場景

1. SQL 語句（Nowdoc 推薦）

$sql = <<<'SQL'
SELECT u.id, u.name, p.title
FROM users u
JOIN posts p ON p.user_id = u.id
WHERE u.status = 1
  AND p.created_at > '2023-01-01'
ORDER BY p.views DESC
LIMIT 20
SQL;

2. HTML 郵件模板（Heredoc）

$html = <<<HTML
<div style="font-family: 'Microsoft YaHei'; padding: 20px;">
    <h2>歡迎, {$user['name']}！</h2>
    <p>您的驗證碼是：<strong>{$code}</strong>，<span style="color:red">10 分鐘</span>內有效。</p>
    <hr>
    <small>如非本人操作，請忽略。</small>
</div>
HTML;

3. JavaScript 代碼注入（Nowdoc 防 XSS）

$jsConfig = <<<'JS'
window.APP_CONFIG = {
    apiBase: '/api/v1',
    csrfToken: '{$csrfToken}', // 此處不會被 PHP 解析，由前端模板引擎替換
    userId: {$userId}
};
JS;

最佳實踐總結

1. 靜態大文本：優先 **Nowdoc**（<<< 'EOT'），性能最好、無解析風險。
2. 需插值模板：使用 **Heredoc**（<<< EOT），配合 {$var} 語法。
3. 結束標識：PHP < 7.3 必須頂格；≥ 7.3 可縮進但遵守規則，**建議統一頂格**避免混淆。
4. 標識符命名：使用語義化大寫 SQL、HTML、JS、CSS、JSON，IDE 可高亮。避免 EOF、EOT 等通用名造成嵌套衝突。
5. 避免在循環中定義：大字符串移到循環外或靜態屬性，避免重複分配內存。