能返回页面内容的控制器不继承controller类也可运行，但无法使用$request、$view等核心功能；必须确保文件位于app/controller/下、类名与文件名严格一致且首字母大写，如test.php中定义class test并实现public hello()方法返回字符串。
直接写一个能返回页面内容的控制器，不需要继承 Controller 类也能跑通；但如果你要用请求参数、模板渲染或中间件，就必须继承 think\Controller 或自定义的基类（比如 app\BaseController）。
控制器文件位置和命名必须匹配
ThinkPHP6 会自动根据 URL 解析控制器名，并映射到 app/controller/ 下的 PHP 文件。路径和命名不一致，就会报 ClassNotFoundException。
- URL 访问
/index/index→ 框架找的是app/controller/Index.php里的Index类 - 类名必须与文件名完全一致（大小写敏感），例如
app/controller/User.php必须定义class User - 多级目录如
app/controller/admin/User.php，命名空间得是app\controller\admin，访问 URL 是/admin/user/index - 别手误写成
App\Controller\Index（首字母大写）——框架默认是小写app\controller
不继承 Controller 类也能返回字符串
最简控制器甚至可以不引入任何框架类，直接 return 字符串，TP6 能识别并输出 HTTP 响应。
示例：app/controller/Test.php
<?php namespace app\controller;
class Test
{
public function hello()
{
return 'Hello from plain controller!';
}
}
访问 /test/hello 就能看到内容。但注意：
- 无法使用
$this->request、$this->view等对象 - 不能调用
validate()、success()等封装方法 - 若后续要加权限校验或日志，就得重构为继承类
推荐继承 think\Controller 实现标准功能
真正做业务时，90% 的场景都需要读取请求、跳转、赋值给模板，这时候必须继承 think\Controller。
示例：app/controller/Home.php
<?php namespace app\controller;
use think\Controller;
class Home extends Controller
{
public function index()
{
$name = $this->request->param('name', 'Guest');
$this->assign('msg', "Welcome, {$name}!");
return $this->fetch(); // 默认渲染 Home/index.html
}
}
关键点：
-
$this->request是think\Request实例，param()自动合并 GET/POST/ROUTE 参数 -
$this->assign()把变量传给模板，fetch()默认找view/home/index.html - 如果没建模板文件，会抛出
TemplateNotFoundException，不是白屏而是明确报错 - 想跳过模板直接输出 JSON？改用
return json(['code' => 0, 'data' => [...]])
常见 404 和 500 场景怎么快速定位
浏览器显示 404 或空白页，大概率不是代码逻辑错，而是路径/命名/路由层面断掉了。
- URL 是
/user/login，但文件是app/controller/user.php（小写）→ 报 404：TP6 默认控制器名首字母大写，user不等于User - 写了
return view('index')但没开视图驱动（config/view.php中'type'为空）→ 报 500：View not exists - 在
app\BaseController里重写了initialize()，但忘了parent::initialize()→ 可能导致$this->request为 null - 用了多应用模式（如
app\admin\controller），但路由注册在了根route/app.php而非app\admin\route\app.php→ 请求根本没进这个应用
最省事的验证方式：先删掉所有逻辑，只留 return 'OK';，确认路径通了再一层层加功能。控制器这层看似简单，但命名、命名空间、目录结构三者只要一个不严丝合缝，就卡在第一步。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
