06.5.2.6 控制器与请求响应对象
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.2 ThinkPHP
本节要解决的问题
- 控制器如何组织,多级/分级控制器如何调度?
Request如何取值、做类型转换与判断请求类型,文件上传如何处理?Response有哪些类型,状态码/响应头/下载/重定向如何设置,异常如何统一接管?
版本前提:ThinkPHP 6.x / 8.0;请求对象基类 think\Request,应用可自定义 app\Request 并在 provider.php 绑定。
06.5.2.6-001 控制器基类 BaseController 是必须继承的吗?
一句话结论
不是必须:控制器可以不继承任何类,路由调度时容器解析并注入依赖;继承 BaseController 主要为复用公共属性与方法。
概念解释
框架对控制器类的约束很宽松,操作方法即调度目标。基类可放跨控制器复用的辅助方法、公共属性,但不强制继承。
原理流程
- 路由解析到控制器类与方法。
- 容器实例化控制器,注入构造依赖。
- 反射调用操作方法,绑定参数。
- 返回值由框架包装为响应。
代码或图示
namespace app\controller;
class Index
{
public function hello(string $name)
{
return json(['name' => $name]);
}
}
常见误区
- 把公共业务逻辑塞进基类:基类被所有控制器继承,耦合面过大,应抽服务层。
- 控制器构造器做重初始化:构造只装配依赖。
追问
- 默认
BaseController提供什么?答:以安装骨架中的基类为准,通常持有请求等公共属性,可按需修改。 - 控制器需要继承框架内核类吗?答:不需要,调度由路由与容器完成。
06.5.2.6-002 多级/分级控制器如何组织与调度?
一句话结论
控制器可按子目录分级放置,命名空间与目录保持一致;路由通过分组 layer/controller/namespace 绑定或规则地址中的层级表达,调度到对应类方法。
概念解释
大型项目按后台、接口、模块划分控制器目录。分级目录对应命名空间层级,自动加载与调度都依赖二者一致。
原理流程
- 控制器按目录分级创建,命名空间同步层级。
- 路由规则地址或分组绑定指向分级。
- 调度器按命名空间定位控制器类。
- 调用对应操作方法。
代码或图示
app/controller/
├── blog/
│ └── Article.php
└── User.php
Route::group('admin', function () {
Route::get('article/:id', 'blog.article/read');
})->layer('admin');
常见误区
- 目录层级与命名空间不一致:类自动加载失败。
- 规则地址分隔符与版本约定不符:调度找不到控制器,以手册写法为准(待确认)。
追问
- 旧版多级控制器怎么访问?答:规则地址用层级分隔表达,具体分隔符查阅对应版本路由文档。
- 分级控制器中间件如何挂?答:分组中间件对整组分级生效,控制器类也可定义
$middleware。
06.5.2.6-003 获取 Request 对象有哪几种方式?
一句话结论
三种方式:构造器/操作方法注入 think\Request、think\facade\Request 静态调用、request() 助手函数;三者指向容器中的同一请求实例。
概念解释
请求对象在初始化阶段存入容器。注入方式类型显式,门面与助手用于无法注入的场合。
原理流程
- 初始化把当前请求实例绑定到容器。
- 方法/构造器类型提示
Request取实例。 - 门面静态调用转发到同一实例。
- 助手函数内部解析容器请求对象。
代码或图示
public function index(\think\Request $request)
{
$a = $request->param('name');
$b = \think\facade\Request::param('name');
$c = request()->param('name');
}
常见误区
- 以为门面读到独立副本:同一实例,修改互相可见。
- 在命令行依赖真实请求数据:CLI 下请求对象为默认值。
追问
- 自定义请求类如何生效?答:修改
app\Request并在provider.php绑定,注入与门面都解析子类。 - 请求对象能在模型/服务中直接取吗?答:可通过门面/助手,但更推荐作为方法参数传入以保持可测试。
06.5.2.6-004 param/get/post/route 取值与优先级如何?
一句话结论
param() 合并路由变量、GET 与当前请求类型参数,路由变量优先;get() 取 $_GET,post() 取 $_POST,route() 取路由/PATHINFO 变量,file() 取上传文件。
概念解释
param() 是推荐的统一取值入口,自动识别请求类型并合并来源。各来源按框架规则覆盖合并,路由变量优先级最高。
原理流程
- 框架收集路由变量、GET、POST/PUT 等输入。
param()按优先级合并后返回。- 专用方法只取对应来源。
- 取值可带默认值与过滤修饰符。
代码或图示
$name = $request->param('name');
$page = $request->get('page', 1);
$email = $request->post('email');
$id = $request->route('id');
$all = $request->param(); // 全部经过过滤的变量
常见误区
- 混用来源导致取值不确定:明确区分路由变量、查询串与表单体。
- 直接读
$_GET/$_POST:绕过框架过滤与合并规则。
追问
param(false)与param(true)区别?答:控制是否返回原始数据/包含上传文件,参数形式以版本手册为准(待确认)。- PUT/DELETE body 参数怎么取?答:
put()/delete()方法或param()合并获取。
06.5.2.6-005 变量修饰符如何做类型转换?
一句话结论
取值方法第二参数为默认值,变量名后可加修饰符:/s 字符串、/d 整型、/b 布尔、/a 数组、/f 浮点;也可在第三参数传过滤方法。
概念解释
修饰符在取值时完成基础类型转换,避免后续到处强转。严格格式校验应配合验证器规则。
原理流程
- 变量名书写为
'id/d'。 - 框架按修饰符转换返回值类型。
- 缺省使用第二参数默认值。
- 第三参数可指定过滤函数/方法。
代码或图示
$id = $request->get('id/d', 0);
$name = $request->post('name/s', '');
$ids = $request->post('ids/a', []);
$rate = $request->param('rate/f', 0.0);
常见误区
- 修饰符转换后仍按字符串比较:类型已变,比较规则随之改变。
- 用修饰符替代业务校验:格式、范围、唯一性仍需验证器。
追问
- 修饰符与类型声明冲突吗?答:方法参数类型声明会再做校验,修饰符先转换输入值。
- 过滤方法怎么传?答:第三参数传函数名/回调,具体签名以 Request 源码为准(待确认)。
06.5.2.6-006 上传文件如何获取与校验?
一句话结论
request()->file('image') 获取上传文件对象(think\File),多文件返回数组;校验用 fileSize/fileExt/fileMime 规则,保存经 Filesystem 组件。
概念解释
上传对象支持读取文件信息与移动保存。本地保存由 Filesystem 驱动完成,远程/对象存储需安装对应扩展。
原理流程
- 表单
enctype="multipart/form-data"提交文件。 file()按字段名取文件对象或数组。- 验证大小、后缀、MIME 类型。
- 调用 Filesystem
putFile保存并返回路径。
代码或图示
$file = $request->file('image');
validate(['image' => 'fileSize:10240|fileExt:jpg,png|image:200,200,jpg'])
->check($file);
$savename = \think\facade\Filesystem::putFile('topic', $file);
常见误区
- 只校验后缀不校验 MIME:可绕过上传伪装文件。
- 保存前未判断文件存在:缺失时
file()返回 null,需先判空。
追问
- 多文件上传怎么遍历?答:
file('image[]')返回数组,逐个保存。 - 远程存储用什么?答:安装
topthink/think-filesystem并配置驱动,具体适配器以扩展文档为准。
06.5.2.6-007 如何判断请求类型与 AJAX/JSON?
一句话结论
method() 返回大写请求类型,isGet/isPost/isPut/isDelete/isAjax/isPjax/isJson/isHead/isPatch/isOptions/isCli 做对应判断。
概念解释
请求类型判断通常可前置到路由方法限定;控制器内用于分支处理。method() 始终返回大写。
原理流程
- 框架解析原始请求方法与伪装方法。
- 判断方法按类型返回布尔。
- AJAX/JSON 按请求头识别。
- 控制器按判断结果分支响应。
代码或图示
if ($request->isAjax()) {
return json(['ok' => true]);
}
if ($request->isPost()) {
// 处理提交
}
$type = $request->method(); // 如 POST
常见误区
- 用 AJAX 判断做权限控制:请求头可伪造,鉴权必须基于身份凭证。
- 混淆
isJson与返回 JSON:isJson判断请求是否 JSON 类型,响应类型由控制器决定。
追问
- CLI 下这些方法返回什么?答:
isCli()为 true,method()返回默认 GET,其他类型判断为 false。 - 伪装方法如何取原始值?答:
Request::method(true)获取伪装前的原始请求类型。
06.5.2.6-008 请求类型伪装 _method 如何工作?
一句话结论
普通表单 POST 提交隐藏域 _method 指定目标方法(PUT/DELETE 等),框架识别为对应请求类型;伪装变量只能经 POST 提交,原始类型可用 method(true) 取得。
概念解释
浏览器表单只能 GET/POST,伪装机制补齐 RESTful 方法支持。框架按 _method 覆盖请求类型判断。
原理流程
- 表单
method="post",隐藏域_method写目标方法。 - 框架读取伪装变量覆盖当前方法。
- 路由按伪装后的方法匹配规则。
method(true)返回原始 POST。
代码或图示
<form method="post" action="">
<input type="hidden" name="_method" value="PUT">
<button type="submit">提交</button>
</form>
// 服务端按伪装后的方法匹配路由;原始方法可用 method(true) 获取
$method = \think\facade\Request::method();
$raw = \think\facade\Request::method(true);
常见误区
- GET 表单伪装方法:伪装变量只能通过 POST 提交。
- 路由未注册 PUT/DELETE 规则:伪装后仍匹配不到。
追问
- 伪装变量名可改吗?答:可在自定义 Request 类的
varMethod属性修改,属性名以版本源码为准(待确认)。 - API JSON 请求需要伪装吗?答:前端可直接发送 PUT/DELETE 请求体,无需
_method。
06.5.2.6-009 Response 有哪些类型?
一句话结论
常用响应类型:json() JSON 数据、view() 视图渲染、redirect() 重定向、download() 文件/内容下载、response() 原始内容;各类型由对应 Response 子类处理输出转换。
概念解释
控制器返回响应助手或 Response 对象,框架按类型设置 Content-Type 并序列化数据。API 项目主要用 json()。
原理流程
- 控制器返回响应助手/对象。
- 框架按响应类型包装数据。
- 设置对应 Content-Type 与状态码。
- 中间件后置逻辑可加工响应后发送。
代码或图示
return json(['code' => 0, 'data' => $list], 200);
return view('hello', ['name' => 'tp']);
return redirect('/login');
return download('image.jpg', 'my.jpg');
常见误区
- 控制器直接
echo后返回:绕过响应包装,中间件后置与头控制失效。 - JSON 响应里带视图数据:类型混用导致前端解析失败。
追问
- 自定义响应类型怎么做?答:继承 Response 子类并在控制器返回,注册方式以响应手册为准。
- 响应数据在哪里统一转换?答:Response 子类按类型序列化,
data()设置原始数据。
06.5.2.6-010 状态码与响应头如何设置?
一句话结论
json($data, 201) 第二参数设状态码,code() 链式设置状态码,header() 设置响应头;另有 lastModified/expires/eTag/cacheControl/contentType 快捷方法。
概念解释
响应头与状态码在 Response 对象上维护,支持链式多次调用。最终发送时写入 HTTP 响应。
原理流程
- 响应助手传入数据与状态码。
- 链式调用
header()追加头信息。 - 中间件后置可继续补头。
send()输出状态行、头与主体。
代码或图示
return json($data, 201)
->header(['Cache-control' => 'no-cache,must-revalidate'])
->cacheControl('no-cache');
常见误区
- 头部在
send()之后再设置:已输出无法追加。 - 覆盖子类默认 Content-Type:除非明确需要,否则不要随意改。
追问
- 如何读取已设置的头?答:Response 提供
getHeader()方法,方法名以版本源码为准。 - 状态码与业务 code 字段区别?答:HTTP 状态码表达协议层结果,业务 code 是响应体自定义结构,二者分别维护。
06.5.2.6-011 download() 下载如何使用,有哪些方法?
一句话结论
download(文件路径, 下载名, 是否内容下载) 返回下载响应;链式支持 name/expire/isContent/mimeType/force,文件不存在抛异常。
概念解释
下载路径是服务器路径而非 URL。force(false) 可让浏览器内联打开图像等文件;内容下载直接输出字符串内容。
原理流程
- 传入服务器文件路径与保存文件名。
- 响应对象设置下载头与内容。
expire()设置有效期,mimeType()指定类型。- 发送时输出文件流/内容。
代码或图示
return download('image.jpg', 'my.jpg')->expire(300)->force(true);
// 内容下载:第三参数 true
return download($content, 'test.txt', true);
常见误区
- 传 URL 路径下载:必须是服务器本地路径。
- 未校验文件存在:不存在时框架抛异常,需在业务侧预判。
追问
- 下载名省略后缀会怎样?答:自动按文件判断后缀,细节以下载手册为准。
- 大文件下载性能注意什么?答:框架下载实现基于响应输出,超大文件需评估内存与流式发送方案。
06.5.2.6-012 控制器参数绑定规则是什么?
一句话结论
操作方法参数中,对象类型由容器依赖注入,标量类型从路由变量/请求数据绑定;参数名与变量名匹配,缺省时使用参数默认值。
概念解释
参数绑定把 URL 变量与方法形参对应起来。对象与标量走不同解析路径,同一方法可并存。
原理流程
- 反射方法签名与参数类型。
- 对象参数:容器解析实例。
- 标量参数:按路由变量优先合并请求数据。
- 缺少必需参数且无默认值时按框架规则报错。
代码或图示
public function read(\app\model\Blog $blog, int $id, string $flag = 'default')
{
return json(['blog' => $blog->id, 'id' => $id, 'flag' => $flag]);
}
常见误区
- 形参名与路由变量名不一致:绑定取不到值。
- 标量参数声明类型但传入非法格式:类型转换/校验失败。
追问
- 模型绑定与参数注入区别?答:路由模型绑定按变量查出模型对象注入;普通对象参数由容器解析,标量来自请求。
- 多余请求参数会注入吗?答:只绑定方法签名内声明的参数,多余数据留在请求对象中。
06.5.2.6-013 控制器方法如何做依赖注入?
一句话结论
操作方法签名声明服务/请求类型,容器在调用方法时解析注入;构造器注入表达控制器必需依赖,方法注入表达单次请求相关对象。
概念解释
方法注入不要求继承基类。业务服务优先构造器注入,Request 等请求相关对象可方法注入。
原理流程
- 控制器构造器声明长期服务依赖。
- 操作方法声明 Request 或可选服务。
- 容器反射解析各参数。
- 调用方法并传入实例。
代码或图示
class Order
{
public function __construct(private \app\service\OrderService $orders) {}
public function detail(\think\Request $request, int $id)
{
return json($this->orders->detail($id));
}
}
常见误区
- 方法内再
app()取已可注入对象:依赖不显式。 - 构造器堆过多服务:类职责过大,应拆分。
追问
- 方法注入可以注入自定义服务吗?答:可以,类型提示服务类即可。
- 注入接口实现如何解析?答:容器中接口绑定到实现类,注入方依赖接口。
06.5.2.6-014 验证在控制器中如何触发?
一句话结论
通过 validate(验证器类/规则)->scene()->batch()->check($data) 执行,失败抛 ValidateException,可在控制器捕获取 getError(),或交由异常处理器统一渲染。
概念解释
控制器负责组织待验证数据并触发校验;规则、场景、错误信息维护在验证器类中。验证失败不进入后续业务。
原理流程
- 组装请求数据数组。
- 调用验证器检查,指定场景/批量等选项。
- 失败抛异常,
getError()取错误信息。 - 验证通过后调用服务处理业务。
代码或图示
try {
validate(\app\validate\User::class)
->scene('edit')
->check($request->param());
} catch (\think\exception\ValidateException $e) {
return json(['code' => 422, 'msg' => $e->getError()], 422);
}
常见误区
- 控制器内手写
if拼接校验规则:规则应沉淀到验证器复用。 - 验证通过后仍信任全部输入:写库前按字段白名单筛选。
追问
- 路由层验证与控制器验证区别?答:路由
validate绑定在匹配阶段拦截,控制器验证在动作内执行,粒度不同。 - 批量验证错误结构?答:
batch(true)返回包含字段与错误信息的数组。
06.5.2.6-015 异常接管如何统一渲染响应?
一句话结论
app\ExceptionHandle 继承框架异常处理器,在渲染方法中按异常类型记录日志并返回统一 JSON/视图;业务代码抛语义异常即可,不各自拼错误响应。
概念解释
异常收口在入口层,控制器与服务只抛异常。处理器区分 HTTP 异常、校验异常与内部错误,映射不同状态码。
原理流程
provider.php绑定异常处理器类。- 链路抛出未捕获异常进入处理器。
- 渲染方法判断类型、记录日志、生成响应。
- 生产环境不输出堆栈详情。
代码或图示
namespace app;
use think\exception\Handle;
class ExceptionHandle extends Handle
{
public function render($request, \Throwable $e)
{
if ($e instanceof \think\exception\ValidateException) {
return json(['code' => 422, 'msg' => $e->getError()], 422);
}
return json(['code' => 500, 'msg' => '服务器内部错误'], 500);
}
}
常见误区
- 每个控制器 catch 后自拼响应:结构不统一。
- 调试信息泄漏到生产客户端:按
APP_DEBUG区分输出详情。
追问
- 404 在哪里处理?答:路由未命中走 MISS 或处理器对
HttpException/未找到异常映射 404。 - 异常日志如何记录?答:处理器内调用 Log 组件记录,避免每个异常点重复写日志。
06.5.2.6-016 自定义 app\Request 如何接入?
一句话结论
骨架默认提供 app\Request 继承 think\Request,可增改方法;需在 provider.php 绑定后,注入、门面与助手才解析自定义子类。
概念解释
自定义请求类用于项目统一取值、过滤与业务判断。改类名/路径时同步更新绑定。
原理流程
- 编写
app\Request继承框架请求基类。 - 在
provider.php登记请求对象绑定。 - 框架初始化绑定自定义实例到容器。
- 各处取用均为子类实例。
代码或图示
// app/Request.php
namespace app;
class Request extends \think\Request
{
public function clientId(): string
{
return (string) $this->header('X-Client-Id', '');
}
}
常见误区
- 改了类名忘记更新
provider.php:框架仍解析默认基类。 - 自定义 Request 为某应用单独定义:请求对象是全局自定义,多应用需在入口注入。
追问
- 多应用能否各用不同 Request?答:自定义请求对象全局生效,按应用区分可在入口文件传入不同请求类,细节以手册为准。
- 如何在入口注入自定义请求?答:
$http->run($request)传入请求实例,框架默认使用绑定对象。
06.5.2.6-017 控制器返回值如何被转换为响应?
一句话结论
返回 Response 对象直接使用;返回数组/字符串由框架按默认响应类型包装;返回 json()/view() 等助手结果按对应类型序列化。
概念解释
响应转换由框架内核在调度完成后统一处理。明确返回响应助手便于控制类型与状态码。
原理流程
- 控制器方法执行完毕返回值。
- 内核判断值类型:Response 直接采用。
- 标量/数组按默认规则包装为对应响应。
- 经过中间件后置逻辑后发送。
代码或图示
// 数组:由框架包装(默认输出类型按配置)
return ['code' => 0, 'data' => []];
// 明确 JSON 响应
return json(['code' => 0, 'data' => []]);
常见误区
- 依赖默认输出类型却在 API 项目返回 HTML:应显式
json()。 - 方法无返回值:响应主体为空,状态码按框架默认。
追问
- 默认响应类型在哪里配置?答:
config/app.php或路由/请求配置中默认输出类型,键名以版本手册为准(待确认)。 - 返回模型集合会被序列化吗?答:模型/集合经序列化输出,获取器与隐藏字段规则生效。
06.5.2.6-018 视图渲染 view() 如何定位模板?
一句话结论
view(模板地址, 变量数组) 由视图驱动定位模板文件并渲染;模板路径、后缀与驱动在 config/view.php 配置,8.0 需安装 think-view 扩展。
概念解释
视图渲染把控制器准备的变量注入模板编译产物。模板目录按控制器/操作约定或显式地址定位。
原理流程
- 控制器调用
view()传入模板标识与变量。 - 视图驱动按配置定位模板文件。
- 编译模板并替换变量输出。
- 包装为 View Response 返回。
代码或图示
return view('blog/detail', [
'blog' => $blog,
'tags' => $tags,
]);
常见误区
- 未装
think-view直接渲染:视图驱动类不存在。 - 模板内做数据库查询:数据应由控制器/服务准备。
追问
- 模板编译缓存放哪里?答:
runtime编译目录,改动模板后清理对应缓存。 - API 项目需要视图组件吗?答:纯接口可不安装,响应统一走 JSON。
06.5.2.6-019 控制器与服务层如何分工?
一句话结论
控制器负责 HTTP 入参出参、调用服务与选择响应格式;服务层承载业务用例、事务编排与规则校验;模型封装数据,控制器不泄漏 ORM 细节。
概念解释
薄控制器、厚服务让业务可被命令行、队列、API 多入口复用。控制器做请求编排,不写业务不变量。
原理流程
- 控制器取参数、触发验证。
- 调用应用服务执行用例与事务边界。
- 服务返回与格式无关的数据。
- 控制器包装为 JSON/视图响应。
代码或图示
class OrderController
{
public function __construct(private \app\service\OrderService $service) {}
public function save(\think\Request $request)
{
$result = $this->service->place($request->param());
return json(['code' => 0, 'data' => $result]);
}
}
常见误区
- 控制器里写事务与业务规则:无法复用,测试只能走 HTTP。
- 把模型对象直接序列化给前端:内部结构泄漏,应输出 DTO/数组。
追问
- 跨模型用例放哪里?答:应用服务编排多个领域服务与仓储,事务边界在服务层划定。
- 业务校验放哪层?答:格式校验在请求/验证器,业务不变量在服务层。
06.5.2.6-020 CLI/命令行下 Request 的默认行为是什么?
一句话结论
CLI 下没有真实 HTTP 请求,Request 使用默认值:isCli() 为 true,method() 返回 GET,AJAX/JSON 等判断为 false,超全局输入为空。
概念解释
命令入口走控制台应用,不经过 HTTP 内核。命令中需要数据应从命令参数/配置/数据库获取,不依赖请求对象。
原理流程
- CLI 引导创建默认请求对象。
- 服务器变量与输入按 CLI 环境初始化。
- 请求类型判断返回 CLI 对应默认值。
- 命令逻辑通过参数与服务获取数据。
代码或图示
// 命令类中
public function execute(ConsoleInput $input, ConsoleOutput $output)
{
$id = (int) $input->getOption('id');
// 不依赖 request()->param()
}
常见误区
- 复用 HTTP 控制器逻辑时读请求参数:CLI 下取不到,应改为显式传参。
- 命令中启动 Session/跨域中间件:CLI 无对应上下文。
追问
- 命令如何取容器实例?答:通过命令的
$this->app或app()助手解析,与 HTTP 共用绑定。 - 队列任务里能用 Request 吗?答:消费者进程无 HTTP 请求,任务数据应随任务载荷传递。