php实现路由功能 Laravel 56 文档 基本组件 路由

这是一篇最重量级的文档了，laravel只有一个入口，如何用好路由，将给你的系统带来极大的灵巧与方便。

【文章转自laravel学院】

最基本的 Laravel 路由只吸收一个 URI 和一个闭包，并以此为根本供应一个非常大略优雅的路由定义方法：

Route::get('hello', function () { return 'Hello, Welcome to LaravelAcademy.org';});

我们以在安装配置文档中新建的 blog 运用为例，在 routes/web.php 中定义该路由：



在浏览器中通过 http://blog.test/hello （我利用 Valet 作为开拓环境，故而对应域名是 blog.test，实际域名以自己配置的为准）即可访问我们刚刚定义的路由，页面输出内容如下：

Hello, welcome to LaravelAcademy.org

默认路由文件

所有 Laravel 路由都定义在位于 routes 目录下的路由文件中，这些文件通过框架自动加载，相应逻辑位于 app/Providers/RouteServiceProvider 类。
routes/web.php 文件定义了 Web 界面的路由，这些路由被分配到了 web 中间件组，从而可以利用 Session 和 CSRF 保护等功能。
routes/api.php 中的路由是无状态的，这是由于被分配到了 api 中间件组。

对大多数运用而言，都是从 routes/web.php 文件开始定义路由。
定义在 routes/web.php 中的路由可以通过在浏览器地址栏输入相应的 URL 进行访问，例如，你可以通过 http://blog.test/user 访问下面的路由：

Route::get('/user', 'UsersController@index');

正如前面所提到的，定义在 routes/api.php 文件中的路由通过 app/Providers/RouteServiceProvider 的处理被嵌套在一个路由群组中， 在这个群组中，所有路由会被自动添加 /api 前缀，以是你不须要再到路由文件中为每个路由手动添加，你可以通过编辑 RouteServiceProvider 类来修正途由前缀以及其他的路由群组选项：



有效的路由方法

我们可以注册路由来相应任何 HTTP 要求动作：

Route::get($uri, $callback);Route::post($uri, $callback);Route::put($uri, $callback);Route::patch($uri, $callback);Route::delete($uri, $callback);Route::options($uri, $callback);

有时候还须要注册一个路由相应多种 HTTP 要求动作 —— 这可以通过 match 方法来实现。
或者，可以利用 any 方法注册一个路由来相应所有 HTTP 要求动作：

Route::match(['get', 'post'], 'foo', function () { return 'This is a request from get or post';});Route::any('bar', function () { return 'This is a request from any HTTP verb';});

测试 GET 要求的时候直接在浏览器中输入要求地址即可，测试 POST 要求可以通过客户端工具，比如 Advanced REST Client，该工具可以在 Chrome 运用商店下载到，此外如果上面的路由是定义在 routes/web.php 的话，在测试 POST 要求之前，须要将对应路由取消 CSRF 保护检讨，否则会返回 419 状态码导致无法要求成功，取消的方法是在 app/Http/Middleware/VerifyCsrfToken 中设置打消检讨路由：



下面我们来测试下 POST 要求：



如果路由是定义在 routes/api.php 的话，则无需关注 CSRF 保护问题，比如我们在 routes/api.php 定义 bar 路由，并且在 VerifyCsrfToken 的 $except 属性数组中移除 bar，然后我们测试下对 http://blog.test 的 POST 要求：

正如我们所预测的，完备没有任何问题，背后的缘故原由是由于 web 路由文件中定义的路由都位于 web 中间件群组，该群组默认启用 CSRF 保护检讨，而 api 路由文件位于 api 路由群组，该群组下的路由紧张用于 第三方 API 要求，没办法进行 CSRF 检讨，以是不须要做任何处理。

CSRF 保护

在 routes/web.php 路由文件中所有要求办法为 PUT、POST 或 DELETE 的路由对应的 HTML 表单都必须包含一个 CSRF 令牌字段，否则，要求会被谢绝。
关于 CSRF 的更多细节，可以参考 CSRF文档：

<form method=\"大众POST\"大众 action=\公众/profile\"大众> {{ csrf_field() }} ...</form>

还是以上面的 foo 路由为例，如果我们不在 VerifyCsrfToken 中间件中打消对它的检讨（事实上，这样的操作也不屈安），那么就须要在表单提交中带上 csrf_token 字段：



这样，当我们访问 http://blog.test/form 然后在页面点击提交按钮后，页面会跳转到 http://blog.test/foo 并显示如下内容：

This is a request from get or post

路由重定向

如果你须要定义一个重定向到其他 URI 的路由，可以利用 Route::redirect 方法，该方法非常方便，以至于你不须要再定义额外的路由或掌握器来实行大略的重定向逻辑：

Route::redirect('/here', '/there', 301);

