get_defined_constants() 為什麼返回嵌套數組？

M66 2025-05-20

在PHP 開發過程中， get_defined_constants()是一個非常有用的函數，它可以返回所有已經定義的常量。然而，許多開發者第一次使用它時，會對它的返回結果感到困惑：為什麼這個函數返回的是一個嵌套數組，而不是一個簡單的鍵值對列表？

函數簡介

get_defined_constants()是一個內置函數，用於返回當前腳本中所有已經定義的常量。其語法如下：

 array get_defined_constants ([ bool $categorize = false ] )

當我們調用get_defined_constants()並傳入參數$categorize = true時，它會按照常量的“分類”返回嵌套數組。即使沒有顯式傳入該參數，有些環境中可能會默認返回嵌套結構。

為什麼返回嵌套數組？

PHP 中的常量種類非常多，涵蓋了核心語言、擴展、用戶自定義等各個方面。為了更清晰地展示這些信息，PHP 提供了分類方式來組織常量。當你使用：

 print_r(get_defined_constants(true));

你會看到類似如下的輸出結構：

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

    [date] => Array
        (
            [DATE_ATOM] => Y-m-d\TH:i:sP
            ...
        )

    [user] => Array
        (
            [MY_CUSTOM_CONST] => 123
        )
)

這種嵌套數組結構使得我們更容易地了解哪些常量是由核心模塊定義的，哪些是擴展提供的，哪些又是用戶自定義的。這種組織方式在調試和排查問題時非常有用，尤其是在大型項目或使用了多個擴展的環境中。

如果只想獲取純列表怎麼辦？

如果你只想獲取一個簡單的常量列表而不關心分類，可以將參數設為false （或省略參數）：

 $constants = get_defined_constants(false);
print_r($constants);

這將返回一個扁平的數組，例如：

 Array
(
    [E_ERROR] => 1
    [E_WARNING] => 2
    [DATE_ATOM] => Y-m-d\TH:i:sP
    [MY_CUSTOM_CONST] => 123
)

這種方式適合需要快速查找某個常量值的情況，或者在處理常量時不關心它的來源。

實際應用舉例

在調試時，你可能會想檢查自定義常量是否被正確定義：

 define('SITE_URL', 'https://m66.net');
$constants = get_defined_constants(true);

if (isset($constants['user']['SITE_URL'])) {
    echo "常量 SITE_URL 已定義，值為：" . $constants['user']['SITE_URL'];
}

通過這種方式，我們可以清晰地定位某個常量的定義來源，避免在項目中常量命名衝突的問題。

結語

PHP 中的get_defined_constants()之所以返回嵌套數組，是為了增強可讀性和可維護性，特別是在大型系統中能清楚地區分常量的來源。雖然初看複雜，但一旦理解其結構和用途，將會成為開發者手中的強大工具。

get_defined_constants