CodeIgniter 2.2 升級 3.0 完整遷移指南與坑點總結

核心變更清單

1. 系統文件全替換：覆蓋 system/ 目錄、index.php。
2. 控制器/模型文件名首字母大寫：
   application.php → Application.php
m_application.php → M_application.php
   類名同步修改：class Application extends CI_Controller。
3. 替換 config/mimes.php：新增大量 MIME 類型。
4. 移除 $autoload['core']：CI 3 不再支持 core 自動加載，改用 $autoload['libraries'] 或 Composer。
5. Session 庫重大變更：
   // 2.x $this->session->unset_userdata(array('item'=>''));
// 3.x $this->session->unset_userdata(array('item', 'item2'));（只傳鍵名陣列）
6. 資料庫配置更新：
   $active_group = 'default';
$query_builder = TRUE;（替代 $active_record）
   $db['default']['dbdriver'] = 'mysqli';（棄用 mysql 驅動）
7. 錯誤視圖遷移：將 system/views/errors/ 複製到 application/views/errors/，可自定義錯誤頁。
8. 路由正則變更：(:any) 不再匹配 /，需用 (.+) 匹配任意字符含斜槿。
   $route['product/(:any)'] → $route['product/(.+)']

其他常見兼容性問題

遷移驗證清單

• [ ] 所有控制器/模型文件名、類名首字母大寫
• [ ] config/mimes.php 已替換
• [ ] autoload.php 移除 core、調整 libraries
• [ ] Session 代碼全部按新語法修正
• [ ] database.php 驅動改 mysqli、啟用 query_builder
• [ ] views/errors/ 已複製到應用目錄
• [ ] 路由正則 (:any) → (.+) 全局替換
• [ ] 運行單元測試/功能測試覆蓋核心業務

官方升級文檔

CodeIgniter 3.0 升級指南（英文原版，最權威）