Laravel 大将之路由模块

Posted SegmentFault

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Laravel 大将之路由模块相关的知识，希望对你有一定的参考价值。

本文是基于 Laravel5.4版本的路由模块代码进行分析书写。

模块组成

下图展示了路由模块中各个文件的关系，并进行简要说明。

剖析

服务提供者

看 Laravel模块，首先找 ServiceProvider文件，这是模块与 IOC容器交互的入口，从这个文件，可以看出该模块提供向系统提供了哪些服务；

 
   
   
 
    
  
    
    
  
  1. public function register() {
    2. 
  
    
    
  
  2.     // 注册路由管理，提供路由注册，路由匹配的功能
    3. 
  
    
    
  
  3.     $this->registerRouter();
    4. 
  
    
    
  
  4.     // 注册 Url 生成器实例
    5. 
  
    
    
  
  5.     $this->registerUrlGenerator();
    6. 
  
    
    
  
  6.     // 注册跳转器
    7. 
  
    
    
  
  7.     $this->registerRedirector();
    8. 
  
    
    
  
  8.     // 绑定 PSR-7 请求实现到 ServerRequestInterface 接口
    9. 
  
    
    
  
  9.     $this->registerPsrRequest();
    10. 
  
    
    
  
  10.     // 绑定 PSR-7 Response 实现到 ResponseInterface 接口
    11. 
  
    
    
  
  11.     $this->registerPsrResponse();
    12. 
  
    
    
  
  12.     // 注册 ReponseFactory，提供各式各样的 Response，比如视图响应、Json响应、Jsonp响应、文件下载等
    13. 
  
    
    
  
  13.     $this->registerResponseFactory();
    14. 
  
    
    
  
  14. }
    15.

路由管理

“路由管理”服务有以下元素需要了解：

  • Route：路由；会记录 Url、 Http 动作、 Action (路由要执行的具体对象，可能是 Closure，也可以是某个 Controller 中的方法)，路由参数，路由参数的约束；

  • RouteCollection：路由集，用来存储所有 Route对象的“盒子”；

  • RouteGroup：路由组；只有路由注册过程中会临时用到；存储一批路由公共的一些属性，属性包括 domain、 prefix、 as、 middleware、 namespace、 where；

  • Resource：资源路由；资源路由是一套路由的统称，包含列表（ index）、显示增加（ create）、保存增加（ store）、显示详情（ show）、显示编辑详情（ edit）、更新编辑（ update）、删除详情（ destory）；同时可以通过调用 only或 except方法或参数的形式只生成部分路由；

  • Action：路由要执行的对象；有两种表现形式，一是 Closure函数，二是类似 ['uses'=>'FooController@method','as'=>'name']这样的字符串；对于不同的表现形式，路由在执行时会调用不同的处理；

注册流程

在项目启动后，会执行所有 ServiceProvider的 loadRoutes方法，也就是调用 map方法，一般情况下 map方法如下

 
   
   
 
    
  
    
    
  
  1. public function map(Router $router){
    2. 
  
    
    
  
  2.     require __DIR__.'/routes.php';
    3. 
  
    
    
  
  3. }
    4.

这时候，项目就会执行很多 Route::get、 Route::post、 Route::group方法；

当遇到 Route::group方法时，会实例化一个 RouteGroup对象， put进 Router管理类的路由组栈头部；而后当执行 get、 post这类具体的注册路由方法时，会把当前路由组栈中所有组的属性合并进新路由中，将新路由存储在 RouteCollection这个大盒子里；当 Route::group的 Closure执行完毕时，会把头部的 RouteGroup实例 pull出去；

当执行 Route::resource时， Router管理类会调用 ResourceRegister类来完成批量注册路由；

对于 Router::get这类注册方法， Illuminate\Foudation\helpers提供了简写；Router::get 简化成 get，Router::post 简化成 post，Router::put 简化成 put，Router::patch 简化成 patch，Router::delete 简化成 delete，Router::resource简化成 resource，

至此， RouteCollection大盒子就存放了所有要注册的路由；

request 请求匹配流程

