第三章 · 路由进件:接单窗口与门卫制度


第三章 · 路由进件:接单窗口与门卫制度

本章要回答的三个问题:一个 URI 敲进来,框架凭什么知道该调哪段代码,路由参数、分组、资源路由又分别解决什么问题?URL 里那个编号怎么自动变成数据库里的模型对象,找不到记录时谁来兜底?中间件这道"门卫"在什么时机拦人,自己要加一个门卫该往哪写?

为什么会有这一章

从这一章起,我们站到流水线第一线。第二章讲过,请求穿过全局中间件后第一件事就是"查登记簿"——路由系统就是这本登记簿。它看起来是框架里最简单的部分(不就是把 URI 和闭包对应起来吗),实际却承担着三件决定项目可维护性的大事:入口的清晰度(全项目有哪些入口,一张路由文件看完)、权限的挂载点(哪些入口要登录、哪些要管理员,都在这里声明)、参数的入口规范(URL 里的编号怎么安全地变成模型对象)。登记簿混乱的项目,后面每一层都在还债。

本章沿"登记 → 凭单直达 → 设卡"的顺序推进,这三节合起来,就是把一个请求从"进大门"送到"递到工头手上"的全过程。

读完能解决什么

  • 用路由文件把项目的全部入口讲清楚:基本注册、路由参数与约束、命名路由与跳转、分组共享配置、资源路由一行注册七个 RESTful 动作;
  • 用隐式与显式路由模型绑定,把 URL 参数自动解析成 Eloquent 模型,并自定义"找不到记录"与"无效编号"的行为;
  • 说清中间件在哪几层设卡、执行顺序由什么决定,并亲手写一个可复用的自定义中间件挂到路由组上。

各节怎么分工

节号 回答哪个问题 关键产出
3.1 路由定义、分组与资源路由 入口怎么登记才清晰 完整的路由注册语料库 + 分组与资源路由实战
3.2 路由模型绑定 编号怎么变成对象 隐式与显式绑定 + 404 兜底的定制方法
3.3 中间件管道与自定义门卫 门卫怎么设卡 管道执行顺序 + 亲手写一个门卫中间件

先决条件

  • 第二章的生命周期概念(本章内容全部挂在那条流水线上);
  • 第一章搭好的项目环境,本章所有代码都可以直接贴进去跑。

往下走到哪

请求通过了门卫、绑定好了参数,接下来就该工头接单了。第四章控制器派工:控制器有哪几种形态、接单前怎么开材料质检单(表单验证)、交付物怎么标准化。你在本章给路由起的名字(name 方法),下一章生成跳转与验证重定向时都会用到。

本章的高频疑问

问:项目路由涨到几百条怎么办?
分域拆文件:按模块把路由拆成多个文件,在 withRouting 里分别注册;再配合前缀分组,让每本登记簿只描述一个业务域。真正的解药是纪律——新入口先问"这个动作属于哪个模块",而不是往 web.php 里无限追加。

问:路由缓存会把我坑死吗?
只有一条纪律要记:改了路由文件就重新生成缓存。生产环境的流程固定为"部署必跑缓存命令",本地开发不缓存。凡是"明明改了却不生效"的悬案,先清缓存再排查代码,能省下大把时间。

问:模型绑定失败时页面显示什么?
查无此单抛模型未找到异常,框架转成 404 页面;参数格式不符合约束同样是 404。这两个 404 可以在异常处理里统一定制样式,也可以按第七章的策略改成鉴权口径的响应。

问:中间件写在哪一层最合适?
判断标准是"这个检查属于谁的职责":每个请求都必须做的进全局层,一组路由共享的进路由组,单个动作专属的直接用表单验证的 authorize。拿不准时从最窄一层开始,需要放宽再上移。

问:本章学完的自检标准是什么?
打开自己的路由文件,给新同事讲三分钟:这批入口怎么分组、参数怎么约束、哪条路由配了哪个门卫——讲不清楚的地方,就是本章要回炉的地方。

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