CodeIgniter config.php 核心配置項深度解析與動態修改技巧

前言：配置是應用行為的基因

application/config/config.php 是 CodeIgniter 應用的中樞神經，控制著語系、編碼、安全、日誌、Hook、類別前綴等核心行為。本文逐項解析關鍵配置項，並示範運行時動態修改技巧。

關鍵配置項詳細說明

動態讀取與修改配置

1. 輔助函數 config_item() (唯讀)

$charset = config_item('charset'); // 返回 'UTF-8'
$csrf = config_item('csrf_protection'); // 返回 TRUE/FALSE

2. Config 類別實例 (可讀寫)

// 讀取
$charset = $this->config->item('charset');

// 修改 (僅影響當前請求)
$this->config->set_item('csrf_protection', FALSE); // 關閉特定頁面 CSRF
$this->config->set_item('language', 'chinese');    // 動態切換語系

// 取得所有配置陣列
$all_config = $this->config->config; // 參考傳回，修改會影響全域

3. 實戰場景：動態關閉 CSRF 保護

class Api extends CI_Controller {
    public function __construct() {
        parent::__construct();
        // API 端點使用 Token 驗證，關閉 CSRF
        if (strpos($this->uri->uri_string(), 'api/') === 0) {
            $this->config->set_item('csrf_protection', FALSE);
        }
    }
}

4. 實戰場景：多語系動態切換

class MY_Controller extends CI_Controller {
    public function __construct() {
        parent::__construct();
        $lang = $this->session->userdata('lang') ?: 'english';
        $this->config->set_item('language', $lang);
        $this->lang->load('common', $lang); // 載入對應語系檔
    }
}

配置檔分離與環境管理

環境專屬配置

application/config/
├── config.php              # 共用配置
├── development/
│   └── config.php          # 開發環境覆蓋 (log_threshold=4, csrf_protection=FALSE)
├── production/
│   └── config.php          # 生產環境覆蓋 (log_threshold=1, encryption_key=xxx)
└── testing/
    └── config.php          # 測試環境覆蓋

CI 根據 ENVIRONMENT 常數 (預設從 $_SERVER['CI_ENV'] 讀取) 自動載入對應目錄配置覆蓋基礎配置。

敏感配置外部化

// config.php
$config['encryption_key'] = getenv('CI_ENCRYPTION_KEY') ?: 'dev_default_key_32chars_long!!';
$config['database'] = [
    'default' => [
        'hostname' => getenv('DB_HOST') ?: 'localhost',
        'username' => getenv('DB_USER') ?: 'root',
        'password' => getenv('DB_PASS') ?: '',
        'database' => getenv('DB_NAME') ?: 'myapp',
    ]
];

生產環境透過 Web Server (Apache SetEnv / Nginx fastcgi_param) 或 Docker/K8s 環境變數注入，程式碼零敏感資訊。

自定義配置檔

建立 application/config/payment.php：

$config['ecpay'] = [
    'merchant_id' => '2000132',
    'hash_key'    => '5294y06JbISpM5x9',
    'hash_iv'     => 'v77hoKGq4kWxNNIS',
    'url'         => 'https://payment.ecpay.com.tw/Cashier/AioCheckOut/V5',
];
$config['newebpay'] = [ ... ];

載入使用：

$this->config->load('payment'); // 載入到 $this->config->config['ecpay']
$ecpay = $this->config->item('ecpay'); // 取得單項
// 或
$this->config->load('payment', TRUE); // 載入到 $this->config->payment['ecpay'] (第二參數 TRUE 為命名空間)
$ecpay = $this->config->item('ecpay', 'payment');

常見配置錯誤排查

總結

config.php 是應用行為的控制台，**理解每個配置項的副作用、環境區隔策略、動態修改時機** 是 CI 開發者必修課。建立「配置即代碼」文化：敏感值環境變數化、環境差異目錄化、業務配置檔案化、動態修改局部化。