PHP 變數命名慣例建議：型態前綴與團隊規範

PHP 是弱型別語言，變數型態不顯式宣告，團隊協作時統一命名慣例能大幅提升程式碼可讀性與維護性。本文分享實務驗證的「型態前綴」命名風格（類似匈牙利命名法簡化版），並說明陣列維度、物件、資源等進階規範。

基本型態前綴

陣列維度與語意命名

// 一維陣列：單數名詞
$aUser = ['id' => 1, 'name' => 'John'];

// 多維/集合陣列：複數名詞
$aUsers = [
    ['id' => 1, 'name' => 'John'],
    ['id' => 2, 'name' => 'Jane']
];

// 關聯陣列（字典）：單數 + Map/Dict 後綴或直接語意化
$aUserMap = [1 => 'John', 2 => 'Jane'];
$aConfig = ['db_host' => 'localhost', 'db_port' => 3306];

物件與資源進階規範

布林值語意化命名（優於前綴）

// 推薦：以 is/has/can/should 開頭，可省略 b 前綴
$isLoggedIn = true;
$hasPermission = false;
$canEdit = true;
$shouldRetry = false;

常數與全域變數

• 類別常數：CLASS_CONSTANT（全大寫底線分隔）
• 全域常數：APP_DEBUG, DB_DEFAULT_CHARSET
• 全域變數（極少用）：$gConfig、$GLOBALS['app'] 加 g 前綴警示。

團隊落地建議

1. 建立 NAMING_CONVENTION.md 納入專案文件。
2. 配置 PHP_CodeSniffer 自訂規則或使用 PHPStan/Psalm 偵測不符合慣例的變數。
3. Code Review 時重點檢查：型態前綴一致性、陣列單複數、布林語意化。
4. 既有專案漸進式重構：新檔案強制遵循，舊檔案修改時順手調整。

總結

「型態前綴 + 語意化名稱」能在不依賴 IDE 型別提示的情況下，讓開發者一眼掌握變數用途。關鍵在於團隊共識與工具化檢查，而非教條主義。