ThinkPHP5控制器必须同时满足命名、路径、命名空间、类继承四要素：文件名与类名须PascalCase且大小写严格匹配，如Index.php对应class Index；命名空间为app\controller并继承think\Controller；仅public方法可被路由，方法名不可下划线开头；初始化逻辑应写在initialize()而非__construct()中。
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 或拼错（比如写成 app\controlller 少一个 e），PHP 加载器根本找不到类，报错却是模糊的 Class not found，很难定位。
- ✅ 标准写法开头必须有：
namespace app\controller;+use think\Controller;+class Index extends Controller - ❌ 不继承
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 错误。
立即学习“PHP免费学习笔记（深入）”；
- ✅ 权限校验、模板变量赋值等初始化逻辑，统一写在
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 是两个文件。
