ThinkPHP5控制器如何创建_ThinkPHP5控制器基础写法【实战】-ThinkPHP-PHP中文网

thinkphp5控制器必须同时满足命名、路径、命名空间、类继承四要素：文件名与类名须pascalcase且大小写严格匹配，如index.php对应class index；命名空间为app\controller并继承think\controller；仅public方法可被路由，方法名不可下划线开头；初始化逻辑应写在initialize()而非__construct()中。

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 或拼错（比如写成 app\controlller 少一个 e），PHP 加载器根本找不到类，报错却是模糊的 Class not found，很难定位。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

✅ 标准写法开头必须有：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 错误。

✅ 权限校验、模板变量赋值等初始化逻辑，统一写在 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）会按顺序注入，不要依赖参数名匹配