
本文详解如何在 CI4 中通过 PSR-4 自动加载机制,将位于 app/WorkFlowModels/(非默认 app/Models/)的模型类正确注册并实例化,避免“Class not found”错误。
本文详解如何在 ci4 中通过 psr-4 自动加载机制,将位于 `app/workflowmodels/`(非默认 `app/models/`)的模型类正确注册并实例化,避免“class not found”错误。
在 CodeIgniter 4 中,所有类的自动加载均依赖于 PSR-4 标准配置。默认情况下,框架仅注册了 App\ 命名空间(映射到 app/ 目录)及 Config\ 等核心命名空间。若要加载位于 app/WorkFlowModels/ 下的自定义模型(如 \WorkFlowModels\TestModel),必须显式声明该命名空间与物理路径的映射关系——否则即使文件存在、命名空间书写正确,PHP 仍无法定位类,抛出 Class 'WorkFlowModels\TestModel' not found 错误。
✅ 正确配置 PSR-4 命名空间映射
打开 app/Config/Autoload.php,在 $psr4 数组中添加一行,将 WorkFlowModels 命名空间指向 APPPATH . 'WorkFlowModels/':
public $psr4 = [
APP_NAMESPACE => APPPATH, // App\ → app/
'Config' => APPPATH . 'Config',
'WorkFlowModels' => APPPATH . 'WorkFlowModels', // ? 关键:新增映射
];
⚠️ 注意:路径末尾不要加斜杠(
APPPATH . 'WorkFlowModels'✅,APPPATH . 'WorkFlowModels/'❌),CI4 的 Autoloader 会自动处理路径分隔符。
✅ 模型文件规范(修正命名空间与结构)
确保你的模型文件 app/WorkFlowModels/TestModel.php 符合 PSR-4 要求:
WorkFlowModels
-
缓存影响:修改
Autoload.php后,如启用 OPcache 或 CLI 模式下有类缓存,请执行php spark optimize或重启 Web 服务器; -
命名空间大小写敏感:
WorkFlowModels≠workflowmodels,Windows 下可能不报错,但 Linux 生产环境必失败; -
避免硬编码路径:勿再使用
../app/WorkFlowModels/这类相对路径扫描,应统一通过APPPATH和 PSR-4 加载; -
扩展性建议:若模型较多,可考虑将
WorkFlowModels目录移至app/同级(如workflows/),并在Autoload.php中映射为'WorkFlowModels' => ROOTPATH . 'workflows',实现更清晰的模块隔离。
至此,你已成功将自定义模型目录接入 CI4 的自动加载体系,兼顾灵活性与框架规范性。











