萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP const 常量修飾符完整指南:類別常量定義與使用

為什麼類別需要 const?

在 PHP 中,全域常量使用 define() 定義,但類別內部無法使用 define()。類別常量必須使用 const 關鍵字宣告,其特性與靜態成員相似:屬於類別而非實例,不可變更,存取方式為 類別名::常量名 或 self::常量名。

基本語法與規則

  • 宣告於類別內部:const CONSTANT_NAME = 'value';
  • 常量名慣例全大寫,前面不加 $ 符號
  • 值必須為標量或 array(PHP 5.6+),不可為變數或運算式結果
  • 一旦定義不可修改,嘗試修改會導致錯誤
  • PHP 5.3+ 可透過物件存取:$obj::CONSTANT

基礎範例

<?php
class MyClass {
    const CONSTANT = 'CONSTANT value';
    
    public function showConstant() {
        // 類別內部使用 self:: 常量名(無 $ 符號)
        echo self::CONSTANT . "<br>";
    }
}

// 類別外部使用 類別名::常量名
echo MyClass::CONSTANT . "<br>";

$class = new MyClass();
$class->showConstant();

// PHP 5.3.0+ 也可透過物件存取
echo $class::CONSTANT; // 輸出:CONSTANT value
?>

重要細節:常量名不加 $ 符號

<?php
class Config {
    const API_URL = 'https://api.example.com';
    const MAX_RETRY = 3;
    const STATUS_CODES = [200, 201, 400, 401, 404, 500]; // PHP 5.6+ 支援陣列
    
    // ❌ 錯誤:常量名不能加 $
    // const $API_KEY = 'secret'; 
    
    // ❌ 錯誤:不能使用變數或運算式
    // const TIMESTAMP = time(); 
    // const DOUBLE = MAX_RETRY * 2;
}
?>

常量不可變性驗證

<?php
class MyClass {
    const CONSTANT = 'original';
    
    public function tryChange() {
        // ❌ 編譯/執行錯誤:Cannot re-assign auto-global variable
        // self::CONSTANT = 'new value'; 
    }
}

echo MyClass::CONSTANT; // original
?>

const vs define() 差異比較

特性const (類別常量)define() (全域常量)
定義位置類別內部任何位置(全域)
命名空間屬於類別命名空間全域命名空間
存取方式ClassName::CONSTCONST
大小寫敏感永區分大小寫可設定不敏感(第三參數)
值類型標量/陣列 (PHP 5.6+)僅標量
修飾符可用 public/protected/private無(永遠全域可見)
編譯時期編譯時期定義執行時期定義

進階應用:常量可見性控制(PHP 7.1+)

<?php
class ApiConfig {
    // 公開常量:任何地方可存取
    public const VERSION = 'v1';
    
    // 受保護常量:僅本類別與子類別可存取
    protected const INTERNAL_TIMEOUT = 30;
    
    // 私有常量:僅本類別可存取
    private const SECRET_KEY = 'abc123';
    
    public function getTimeout() {
        return self::INTERNAL_TIMEOUT; // 本類別可存取 protected/private
    }
}

echo ApiConfig::VERSION; // 正常
// echo ApiConfig::INTERNAL_TIMEOUT; // Fatal Error: Cannot access protected constant
// echo ApiConfig::SECRET_KEY; // Fatal Error: Cannot access private constant
?>

魔術常量對照表

PHP 提供多個「魔術常量」,值會隨著程式碼位置動態變化:

常量說明
__LINE__檔案中的當前行號
__FILE__檔案完整路徑與檔名(包含檔案時返回被包含檔名)
__DIR__檔案所在目錄(等同 dirname(__FILE__))
__FUNCTION__函數名稱(PHP 5.3+ 區分大小寫)
__CLASS__類別名稱(含命名空間,PHP 5.3+ 區分大小寫)
__TRAIT__Trait 名稱(PHP 5.4+)
__METHOD__類別方法名稱(含類別名,區分大小寫)
__NAMESPACE__當前命名空間名稱(PHP 5.3+)
ClassName::class類別完整名稱(含命名空間,PHP 5.5+)

最佳實踐建議

  1. 配置值集中管理:將 API 端點、狀態碼、預設值等定義為類別常量
  2. 替代魔術數字:避免程式碼中出現不明數字,如 const STATUS_ACTIVE = 1;
  3. 搭配介面定義契約:介面可定義常量,實作類別需遵守
  4. 避免過度使用:頻繁變動的設定應使用配置檔或環境變數

總結

const 是 PHP 類別定義不可變常量的標準方式,提供命名空間隔離、可見性控制與編譯時期優化。掌握其語法規則(無 $、不可變、標量/陣列值)與存取方式(:: 操作子),能讓類別設計更清晰、更安全。

copyright © 萬盛學電腦網 all rights reserved