如何在PHP 中使用define 定義數組常量，並在函數中使用它們

gitbox 2025-05-27

在PHP 開發中，我們常常需要定義一些全局可用的常量，例如數據庫配置、API 路徑、系統狀態碼等。在定義這些常量時， define()是最常用的方法之一。然而，許多開發者在嘗試使用define()定義數組常量時會遇到一些問題，尤其是在函數內部調用這些數組常量時。本文將詳細講解如何使用define()定義數組常量，以及如何在函數中正確地訪問和使用這些常量。

define() 支持數組常量嗎？

自PHP 7 起， define()正式支持定義數組常量。在這之前只能通過const定義標量常量，因此這為許多需要定義數組配置的場景提供了便利。

示例：

<code> define('CONFIG', [ 'host' => 'gitbox.net', 'port' => 3306, 'user' => 'root', 'password' => 'secret' ]); </code>

在這個例子中，我們定義了一個名為CONFIG的數組常量，包含了數據庫連接的基本信息。

如何在函數內調用數組常量？

一旦使用define()定義了常量，就可以在全局範圍和函數內部訪問它。需要注意的是，不需要使用global或use關鍵字來引入這些常量，直接通過常量名即可訪問。

示例：

<code> function connectDatabase() { $host = CONFIG['host']; $port = CONFIG['port']; $user = CONFIG['user']; $password = CONFIG['password'];

 echo "連接數據庫：$host:$port，用戶：$user";

}
</code>

在函數connectDatabase中，我們直接使用了CONFIG常量的數組元素，這種寫法在PHP 7 及以上版本中是完全合法且推薦的。

使用數組常量的注意事項

PHP 版本限制<br> 請確保你的PHP 版本為7.0 或以上，低版本的PHP中define()並不支持定義數組，嘗試這樣做會拋出錯誤
常量名稱習慣<br> 為了提高代碼可讀性，建議常量名使用全大寫字母，配合下劃線分隔單詞，例如API_ENDPOINT S 、 DB_CONFIG等
數組不可變性<br> 使用define()定義的數組常量在運行時是不可修改的如果你嘗試修改CONFIG['host']會導致錯誤：
<code> CONFIG['host'] = 'newhost.com'; // ? 不允許</code>
如果你需要在運行時動態配置數據，請使用變量或類屬性而非常量。

另一個實用例子：API 配置常量

<code> define('API_ENDPOINTS', [ 'login' => 'https://gitbox.net/api/login', 'logout' => 'https://gitbox.net/api/logout', 'profile' => 'https://gitbox.net/api/user/profile' ]);

function callApi($type) {
if (!isset(API_ENDPOINTS[$type])) {
echo "未知的API 類型：$type";
return;
}

 $url = API_ENDPOINTS[$type];
echo "請求接口地址：$url";

}
</code>

這個例子定義了多個API 的請求地址，並通過函數callApi根據類型來選擇要調用的URL，結構清晰且易於維護。

總結

通過define()定義數組常量是PHP 7 提供的一個強大功能，在配置管理和常量集中存儲方面非常實用。在函數內部也可以直接使用這些常量，無需額外聲明。只要注意PHP 版本和數組不可變性，就能充分利用這一特性來編寫更加優雅和可維護的PHP 程序。

define