1、路由命名——给路由起个名字
1.1 基本使用
我们使用as
关键字来为路由命名:
Route::get('/hello/Laravel',['as'=>'academy',function(){
return 'Hello Laravel!';
}]);
路由命名可以让我们在使用route
函数生成指向该路由的URL或者生成跳转到该路由的重定向链接时更加方便:
Route::get('/testNamedRoute',function(){
return route('academy');
});
我们在浏览器中访问http://laravel.app:8000/testNamedRoute
时输出http://laravel.app:8000/hello/Laravel
,然后我们修改上述闭包内代码:
Route::get('/testNamedRoute',function(){
return redirect()->route('academy');
});
再次在浏览器中访问http://laravel.app:8000/testNamedRoute
时会跳转到http://laravel.app:8000/hello/Laravel
。
我们甚至还可以在使用带参数的路由命名:
Route::get('/hello/Laravel/{id}',['as'=>'academy',function($id){
return 'Hello Laravel '.$id.'!';
}]);
对应的测试路由定义如下:
Route::get('/testNamedRoute',function(){
return redirect()->route('academy',['id'=>1]);
});
这样,当我们在浏览器中访问http://laravel.app:8000/testNamedRoute
时会跳转到http://laravel.app:8000/hello/Laravel/1
1.2 路由分组时路由命名方式
再来看一个更复杂的例子,使用路由分组时如何定义路由命名?官网文档提供的例子如下:
Route::group(['as' => 'admin::'], function () {
Route::get('dashboard', ['as' => 'dashboard', function () {
//
}]);
});
在Route
门面的group
方法中使用一个as关键字来指定该路由群组中所有路由的公共前缀,然后再在里面每个路由中使用as
关键字为该路由命名。
这样我们可以通过如下方式来生成该路由URL:
Route::get('/testNamedRoute',function(){
return route('admin::dashboard');
});
2、路由分组
路由分组就是将一组拥有相同属性(中间件、命名空间、子域名、路由前缀等)的路由使用Route
门面的group
方法聚合起来。
2.1 中间件
首先我们在应用根目录下运行如下Artisan命令生成一个测试用的中间件TestMiddleware
:
php artisan make:middleware TestMiddleware
这样会在/app/Http/Middleware
目录下生成一个TestMiddleware.php
文件,打开该文件编辑TestMiddleware
类的handle
方法如下:
public function handle($request, Closure $next)
{
if($request->input('age')<18)
return redirect()->route('refuse');
return $next($request);
}
我们在中间件中定义这段业务逻辑的目的是年龄18岁以下的未成年人不能访问。
然后我们打开/app/Http/Kernal.php
文件,新增TestMiddleware
到Kernel
的$routeMiddleware
属性:
protected $routeMiddleware = [
'auth' => \App\Http\Middleware\Authenticate::class,
'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
'test' => \App\Http\Middleware\TestMiddleware::class,
];
接下来我们在routes.php
中定义路由如下:
Route::group(['middleware'=>'test'],function(){
Route::get('/write/Laravel',function(){
//使用Test中间件
});
Route::get('/update/Laravel',function(){
//使用Test中间件
});
}); Route::get('/age/refuse',['as'=>'refuse',function(){
return "未成年人禁止入内!";
}]);
这样当我们在浏览器中访问http://laravel.app:8000/write/Laravel?age=15
或者http://laravel.app:8000/update/Laravel?age=15
时就会跳转到http://laravel.app:8000/age/refuse
,并显示:
未成年人禁止入内!
2.2 命名空间
默认情况下,routes.php
中的定义的控制器位于App\Http\Controllers
命名空间下,所以如果要指定命名空间,只需指定App\Http\Controllers
之后的部分即可:
Route::group(['namespace' => 'Laravel'], function(){
// 控制器在 "App\Http\Controllers\Laravel" 命名空间下 Route::group(['namespace' => 'DOCS'], function()
{
// 控制器在 "App\Http\Controllers\Laravel\DOCS" 命名空间下
});
});
2.3 子域名
子域名可以通过domain
关键字来设置:
Route::group(['domain'=>'{service}.laravel.app'],function(){
Route::get('/write/Laravel',function($service){
return "Write FROM {$service}.laravel.app";
});
Route::get('/update/Laravel',function($service){
return "Update FROM {$service}.laravel.app";
});
});
这样我们在浏览器中访问http://write.laravel.app:8000/write/Laravel
,则输出
Write FROM write.laravel.app
访问http://update.laravel.app:8000/write/Laravel
时,则输出:
Write FROM update.laravel.app
注意:要想让子域名解析生效,需要在hosts中绑定IP地址
2.4 路由前缀
如果路由群组中的所有路由包含统一前缀,则我们可以通过在group
方法中设置prefix
属性来指定该前缀:
Route::group(['prefix'=>'Laravel'],function(){
Route::get('write',function(){
return "Write Laravel";
});
Route::get('update',function(){
return "Update Laravel";
});
});
这样我们就可以通过http://laravel.app:8000/Laravel/write
或者http://laravel.app:8000/Laravel/update
来访问对应的操作。
我们甚至还可以在路由前缀中指定参数:
Route::group(['prefix'=>'Laravel/{version}'],function(){
Route::get('write',function($version){
return "Write Laravel {$version}";
});
Route::get('update',function($version){
return "Update Laravel {$version}";
});
});
这样我们在浏览器中访问http://laravel.app:8000/Laravel/5.1/write
,则对应会输出:
Write Laravel 5.1