PHP 替代語法詳解：if/while/for/foreach/switch 冒號與 endif/endwhile 寫法優缺點與適用場景

PHP 替代語法詳解：if/while/for/foreach/switch 冒號與 endif/endwhile 寫法優缺點與適用場景

在 WordPress、Drupal、Laravel Blade 等知名專案的模板檔案中，常見 if ... :、endif;、endforeach; 等寫法。這是 PHP 官方提供的 替代語法，專為「模板檔案中混合 HTML 與 PHP 邏輯」設計。本文系統整理替代語法規則、支援的控制結構、與標準大括號寫法對比、優缺點分析與最佳實踐建議。

一、語法對照表

二、實際程式碼對比

1. if-else 結構

<?php if ($user->isAdmin()): ?>
    <div class="admin-panel">
        管理員專區內容
    </div>
<?php elseif ($user->isEditor()): ?>
    <div class="editor-tools">
        編輯器工具列
    </div>
<?php else: ?>
    <p>歡迎訪客，請 登入</p>
<?php endif; ?>

等同標準寫法：

<?php if ($user->isAdmin()) { ?>
    <div class="admin-panel">...</div>
<?php } elseif ($user->isEditor()) { ?>
    <div class="editor-tools">...</div>
<?php } else { ?>
    <p>...</p>
<?php } ?>

2. while 迴圈

<ul>
<?php while ($posts->have_posts()): $posts->the_post(); ?>
    <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li>
<?php endwhile; ?>
</ul>

3. foreach 迴圈（最常見於模板）

<select name="category">
<?php foreach ($categories as $cat): ?>
    <option value="<?php echo $cat->id; ?>"><?php echo $cat->name; ?></option>
<?php endforeach; ?>
</select>

4. switch 結構

<?php switch ($status): ?>
    <?php case 'published': ?>
        <span class="badge success">已發布</span>
        <?php break; ?>
    <?php case 'draft': ?>
        <span class="badge warning">草稿</span>
        <?php break; ?>
    <?php default: ?>
        <span class="badge secondary">未知</span>
<?php endswitch; ?>

三、優缺點深度分析

四、適用場景與最佳實踐

1. 純模板檔案（.phtml, .php 作為 View）：推薦使用替代語法。HTML 佔比高、邏輯淺層時，endif、endforeach 明顯優於尋找對應 }。
2. 業務邏輯層（Controller, Service, Model）：禁止使用替代語法。統一使用標準大括號，配合 PSR-12 風格，利於靜態分析、重構、IDE 重構工具。
3. 專案規範： 在 phpcs.xml 或團隊規範中明確定義：「View 層可用替代語法，其餘層禁用」。
4. 避免混用： 同一檔案內不得同時出現 :/endif 與 {/} 控制同一層級結構。

五、常見錯誤與避坑

• 漏寫分號： endif、endwhile 等必須以分號結尾（endif;），否則語法錯誤。
• else/elseif 也要加冒號： else:、elseif ($cond):，不能寫 else {。
• switch 中的 break： 替代語法下 break; 保持不變，不可寫成 break 或 endbreak。
• 巢狀層級過深： 超過 3 層建議重構為局部模板或 View Helper，而非硬抗巢狀替代語法。