个中 here 表示原路由，there 表示重定向之后的路由，301 是一个 HTTP 状态码，用于标识重定向。

路由视图

如果你的路由须要返回一个视图，可以利用 Route::view 方法，和 redirect 方法类似，这个方法也很方便，以至于你不须要在额外定义一个路由或掌握器。

view 方法吸收一个 URI 作为第一个参数，以及一个视图名称作为第二个参数，此外，你还可以供应一个数组数据通报到该视图方法作为可选的第三个参数，该数组数据可用于视图中的数据渲染：

Route::view('/welcome', 'welcome');Route::view('/welcome', 'welcome', ['name' => '学院君']);

我们在 routes/web.php 定义一个路由视图如下：



为了担保可以共用 welcome.blade.php 这个视图文件，我们也对默认供应的 / 路由做了调度，接下来，我们须要修正 resources/views/welcome.blade.php 代码以支持 website 数据变量：



我们将原来写去世的 Laravel 文本调度为支持变量传入的办法，这样，我们就可以在浏览器中通过 http://blog.test/view 访问路由视图了：



必选参数

有时我们须要在路由中获取 URI 要求参数。
例如，如果要从 URL 中获取用户ID，须要通过如下办法定义路由参数：

Route::get('user/{id}', function ($id) { return 'User ' . $id;});

这样我们在浏览器中访问 http://blog.test/user/1，就会得到以下输出：

User 1

可以根据须要在路由中定义多个路由参数：

Route::get('posts/{post}/comments/{comment}', function ($postId, $commentId) { return $postId . '-' . $commentId;});

根据上面的示例，路由参数须要通过花括号 {} 进行包裹并且是拼音字母，这些参数在路由被实行时会被通报到路由的闭包。
路由参数名称不能包含 - 字符，如果须要的话可以利用 _ 替代，比如如果某个路由参数定义成 {post-id} 则访问路由会报错，该当修正成 {post_id} 才行。
路由参数被注入到路由回调/掌握器取决于它们的顺序，与回调/掌握器名称无关。

可选参数

有必选参数就有可选参数，这可以通过在参数名后加一个 ? 标记来实现，这种情形下须要给相应的变量指定默认值，当对应的路由参数为空时，利用默认值：

Route::get('user/{name?}', function ($name = null) { return $name;});Route::get('user/{name?}', function ($name = 'John') { return $name;});

这时如果定义的路由是下面这个的话，访问 http://blog.test/user 会返回 John。

正则约束

可以通过路由实例上的where方法来约束路由参数的格式。
where方法吸收参数名和一个正则表达式来定义该参数如何被约束：

