罗罗编程学习记录
本页内容 展开查看

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 主要为复用公共属性与方法。

概念解释

框架对控制器类的约束很宽松,操作方法即调度目标。基类可放跨控制器复用的辅助方法、公共属性,但不强制继承。

原理流程

  1. 路由解析到控制器类与方法。
  2. 容器实例化控制器,注入构造依赖。
  3. 反射调用操作方法,绑定参数。
  4. 返回值由框架包装为响应。

代码或图示

namespace app\controller;

class Index
{
    public function hello(string $name)
    {
        return json(['name' => $name]);
    }
}

常见误区

  • 把公共业务逻辑塞进基类:基类被所有控制器继承,耦合面过大,应抽服务层。
  • 控制器构造器做重初始化:构造只装配依赖。

追问

  • 默认 BaseController 提供什么?答:以安装骨架中的基类为准,通常持有请求等公共属性,可按需修改。
  • 控制器需要继承框架内核类吗?答:不需要,调度由路由与容器完成。

06.5.2.6-002 多级/分级控制器如何组织与调度?

一句话结论

控制器可按子目录分级放置,命名空间与目录保持一致;路由通过分组 layer/controller/namespace 绑定或规则地址中的层级表达,调度到对应类方法。

概念解释

大型项目按后台、接口、模块划分控制器目录。分级目录对应命名空间层级,自动加载与调度都依赖二者一致。

原理流程

  1. 控制器按目录分级创建,命名空间同步层级。
  2. 路由规则地址或分组绑定指向分级。
  3. 调度器按命名空间定位控制器类。
  4. 调用对应操作方法。

代码或图示

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() 助手函数;三者指向容器中的同一请求实例。

概念解释

请求对象在初始化阶段存入容器。注入方式类型显式,门面与助手用于无法注入的场合。

原理流程

  1. 初始化把当前请求实例绑定到容器。
  2. 方法/构造器类型提示 Request 取实例。
  3. 门面静态调用转发到同一实例。
  4. 助手函数内部解析容器请求对象。

代码或图示

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() 是推荐的统一取值入口,自动识别请求类型并合并来源。各来源按框架规则覆盖合并,路由变量优先级最高。

原理流程

  1. 框架收集路由变量、GET、POST/PUT 等输入。
  2. param() 按优先级合并后返回。
  3. 专用方法只取对应来源。
  4. 取值可带默认值与过滤修饰符。

代码或图示

$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 浮点;也可在第三参数传过滤方法。

概念解释

修饰符在取值时完成基础类型转换,避免后续到处强转。严格格式校验应配合验证器规则。

原理流程

  1. 变量名书写为 'id/d'。
  2. 框架按修饰符转换返回值类型。
  3. 缺省使用第二参数默认值。
  4. 第三参数可指定过滤函数/方法。

代码或图示

$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 驱动完成,远程/对象存储需安装对应扩展。

原理流程

  1. 表单 enctype="multipart/form-data" 提交文件。
  2. file() 按字段名取文件对象或数组。
  3. 验证大小、后缀、MIME 类型。
  4. 调用 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() 始终返回大写。

原理流程

  1. 框架解析原始请求方法与伪装方法。
  2. 判断方法按类型返回布尔。
  3. AJAX/JSON 按请求头识别。
  4. 控制器按判断结果分支响应。

代码或图示

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 覆盖请求类型判断。

原理流程

  1. 表单 method="post",隐藏域 _method 写目标方法。
  2. 框架读取伪装变量覆盖当前方法。
  3. 路由按伪装后的方法匹配规则。
  4. 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()。

原理流程

  1. 控制器返回响应助手/对象。
  2. 框架按响应类型包装数据。
  3. 设置对应 Content-Type 与状态码。
  4. 中间件后置逻辑可加工响应后发送。

代码或图示

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 响应。

原理流程

  1. 响应助手传入数据与状态码。
  2. 链式调用 header() 追加头信息。
  3. 中间件后置可继续补头。
  4. 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) 可让浏览器内联打开图像等文件;内容下载直接输出字符串内容。

原理流程

  1. 传入服务器文件路径与保存文件名。
  2. 响应对象设置下载头与内容。
  3. expire() 设置有效期,mimeType() 指定类型。
  4. 发送时输出文件流/内容。

代码或图示

return download('image.jpg', 'my.jpg')->expire(300)->force(true);

// 内容下载:第三参数 true
return download($content, 'test.txt', true);

常见误区

  • 传 URL 路径下载:必须是服务器本地路径。
  • 未校验文件存在:不存在时框架抛异常,需在业务侧预判。

追问

  • 下载名省略后缀会怎样?答:自动按文件判断后缀,细节以下载手册为准。
  • 大文件下载性能注意什么?答:框架下载实现基于响应输出,超大文件需评估内存与流式发送方案。

