在 PHP 中,全域常量使用 define() 定義,但類別內部無法使用 define()。類別常量必須使用 const 關鍵字宣告,其特性與靜態成員相似:屬於類別而非實例,不可變更,存取方式為 類別名::常量名 或 self::常量名。
const CONSTANT_NAME = 'value';array(PHP 5.6+),不可為變數或運算式結果$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 (類別常量) | define() (全域常量) |
|---|---|---|
| 定義位置 | 類別內部 | 任何位置(全域) |
| 命名空間 | 屬於類別命名空間 | 全域命名空間 |
| 存取方式 | ClassName::CONST | CONST |
| 大小寫敏感 | 永區分大小寫 | 可設定不敏感(第三參數) |
| 值類型 | 標量/陣列 (PHP 5.6+) | 僅標量 |
| 修飾符 | 可用 public/protected/private | 無(永遠全域可見) |
| 編譯時期 | 編譯時期定義 | 執行時期定義 |
<?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+) |
const STATUS_ACTIVE = 1;const 是 PHP 類別定義不可變常量的標準方式,提供命名空間隔離、可見性控制與編譯時期優化。掌握其語法規則(無 $、不可變、標量/陣列值)與存取方式(:: 操作子),能讓類別設計更清晰、更安全。