Laravel学习教程之路由模块

站长资源 2024/11/16 佚名

21 1538 21

相思资源网 Design By www.200059.com

前言

本文主要给大家介绍的是关于Laravel路由模块的相关内容，分享出来供大家参考学习，下面话不多说了，来一起看看详细的介绍吧。

备注：本文是基于Laravel 5.4版本的路由模块代码进行分析书写；

模块组成

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

剖析

服务提供者

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

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

路由管理

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

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方法如下

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

这时候，项目就会执行很多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方法，在这个方法中，请求会执行以下语句

$this->router->dispatch($request)

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

public function dispatch(Request $request) {
 $this->currentRequest = $request;
 return $this->dispatchToRoute($request);
}

public function dispatchToRoute(Request $request) {
 // 根据请求的 url 找到匹配的路由
 $route = $this->findRoute($request);
 // 将路由绑定到请求上
 $request->setRouteResolver(function () use ($route) {
 return $route;
 }
 // 触发 RouteMatched 事件
 $this->events->dispatch(new Events\RouteMatched($route, $request));
 // 通过 Pipeline 流水线执行路由上绑定的中间件及对应的方法
 $response = $this->runRouteWithinStack($route, $request);
 // 根据 request 请求设置 response 的响应头
 return $this->prepareResponse($request, $response);
}

1、根据请求找匹配的路由

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

2、将路由绑定到请求上

3、触发RouteMatched事件

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

4、通过 Pipeline 流水线执行路由上绑定的中间件及对应的方法

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

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

项目中会用到的一些方法

获取路由集合 app('router')->getRoutes()
获取当前的请求 $request = app('router')->getCurrentRequest()
获取当前请求所对应的路由 $route = $request->route() 或 $route = app('router')->getCurrentRoute()
获取当前路由需要执行的中间件 $middlewares = app('router')->gatherRouteMiddleware($route)

Url 生成器

Url 生成器是什么？

举个例子，

$url = new UrlGenerator(
 $routes = new RouteCollection,
 $request = Request::create('http://www.foo.com/')
);

$url->to('foo/bar'); // 输出 http://www.foo.com/foo/bar

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

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

列一些常用的使用：

根据路径名生成

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

// 路径名是 foo/bar，当前请求的根路径为 http://www.foo.com，所以输出是 http://www.foo.com/foo/bar
$url->to('foo/bar')
// 路径名是 foo/bar，当前请求的根路径为 http://www.foo.com，第三个参数决定 scheme 是 https，所以输出是 https://www.foo.com/foo/bar
$url->to('foo/bar', [], true)
// 路径名是 foo/bar，第二个参数 是补充路径名，implode 后是 /baz/boom
// 第三个参数决定 scheme 是 https，所以输出是 https://www.foo.com/foo/bar/baz/boom
$url->to('foo/bar', ['baz', 'boom'], true)
// 路径名是 foo/bar，查询参数是 "htmlcode">

$route = new Route(['GET'], 'foo/bar', ['as' => 'foo']);
$routes->add($route);

// 输出 'http://www.foo.com/foo/bar
$url->route('foo');

// 第三个参数为 false，表示不显示根目录，于是输出 /foo/bar
$url->route('foo', [], false)

// 路由中的 url 本身不带参数，则第二参数中所有关联数组都将作为查询参数
// 输出 /foo/bar"htmlcode">

$route = new Route(['GET'], 'foo/bar/{baz}/breeze/{boom}', ['as' => 'bar']);
$routes->add($route);

// 路由上的 url 带参数，根据参数名找值；剩余多余的为查询参数；
// 输出 http://www.foo.com/foo/bar/otwell/breeze/taylor"htmlcode">

$route = new Route(['GET'], 'foo/bam', ['controller' => 'foo@bar']);
$routes->add($route);

// 输出 http://www.foo.com/foo/bam
$url->action('foo@bar');




$route = new Route(['GET'], 'foo/invoke', ['controller' => 'InvokableActionStub']);
$routes->add($route);

// 输出 http://www.foo.com/foo/invoke
$url->action('InvokableActionStub');


设置全局默认参数




$url->defaults(['locale' => 'en']);

$route = new Route(['GET'], 'foo', ['as' => 'defaults', 'domain' => '{locale}.example.com', function() {}]);

// 路由 url 有参数，但没有传参数值，则会找全局默认参数值；输出 http://en.example.com/foo
$url->route('defaults');


设置全局命名空间


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


// 设置全局命名空间
$url->setRootControllerNamespace('namespace');

// 配置添加路由
$route = new Route(['GET'], 'foo/bar', ['controller' => 'namespace\foo@bar']);
$routes->add($route);
$route = new Route(['GET'], 'foo/invoke', ['controller' => 'namespace\InvokableActionStub']);
$routes->add($route);

// 输出 http://www.foo.com/foo/bar; action 的值省略 namespace 这个命名空间
$url->action('foo@bar');
// 输出 http://www.foo.com/foo/invoke; action 的值省略 namespace 这个命名空间
$url->action('InvokableActionStub');

// 配置添加路由
$route = new Route(['GET'], 'something/else', ['controller' => 'something\foo@bar']);
$routes->add($route);

// 输出 http://www.foo.com/something/else； action 的最前面加了 `\`，全局命名空间下调用
$url->action('\something\foo@bar')；


跳转器


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


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


public function home($status = 302)


back


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


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


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


if ($url) {
  return $url;
} elseif ($fallback) {
 return $this->to($fallback);
} else {
 return $this->to('/');
}


refresh


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


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


to


通过调用app('redirect')->to('path')会跳转至指定路径页面；或者全局帮助函数redirect('path')也可以；
这里的 path 路径是不包含根目录的，例如（foo/bar）；


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


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


通过调用app('redirect')->away('path')会跳转至指定路径页面；
这里的 path 路径是包含根目录的，例如（http://xx.com/foo/bar）；


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


secure


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


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


其本质是调用了to方法


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


route


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


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


action


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


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


guest


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


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


intended


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


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


响应工厂（ResponseFactory）


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


response()会返回ResponseFactory实例；
视图响应


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


Jsop响应


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


Jsonp响应


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


文件响应


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


response()->file($pathToFile, $headers);


文件下载


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


return response()->download($pathToFile, $name, $headers);


跳转


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


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


总结
以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流，谢谢大家对的支持。

                                
                                
                                    laravel路由绑定模块,laravel5.3,路由,laravel,路由管理 
                                
                                    标签：
                                        laravel路由绑定模块,laravel5.3,路由,laravel,路由管理
                                     

                                相思资源网 Design By www.200059.com

广告合作：本站广告合作请联系QQ：858582 申请时备注：广告合作（否则不回）
免责声明：本站文章均来自网站采集或用户投稿，网站不提供任何软件下载或自行开发的软件！如有用户或公司发现本站内容信息存在侵权行为，请邮件告知！ 858582#qq.com

相思资源网 Design By www.200059.com

评论“Laravel学习教程之路由模块”

暂无Laravel学习教程之路由模块的评论...

www.200059.com 相思资源网

139,976影音资源

144,792福利资源

21,817软件资源

631,128技术资源

RTX 5090要首发性能要翻倍！三星展示GDDR7显存

三星在GTC上展示了专为下一代游戏GPU设计的GDDR7内存。

首次推出的GDDR7内存模块密度为16GB，每个模块容量为2GB。其速度预设为32 Gbps（PAM3），但也可以降至28 Gbps，以提高产量和初始阶段的整体性能和成本效益。
据三星表示，GDDR7内存的能效将提高20%，同时工作电压仅为1.1V，低于标准的1.2V。通过采用更新的封装材料和优化的电路设计，使得在高速运行时的发热量降低，GDDR7的热阻比GDDR6降低了70%。

Laravel学习教程之路由模块

laravel路由绑定模块,laravel5.3,路由,laravel,路由管理

PDO操作MySQL的基础教程(推荐)

Django中的cookie与session操作实例代码

评论“Laravel学习教程之路由模块”

RTX 5090要首发性能要翻倍！三星展示GDDR7显存

友情链接

Laravel学习教程之路由模块

laravel路由绑定模块,laravel5.3,路由,laravel,路由管理

PDO操作MySQL的基础教程(推荐)

Django中的cookie与session操作实例代码

评论“Laravel学习教程之路由模块”

RTX 5090要首发 性能要翻倍！三星展示GDDR7显存

友情链接

RTX 5090要首发性能要翻倍！三星展示GDDR7显存