CodeIgniter控制器继承技巧解析

本文深入解析了CodeIgniter 2/3中控制器继承的核心机制与实战要点，强调MY_Controller是实现继承的强制性入口点——它不是可选项，而是框架自动加载体系的唯一桥梁；文章直击开发者高频踩坑场景，如“Class not found”错误、session未加载导致的空对象调用、大小写敏感引发的线上500异常，并给出清晰可行的解决方案：确保MY_Controller存在且规范配置subclass_prefix、在自定义基类中显式加载session等依赖库、避免职责混乱的视图输出；同时明确划清CI4与CI3的根本差异，提醒开发者切勿套用旧模式——CI4已废弃MY_Controller和subclass_prefix，转而通过app/Controllers下的BaseController及Filter机制实现更现代、安全的权限控制与扩展逻辑。

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 里，不拆分文件，不折腾自动加载路径。复杂逻辑往后放，先让继承链跑通再说。

今天关于《CodeIgniter控制器继承技巧解析》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！