my_controller是codeigniter 2/3中控制器继承的唯一合法入口点,必须存在且正确配置subclass_prefix,所有自定义基类需在其内定义或手动引入,否则将报class not found错误。

MY_Controller 是 CodeIgniter 2/3 中实现控制器继承的唯一合法入口点,不是可选方案,而是必须走的路径。跳过它直接让业务控制器继承 AdminBase 或 HomeBase,一定会报错:`Class 'AdminBase' not found`。
为什么必须先定义 MY_Controller?
CodeIgniter 的自动加载机制只识别 application/core/ 下以 subclass_prefix 开头的类(默认是 MY_),并把它作为系统控制器的“扩展层”。没有 MY_Controller,框架根本不会去加载你写的 AdminBase —— 它连文件都不会扫描。
常见错误现象:
PHP Fatal error: Class 'AdminBase' not found- 控制器方法执行了,但
$this->session或$this->load报Call to a member function on null
正确做法:
- 确保
application/core/MY_Controller.php存在且可读 - 检查
application/config/config.php中$config['subclass_prefix']值为'MY_'(注意末尾下划线) -
MY_Controller必须继承CI_Controller,且构造函数里调用parent::__construct() - 所有自定义基类(如
AdminBase)必须定义在同一个MY_Controller.php文件里,或单独文件但需手动require_once(不推荐)
AdminBase 构造函数里 session 判断要防空
很多人在 AdminBase::__construct() 里直接写 $this->session->userdata('admin'),结果一访问就报 Call to a member function userdata() on null —— 因为 $this->session 还没被加载。
原因很简单:MY_Controller 虽然继承了 CI_Controller,但没自动加载任何库。Session 是独立组件,得自己载入。
实操建议:
- 在
AdminBase::__construct()开头加$this->load->library('session'); - 再判断
$admin = $this->session->userdata('admin');是否存在且有效 - 跳转用
redirect('admin/login'),别用error()或show_error(),后者会中断流程且不重定向 - 避免在基类里加载视图或输出内容,保持职责单一
CI4 的写法完全不同,不能套用 CI3 的 MY_Controller
如果你正在用 CodeIgniter 4,application/core/ 目录和 subclass_prefix 已废弃。CI4 的控制器统一放在 app/Controllers/,继承 BaseController 即可。
关键区别:
- CI4 没有
MY_Controller概念,也不走subclass_prefix加载逻辑 -
BaseController是框架自带的,已预加载session、request、response等服务 - 权限校验推荐用
Filter(比如before钩子),而不是塞进每个基类构造函数 - 若硬要在 CI4 写类似
AdminBase,应继承BaseController并放在app/Controllers/AdminBase.php,然后业务控制器extends AdminBase
文件命名和类名大小写容易踩坑
CI3 对大小写敏感,尤其在 Linux 服务器上。Windows 开发时可能不报错,一上线就 500。
必须严格遵守:
- 文件名全小写:
my_controller.php❌,必须是MY_Controller.php - 类名首字母大写,且与文件名完全一致:
class MY_Controller extends CI_Controller - 业务控制器文件名如
blog.php,类名必须是Blog,不能是blog或BLOG - 子类名如
AdminBase,对应文件若单独存在,必须叫AdminBase.php(但 CI3 不会自动加载它,所以仍建议合并在MY_Controller.php)
最稳妥的做法:所有基类都写在 MY_Controller.php 里,不拆分文件,不折腾自动加载路径。复杂逻辑往后放,先让继承链跑通再说。










