CodeIgniter IDE 程式碼提示完善：在核心類別加入 @var 註解

CodeIgniter 採用動態載入類庫（$this->load->library()），IDE 無法靜態分析 $this->load、$this->db 等屬性型別，導致程式碼提示失效。解決方法是在核心基底類別加入 @var PHPDoc 註解。

修改檔案

• system/core/Controller.php（基底控制器）
• system/core/Model.php（基底模型）

加入的註解程式碼

/**
 * @var CI_Loader        $load
 * @var CI_DB_active_record $db
 * @var CI_Calendar      $calendar
 * @var CI_Email         $email
 * @var CI_Encrypt       $encrypt
 * @var CI_Ftp           $ftp
 * @var CI_Hooks         $hooks
 * @var CI_Image_lib     $image_lib
 * @var CI_Language      $language
 * @var CI_Log           $log
 * @var CI_Output        $output
 * @var CI_Pagination    $pagination
 * @var CI_Parser        $parser
 * @var CI_Session       $session
 * @var CI_Sha1          $sha1
 * @var CI_Table         $table
 * @var CI_Trackback     $trackback
 * @var CI_Unit_test     $unit
 * @var CI_Upload        $upload
 * @var CI_URI           $uri
 * @var CI_User_agent    $agent
 * @var CI_Validation    $validation
 * @var CI_Xmlrpc        $xmlrpc
 * @var CI_Zip           $zip
 */

放置位置

在類別定義開頭，class CI_Controller { 之前：

<?php
/**
 * CodeIgniter Controller Class
 * ...
 * 上述 @var 註解放這裡
 */
class CI_Controller {
    // ...
}

原理說明

• PHPStorm、VS Code (Intelephense)、NetBeans 等 IDE 掃描 PHPDoc @var 推斷屬性型別
• CodeIgniter 魔術方法 __get() 動態載入類庫，靜態分析無法追蹤
• 註解欺騙 IDE：「這個屬性是這個型別」，即可獲得完整提示

擴展：自訂類庫也要加註解

class MY_Controller extends CI_Controller {
    /**
     * @var My_Custom_Lib $mylib
     * @var Another_Lib $another
     */
    // ...
}

現代替代方案（CodeIgniter 3.1+ / 4.x）

• IDE Helper 套件：composer require --dev codelgniter/ide-helper 自動產生 _ide_helper.php
• PHPStorm Meta：.phpstorm.meta.php 定義動態回傳型別
• Intelephense Stubs：VS Code 安裝 bmewburn.vscode-intelephense-client 內建 CI Stubs

效果對比

僅需幾十行註解，即可讓 IDE 成為 CodeIgniter 開發的強大助手，大幅減少查閱文檔時間與拼寫錯誤。