ThinkPHP 的 C() 方法是框架配置管理的核心,主要職責:
$_config。C() 可輸出所有配置項。| 操作類型 | 語法範例 | 說明 |
|---|---|---|
| 設定一維配置 | C('USER_NAME', '小陳') | 單一鍵值設定 |
C(['USER_NAME'=>'chen', 'USER_HEIGHT'=>'170']) | 批次設定陣列 | |
| 設定二維配置 | C(['DB_PASSWORD'=>'root', 'DB_USERNAME'=>'root'], 'DB') | 指定群組名稱 |
C('DB.USER_NAME', 'XIAOCHEN') | 點號語法存取二維 | |
| 讀取一維 | C('USER_NAME') | 回傳字串值 |
| 讀取二維 | C('DB.DB_PASSWORD') | 點號分隔群組與鍵名 |
| 檢視所有 | C() | 除錯用,回傳完整配置陣列 |
PHP 陣列鍵名區分大小寫,團隊協作時開發者習慣不一(如 'db'、'DB'、'Db')會造成重複儲存。框架內部自動將一維鍵名轉為小寫,二維則只轉換第一層鍵名,避免此類問題。
<?php
// config.php
return [
'DB_TYPE' => 'mysql',
'DB_HOST' => 'localhost',
'DB_NAME' => 'my_db',
'DB_USER' => 'root',
'DB_PWD' => 'password',
'DB_PORT' => 3306,
'DB_PREFIX' => 'tp_',
];
// 載入配置
C(include 'config.php');
// 使用
$dbHost = C('DB_HOST'); // 自動轉小寫匹配
?>
function C($name = null, $value = null) {
static $_config = [];
if (!is_null($name)) {
if (is_string($name)) {
if (is_null($value)) { // 讀取
if (strpos($name, '.') === false) {
return isset($_config[strtolower($name)]) ? $_config[strtolower($name)] : null;
} else {
$name = explode('.', $name);
return isset($_config[strtolower($name[0])][$name[1]]) ? $_config[strtolower($name[0])][$name[1]] : null;
}
} else { // 寫入
if (strpos($name, '.') === false) {
$_config[strtolower($name)] = $value;
} else {
$name = explode('.', $name);
$_config[strtolower($name[0])][$name[1]] = $value;
}
}
} elseif (is_array($name)) { // 批次寫入
if (is_null($value)) {
$_config = array_merge($_config, $name);
} else {
$_config[$value] = $name; // 動態新增二維群組
}
}
} else {
return empty($_config) ? null : $_config; // 回傳全部
}
}
理解此機制有助於在專案中靈活管理多環境配置(開發/測試/正式環境)。