Route::get('user/{name}', function ($name) { // $name 必须是字母且不能为空})->where('name', '[A-Za-z]+');Route::get('user/{id}', function ($id) { // $id 必须是数字})->where('id', '[0-9]+');Route::get('user/{id}/{name}', function ($id, $name) { // 同时指定 id 和 name 的数据格式})->where(['id' => '[0-9]+', 'name' => '[a-z]+']);

利用正则约束还有一个好处便是避免了user/{id}和user/{name}的稠浊。

全局约束

如果想要路由参数在全局范围内被给定正则表达式约束，可以利用pattern方法。
须要在RouteServiceProvider 类的boot方法中定义这种约束模式：

/ 定义路由模型绑定，模式过滤器等 @param \Illuminate\Routing\Router $router @return void @translator http://laravelacademy.org/public function boot(){ Route::pattern('id', '[0-9]+'); parent::boot();}

一旦模式被定义，将会自动运用到所有包含该参数名的路由中：

Route::get('user/{id}', function ($id) { // 只有当 {id} 是数字时才会被调用});

除此之外，该模式还会被运用到诸如下面这些路由参数上：

Route::get('post/{id}', function ($id) { // 只有当 {id} 是数字时才会被调用});Route::get(`product/{id}', function ($id) { // 只有当 {id} 是数字时才会被调用});

很显然这种办法让代码更简洁，也为我们实现同一参数统一约束带来了方便。

命名路由

命名路由为天生 URL 或重定向供应了方便，实现起来也很大略，在路由定义之后利用name方法链的办法来定义该路由的名称：

Route::get('user/profile', function () { // 通过路由名称天生 URL return 'my url: ' . route('profile');})->name('profile');

还可以为掌握器动作指定路由名称：

Route::get('user/profile', 'UserController@showProfile')->name('profile');

这样我们就可以通过以下办法定义重定向：

Route::get('redirect', function() { // 通过路由名称进行重定向 return redirect()->route('profile');});

为命名路由天生 URL

正如上面代码所展示的，为给定路由分配名称之后，就可以通过赞助函数route为该命名路由天生 URL 或者通过redirect函数进行重定向：

// 天生URL$url = route('profile');// 天生重定向return redirect()->route('profile');

如果命名路由定义了参数，可以将该参数作为第二个参数通报给route函数。
给定的路由参数将会自动插入到 URL 中：

Route::get('user/{id}/profile', function ($id) { $url = route('profile', ['id' => 1]); return $url;})->name('profile');

这样，当我们访问http://blog.test/user/123/profile页面输出内容也是http://blog.test/user/123/profile。

检讨当前路由

如果你想要判断当前要求是否被路由到给定命名路由，可以利用 Route 实例上的named方法，例如，你可以从路由中间件中检讨当前路由名称：

/ 处理输入要求 @param \Illuminate\Http\Request $request @param \Closure $next @return mixed/public function handle($request, Closure $next){ if ($request->route()->named('profile')) { // } return $next($request);}路由分组

路由分组的目的是让我们在多个路由中共享相同的路由属性，比如中间件和命名空间等，这样的话我们定义了大量的路由时就不必为每一个路由单独定义属性。
共享属性以数组的形式作为第一个参数被通报给Route::group方法。

中间件

要给某个路由分组中定义的所有路由分配中间件，可以在定义分组之前利用middleware方法。
中间件将会按照数组中定义的顺序依次实行：

Route::middleware(['first', 'second'])->group(function () { Route::get('/', function () { // Uses first & second Middleware }); Route::get('user/profile', function () { // Uses first & second Middleware });});

关于中间件的利用我们在后面单独讲中间件时再进行示例演示，这里我们先理解这样利用就行。

命名空间

路由分组另一个通用的例子是利用namespace方法分配同一个 PHP 命名空间给该分组下的多个掌握器：

Route::namespace('Admin')->group(function () { // Controllers Within The \"大众App\Http\Controllers\Admin\公众 Namespace});

默认情形下，RouteServiceProvider在一个命名空间分组下引入所有路由文件，并指定所有掌握器类所在的默认命名空间是App\Http\Controllers，因此，我们在定义掌握器的时候只须要定命名空间App\Http\Controllers之后的部分即可。

关于命名空间后面我们单独讲掌握器的时候还会再详细演示，这里先理解用法即可。

子域名路由

路由分组还可以被用于处理子域名路由，子域名可以像 URI 一样被分配给路由参数，从而许可捕获子域名的部分用于路由或者掌握器，子域名可以在定义分组之前调用domain方法来指定：

Route::domain('{account}.blog.dev')->group(function () { Route::get('user/{id}', function ($account, $id) { return 'This is ' . $account . ' page of User ' . $id; });});

比如我们设置会员子域名为account.blog.test，那么就可以通过 http://account.blog.test/user/1 访问用户ID为1的会员信息了：

This is account page of User 1

路由前缀

prefix方法可以用来为分组中每个路由添加一个给定 URI 前缀，例如，你可以为分组中所有路由 URI 添加admin前缀 ：

Route::prefix('admin')->group(function () { Route::get('users', function () { // Matches The \"大众/admin/users\"大众 URL });});

这样我们就可以通过http://blog.test/admin/users访问路由了。

路由名称前缀

name方法可通过传入字符串为分组中的每个路由名称设置前缀，例如，你可能想要在所有分组路由的名称前添加admin前缀，由于给定字符串和指定路由名称前缀字符串完备一样，以是须要在前缀字符串末端后加上.字符：

Route::name('admin.')->group(function () { Route::get('users', function () { // 新的路由名称为 \"大众admin.users\公众... })->name('users');});路由模型绑定

注入模型 ID 到路由或掌握器动作时，常日须要查询数据库才能获取相应的模型数据。
Laravel 路由模型绑定让注入模型实例到路由变得大略，例如，你可以将匹配给定 ID 的全体User类实例注入到路由中，而不但是注入用户 ID。

隐式绑定

Laravel 会自动解析定义在路由或掌握器动作（变量名匹配路由片段）中的 Eloquent 模型类型声明，例如（我们将这个路由定义在routes/api.php文件中）：

Route::get('users/{user}', function (App\User $user) { return $user->email;});

在这个例子中，由于类型声明了 Eloquent 模型App\User，对应的变量名$user会匹配路由片段中的{user}，这样，Laravel 会自动注入与要求 URI 中传入的 ID 对应的用户模型实例。
如果匹配模型实例在数据库中不存在，会自动天生 404 相应。

在演示本功能之前，我们须要先创建数据表，由于我是在 Valet 开拓环境中开拓，须要自己创建数据库，我们将数据库命名为valet，本地的数据库用户名为root，密码为空，对应地，修正.env文件配置如下：

DB_CONNECTION=mysqlDB_HOST=127.0.0.1DB_PORT=3306DB_DATABASE=valetDB_USERNAME=rootDB_PASSWORD=

详细配置值以你自己的开拓环境设置为准。
我们将基于 Laravel 强大的数据库迁移功能创建users表，关于数据库迁移后面在数据库部分会详细谈论，这里我们通过以下命令来天生users表即可：

php artisan migrate

进入数据库可以看到该表已经天生：



这时，users数据表还没有任何记录，如果数据库中找不到对应的模型实例，会自动天生 HTTP 404 相应，提示页面不存在，以是我们须要在这张表中插入一条记录，这里我们基于 Laravel 强大的数据库添补器来快速完成数据添补功能，首先通过如下命令天生users对应的数据表添补器：

php artisan make:seeder UsersTableSeeder

该命令会在database/seeds目录下天生一个UsersTableSeeder文件，编辑该文件内容如下：

然后编辑同目录下的DatabaseSeeder.php文件如下（取消调用数据表添补器前的注释）：



末了实行php artisan db:seed即可插入对应数据到users表了，这样我们在浏览器中再次访问 http://blog.test/api/users/1 的时候就会显示User模型数据了：



接下来，你就可以在运用代码中直接拿$user模型去做你想做的事情了，而不须要自己去数据库查询，从而提高了开拓的效率。

自定义键名

如果你想要在隐式模型绑定中利用数据表的其它字段而不是id字段，可以重写 Eloquent 模型类的getRouteKeyName方法，以User模型为例，可以在该模型类中添加这个方法 ：

/ Get the route key for the model. @return string/public function getRouteKeyName(){ return 'name';}

这样我们就可以通过http://blog.test/api/users/jroJoGP71W访问同一个模型实例了。
这里须要把稳的点是如果该字段不是唯一键，则会返回结果集的第一条记录，对应的底层实现在这里：

显式绑定

有隐式绑定，就有显式绑定。
要注册显式绑定，可以利用路由器的model方法来为给定参数指定绑定类。
你须要在 RouteServiceProvider类的boot方法中定义显式模型绑定：

public function boot(){ parent::boot(); Route::model('user_model', App\User::class);}

接下来，在routes/api.php中定义一个包含{user}参数的路由：

$router->get('profile/{user_model}', function(App\User $user) { dd($user);});

由于我们已经绑定{user_model}参数到App\User模型，User实例会被注入到该路由。
因此，如果要求 URL 是http://blog.test/api/profile/1，就会注入一个用户 ID 为1的User实例。

如果匹配的模型实例在数据库不存在，会自动天生并返回 HTTP 404 相应。

自定义解析逻辑

如果你想要利用自定义的解析逻辑，可以在RouteServiceProvider类的boot方法中利用Route::bind方法，通报到bind 方法的闭包会获取到 URI 要求参数中的值，并且返回你想要在该路由中注入的类实例：

public function boot(){ parent::boot(); Route::bind('user', function($value) { return App\User::where('name', $value)->first() ?? abort(404); });}

有了这些方法，基本上可以知足你对路由模型绑定的各种需求了。

Laravel 自带了一个中间件用于限定对运用路由的访问频率。
开始利用该功能之前，分配throttle中间件到某个路由或路由分组，throttle中间件吸收两个参数用于判断给定时间内（单位：分钟）的最大要求次数。
例如，我们指定登任命户每分钟只能访问下面的分组路由 60 次：

Route::middleware('auth:api', 'throttle:60,1')->group(function () { Route::get('/user', function () { // });});

超出访问次数后，会返回429状态码并提示”Too many requests”。

动态频率限定

此外，还可以基于User模型的属性来动态设置最大要求次数。
例如，如果User模型包含rate_limit属性，就可以将其这个属性名通报到throttle中间件，这样就可以将属性值作为打算最大要求次数的数据来源：

Route::middleware('auth:api', 'throttle:rate_limit,1')->group(function () { Route::get('/user', function () { // });});表单方法假造

HTML 表单不支持PUT、PATCH或者DELETE要求方法，因此，在 HTML 表单中调用PUT、PATCH或DELETE路由时，须要添加一个隐蔽的_method字段，其值被用作该表单的 HTTP 要求方法：

<form action=\"大众/foo/bar\"大众 method=\"大众POST\公众> <input type=\"大众hidden\"大众 name=\"大众_method\"大众 value=\"大众PUT\"大众> <input type=\"大众hidden\"大众 name=\"大众_token\公众 value=\"大众{{ csrf_token() }}\"大众></form>

还可以直策应用 Blade 指令@method来天生_method字段：

<form action=\"大众/foo/bar\"大众 method=\"大众POST\"大众> @method('PUT') @csrf</form>访问当前路由

你可以利用Route门面上的current、currentRouteName和currentRouteAction方法来访问处理当前输入要求的路由信息：

// 获取当前路由实例$route = Route::current();// 获取当前路由名称$name = Route::currentRouteName();// 获取当前路由action属性$action = Route::currentRouteAction();

参考API文档理解路由门面底层类以及Route实例的更多可用方法。