06.5.2.6-012 控制器参数绑定规则是什么?

一句话结论

操作方法参数中,对象类型由容器依赖注入,标量类型从路由变量/请求数据绑定;参数名与变量名匹配,缺省时使用参数默认值。

概念解释

参数绑定把 URL 变量与方法形参对应起来。对象与标量走不同解析路径,同一方法可并存。

原理流程

  1. 反射方法签名与参数类型。
  2. 对象参数:容器解析实例。
  3. 标量参数:按路由变量优先合并请求数据。
  4. 缺少必需参数且无默认值时按框架规则报错。

代码或图示

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 等请求相关对象可方法注入。

原理流程

  1. 控制器构造器声明长期服务依赖。
  2. 操作方法声明 Request 或可选服务。
  3. 容器反射解析各参数。
  4. 调用方法并传入实例。

代码或图示

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(),或交由异常处理器统一渲染。

概念解释

控制器负责组织待验证数据并触发校验;规则、场景、错误信息维护在验证器类中。验证失败不进入后续业务。

原理流程

  1. 组装请求数据数组。
  2. 调用验证器检查,指定场景/批量等选项。
  3. 失败抛异常,getError() 取错误信息。
  4. 验证通过后调用服务处理业务。

代码或图示

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 异常、校验异常与内部错误,映射不同状态码。

原理流程

  1. provider.php 绑定异常处理器类。
  2. 链路抛出未捕获异常进入处理器。
  3. 渲染方法判断类型、记录日志、生成响应。
  4. 生产环境不输出堆栈详情。

代码或图示

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 绑定后,注入、门面与助手才解析自定义子类。

概念解释

自定义请求类用于项目统一取值、过滤与业务判断。改类名/路径时同步更新绑定。

原理流程

  1. 编写 app\Request 继承框架请求基类。
  2. 在 provider.php 登记请求对象绑定。
  3. 框架初始化绑定自定义实例到容器。
  4. 各处取用均为子类实例。

代码或图示

// 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() 等助手结果按对应类型序列化。

概念解释

响应转换由框架内核在调度完成后统一处理。明确返回响应助手便于控制类型与状态码。

原理流程

  1. 控制器方法执行完毕返回值。
  2. 内核判断值类型:Response 直接采用。
  3. 标量/数组按默认规则包装为对应响应。
  4. 经过中间件后置逻辑后发送。

代码或图示

// 数组:由框架包装(默认输出类型按配置)
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 扩展。

概念解释

视图渲染把控制器准备的变量注入模板编译产物。模板目录按控制器/操作约定或显式地址定位。

原理流程

  1. 控制器调用 view() 传入模板标识与变量。
  2. 视图驱动按配置定位模板文件。
  3. 编译模板并替换变量输出。
  4. 包装为 View Response 返回。

代码或图示

return view('blog/detail', [
    'blog' => $blog,
    'tags' => $tags,
]);

常见误区

  • 未装 think-view 直接渲染:视图驱动类不存在。
  • 模板内做数据库查询:数据应由控制器/服务准备。

追问

  • 模板编译缓存放哪里?答:runtime 编译目录,改动模板后清理对应缓存。
  • API 项目需要视图组件吗?答:纯接口可不安装,响应统一走 JSON。

06.5.2.6-019 控制器与服务层如何分工?

一句话结论

控制器负责 HTTP 入参出参、调用服务与选择响应格式;服务层承载业务用例、事务编排与规则校验;模型封装数据,控制器不泄漏 ORM 细节。

概念解释

薄控制器、厚服务让业务可被命令行、队列、API 多入口复用。控制器做请求编排,不写业务不变量。

原理流程

  1. 控制器取参数、触发验证。
  2. 调用应用服务执行用例与事务边界。
  3. 服务返回与格式无关的数据。
  4. 控制器包装为 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 内核。命令中需要数据应从命令参数/配置/数据库获取,不依赖请求对象。

原理流程

  1. CLI 引导创建默认请求对象。
  2. 服务器变量与输入按 CLI 环境初始化。
  3. 请求类型判断返回 CLI 对应默认值。
  4. 命令逻辑通过参数与服务获取数据。

代码或图示

// 命令类中
public function execute(ConsoleInput $input, ConsoleOutput $output)
{
    $id = (int) $input->getOption('id');
    // 不依赖 request()->param()
}

常见误区

  • 复用 HTTP 控制器逻辑时读请求参数:CLI 下取不到,应改为显式传参。
  • 命令中启动 Session/跨域中间件:CLI 无对应上下文。

追问

  • 命令如何取容器实例?答:通过命令的 $this->app 或 app() 助手解析,与 HTTP 共用绑定。
  • 队列任务里能用 Request 吗?答:消费者进程无 HTTP 请求,任务数据应随任务载荷传递。