如何使用ThinkPHP实现事件类自动加载？

本文共计892个文字，预计阅读时间需要4分钟。

ThinkPHP无需手动加载事件类，只需命名规范、目录结构与类名三者一致即可。例如：

事件类文件必须放在 Application/Home/Event/ 目录下

ThinkPHP 对模块级命名空间（如 Home、Admin）的自动加载路径是硬编码的：遇到未注册的根命名空间（比如 Home），会默认去 Application// 下找子目录。所以：

• HomeEventUserEvent → 自动尝试加载 Application/Home/Event/UserEvent.php（TP5.1+ 默认后缀是 .php，不是 .class.php）
• 目录名 Event 必须首字母大写，且与命名空间中的 Event 完全一致（Linux 环境区分大小写）
• 类文件里必须声明 namespace HomeEvent;，不能漏掉或写成 homeevent
• 如果用了 .class.php 后缀（老项目遗留），需显式配置：'EXT' => '.class.php'，否则自动加载失败

为什么 new HomeEventUserEvent() 报错 Class not found

常见原因不是“没加载”，而是路径或声明不匹配。