本章要回答的三个问题:一个 URI 敲进来,框架凭什么知道该调哪段代码,路由参数、分组、资源路由又分别解决什么问题?URL 里那个编号怎么自动变成数据库里的模型对象,找不到记录时谁来兜底?中间件这道"门卫"在什么时机拦人,自己要加一个门卫该往哪写?
从这一章起,我们站到流水线第一线。第二章讲过,请求穿过全局中间件后第一件事就是"查登记簿"——路由系统就是这本登记簿。它看起来是框架里最简单的部分(不就是把 URI 和闭包对应起来吗),实际却承担着三件决定项目可维护性的大事:入口的清晰度(全项目有哪些入口,一张路由文件看完)、权限的挂载点(哪些入口要登录、哪些要管理员,都在这里声明)、参数的入口规范(URL 里的编号怎么安全地变成模型对象)。登记簿混乱的项目,后面每一层都在还债。
本章沿"登记 → 凭单直达 → 设卡"的顺序推进,这三节合起来,就是把一个请求从"进大门"送到"递到工头手上"的全过程。
| 节号 | 回答哪个问题 | 关键产出 |
|---|---|---|
| 3.1 路由定义、分组与资源路由 | 入口怎么登记才清晰 | 完整的路由注册语料库 + 分组与资源路由实战 |
| 3.2 路由模型绑定 | 编号怎么变成对象 | 隐式与显式绑定 + 404 兜底的定制方法 |
| 3.3 中间件管道与自定义门卫 | 门卫怎么设卡 | 管道执行顺序 + 亲手写一个门卫中间件 |
请求通过了门卫、绑定好了参数,接下来就该工头接单了。第四章控制器派工:控制器有哪几种形态、接单前怎么开材料质检单(表单验证)、交付物怎么标准化。你在本章给路由起的名字(name 方法),下一章生成跳转与验证重定向时都会用到。
问:项目路由涨到几百条怎么办?
分域拆文件:按模块把路由拆成多个文件,在 withRouting 里分别注册;再配合前缀分组,让每本登记簿只描述一个业务域。真正的解药是纪律——新入口先问"这个动作属于哪个模块",而不是往 web.php 里无限追加。
问:路由缓存会把我坑死吗?
只有一条纪律要记:改了路由文件就重新生成缓存。生产环境的流程固定为"部署必跑缓存命令",本地开发不缓存。凡是"明明改了却不生效"的悬案,先清缓存再排查代码,能省下大把时间。
问:模型绑定失败时页面显示什么?
查无此单抛模型未找到异常,框架转成 404 页面;参数格式不符合约束同样是 404。这两个 404 可以在异常处理里统一定制样式,也可以按第七章的策略改成鉴权口径的响应。
问:中间件写在哪一层最合适?
判断标准是"这个检查属于谁的职责":每个请求都必须做的进全局层,一组路由共享的进路由组,单个动作专属的直接用表单验证的 authorize。拿不准时从最窄一层开始,需要放宽再上移。
问:本章学完的自检标准是什么?
打开自己的路由文件,给新同事讲三分钟:这批入口怎么分组、参数怎么约束、哪条路由配了哪个门卫——讲不清楚的地方,就是本章要回炉的地方。