新手必學：在 HTML 中嵌入 PHP 代碼的完整指南

新手必學：在 HTML 中嵌入 PHP 代碼的完整指南

PHP 的設計初衷就是為了與 HTML 無縫混合。對於有經驗的開發者這很基礎，但初學者常對標籤位置、輸出方式感到困惑。本文從最簡單的輸出到流程控制嵌入，逐步講解。

基本語法：PHP 標籤

所有 PHP 代碼必須包裹在 <?php ... ?> 標籤內。伺服器會解析標籤內的代碼，將結果輸出到 HTML 流中。

範例 1：輸出簡單字串

<!DOCTYPE html>
<html>
<head>
    <title>PHP 測試頁</title>
</head>
<body>
    <?php echo '<p>Hello World!</p>'; ?>
</body>
</html>

範例 2：在 HTML 結構中混合流程控制

利用 PHP 的流程控制語句（if, for, foreach 等）動態生成 HTML 結構。注意：大括號可以用冒號 : 和 endif; endfor; 替代，閱讀性更佳。

<!DOCTYPE html>
<html>
<head><title>PHP 與 HTML 整合</title></head>
<body>
    <ul>
    <?php for ($i = 1; $i <= 5; $i++): ?>
        <li>項目編號 <?php echo $i; ?></li>
    <?php endfor; ?>
    </ul>
</body>
</html>

輸出結果：

項目編號 1
項目編號 2
項目編號 3
項目編號 4
項目編號 5

進階技巧：短標籤與輸出緩衝

• 短標籤：<?= $var ?> 等同於 <?php echo $var; ?>（需啟用 short_open_tag）。
• 輸出緩衡：使用 ob_start() 可捕獲輸出，便於模板引擎或延遲輸出。

最佳實踐建議

1. 邏輯與視圖分離：複雜業務邏輯放在控制器/服務層，視圖僅負責輸出變數與簡單判斷。
2. 善用模板引擎：如 Blade、Twig、Smarty，提供繼承、過濾器等高級功能。
3. 注意 XSS：輸出用戶輸入時務必用 htmlspecialchars() 轉義。