
本文详解如何在 CI4 中通过 PSR-4 自动加载机制,将位于 app/WorkFlowModels/(非默认 app/Models/)的模型类正确注册并使用,避免“Class not found”错误。
本文详解如何在 ci4 中通过 psr-4 自动加载机制,将位于 `app/workflowmodels/`(非默认 `app/models/`)的模型类正确注册并使用,避免“class not found”错误。
在 CodeIgniter 4 中,所有类(包括模型、控制器、库等)均依赖 Composer 的 PSR-4 自动加载规范。默认情况下,CI4 仅注册了 App 命名空间(映射到 app/ 目录)及部分核心命名空间。若你将模型类放在 app/WorkFlowModels/ 这类自定义目录下,必须显式声明该命名空间与物理路径的映射关系,否则即使类文件存在、命名空间书写正确,PHP 仍无法自动定位和加载——这正是 Class 'WorkFlowModelsTestModel' not found 错误的根本原因。
✅ 正确配置 PSR-4 映射
打开 app/Config/Autoload.php,在 $psr4 数组中添加你的自定义命名空间条目:
public $psr4 = [
APP_NAMESPACE => APPPATH, // 默认 App → app/
'Config' => APPPATH . 'Config',
'WorkFlowModels' => APPPATH . 'WorkFlowModels', // ← 关键:注册 WorkFlowModels 命名空间
];⚠️ 注意事项:
- 命名空间名称(如
WorkFlowModels)必须与类文件中的namespace声明完全一致(大小写敏感); - 路径值(
APPPATH . 'WorkFlowModels')需指向实际存放.php文件的目录路径,末尾不加斜杠; - 修改后需执行
composer dump-autoload(CI4 默认已配置自动重载,但首次添加或环境变更时建议手动执行以确保生效)。
✅ 修正模型类定义
确保 app/WorkFlowModels/TestModel.php 的命名空间声明简洁、合法(不可含前导反斜杠):
<?php
namespace WorkFlowModels; // ✅ 正确:无前导
// ❌ 错误:namespace WorkFlowModels; (PHP 解析为全局命名空间下的 WorkFlowModels)
use AppLibrariesMongoDb;
class TestModel
{
private $Collection = '';
public function check()
{
echo 'testing';
}
}✅ 在控制器中安全使用
无需手动 include 或 require,直接通过完整命名空间实例化即可(推荐使用依赖注入或 model() 辅助函数,但此处为兼容性演示):
public function GetActions()
{
foreach (scandir($this->ModelDir) as $file) {
if (in_array($file, ['.', '..'])) continue;
$className = pathinfo($file, PATHINFO_FILENAME);
$fullClass = 'WorkFlowModels\' . $className;
// 安全检查:类是否存在
if (class_exists($fullClass)) {
$instance = new $fullClass();
$instance->check(); // 输出 testing
} else {
log_message('error', "Class {$fullClass} not found.");
}
}
}? 总结
- CI4 的类加载严格遵循 PSR-4,路径映射必须由
Autoload.php显式配置; - 自定义目录 ≠ 自动识别,遗漏
$psr4条目是“Class not found”的最常见原因; - 命名空间声明、目录结构、自动加载配置三者必须严格一致;
- 推荐将业务模型统一归入
app/Models/并利用 CI4 的 Model 基类特性;若确需分离(如工作流专用模型),则务必通过 PSR-4 规范管理,保障可维护性与框架兼容性。


















