ThinkPHP5控制器如何创建_ThinkPHP5控制器基础写法【实战】

在ThinkPHP5中，指望建个PHP文件就让控制器跑起来？可没那么简单。控制器必须同时满足命名、路径、命名空间、类继承这四个条件，一个都少不了。特别是在Linux服务器上，大小写不匹配直接给你来个404，倒是Windows开发环境下容易蒙混过关，一上线就原形毕露。

控制器文件名和类名必须 PascalCase 且严格大小写匹配

当你通过URL访问 /index/index 时，框架会去查找 app/controller/Index.php 文件，并尝试实例化 Index 类。哪怕大小写错了一个字母——比如文件名写成了 index.php 或类名写成 index——路由就识别不了，不报错，直接静默404。

• 正确示范：文件名 Index.php，类名 class Index，命名空间 namespace app\controller;
• 常见错误：index.php、IndexController.php、class index、class IndexController
• 多级目录的情况：比如 app/controller/v1/User.php，对应 URL 是 /index/v1.user/index（注意中间用的是点号，不是斜杠）

必须声明正确的命名空间并继承 think\Controller

没写 namespace 或者拼写有误，PHP 加载器根本找不到这个类，报错信息却是模糊的 Class not found，排查起来相当头疼。

• 标准写法：开头必须有 namespace app\controller; + use think\Controller; + class Index extends Controller
• 不继承的后果：无法使用 $this->assign()、$this->fetch()、$this->redirect() 这些核心方法
• 版本差异需要注意：ThinkPHP5.0 和 5.1+ 的基类路径一致，都是 think\Controller；但 TP6 改成了 think\Controller（小写c），混用会报错

__construct() 里不能调用 redirect() 或输出内容

构造函数执行的时候，请求上下文还没完全初始化完毕，$this->response 和 $this->request 都不可靠。这时候强行 echo 或调用 $this->redirect()，很容易触发 headers already sent 错误。

• 正确的做法：权限校验、模板变量赋值这些初始化逻辑，统一写在 initialize() 方法里（父类已经定义好，子类重写即可）
• 别踩的坑：不要手写 _initialize()（带下划线的），那是 TP3 的风格，TP5 里不认；也别写成 Initialize()（首字母大写），大小写敏感，不会被自动调用
• 额外提醒：initialize() 在每个 Action 执行前都会运行，但在 CLI 命令行调用场景下不适用，需要额外增加 $this->request->isCli() 判断

public 方法才可被路由，方法名不能以下划线开头

框架默认只扫描 public 方法作为可访问的操作，而且所有以 _ 开头的非魔术方法都会被跳过。比如你写了个 public function _check()，它永远都是404。

• 可访问的：public function index()、public function userList()、public function edit($id)
• 不可访问的：private function auth()、protected function init()、public function _init()、public function __toString()
• 参数传递注意：方法参数支持类型提示和默认值，但 URL 路径传参（如 /user/edit/123）会按顺序注入，不要依赖参数名来匹配

说起来，容易被忽略的还是命名空间和大小写——语法上不出错，却能让整个控制器直接“消失”。开发的时候就按 Linux 的规则来，别等到部署到生产环境，才发现 Index.php 和 index.php 是两个文件，那可就尴尬了。