PHP 專案開發編碼規範：變量、類、方法、常量命名與格式化統一標準

一、變量命名

• 全部小寫字母。
• 首字母前綴標識類型：
  • 整數 i、浮點 f、字符串 s、布爾 b
  • 陣列 a、對象 o、資源 r、混合 m
• 單詞間以下劃線 _ 分隔。

$i_age_max = 10;
$f_price = 22.5;
$s_name = 'harry';
$b_flag = true;
$a_price = array();
$o_object = new ClassName();
$r_file = fopen(...);
$m_var = array_combine($a_name, $a_flag);

二、類命名

• 駝峰式：每個單詞首字母大寫，其餘小寫。
• 首字母大寫。
• 不使用下劃線。
• 介面以 I 開頭、Interface 結尾。

class NameOneTwo {}
class Name {}
interface IExampleInterface {}

三、方法命名

• 駝峰式，首字母大寫。
• private/protected 方法以下劃線 _ 為前綴。
• 訪問器以 get/set 開頭；單例、工廠等模式方法名包含模式名。

class NameOneTwo {
    public function DoIt() {}
    protected function _HandleError() {}
    private function _SayHello() {}
}

四、類屬性命名

• 前綴同變量類型前綴（i/s/a...）。
• 其後遵循類命名規則（駝峰）。
• 私有屬性額外以下劃線 _ 開頭。

class NameOneTwo {
    public $iAge;
    private $_iAge;
}

五、方法參數命名

參照類屬性命名規則。

public function VarAbc($sMsg) {}

六、全局變量

• 前綴 g，其餘同變量規則。

global $gi_Age;
global $ga_Price;

七、常量定義

• 全大寫，單詞間以下劃線分隔。

define('E_ERROR_MISSING_PARA', 501);

八、函數命名

• 全小寫，單詞間以下劃線分隔。

function some_bloody_function() {}

九、大括號風格

大括號置於關鍵字同行（推薦）或下一行同列。

function foo() {
    if (true) {
        // code
    }
}

十、縮進規則

使用 Tab 鍵縮進，保持層級清晰。

總結

統一編碼規範能顯著降低團隊溝通成本，提升代碼可讀性與維護效率。建議納入代碼審查清單，配合 IDE 格式化工具強制執行。