PHP 閉合標籤 ?> 何時可省略？最佳實踐與 Header 錯誤防範

PHP 閉合標籤 ?> 何時可省略？最佳實踐與 Header 錯誤防範

許多 PHP 專案中的純類別檔、設定檔、函數庫都省略結尾的 ?>。這不是偷懶，而是官方推薦的最佳實踐，能有效避免「Header already sent」等難除錯錯誤。本文透過兩個對比範例，解析核心原理與適用場景。

核心對比：純 PHP vs 混合 HTML

✅ 純 PHP 檔案：可省略、建議省略

<?php
echo 123456;
// 結尾無 ?> 完全合法，執行正常

❌ 混合 HTML：必須保留 ?>

<?php
echo 123456;
?>
<p>abc</p>
<?php // 若無上方 ?>，這裡的 HTML 會被視為 PHP 代碼導致語法錯誤
echo "more";
?>

為何純 PHP 建議省略 ?>？

1. 防止輸出汙染：PHP 解析器將 ?> 後的所有字元（含看不見的空白、換行、BOM）視為**直接輸出**送往瀏覽器。
2. Header/Session/Cookie 錯誤：這些函數必須在**任何輸出之前**呼叫。若被包含的檔案尾部有多餘換行，主程式呼叫 header() 時就會噴 Warning: Cannot modify header information - headers already sent。
3. 源碼洩露：瀏覽器「檢視原始碼」開頭出現大量空行，往往就是這個原因。

官方文件明確建議

「PHP 閉合標籤 ?> 在 PHP 解析器中是**可選**的。若使用閉合標籤，任何由開發者、使用者、FTP 工具插入在標籤後的空白字元，都可能導致多餘輸出、PHP 錯誤、後續輸出無法顯示、空白頁。因此，**所有純 PHP 檔案應省略閉合標籤**，並以註釋標示檔案結束與相對路徑。」

對比範例

<?php
echo "Here's my code!";
?>

<?php
echo "Here's my code!";
/* End of file myfile.php */

適用場景速查表

常見誤區澄清

• Dreamweaver 設計視圖會亂碼？：現代 IDE（PhpStorm、VS Code）皆完美支援無閉合標籤檔案，舊工具限制不應成為理由。
• 不寫 ?> 會不標準？：官方文件明確說是可選，且推薦省略，符合 PSR-12 風格指南。

養成習慣：純 PHP 檔案永遠不寫 ?>，檔案結尾加上 /* End of file ... */ 註釋。這行微小改動，能替你省下無數個深夜除錯 headers already sent 的時間。