在CodeIgniter开发中,控制器调用模型方法时突然报错“Call to undefined method”,这通常是模型类没有被正确加载。不少新手甚至老手都会在这个问题上卡壳。其实,CodeIgniter提供了多种灵活的方式来加载模型,关键在于根据实际场景选择最合适的那一种。下面逐一拆解。

一、在控制器方法内手动加载
如果某个模型只在控制器的特定操作中用到,没必要全局加载。此时在方法内部手动加载是最直接的方式,能有效控制内存占用,避免不必要的开销。
- 在控制器的某个方法(比如
index())内部,调用$this->load->model()方法。 - 传入模型文件名(不含
.php后缀),例如:$this->load->model('User_model')。 - 加载后即可通过
$this->User_model->method_name()调用模型的公共方法。 - 如果模型放在子目录下(如
models/auth/Login_model.php),路径需要用斜杠分隔:$this->load->model('auth/Login_model')。
二、在控制器构造函数中加载
当同一个模型需要在控制器的多个方法中反复调用时,在构造函数中统一加载是最省事的做法。这样所有方法都能直接访问模型实例,不用重复写加载语句,代码也更整洁。
- 在控制器类中定义
__construct()方法,并记得调用parent::__construct()。 - 在构造函数体内加入
$this->load->model('Product_model')。 - 确保模型类文件名与类名严格一致(比如
Product_model.php内定义class Product_model extends CI_Model)。 - 此后,控制器内任意方法都可以直接使用
$this->Product_model对象,无需再次加载。
三、配置自动加载模型
对于那些全站通用、高频使用的模型(比如 Auth_model、Setting_model),每次手动加载会显得繁琐。CodeIgniter 提供了自动加载机制,在系统初始化阶段就完成加载,一劳永逸。
- 打开
application/config/autoload.php文件。 - 找到
$autoload['model']数组。 - 把模型名以字符串形式加入数组,例如:
$autoload['model'] = array('Auth_model', 'Setting_model')。 - 保存后,所有控制器在实例化时都会自动加载这些模型,无需额外代码。
四、使用命名空间在CodeIgniter 4中加载
如果你用的是 CodeIgniter 4,加载模型的方式和 CI3 有本质区别。CI4 采用 PSR-4 自动加载机制,模型必须按命名空间路径存放并正确声明。
- 确认模型文件位于
app/Models/目录下,例如app/Models/UserModel.php。 - 在文件顶部声明命名空间:
namespace App\Models;,并继承CodeIgniter\Model。 - 在控制器中使用
use语句引入:use App\Models\UserModel; - 通过
new UserModel()或使用服务定位器:model('UserModel')获取实例。
五、动态加载带参数的模型实例
有时候需要为同一个模型创建多个独立实例,比如连接不同数据库前缀的表。这时可以通过传递配置参数实现隔离式加载,避免实例冲突。
- 让模型类支持构造参数,例如在
__construct()中接收$db_group或$table_prefix。 - 调用
$this->load->model()时传入第二个参数作为别名:$this->load->model('Log_model', 'admin_log')。 - 加载后使用
$this->admin_log->write()而非$this->Log_model->write(),避免与默认实例冲突。 - 确保模型内部逻辑能识别并响应传入的别名或配置上下文。
以上五种方法覆盖了从简单到复杂的各种场景。实际开发中,建议根据模型的使用频率、作用范围以及是否涉及多实例等需求来灵活选择。记住,正确的加载是顺利调用模型方法的第一步,也是 MVC 架构中保持代码清晰的关键。