CodeIgniter 修改 View 視圖目錄路徑實作：add_package_path 多主題切換

CodeIgniter 預設視圖目錄為 application/views/。若需支援多主題、多皮膚、多租戶架構，須動態修改視圖搜尋路徑。本文解析 Loader::add_package_path() 實現原理、正確用法、目錄結構要求、常見坑點。

核心代碼

// 在 Controller 建構子或基類 Controller 中
$this->load->add_package_path(FCPATH . 'skins/' . $this->config->item('base_skins') . '/');

原理解析：Loader.php 關鍵邏輯

// system/core/Loader.php
public function add_package_path($path, $view_cascade = TRUE) {
    $path = rtrim($path, '/') . '/';
    
    // 1. 加入 library/model/helper 搜尋路徑 (前插，優先級最高)
    array_unshift($this->_ci_library_paths, $path);
    array_unshift($this->_ci_model_paths, $path);
    array_unshift($this->_ci_helper_paths, $path);
    
    // 2. 關鍵：視圖路徑陣列 (鍵=路徑, 值=是否級聯)
    $this->_ci_view_paths = array(
        $path . 'views/' => $view_cascade
    ) + $this->_ci_view_paths;
    
    // 3. 配置檔路徑
    $config =& $this->_ci_get_component('config');
    array_unshift($config->_config_paths, $path);
}

目錄結構要求 (關鍵)

# 專案根目錄
/
├── application/
├── skins/                    # 自訂皮膚根目錄
│   ├── default/              # 主題 1
│   │   ├── views/            # ← 必須有 views 子目錄！
│   │   │   ├── header.php
│   │   │   └── footer.php
│   │   ├── config/
│   │   └── libraries/
│   ├── blue/                 # 主題 2
│   │   └── views/
│   └── mobile/               # 主題 3
│       └── views/
└── system/

⚠️ 必須在皮膚目錄下建立 views/ 子目錄，所有視圖檔放在此處。add_package_path 會自動拼接 views/。

完整實作範例：動態主題切換

session->userdata('theme') 
               ?? $this->config->item('default_theme') 
               ?? 'default';
        
        // 2. 註冊主題包路徑
        $themePath = FCPATH . 'skins/' . $theme . '/';
        if (is_dir($themePath)) {
            $this->load->add_package_path($themePath);
        } else {
            log_message('error', "Theme not found: $themePath");
        }
        
        // 3. 可選：共用視圖資料
        $this->data['current_theme'] = $theme;
    }
}

// 使用範例
class Welcome extends MY_Controller {
    public function index() {
        // 載入順序：skins/current/views/welcome_message.php → application/views/welcome_message.php
        $this->load->view('welcome_message', $this->data);
    }
}

進階：主題繼承與級聯 (view_cascade)

add_package_path($path, $view_cascade) 第二參數控制級聯行為：

建議保持 TRUE，實現「主題覆蓋核心，缺失回退核心」的繼承機制。

常見問題排查

1. 視圖不生效 / 仍載入預設
   • 確認 skins/主題/views/ 目錄存在
   • 確認 add_package_path 路徑以 / 結尾 (方法內已處理)
   • 檢查 $this->load->view('name') 不含 .php 副檔名
2. 無法載入主題下的 Library/Model
   • 類別命名需符合 CI 規範：MyLib.php → class MyLib
   • 檔案放在 skins/主題/libraries/ 或 models/
3. 多主題並存衝突
   • 同名視圖以 最後註冊的路徑優先 (array_unshift)
   • 切換主題前建議 $this->load->_ci_view_paths = [] 重置 (需繼承 Loader)

替代方案對比

掌握 add_package_path + views/ 目錄約定，即可在 CodeIgniter 中實現優雅、可維護的多主題架構。