Authenticate.php 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
  1. <?php
  2. namespace App\Http\Middleware\V3;
  3. use App\Services\AuthService;
  4. use Closure;
  5. use Illuminate\Auth\AuthenticationException;
  6. use Illuminate\Contracts\Auth\Middleware\AuthenticatesRequests;
  7. use Illuminate\Http\Request;
  8. use Symfony\Component\HttpFoundation\Response;
  9. /**
  10. * v3 的登录闸:没带有效 bearer token 就在进控制器之前 401。
  11. *
  12. * 挂法见 routes/v3/*.php,别名 `auth.v3`(在 bootstrap/app.php 注册)。
  13. * 可以挂在路由组上,也可以按方法挂:
  14. *
  15. * Route::apiResource('channels', ChannelController::class)
  16. * ->middlewareFor(['store', 'update', 'destroy'], 'auth.v3');
  17. *
  18. * **鉴权和 URL 形状是两件事**:要让某些动作需要登录,挂中间件就行,
  19. * 不需要把它们塞进 `/v3/me/` 前缀。
  20. *
  21. * 两个设计点:
  22. *
  23. * 1. **只认 bearer。** `AuthService::current()` 拿不到 bearer 时会回落去读
  24. * `$_COOKIE['user_uid']`,那是 v2 的旁路;v3 硬规范要求统一 bearer,所以这里
  25. * 先自己挡一道。不改 `AuthService`——它是 v2 也在用的共享代码。
  26. * 2. **解出来的用户存进 request attributes**,控制器直接取,不必再解一次 JWT。
  27. * 3. **实现 `AuthenticatesRequests` 标记接口**,让框架的中间件优先级把它排在
  28. * `SubstituteBindings`(路由模型绑定)之前:否则未登录访问不存在的资源先得到 404
  29. * 而不是 401,还顺带泄露了资源是否存在。
  30. */
  31. class Authenticate implements AuthenticatesRequests
  32. {
  33. /**
  34. * 解析出的用户存在 request attributes 的哪个键下。
  35. */
  36. public const USER = 'v3.user';
  37. /**
  38. * @throws AuthenticationException 没带 bearer,或 token 无效 / 过期
  39. */
  40. public function handle(Request $request, Closure $next): Response
  41. {
  42. // 不给 AuthenticationException 传消息:bootstrap/app.php 的处理器只按状态码
  43. // 渲染,detail 留空,面向人的文案就是 Problem 的 title(RFC 9457 要求它稳定)
  44. if (! $request->bearerToken()) {
  45. throw new AuthenticationException;
  46. }
  47. $user = AuthService::current($request);
  48. if (! $user) {
  49. throw new AuthenticationException;
  50. }
  51. $request->attributes->set(self::USER, $user);
  52. return $next($request);
  53. }
  54. }