PHP 5 類別常數完整指南：定義、存取與常見錯誤避坑

PHP 類別常數：不可變的類別層級資料

PHP 5 引入 const 關鍵字於類別內部定義常數，不同於全域 define()，類別常數具備命名空間隔離、可見度控制與自動載入優勢。本文詳細說明定義語法、存取方式與常見陷阱。

基本定義與存取語法

<?php
class Math {
    // 類別常數定義：不需 $ 符號，慣例全大寫底線分隔
    public const PI = 3.14159265359;
    public const EULER = 2.71828182846;
    private const INTERNAL_FACTOR = 1.5;
    
    public function calculateCircleArea(float $radius): float {
        // 類別內部存取：self::常數名
        return self::PI * $radius ** 2;
    }
    
    public static function getConstants(): array {
        return [
            'PI' => self::PI,
            'EULER' => self::EULER,
        ];
    }
}

// 類別外部存取：類別名::常數名
echo Math::PI;           // 3.14159265359
echo Math::EULER;        // 2.71828182846
// echo Math::INTERNAL_FACTOR; // Fatal Error: private 常數不可外部存取

關鍵特性與規範

常見錯誤與正確寫法對照

<?php
class Config {
    // 錯誤 1：嘗試在方法中修改常數
    public const VERSION = '1.0';
    public function setVersion(string $v) {
        // self::VERSION = $v; // Fatal Error: Cannot modify const
    }
    
    // 錯誤 2：使用變數語法存取
    // echo $this->VERSION; // Error: Access to undeclared static property
    
    // 正確：唯讀屬性替代可變「常數」（PHP 8.1+）
    public readonly string $version = '1.0';
    
    // 正確：運算式定義常數（PHP 8.1+）
    public const CACHE_TTL = 60 * 60 * 24; // 86400
    public const DS = DIRECTORY_SEPARATOR;
}

實戰應用場景

• 狀態碼定義：class HttpStatus { const OK = 200; const NOT_FOUND = 404; }
• 設定預設值：class Pagination { const DEFAULT_PER_PAGE = 20; }
• 型別常數：class UserType { const ADMIN = 'admin'; const USER = 'user'; }
• 位元遮罩旗標：class Permission { const READ = 1; const WRITE = 2; const EXECUTE = 4; }

晚期靜態綁定（LSB）與常數

<?php
class Base {
    public const NAME = 'Base';
    public static function whoAmI() {
        echo static::NAME; // LSB：執行時解析為實際呼叫類別
    }
}

class Child extends Base {
    public const NAME = 'Child';
}

Base::whoAmI();  // 輸出: Base
Child::whoAmI(); // 輸出: Child（若用 self::NAME 則輸出 Base）

總結

類別常數是表達「不變的類別層級資料」的標準方式。善用可見度控制、命名規範與 LSB 特性，能撰寫更清晰、安全且可維護的程式碼。PHP 8.1+ 的 readonly 屬性與 const 運算式支援，進一步擴展了適用場景。