首先， request请求会经过 Foundation/Http/Kernel的 handle方法，在这个方法中，请求会执行以下语句

 
   
   
 
    
  
    
    
  
  1. $this->router->dispatch($request)
    2.

这里的 $this->router，就是 Router管理类； dispatch方法如下

 
   
   
 
    
  
    
    
  
  1. public function dispatch(Request $request) {
    2. 
  
    
    
  
  2.     $this->currentRequest = $request;
    3. 
  
    
    
  
  3.     return $this->dispatchToRoute($request);
    4. 
  
    
    
  
  4. }
    5. 
  
    
    
  
    6. 
  
    
    
  
  6. public function dispatchToRoute(Request $request) {
    7. 
  
    
    
  
  7.     // 根据请求的 url 找到匹配的路由
    8. 
  
    
    
  
  8.     $route = $this->findRoute($request);
    9. 
  
    
    
  
  9.     // 将路由绑定到请求上
    10. 
  
    
    
  
  10.     $request->setRouteResolver(function () use ($route) {
    11. 
  
    
    
  
  11.         return $route;
    12. 
  
    
    
  
  12.     }
    13. 
  
    
    
  
  13.     // 触发 RouteMatched 事件
    14. 
  
    
    
  
  14.     $this->events->dispatch(new Events\RouteMatched($route, $request));
    15. 
  
    
    
  
  15.     // 通过 Pipeline 流水线执行路由上绑定的中间件及对应的方法
    16. 
  
    
    
  
  16.     $response = $this->runRouteWithinStack($route, $request);
    17. 
  
    
    
  
  17.     // 根据 request 请求设置 response 的响应头
    18. 
  
    
    
  
  18.     return $this->prepareResponse($request, $response);
    19. 
  
    
    
  
  19. }
    20.

  1. 根据请求找匹配的路由 RouteCollection根据请求的 http动作缩小要匹配的路由范围；在筛选出来的这些路由中依次遍历，找出第一个符合验证的路由（需要进行较验的验证在 Route中的 getValidators方法中声明）；

  2. 将路由绑定到请求上

  3. 触发 RouteMatched事件 初始化的 Laravel项目没有对 RouteMatched路由匹配事件进行任何的监听器绑定，如有需要，可以自定义监听器，在模块的 EventServiceProvider中注册该事件监听；这样一旦请求匹配上某个路由，就可以执行自定义方法了；

  4. 通过 Pipeline 流水线执行路由上绑定的中间件及对应的方法 在 runRouteWithinStack方法中，系统会判断是否需要执行中间件，如果 IOC容器中设置了 middleware.disable的值为 true，则需要执行的中间件数组为空；否则会找到所有的中间件，并按照 middlewarePriority对必要的一些中间件进行排序调整；然后执行 $route->run()方法；

  5. 根据 request 请求设置 response 的响应头

项目中会用到的一些方法

  1. 获取路由集合 app('router')->getRoutes()

  2. 获取当前的请求 $request=app('router')->getCurrentRequest()

  3. 获取当前请求所对应的路由 $route=$request->route() 或 $route=app('router')->getCurrentRoute()

  4. 获取当前路由需要执行的中间件 $middlewares=app('router')->gatherRouteMiddleware($route)

Url 生成器

Url 生成器是什么？举个例子：

 
   
   
 
    
  
    
    
  
  1. $url = new UrlGenerator(
    2. 
  
    
    
  
  2.     $routes = new RouteCollection,
    3. 
  
    
    
  
  3.     $request = Request::create('http://www.foo.com/')
    4. 
  
    
    
  
  4. );
    5. 
  
    
    
  
    6. 
  
    
    
  
  6. $url->to('foo/bar'); // 输出 http://www.foo.com/foo/bar
    7.

像这种基于当前请求，生成指定路径的 Url；

这部分功能由两个文件完成，一个是 UrlGenerator.php，另一个是 RouteUrlGenerator.php； UrlGenerator.php处理根据路径名生成 Url， RouteUrlGenerator.php处理根据路由生成 Url；

列一些常用的使用：

根据路径名生成

使用 to方法，第一个参数为路径，第二个参数是数组， implode后会接着路径名，第三个参数决定用不用 https

 
   
   
 
    
  
    
    
  
  1. // 路径名是 foo/bar，当前请求的根路径为 http://www.foo.com，所以输出是 http://www.foo.com/foo/bar
    2. 
  
    
    
  
  2. $url->to('foo/bar')
    3. 
  
    
    
  
  3. // 路径名是 foo/bar，当前请求的根路径为 http://www.foo.com，第三个参数决定 scheme 是 https，所以输出是 https://www.foo.com/foo/bar
    4. 
  
    
    
  
  4. $url->to('foo/bar', [], true)
    5. 
  
    
    
  
  5. // 路径名是 foo/bar，第二个参数 是补充路径名，implode 后是 /baz/boom
    6. 
  
    
    
  
  6. // 第三个参数决定 scheme 是 https，所以输出是 https://www.foo.com/foo/bar/baz/boom
    7. 
  
    
    
  
  7. $url->to('foo/bar', ['baz', 'boom'], true)
    8. 
  
    
    
  
  8. // 路径名是 foo/bar，查询参数是 ?foo=bar ，补充路径是 /baz，所以输出是 https://www.foo.com/foo/bar/baz?foo=bar
    9. 
  
    
    
  
  9. $url->to('foo/bar?foo=bar', ['baz'], true)
    10.
根据路由的 as 名生成

使用 route方法，第一个参数为指定路由的 as 名，第二个参数是参数数组，第三个参数决定是否显示根目录（默认为 true）

 
   
   
 
    
  
    
    
  
  1. $route = new Route(['GET'], 'foo/bar', ['as' => 'foo']);
    2. 
  
    
    
  
  2. $routes->add($route);
    3. 
  
    
    
  
    4. 
  
    
    
  
  4. // 输出 'http://www.foo.com/foo/bar
    5. 
  
    
    
  
  5. $url->route('foo');
    6. 
  
    
    
  
    7. 
  
    
    
  
  7. // 第三个参数为 false，表示不显示根目录，于是输出 /foo/bar
    8. 
  
    
    
  
  8. $url->route('foo', [], false)
    9. 
  
    
    
  
    10. 
  
    
    
  
  10. // 路由中的 url 本身不带参数，则第二参数中所有关联数组都将作为查询参数
    11. 
  
    
    
  
  11. // 输出 /foo/bar?foo=bar
    12. 
  
    
    
  
  12. $url->route('foo', ['foo' => 'bar'], false)
    13. 
 
   
   
 
 
   
   
 
    
  
    
    
  
  1. $route = new Route(['GET'], 'foo/bar/{baz}/breeze/{boom}', ['as' => 'bar']);
    2. 
  
    
    
  
  2. $routes->add($route);
    3. 
  
    
    
  
    4. 
  
    
    
  
  4. // 路由上的 url 带参数，根据参数名找值；剩余多余的为查询参数；
    5. 
  
    
    
  
  5. // 输出 http://www.foo.com/foo/bar/otwell/breeze/taylor?fly=wall
    6. 
  
    
    
  
  6. $url->route('bar', ['boom' => 'taylor', 'baz' => 'otwell', 'fly' => 'wall']);
    7. 
  
    
    
  
    8. 
  
    
    
  
  8. // 路由上的 url 带参数，找不到对应的参数值，则按顺序作值；剩余多余的为查询参数；
    9. 
  
    
    
  
  9. // 输出 http://www.foo.com/foo/bar/taylor/breeze/otwell?fly=wall
    10. 
  
    
    
  
  10. $url->route('bar', ['taylor', 'otwell', 'fly' => 'wall']);
    11.
根据路由的 action 名生成

使用 action方法，第一个参数为指定路由的 action 名，第二个参数是参数数组，第三个参数决定是否显示根目录（默认为 true）

 
   
   
 
    
  
    
    
  
  1. $route = new Route(['GET'], 'foo/bam', ['controller' => 'foo@bar']);
    2. 
  
    
    
  
  2. $routes->add($route);
    3. 
  
    
    
  
    4. 
  
    
    
  
  4. // 输出 http://www.foo.com/foo/bam
    5. 
  
    
    
  
  5. $url->action('foo@bar');
    6. 
 
   
   
 
 
   
   
 
    
  
    
    
  
  1. $route = new Route(['GET'], 'foo/invoke', ['controller' => 'InvokableActionStub']);
    2. 
  
    
    
  
  2. $routes->add($route);
    3. 
  
    
    
  
    4. 
  
    
    
  
  4. // 输出 http://www.foo.com/foo/invoke
    5. 
  
    
    
  
  5. $url->action('InvokableActionStub');
    6.
设置全局默认参数
 
   
   
 
    
  
    
    
  
  1. $url->defaults(['locale' => 'en']);
    2. 
  
    
    
  
    3. 
  
    
    
  
  3. $route = new Route(['GET'], 'foo', ['as' => 'defaults', 'domain' => '{locale}.example.com', function() {}]);
    4. 
  
    
    
  
    5. 
  
    
    
  
  5. // 路由 url 有参数，但没有传参数值，则会找全局默认参数值；输出 http://en.example.com/foo
    6. 
  
    
    
  
  6. $url->route('defaults');
    7.
设置全局命名空间

这样调用的时候，不用在 action 上省略这部分命名空间

 
   
   
 
    
  
    
    
  
  1. // 设置全局命名空间
    2. 
  
    
    
  
  2. $url->setRootControllerNamespace('namespace');
    3. 
  
    
    
  
    4. 
  
    
    
  
  4. // 配置添加路由
    5. 
  
    
    
  
  5. $route = new Route(['GET'], 'foo/bar', ['controller' => 'namespace\foo@bar']);
    6. 
  
    
    
  
  6. $routes->add($route);
    7. 
  
    
    
  
  7. $route = new Route(['GET'], 'foo/invoke', ['controller' => 'namespace\InvokableActionStub']);
    8. 
  
    
    
  
  8. $routes->add($route);
    9. 
  
    
    
  
    10. 
  
    
    
  
  10. // 输出 http://www.foo.com/foo/bar;  action 的值省略 namespace 这个命名空间
    11. 
  
    
    
  
  11. $url->action('foo@bar');
    12. 
  
    
    
  
  12. // 输出 http://www.foo.com/foo/invoke;  action 的值省略 namespace 这个命名空间
    13. 
  
    
    
  
  13. $url->action('InvokableActionStub');
    14. 
  
    
    
  
    15. 
  
    
    
  
  15. // 配置添加路由
    16. 
  
    
    
  
  16. $route = new Route(['GET'], 'something/else', ['controller' => 'something\foo@bar']);
    17. 
  
    
    
  
  17. $routes->add($route);
    18. 
  
    
    
  
    19. 
  
    
    
  
  19. // 输出  http://www.foo.com/something/else； action 的最前面加了 `\`，全局命名空间下调用
    20. 
  
    
    
  
  20. $url->action('\something\foo@bar')；
    21.

跳转器

跳转器内部提供了以下跳转；

home通过调用 app('redirect')->home()会跳转至根目录下 \；

 
   
   
 
    
  
    
    
  
  1. public function home($status = 302)
    2.

back通过调用 app('redirect')->back()会跳转至上一次访问页面；或者全局帮助函数 back()也可以；

 
   
   
 
    
  
    
    
  
  1. public function back($status = 302, $headers = [], $fallback = false)
    2.

第三个参数表示，如果没有前一次访问请求，访问哪个页面，具体源码如下：

 
   
   
 
    
  
    
    
  
  1. if ($url) {
    2. 
  
    
    
  
  2.      return $url;
    3. 
  
    
    
  
  3. } elseif ($fallback) {
    4. 
  
    
    
  
  4.     return $this->to($fallback);
    5. 
  
    
    
  
  5. } else {
    6. 
  
    
    
  
  6.     return $this->to('/');
    7. 
  
    
    
  
  7. }
    8.

refresh通过调用 app('redirect')->refresh()会刷新当前访问页面；

 
   
   
 
    
  
    
    
  
  1. public function refresh($status = 302, $headers = [])
    2.

to通过调用 app('redirect')->to('path')会跳转至指定路径页面；或者全局帮助函数 redirect('path')也可以；

这里的 path 路径是不包含根目录的，例如（ foo/bar）；

 
   
   
 
    
  
    
    
  
  1. public function to($path, $status = 302, $headers = [], $secure = null) 
    2.

第四个参数表示是否使用 https；

away通过调用 app('redirect')->away('path')会跳转至指定路径页面；

这里的 path 路径是包含根目录的，例如（ http://xx.com/foo/bar）；

 
   
   
 
    
  
    
    
  
  1. public function away($path, $status = 302, $headers = [])
    2.

secure通过调用 app('redirect')->secure('path')会跳转至指定路径页面；这里的 path路径是不包含根目录的；

 
   
   
 
    
  
    
    
  
  1. public function secure($path, $status = 302, $headers = [])
    2.

其本质是调用了 to方法

 
   
   
 
    
  
    
    
  
  1. return $this->to($path, $status, $headers, true);
    2.

route通过调用 app('redirect')->route('route_as_name')，根据路由的 as名会跳转至与路由一致的 url路径页；

 
   
   
 
    
  
    
    
  
  1. public function route($route, $parameters = [], $status = 302, $headers = [])
    2.

action通过调用 app('redirect')->action('route_action')，根据路由的 action名会跳转至与路由一致的 url路径页；

 
   
   
 
    
  
    
    
  
  1. public function action($action, $parameters = [], $status = 302, $headers = [])
    2.

guest跳到指定的路径页的同时，将当前 url存放至 session中，键名为 url.intended;

 
   
   
 
    
  
    
    
  
  1. public function guest($path, $status = 302, $headers = [], $secure = null)
    2.

intended跳转至 session中键名为 url.intended的值所对应的 Url；如果不存在，则跳转至第一个参数所传的值；

 
   
   
 
    
  
    
    
  
  1. public function intended($default = '/', $status = 302, $headers = [], $secure = null)
    2.

响应工厂（ResponseFactory）

ResponseFactory文件提供了两部分 API，分别是与响应类型相关和与跳转相关；

响应

response()会返回 ResponseFactory实例；

视图响应

 
   
   
 
    
  
    
    
  
  1. response()->view('hello', $data, 200);
    2.

Jsop响应

 
   
   
 
    
  
    
    
  
  1. response()->json(['name' => 'Abigail', 'state' => 'CA']);
    2.

Jsonp响应

 
   
   
 
    
  
    
    
  
  1. response()->json(['name' => 'Abigail', 'state' => 'CA'])->withCallback($request->input('callback'));
    2.

文件响应直接在浏览器显示文件，而不是下载，例如图片或 PDF； file方法第一参数为文件路径，第二参数选填为头信息数组；

 
   
   
 
    
  
    
    
  
  1. response()->file($pathToFile, $headers); 
    2.

文件下载 download方法第一参数为文件路径，第二参数选填为文件名，第三参数选填为头信息数组；

 
   
   
 
    
  
    
    
  
  1. return response()->download($pathToFile, $name, $headers);
    2.
跳转

这里的跳转方法，其实调用的还是跳转器中的方法，不过是在暴露更多的接口，方便调用与使用；

方法名 调用 实际调用的是跳转器中的哪个方法
redirectTo response()->redirectTo(...) to方法
redirectToRoute response()->redirectToRoute(...) route方法
redirectToAction response()->redirectToAction(...) action方法
redirectGuest response()->redirectGuest(...) guest方法
redirectToIntended response()->redirectToIntended(...) intended方法

相关讲堂推荐



以上是关于Laravel 大将之路由模块的主要内容，如果未能解决你的问题，请参考以下文章

如何从 Laravel 5 的模块/目录中获取路由列表？

laravel5.5学习2-路由系统

laravel新创建的模块路由无法访问

在 laravel 7 路由中找不到句柄模块

Laravel 8 视图不更新路由

laravel路由之分组路由