本章要回答的三个问题:登录、注册、密码重置这套门禁系统怎么搭起来,session 与 API 令牌两种通行方式各用在什么场景?"这个用户能不能动这条数据"的判断写在哪,才不会散落成一堆 if?API 通行证(Sanctum)怎么发、怎么验,和网页门禁是什么关系?
装修完工的项目谁都能进,从这一章起系统开始认人。认证(authentication)回答"你是谁",授权(authorization)回答"你能干什么",两件事常被混为一谈,出的事故却各有各的形状:只做了登录不查归属,编号递增的接口让任何人翻到别人的工单(上一章讲路由绑定时的越权隐患在这里收口);把权限判断散落在控制器各处,加一个"只读访客"角色要改二十个文件。
这一章把门禁系统一次装齐:员工卡(认证)、钥匙与权限清单(策略与 Gate)、外来访客通行证(API 令牌)。装完之后,第三章在绑定层做的那版简易归属过滤也有了正式的替代方案。
| 节号 | 回答哪个问题 | 关键产出 |
|---|---|---|
| 7.1 用户认证 | 门禁怎么认人 | session 登录全套 + 认证体系零件图 |
| 7.2 授权策略、Gate 与 API 通行证 | 认人之后怎么辨权 | Policy 与 Gate 声明 + Sanctum 令牌发放 |
问:session 认证和令牌认证能不能共存?
不仅共存,而且是推荐形态:浏览器用户走 session,移动端与脚本走 Sanctum 令牌,两套闸机各守各的门。多数项目真正要避免的是"全站都套令牌"——浏览器场景里 session 的安全机制(HttpOnly、CSRF 配套)更成熟。
问:Policy 写完怎么验证它真的生效?
两条路:Feature 测试里用 actingAs 造不同身份的用户,断言越权请求返回 403(第九章的用例会示范);开发期在浏览器里用低权限账号手动试一遍关键动作。Policy 是纯 PHP 类,单测成本极低,是整个项目里最值得测的部件之一。
问:要不要一上来就引入权限管理包?
先声明式收口(Gate 与 Policy),等出现"角色多、权限交叉、需要后台动态配权"的真实需求再上 Spatie 这类权限包。过早引入的代价是每个权限判断都隔着包的缓存与委托层,排查问题时多了一层迷雾。
问:本章自检看什么?
退出登录后直接敲一个需要登录的地址,确认被送回登录页;再用另一个队组的账号访问你自己的工单详情,确认拿到的是拒绝而不是数据。这两下试探,就是门禁系统的验收标准。通过之后,再翻一遍控制器:凡是用 if 判断当前用户身份的角落,都值得收编进 Policy,让规则回到声明里。通过之后,你还可以翻一遍控制器,确认没有手写的身份判断漏网在外。
门禁装好后,项目进入"幕后运营"阶段:下一章队列、调度、事件与通知——登录通知、完工提醒这些需要异步与广播的能力,都建立在一套可靠的门禁之上。