萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 結束標籤與分號的最佳實踐技巧

關於 PHP 標籤結束與分號的細節:少即是多

PHP 解析器對結束標籤 ?> 與最後一條陳述式的分號有寬容處理,但理解規則能避免常見陷阱 (如輸出前多餘空白導致 Header 失效)。

規則總結

情況是否需要分號是否需要 ?>說明
單行純 PHP 檔案可省略建議省略避免結束標籤後誤留空白/換行
多行 PHP 代碼每行必須可省略最後一行分號可省,但建議保留一致性
PHP 嵌入 HTMLPHP 區塊內必須必須切換回 HTML 模式需 ?>
只含一條陳述式可省略可省略 合法

實例演示

<?php
// 情況 1:純 PHP 檔案 (如類別定義、函數庫)
// ✅ 推薦:省略結束標籤,防止後方空白字元輸出
function helper() {
    return 'hello';
}
// 結尾無 ?>

// 情況 2:模板檔案 (PHP 嵌入 HTML)
?>


<?= $title ?? '預設標題' ?>

    

歡迎,

版權所有
<?php // 這裡若還有 PHP 代碼需重新開啟標籤 ?>

為什麼純 PHP 檔建議省略 ?>?

  1. 防止輸出前空白:結束標籤後的換行、空格會被直接輸出,導致 header()、session_start()、setcookie() 失效 (「Headers already sent」)。
  2. 版本控制差異:編輯器自動加入檔案末尾換行 (POSIX 標準),若有 ?> 會產生多餘輸出。
  3. PSR-12 標準:明確建議純 PHP 檔案省略結束標籤。
  4. 分號省略細節

    <?php
    // 合法:最後一條陳述式前無分號
    echo 'Hello'
    ?>
    
    // 但建議統一加分號,避免後續新增行時忘記補上
    echo 'Hello';
    ?>
    
    // 嵌入 HTML 時,PHP 區塊最後一行分號可省略
    ?>
    
    <?php // 但下一行 PHP 代碼需正常分號 $next = 'value'; ?>

    實務建議清單

    • ✅ 所有純 PHP 檔案 (Class, Function, Config) 省略 ?> 。
    • ✅ 模板/視圖檔案 保留 切換。
    • ✅ 統一在 PHP 區塊內保留分號 (含最後一行),維持一致性。
    • ✅ 使用 短標籤輸出變數 (PHP 5.4+ 永遠啟用,不受 short_open_tag 影響)。
    • ✅ 設定編輯器「檔案結尾換行」但不在 ?> 後 (因為沒有 ?>)。
copyright © 萬盛學電腦網 all rights reserved