PHP Heredoc（<<<）語法提供了一種優雅的多行字符串定義方式，支持變量插值、保留格式、無需轉義引號。本文全面解析 Heredoc 與 Nowdoc 的語法規則、變量解析機制、縮進處理、常見陷阱及現代最佳實踐。
基本語法結構
$str = <<
關鍵規則
- 標識符：
EOF 為自定義標識符，可為任意合法標識符（如 HTML、SQL、JSON），首尾必須完全一致。
- 結束標識符：必須獨佔一行，行首無縮進、無空格、無額外字符，末尾分號可選但推薦加上。
- 起始標識符後：
<< 後必須換行，字符串內容從下一行開始。
Heredoc vs Nowdoc：解析與不解析
| 特性 | Heredoc (<<| Nowdoc (<<<'EOF') | |
|---|
| 變量解析 | ✅ 支持 {$var}、{$obj->prop}、{$arr['key']} | ❌ 完全不解析，視為字面量 |
| 轉義序列 | 支持 \n、\t、\\ 等 | 不支持，按字面量輸出 |
| 用途 | 動態模板、SQL 構建、包含變量的多行文本 | 靜態模板、正則表達式、包含 $ 符號的代碼片段 |
變量解析進階語法
$name = 'ThinkPHP';
$arr = ['version' => '3.1'];
$obj = new stdClass();
$obj->author = 'Liu21st';
// 簡單變量
echo <<author}
Class: {get_class($obj)} // 函數調用需花括號
STR;
實戰陷阱與規避
1. 結束標識符縮進導致解析失敗
function test() {
$str = <<
PHP 7.3+ 支持結束標識符縮進：若啟用 heredoc_indent 特性（實驗性），可允許縮進，但建議保持兼容性，堅持頂格。
2. 變量解析邊界歧義
$var = 'test';
echo <<
鐵律：Heredoc 中所有變量必須使用 {$var} 花括號語法。
3. 單引號標識符誤用
$str = <<<'EOF'
{$var} 不會解析
EOF; // 這是 Nowdoc，非 Heredoc
4. 尾隨空格導致不匹配
$str = <<
現代最佳實踐
1. 語義化標識符提升可讀性
$sql = <<
{$title}
{$content}
HTML;
$json = <<
2. 結合 trim() 處理首尾換行
$template = trim(<<
{$title}
TPL
); // 移除首尾換行，獲得緊湊字符串
3. SQL 構建器模式
function buildQuery($table, $where, $order = '') {
$sql = <<
4. 避免在循環中使用 Heredoc（性能）
// ❌ 循環中重複解析 Heredoc 結構
foreach ($items as $item) {
$html .= <<{$item->name}
HTML;
}
// ✅ 預定義模板，循環中替換
$tpl = <<{name}
HTML;
foreach ($items as $item) {
$html .= str_replace('{name}', $item->name, $tpl);
}
總結
PHP Heredoc 以「無需轉義引號、保留格式、支持變量插值」三大優勢，成為多行字符串定義的首選語法。掌握 結束標識符頂格、變量必加花括號、語義化標識符 三大鐵律，配合 trim()、語義化標識符、模板預編譯等現代實踐，可編寫出優雅、可維護、高性能的多行字符串代碼。PHP 7.3+ 的縮進支持雖放寬了格式限制，但為兼容性著想，仍建議堅持頂格結束標識符習慣。
- 上一篇文章： ThinkPHP 3.1 多層 MVC 架構深度解析：Model/Logic/Service 分層、Controller 分層與視圖多主題
- 下一篇文章： PHP 抓取網頁圖片與 DIV 內容實戰：正則匹配、編碼處理與反爬蟲應對指南
Copyright ©
程式碼之家 All Rights Reserved
