CodeIgniter Session 自動加載報錯「必須設置加密密鑰」完美解決

開啟 CodeIgniter Session 自動加載後出現報錯：「In order to use the Session class you are required to set an encryption key」。這是因為 Session 類依賴加密功能，必須配置 encryption_key。

問題原因

CI Session 類在初始化時檢查加密密鑰：

// system/libraries/Session.php
public function __construct() {
    if (empty($this->encryption_key)) {
        show_error('In order to use the Session class you are required to set an encryption key in your config file.');
    }
    // ...
}

解決步驟

1. 打開配置文件

application/config/config.php

2. 找到 encryption_key 配置

/*
|--------------------------------------------------------------------------
| Encryption Key
|--------------------------------------------------------------------------
| If you use the Encryption class or the Session class you
| MUST set an encryption key. See the user guide for info.
*/
$config['encryption_key'] = '';  // 默認空值導致報錯

3. 設置強隨機密鑰

// 方法一：手動設置（生產環境建議）
$config['encryption_key'] = 'X7k9mP2qR5vW8zA1bC3dE6fG9hJ2kL5';

// 方法二：動態生成（僅開發環境）
$config['encryption_key'] = bin2hex(random_bytes(16));

// 方法三：從環境變量讀取（最佳實踐）
$config['encryption_key'] = getenv('CI_ENCRYPTION_KEY') ?: 'fallback_key_for_dev_only';

密鑰生成最佳實踐

命令行快速生成

# Linux/Mac
php -r "echo bin2hex(random_bytes(32)) . PHP_EOL;"

# Windows PowerShell
php -r "echo bin2hex(random_bytes(32)) . PHP_EOL;"

在線工具生成

• 隨機字符串生成器（32-64 字符）
• 包含大小寫字母、數字、特殊符號
• 妥善保存，不要提交到版本控制

環境區分配置（推薦）

// application/config/config.php
switch (ENVIRONMENT) {
    case 'development':
        $config['encryption_key'] = 'dev_key_only_for_local_testing_123456789012';
        break;
    case 'testing':
        $config['encryption_key'] = getenv('CI_TEST_ENCRYPTION_KEY');
        break;
    case 'production':
        $config['encryption_key'] = getenv('CI_PROD_ENCRYPTION_KEY');
        break;
}

// 確保生產環境有值
if (ENVIRONMENT === 'production' && empty($config['encryption_key'])) {
    die('FATAL: Production encryption key not set!');
}

常見誤區

驗證修復

# 重新訪問頁面或運行測試
php index.php test session_check

# 無報錯即成功

延伸閱讀

• CI 官方文檔：Encryption Key 配置指南
• PHP 官方：random_bytes() 安全隨機生成
• 最佳實踐：12 Factor App 配置管理

更多 CI 配置技巧：《CodeIgniter最佳實踐指南》、《PHP安全配置手冊》