第四章 · 控制器派工:工头接单与质检


第四章 · 控制器派工:工头接单与质检

本章要回答的三个问题:控制器有多少种形态,一个项目该按什么标准决定哪里用普通控制器、哪里用单动作?用户提交的表单数据敢不敢直接用,怎么在写库之前把材料彻底验一遍?验完料、干完活,页面、JSON、跳转、文件下载这些交付物怎么标准地发出去?

为什么会有这一章

请求终于过完了安检、绑定了参数,递到了工头手上。控制器是每个 Laravel 项目里代码量最大的层,也是最容易写脏的层:入口动作越写越长、验证逻辑散落各处、响应格式每个接口一个样——脏到一定程度的控制器,没人敢动,只能堆。这一章的任务是立规矩:工头可以调度、可以整理,但验材料要按质检单来(Form Request),发交付物要按标准箱型(响应与 API 资源)。

规矩立住之后,还有一个隐藏收益:控制器变薄了,业务逻辑才有可能下沉到服务类和模型里,单元测试才有落笔的地方。第九章的验收体系能否顺利铺开,取决于本章这层地基打得正不正。

读完能解决什么

  • 区分普通控制器、资源控制器、单动作控制器的适用场景,合理组织一个 CRUD 模块的动作划分;
  • 用 Form Request 把验证规则、错误消息、授权检查从控制器里整体搬走,并用自定义规则处理特殊校验;
  • 用 response、redirect、二进制下载等手段构造各类交付物,并用 API 资源(Resource)统一 JSON 的输出结构与字段口径。

各节怎么分工

节号 回答哪个问题 关键产出
4.1 控制器形态与派工规范 工头有几种编制 三种形态的选型标准 + 薄控制器的代码骨架
4.2 表单验证:材料进场质检单 材料怎么验才可靠 Form Request 完整实战 + 自定义规则
4.3 响应构建与 API 资源交付 交付物怎么标准化 各类响应写法 + Resource 变换层

先决条件

  • 第三章的路由与绑定已掌握,本章示例都挂在那些路由上;
  • 知道 Eloquent 模型的基本形态(第五章会展开,本章只需会用 Order::find 这类静态调用)。

往下走到哪

控制器把验料和交付都规范了,剩下的纯施工——怎么建表、怎么读写数据——全部交给第五章模型施工。你在本章写下的验证规则,到第五章会接上数据库层面的唯一性约束,形成前后两道防线。

本章的高频疑问

问:控制器里到底能不能写业务逻辑?
能写"编排",别写"规则"。判断分支、调服务、组织响应属于编排,放在控制器天经地义;计算折扣、扣库存、走审批这类业务规则,下沉到服务类或模型。一个实用的体检标准:任何动作方法超过一屏,就该考虑拆了。

问:Form Request 类会不会太多太碎?
会有这个体感,但碎是刻意的:每个请求一张独立的质检单,规则、消息、授权自成一体,复用靠组合(规则对象、自定义规则)而不是继承。真想减少类数量,可以把完全一致的验证抽成共享规则集——但通常先问"这两个接口的规则将来会不会分化",多数答案是会。

问:API 和页面共用一套控制器吗?
不建议。页面控制器关心重定向与视图,API 控制器关心资源与状态码,混在一起会让响应口径互相污染。同一业务逻辑下沉到服务类,两层控制器都只是薄壳调用——这也是 4.1 节"业务下沉"的直接理由。

问:响应格式由谁说了算?
由资源层(Resource)说了算,不由控制器临场发挥。项目初期就定下统一的资源装箱规范(字段命名、日期格式、分页结构),后期接小程序、开放接口时,所有客户端读的是同一套契约。

作者与出处
原作者:灏天文库
来源:平台策划编纂
整理人: 灏天文库整理
由灏天文库平台收录,内容或由平台用户上传,仅供学习交流
发布者: 作者: 灏天文库 转发
评论区 (0)
U