這篇文章將為大家詳細講解有關laravel路由指的是什么,小編覺得挺實用的,因此分享給大家做個參考,希望大家閱讀完這篇文章后可以有所收獲。

成都創(chuàng)新互聯(lián)公司長期為上1000家客戶提供的網(wǎng)站建設服務,團隊從業(yè)經(jīng)驗10年,關注不同地域、不同群體,并針對不同對象提供差異化的產(chǎn)品和服務;打造開放共贏平臺,與合作伙伴共同營造健康的互聯(lián)網(wǎng)生態(tài)環(huán)境。為錫林浩特企業(yè)提供專業(yè)的成都網(wǎng)站建設、網(wǎng)站制作,錫林浩特網(wǎng)站改版等技術服務。擁有10余年豐富建站經(jīng)驗和眾多成功案例,為您定制開發(fā)。
在laravel中,路由是外界訪問Laravel應用程序的通路,或者說路由定義了Laravel的應用程序向外界提供服務的具體方式。路由會將用戶的請求按照事先規(guī)劃的方案提交給指定的控制器和方法來進行處理。
本教程操作環(huán)境:windows7系統(tǒng)、Laravel6版,DELL G3電腦。
路由是外界訪問Laravel應用程序的通路或者說路由定義了Laravel的應用程序向外界提供服務的具體方式:通過指定的URI、HTTP請求方法以及路由參數(shù)(可選)才能正確訪問到路由定義的處理程序。
無論URI對應的處理程序是一個簡單的閉包還是說是控制器方法沒有對應的路由外界都訪問不到他們
今天我們就來看看Laravel是如何來設計和實現(xiàn)路由的。
我們在路由文件里通常是向下面這樣來定義路由的:
Route::get('/user', 'UsersController@index');通過上面的路由我們可以知道,客戶端通過以HTTP GET方式來請求 URI "/user"時,Laravel會把請求最終派發(fā)給UsersController類的index方法來進行處理,然后在index方法中返回響應給客戶端。
上面注冊路由時用到的Route類在Laravel里叫門面(Facade),它提供了一種簡單的方式來訪問綁定到服務容器里的服務router,F(xiàn)acade的設計理念和實現(xiàn)方式我打算以后單開博文來寫,在這里我們只要知道調(diào)用的Route這個門面的靜態(tài)方法都對應服務容器里router這個服務的方法,所以上面那條路由你也可以看成是這樣來注冊的:
app()->make('router')->get('user', 'UsersController@index');router這個服務是在實例化應用程序Application時在構造方法里通過注冊RoutingServiceProvider時綁定到服務容器里的:
//bootstrap/app.php
$app = new Illuminate\Foundation\Application(
realpath(__DIR__.'/../')
);
//Application: 構造方法
public function __construct($basePath = null)
{
if ($basePath) {
$this->setBasePath($basePath);
}
$this->registerBaseBindings();
$this->registerBaseServiceProviders();
$this->registerCoreContainerAliases();
}
//Application: 注冊基礎的服務提供器
protected function registerBaseServiceProviders()
{
$this->register(new EventServiceProvider($this));
$this->register(new LogServiceProvider($this));
$this->register(new RoutingServiceProvider($this));
}
//\Illuminate\Routing\RoutingServiceProvider: 綁定router到服務容器
protected function registerRouter()
{
$this->app->singleton('router', function ($app) {
return new Router($app['events'], $app);
});
}通過上面的代碼我們知道了Route調(diào)用的靜態(tài)方法都對應于\Illuminate\Routing\Router類里的方法,Router這個類里包含了與路由的注冊、尋址、調(diào)度相關的方法。
下面我們從路由的注冊、加載、尋址這幾個階段來看一下laravel里是如何實現(xiàn)這些的。
路由加載
注冊路由前需要先加載路由文件,路由文件的加載是在App\Providers\RouteServiceProvider這個服務器提供者的boot方法里加載的:
class RouteServiceProvider extends ServiceProvider
{
public function boot()
{
parent::boot();
}
public function map()
{
$this->mapApiRoutes();
$this->mapWebRoutes();
}
protected function mapWebRoutes()
{
Route::middleware('web')
->namespace($this->namespace)
->group(base_path('routes/web.php'));
}
protected function mapApiRoutes()
{
Route::prefix('api')
->middleware('api')
->namespace($this->namespace)
->group(base_path('routes/api.php'));
}
}namespace Illuminate\Foundation\Support\Providers;
class RouteServiceProvider extends ServiceProvider
{
public function boot()
{
$this->setRootControllerNamespace();
if ($this->app->routesAreCached()) {
$this->loadCachedRoutes();
} else {
$this->loadRoutes();
$this->app->booted(function () {
$this->app['router']->getRoutes()->refreshNameLookups();
$this->app['router']->getRoutes()->refreshActionLookups();
});
}
}
protected function loadCachedRoutes()
{
$this->app->booted(function () {
require $this->app->getCachedRoutesPath();
});
}
protected function loadRoutes()
{
if (method_exists($this, 'map')) {
$this->app->call([$this, 'map']);
}
}
}
class Application extends Container implements ApplicationContract, HttpKernelInterface
{
public function routesAreCached()
{
return $this['files']->exists($this->getCachedRoutesPath());
}
public function getCachedRoutesPath()
{
return $this->bootstrapPath().'/cache/routes.php';
}
}laravel 首先去尋找路由的緩存文件,沒有緩存文件再去進行加載路由。緩存文件一般在 bootstrap/cache/routes.php 文件中。
方法loadRoutes會調(diào)用map方法來加載路由文件里的路由,map這個函數(shù)在App\Providers\RouteServiceProvider類中,這個類繼承自Illuminate\Foundation\Support\Providers\RouteServiceProvider。通過map方法我們能看到laravel將路由分為兩個大組:api、web。這兩個部分的路由分別寫在兩個文件中:routes/web.php、routes/api.php。
Laravel5.5里是把路由分別放在了幾個文件里,之前的版本是在app/Http/routes.php文件里。放在多個文件里能更方便地管理API路由和與WEB路由
路由注冊
我們通常都是用Route這個Facade調(diào)用靜態(tài)方法get, post, head, options, put, patch, delete......等來注冊路由,上面我們也說了這些靜態(tài)方法其實是調(diào)用了Router類里的方法:
public function get($uri, $action = null)
{
return $this->addRoute(['GET', 'HEAD'], $uri, $action);
}
public function post($uri, $action = null)
{
return $this->addRoute('POST', $uri, $action);
}
....可以看到路由的注冊統(tǒng)一都是由router類的addRoute方法來處理的:
//注冊路由到RouteCollection
protected function addRoute($methods, $uri, $action)
{
return $this->routes->add($this->createRoute($methods, $uri, $action));
}
//創(chuàng)建路由
protected function createRoute($methods, $uri, $action)
{
if ($this->actionReferencesController($action)) {
//controller@action類型的路由在這里要進行轉(zhuǎn)換
$action = $this->convertToControllerAction($action);
}
$route = $this->newRoute(
$methods, $this->prefix($uri), $action
);
if ($this->hasGroupStack()) {
$this->mergeGroupAttributesIntoRoute($route);
}
$this->addWhereClausesToRoute($route);
return $route;
}
protected function convertToControllerAction($action)
{
if (is_string($action)) {
$action = ['uses' => $action];
}
if (! empty($this->groupStack)) {
$action['uses'] = $this->prependGroupNamespace($action['uses']);
}
$action['controller'] = $action['uses'];
return $action;
}注冊路由時傳遞給addRoute的第三個參數(shù)action可以閉包、字符串或者數(shù)組,數(shù)組就是類似['uses' => 'Controller@action', 'middleware' => '...']這種形式的。如果action是Controller@action類型的路由將被轉(zhuǎn)換為action數(shù)組, convertToControllerAction執(zhí)行完后action的內(nèi)容為:
[ 'uses' => 'App\Http\Controllers\SomeController@someAction', 'controller' => 'App\Http\Controllers\SomeController@someAction' ]
可以看到把命名空間補充到了控制器的名稱前組成了完整的控制器類名,action數(shù)組構建完成接下里就是創(chuàng)建路由了,創(chuàng)建路由即用指定的HTTP請求方法、URI字符串和action數(shù)組來創(chuàng)建\Illuminate\Routing\Route類的實例:
protected function newRoute($methods, $uri, $action)
{
return (new Route($methods, $uri, $action))
->setRouter($this)
->setContainer($this->container);
}路由創(chuàng)建完成后將Route添加到RouteCollection中去:
protected function addRoute($methods, $uri, $action)
{
return $this->routes->add($this->createRoute($methods, $uri, $action));
}router的$routes屬性就是一個RouteCollection對象,添加路由到RouteCollection對象時會更新RouteCollection對象的routes、allRoutes、nameList和actionList屬性
class RouteCollection implements Countable, IteratorAggregate
{
public function add(Route $route)
{
$this->addToCollections($route);
$this->addLookups($route);
return $route;
}
protected function addToCollections($route)
{
$domainAndUri = $route->getDomain().$route->uri();
foreach ($route->methods() as $method) {
$this->routes[$method][$domainAndUri] = $route;
}
$this->allRoutes[$method.$domainAndUri] = $route;
}
protected function addLookups($route)
{
$action = $route->getAction();
if (isset($action['as'])) {
//如果時命名路由,將route對象映射到以路由名為key的數(shù)組值中方便查找
$this->nameList[$action['as']] = $route;
}
if (isset($action['controller'])) {
$this->addToActionList($action, $route);
}
}
}RouteCollection的四個屬性
routes中存放了HTTP請求方法與路由對象的映射:
[ 'GET' => [ $routeUri1 => $routeObj1 ... ] ... ]
allRoutes屬性里存放的內(nèi)容時將routes屬性里的二位數(shù)組編程一位數(shù)組后的內(nèi)容:
[ 'GET' . $routeUri1 => $routeObj1 'GET' . $routeUri2 => $routeObj2 ... ]
nameList是路由名稱與路由對象的一個映射表
[ $routeName1 => $routeObj1 ... ]
actionList是路由控制器方法字符串與路由對象的映射表
[ 'App\Http\Controllers\ControllerOne@ActionOne' => $routeObj1 ]
這樣就算注冊好路由了。
路由尋址
中間件的文章里我們說過HTTP請求在經(jīng)過Pipeline通道上的中間件的前置操作后到達目的地:
//Illuminate\Foundation\Http\Kernel
class Kernel implements KernelContract
{
protected function sendRequestThroughRouter($request)
{
$this->app->instance('request', $request);
Facade::clearResolvedInstance('request');
$this->bootstrap();
return (new Pipeline($this->app))
->send($request)
->through($this->app->shouldSkipMiddleware() ? [] : $this->middleware)
->then($this->dispatchToRouter());
}
protected function dispatchToRouter()
{
return function ($request) {
$this->app->instance('request', $request);
return $this->router->dispatch($request);
};
}
}上面代碼可以看到Pipeline的destination就是dispatchToRouter函數(shù)返回的閉包:
$destination = function ($request) {
$this->app->instance('request', $request);
return $this->router->dispatch($request);
};在閉包里調(diào)用了router的dispatch方法,路由尋址就發(fā)生在dispatch的第一個階段findRoute里:
class Router implements RegistrarContract, BindingRegistrar
{
public function dispatch(Request $request)
{
$this->currentRequest = $request;
return $this->dispatchToRoute($request);
}
public function dispatchToRoute(Request $request)
{
return $this->runRoute($request, $this->findRoute($request));
}
protected function findRoute($request)
{
$this->current = $route = $this->routes->match($request);
$this->container->instance(Route::class, $route);
return $route;
}
}尋找路由的任務由 RouteCollection 負責,這個函數(shù)負責匹配路由,并且把 request 的 url 參數(shù)綁定到路由中:
class RouteCollection implements Countable, IteratorAggregate
{
public function match(Request $request)
{
$routes = $this->get($request->getMethod());
$route = $this->matchAgainstRoutes($routes, $request);
if (! is_null($route)) {
//找到匹配的路由后,將URI里的路徑參數(shù)綁定賦值給路由(如果有的話)
return $route->bind($request);
}
$others = $this->checkForAlternateVerbs($request);
if (count($others) > 0) {
return $this->getRouteForMethods($request, $others);
}
throw new NotFoundHttpException;
}
protected function matchAgainstRoutes(array $routes, $request, $includingMethod = true)
{
return Arr::first($routes, function ($value) use ($request, $includingMethod) {
return $value->matches($request, $includingMethod);
});
}
}
class Route
{
public function matches(Request $request, $includingMethod = true)
{
$this->compileRoute();
foreach ($this->getValidators() as $validator) {
if (! $includingMethod && $validator instanceof MethodValidator) {
continue;
}
if (! $validator->matches($this, $request)) {
return false;
}
}
return true;
}
}$routes = $this->get($request->getMethod());會先加載注冊路由階段在RouteCollection里生成的routes屬性里的值,routes中存放了HTTP請求方法與路由對象的映射。
然后依次調(diào)用這堆路由里路由對象的matches方法, matches方法, matches方法里會對HTTP請求對象進行一些驗證,驗證對應的Validator是:UriValidator、MethodValidator、SchemeValidator、HostValidator。
在驗證之前在$this->compileRoute()里會將路由的規(guī)則轉(zhuǎn)換成正則表達式。
UriValidator主要是看請求對象的URI是否與路由的正則規(guī)則匹配能匹配上:
class UriValidator implements ValidatorInterface
{
public function matches(Route $route, Request $request)
{
$path = $request->path() == '/' ? '/' : '/'.$request->path();
return preg_match($route->getCompiled()->getRegex(), rawurldecode($path));
}
}MethodValidator驗證請求方法, SchemeValidator驗證協(xié)議是否正確(http|https), HostValidator驗證域名, 如果路由中不設置host屬性,那么這個驗證不會進行。
一旦某個路由通過了全部的認證就將會被返回,接下來就要將請求對象URI里的路徑參數(shù)綁定賦值給路由參數(shù):
路由參數(shù)綁定
class Route
{
public function bind(Request $request)
{
$this->compileRoute();
$this->parameters = (new RouteParameterBinder($this))
->parameters($request);
return $this;
}
}
class RouteParameterBinder
{
public function parameters($request)
{
$parameters = $this->bindPathParameters($request);
if (! is_null($this->route->compiled->getHostRegex())) {
$parameters = $this->bindHostParameters(
$request, $parameters
);
}
return $this->replaceDefaults($parameters);
}
protected function bindPathParameters($request)
{
preg_match($this->route->compiled->getRegex(), '/'.$request->decodedPath(), $matches);
return $this->matchToKeys(array_slice($matches, 1));
}
protected function matchToKeys(array $matches)
{
if (empty($parameterNames = $this->route->parameterNames())) {
return [];
}
$parameters = array_intersect_key($matches, array_flip($parameterNames));
return array_filter($parameters, function ($value) {
return is_string($value) && strlen($value) > 0;
});
}
}賦值路由參數(shù)完成后路由尋址的過程就結束了,結下來就該運行通過匹配路由中對應的控制器方法返回響應對象了。
class Router implements RegistrarContract, BindingRegistrar
{
public function dispatch(Request $request)
{
$this->currentRequest = $request;
return $this->dispatchToRoute($request);
}
public function dispatchToRoute(Request $request)
{
return $this->runRoute($request, $this->findRoute($request));
}
protected function runRoute(Request $request, Route $route)
{
$request->setRouteResolver(function () use ($route) {
return $route;
});
$this->events->dispatch(new Events\RouteMatched($route, $request));
return $this->prepareResponse($request,
$this->runRouteWithinStack($route, $request)
);
}
protected function runRouteWithinStack(Route $route, Request $request)
{
$shouldSkipMiddleware = $this->container->bound('middleware.disable') &&
$this->container->make('middleware.disable') === true;
//收集路由和控制器里應用的中間件
$middleware = $shouldSkipMiddleware ? [] : $this->gatherRouteMiddleware($route);
return (new Pipeline($this->container))
->send($request)
->through($middleware)
->then(function ($request) use ($route) {
return $this->prepareResponse(
$request, $route->run()
);
});
}
}
namespace Illuminate\Routing;
class Route
{
public function run()
{
$this->container = $this->container ?: new Container;
try {
if ($this->isControllerAction()) {
return $this->runController();
}
return $this->runCallable();
} catch (HttpResponseException $e) {
return $e->getResponse();
}
}
}這里我們主要介紹路由相關的內(nèi)容,runRoute的過程通過上面的源碼可以看到其實也很復雜, 會收集路由和控制器里的中間件,將請求通過中間件過濾才會最終到達目的地路由,執(zhí)行目的路由地run()方法,里面會判斷路由對應的是一個控制器方法還是閉包然后進行相應地調(diào)用,最后把執(zhí)行結果包裝成Response對象返回給客戶端。這個過程還會涉及到我們以前介紹過的中間件過濾、服務解析、依賴注入方面的信息。
關于“l(fā)aravel路由指的是什么”這篇文章就分享到這里了,希望以上內(nèi)容可以對大家有一定的幫助,使各位可以學到更多知識,如果覺得文章不錯,請把它分享出去讓更多的人看到。
本文名稱:laravel路由指的是什么
轉(zhuǎn)載來于:http://chinadenli.net/article38/gdeisp.html
成都網(wǎng)站建設公司_創(chuàng)新互聯(lián),為您提供域名注冊、用戶體驗、外貿(mào)網(wǎng)站建設、網(wǎng)站建設、品牌網(wǎng)站制作、網(wǎng)站導航
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時需注明來源: 創(chuàng)新互聯(lián)