PHP 編程風格指南：縮排、控制結構、可維護性最佳實踐

PHP 語法鬆散易上手，但也導致代碼臃腫難維護。PEAR 專案制定編碼標準，本文整理縮排、控制結構、註解等核心規範，提升代碼可讀性與團隊協作效率。

1. 縮排

• 統一縮排：所有代碼必須縮排，是提升可讀性最基本措施
• PEAR 標準：4 空格（不使用 Tab）
• 作者觀點：Tab 鍵優於空格 — 檔案更小、解析更快、個人可自訂 Tab 寬度（作者慣用 8 空格，近期改 4 空格）

範例

while ($x < $z) {
    if ($a == 1) {
        echo "A was equal to 1";
    } else {
        if ($b == 2) {
            // do something
        } else {
            // do something else
        }
    }
}

2. 控制結構

❌ 不好的寫法

if ($a == 1) echo "A was equal to 1";

難以辨識，維護時易漏加大括號導致 Bug。

⚠️ 有改進但仍不足

if ($a == 1)
    echo "A was equal to 1";

可讀性較好，但新增邏輯時仍易忘記加大括號。

✅ 完美寫法

if (($a == 1) && ($b == 2)) {
    echo "A was equal to 1";
    // 易於新增代碼
} elseif (($a == 1) && ($b == 3)) {
    // 其他操作
}

關鍵細節

• 關鍵字後加空格：if (、elseif ( — 與函數呼叫 func( 區分
• 保留空分支註解：// 其他操作 提醒維護者此處可擴展
• 條件括號：複雜條件建議加括號明確優先序

3. 核心原則

• 一致性：專案全域統一風格
• 可維護性優於寫作速度：代碼讀的次數遠多於寫的次數
• 文檔化：關鍵邏輯、非顯而易見處必須註解

現代 PHP 專案建議遵循 PSR-12 編碼標準，並使用 PHP_CodeSniffer、PHP-CS-Fixer 自動檢查修正。