ThinkPHP6.0如何创建控制器_ThinkPHP6.0创建控制器教程【入门】

很多开发者刚接触ThinkPHP 6时，会觉得创建控制器无非就是“新建一个文件，写个类”。但实际操作下来，往往会被几个看似不起眼的细节绊倒——路径、命名、继承关系，或者生命周期里一个微妙的调用时机，都可能导致页面404、类找不到、$this->assign()报错，甚至方法静默不执行，连个错误提示都没有。

控制器文件放哪？命名和类名怎么写才不报错

首先，文件位置是硬性规定。在单应用模式下，控制器必须放在 app/controller/ 目录下。这里有个常见的坑：目录名必须全小写，写成 app/Controller 或 app/controllers 都不行。如果是多应用模式，路径则变为 app/{应用名}/controller/。

位置对了，命名规则同样严格：

• 文件名必须首字母大写，且不带“Controller”后缀。 比如，你想通过 /user/profile 访问，文件就得叫 User.php，而不是 UserController.php 或小写的 user.php。
• 类名必须与文件名完全一致。 在 User.php 里，类就得是 class User，不能是 class UserController。
• 命名空间必须准确。 单应用下是 app\controller，多应用下是 app\{应用名}\controller。漏掉开头的 app\ 前缀，类加载就会失败。
• 还有一个容易忽略的点：如果你修改过应用目录的名称（比如把默认的 app 改成了 src），那么务必同步更新 config/app.php 配置文件里的 app_namespace 项，否则框架会找不到你的控制器。

控制器类必须继承 BaseController 才能用 assign() 和 fetch()

接下来是继承关系。很多新手会直接写一个裸的控制器类，比如：

class Index {
    public function index() {
        $this->assign('name', 'tp6');
    }
}

运行后就会遇到 Call to undefined method assign() 的错误。原因很简单，assign()、fetch()、redirect() 这些便捷方法，并不是凭空出现的，它们都定义在框架的基类里。

• 因此，控制器必须继承 app\BaseController（这是ThinkPHP 6的推荐做法），或者为了兼容也可以继承 \think\Controller。
• 如果你项目中的 app\BaseController 是自定义的，请务必检查它是否正确地继承了 \think\Controller。如果继承链断了，所有快捷方法都会失效。
• 当然，不继承基类理论上也能运行，但意味着你需要手动实例化视图类、调用渲染方法，代码会变得冗长且容易出错，得不偿失。

为什么 index() 不执行？__invoke 和路由绑定的关系

另一个让人困惑的问题是方法“静默失效”。比如，你明明写了 index() 方法，访问对应的URL却没反应。这里需要厘清一个关键概念：ThinkPHP默认的URL访问模式（例如访问 /index/index），调用的是控制器的 index() 方法，而不是PHP魔术方法 __invoke()。

• __invoke() 是PHP的一个特性，它允许将一个对象当作函数来调用。但ThinkPHP框架不会默认用它作为控制器的入口方法。
• 如果你想使用 __invoke()，必须通过路由显式绑定。例如：Route::get('test', 'Index')，这样访问 /test 时才会触发 Index 控制器的 __invoke() 方法。
• 而对于常规的URL（如 /index 或 /index/index），框架依然会去寻找并执行 index() 方法，这与 __invoke() 完全无关。混淆这两者，就会导致“写了方法却没反应”的静默失败。

构造方法里别碰 $this->request，initialize() 才是正解

最后，是关于控制器生命周期的陷阱。有些开发者习惯在控制器的构造方法 __construct() 里进行初始化操作，比如获取请求参数。但在ThinkPHP 6中，控制器实例化时，$this->request、$this->app 等核心对象尚未注入。此时调用 $this->request->param()，会直接报错：Call to a member function param() on null。

• 正确的做法是，将所有初始化逻辑（如权限验证、获取公共参数、依赖中间件等）写在 initialize() 方法中。这是框架提供的一个标准初始化钩子。
• initialize() 方法会在控制器对象构建完成、依赖注入全部结束后被自动调用。此时，$this->request 等对象已经准备就绪，可以安全使用。
• 这一点同样影响到依赖注入。即使你在方法参数中注入了 \think\Request $request，也要遵循这个生命周期。在错误的时间点操作，会导致依赖对象“时有时无”，引发难以排查的bug。

在实际调试中，最容易被忽略的往往是命名空间和继承关系的组合效应。文件位置对了，类名对了，方法也是public，但只要没继承 BaseController，或者命名空间少写了一个 app\，整个控制器就会变成一个“不可见的黑盒”。遇到问题，先死死盯住这两点排查，往往比漫无目的地翻看路由配置要省时得多。