get_defined_constants() 的基本用法詳解

M66 2025-05-20

在PHP開發過程中，常量是非常重要的一部分，它們用於存儲不可改變的值，方便代碼中重複使用。 PHP提供了一個非常實用的函數get_defined_constants() ，用於獲取當前腳本中所有已經定義的常量。本文將詳細介紹get_defined_constants()函數的用法，並解析在使用時需要注意的事項。

什麼是get_defined_constants()函數？

get_defined_constants()是PHP內置的一個函數，作用是返回當前所有已定義的常量數組。它不僅包含用戶自定義的常量，還包含PHP內置的各種系統常量。

函數定義：

 array get_defined_constants([bool $categorize = false])

參數$categorize （可選）：默認值為false ，表示返回一個一維數組，包含所有常量及其值。
如果傳入true ，則返回一個二維數組，按照不同類別將常量分類存儲。

基本用法示例

下面是一個簡單示例，展示如何使用get_defined_constants()獲取所有常量：

 <?php
// 獲取所有常量，不分類
$constants = get_defined_constants();
print_r($constants);
?>

輸出結果是一個包含常量名和常量值的關聯數組，例如：

 Array
(
    [PHP_VERSION] => 8.0.3
    [E_ERROR] => 1
    [E_WARNING] => 2
    ...
)

如果想更清晰地查看不同類型的常量，可以傳入true參數：

 <?php
// 獲取所有常量，並進行分類
$constants = get_defined_constants(true);
print_r($constants);
?>

輸出結構類似於：

 Array
(
    [Core] => Array
        (
            [E_ERROR] => 1
            [E_WARNING] => 2
            ...
        )
    [date] => Array
        (
            [DATE_ATOM] => Y-m-d\TH:i:sP
            [DATE_COOKIE] => l, d-M-Y H:i:s T
            ...
        )
    [user] => Array
        (
            [MY_CONST] => 123
        )
)

這樣你可以很方便地看到常量的分類。

實際應用場景

調試程序：快速查看當前系統和程序中所有可用的常量。
動態生成代碼：通過讀取系統常量來實現代碼適配或配置。
框架開發：框架中需要列出所有內置或用戶定義的常量做統一管理。

注意事項

返回數組較大<br> 如果程序中定義了大量常量，返回的數組會比較大，建議在調試時使用，避免直接在生產環境中打印
只讀性質<br> 常量的值不可改變， get_defined_constants()返回的數組僅供查看，不能通過該函數修改常量
分類參數的使用<br> 傳入true時分類返回的數組對於理解系統常量結構有幫助，但如果只關心全部常量的平鋪列表，傳入false或不傳參數即可
與其他常量函數的配合<br> 可結合define()函數動態定義常量， get_defined_constants()即可檢測到自定義的常量

結合示例：定義並獲取自定義常量

<?php
// 定義自定義常量
define('MY_CONST', 'Hello World');
define('ANOTHER_CONST', 2025);

// 獲取所有常量并分类
$allConstants = get_defined_constants(true);

// 輸出用戶定義的常量部分
print_r($allConstants['user']);
?>

輸出結果：

 Array
(
    [MY_CONST] => Hello World
    [ANOTHER_CONST] => 2025
)

通過這種方式，可以輕鬆管理並查看自定義的常量。

總結

get_defined_constants()是PHP中非常有用的內置函數，能幫助開發者快速獲取當前所有的常量信息。無論是系統常量還是用戶定義常量，都可以一目了然。合理利用該函數能極大方便調試和代碼管理，但需要注意返回數組大小以及分類參數的使用。