HTML 中嵌入 PHP 程式碼完整入門指南

基本語法

PHP 程式碼必須包裹在 <?php ... ?> 標籤中，可插入 HTML 任何位置。

範例 1：簡單輸出

<html>
<head><title>PHP Test</title></head>
<body>
    <?php echo '<p>Hello World</p>'; ?>
</body>
</html>

範例 2：控制結構與 HTML 混合

<html>
<head><title>PHP HTML Integration</title></head>
<body>
    <ul>
    <?php for ($i = 1; $i <= 5; $i++) { ?>
        <li>Item No <?php echo $i; ?></li>
    <?php } ?>
    </ul>
</body>
</html>

輸出：

Item No 1
Item No 2
Item No 3
Item No 4
Item No 5

進階技巧

1. 短標籤 (需啟用 short_open_tag)

<?= $variable ?> <!-- 等同 <?php echo $variable; ?> -->
<?=$user->name?>

2. 替代語法 (適合模板)

<?php if ($loggedIn): ?>
    <p>Welcome, <?=$username?></p>
<?php else: ?>
    <a href="/login">Login</a>
<?php endif; ?>

<?php foreach ($items as $item): ?>
    <div><?=$item['name']?></div>
<?php endforeach; ?>

3. 區塊輸出 (Heredoc/Nowdoc)

<?php
$html = <<<HTML
<div class="card">
    <h3>{$title}</h3>
    <p>{$content}</p>
</div>
HTML;
echo $html;
?>

最佳實踐建議

1. 分離關注點：複雜邏輯放在 Controller/Service，模板僅做輸出與簡單判斷。
2. 輸出轉義：htmlspecialchars($str, ENT_QUOTES, 'UTF-8') 防 XSS，或使用模板引擎 (Blade, Twig, Smarty) 自動轉義。
3. 避免深層巢狀：使用提前返回、輔助函式簡化模板邏輯。
4. 統一編碼：檔案儲存為 UTF-8 無 BOM，HTTP 標頭 Content-Type: text/html; charset=utf-8。

常見錯誤

• <? ... ?> 短標籤在預設關閉的環境會被當成文字輸出。
• HTML 屬性中直接輸出未轉義變數：<input value="<?=$val?>"> 若 $val 含雙引號會破壞結構。
• ?> 後有多餘空白行導致 Cannot modify header information，建議純 PHP 檔案**省略結束標籤**。