引言
上一章内容我们介绍了使用laravel路由动词定义方便的url,以及通过url参数绑定传递数据, 本文我们继续深入Route功能,学习一些提升生产力的方法,在现实场景中也非常实用。
“昵称”
如果你的应用程序路由条目可以达到300到500条,光是管理这些路由地址不重复,或者是浏览某些部分的路由, 都将是一件非常考验脑力的事儿。
有没有想过,能不能给路由起个名字,方便记忆,不用想着路由定义的多复杂,咱们直接用别名访问?laravel为我们考虑到了, 比如路由这样写:
代码语言:javascript复制Route::get('members/{id}', 'MembersController@show')->name('members.show');
这样定义之后在HTML文件内比如有 a 标签,或者 form 表单的 action,填url地址的时候,就可以使用laravel的助手函数,这样来写:
代码语言:javascript复制<a href="<?php echo route('members.show', ['id' => 14]); ?>">
这样使用起来,就好像记一个函数名一样,然后通过数组传入绑定的位置参数,一般不容易写错,格式化也更好。比如我们之前讲述的,使用laravel的 Route::resource() 方法生成 restful 风格的api,那么如果对一个 Phone 模型相关的接口做别名,大概会是这样子的:
代码语言:javascript复制photos.index
photos.create
photos.store
photos.show
photos.edit
photos.update
photos.destroy
其实助手函数 route 提供的参数传入,可以灵活组装url,比如按照位置传入的数据,不指定键名,按顺序传入:
代码语言:javascript复制route('users.comments.show', [1, 2])
// http://myapp.com/users/1/comments/2
也可以明确键名,指定传入的位置参数:
代码语言:javascript复制route('users.comments.show', ['userId' => 1, 'commentId' => 2])
// http://myapp.com/users/1/comments/2
为了验证位置参数是否和数组键名绑定关系,我们颠倒传入的参数顺序,看看输出是否如预期:
代码语言:javascript复制route('users.comments.show', ['commentId' => 2, 'userId' => 1])
// http://myapp.com/users/1/comments/2
可见,route函数是按照键名绑定到位置参数的。如果传入的数组比可接受的数据要多,route函数会将其作为 get 方法的 querystring 进行传递:
代码语言:javascript复制route('users.comments.show', ['userId' => 1, 'commentId' => 2, 'opt' => 'a'])
// http://myapp.com/users/1/comments/2?opt=a
分组
分而治之,对于有相同类目的路由,应该归类到一起,成为一个组。这就是路由组的由来。我们来看一下,不附加任何额外的功能的组是如何声明的:
代码语言:javascript复制Route::group([], function () {
Route::get('hello', function () {
return 'Hello';
});
Route::get('world', function () {
return 'World';
});
});
有了分组,那么可以手动指定,这个分组内所有注册的路由,都要经过某个中间件,可以声明如下:
代码语言:javascript复制Route::group(['middleware' => 'auth'], function () {
Route::get('dashboard', function () {
return view('dashboard');
});
Route::get('account', function () {
return view('account');
});
});
其中这个 'middleware' => 'auth' 的 auth 中间件,是声明在 app/Http/Kernel.php 文件内,下面这一段是源码内自带的中间件:
代码语言:javascript复制protected $routeMiddleware = [
'auth' => AppHttpMiddlewareAuthenticate::class,
'auth.basic' => IlluminateAuthMiddlewareAuthenticateWithBasicAuth::class,
'bindings' => IlluminateRoutingMiddlewareSubstituteBindings::class,
'cache.headers' => IlluminateHttpMiddlewareSetCacheHeaders::class,
'can' => IlluminateAuthMiddlewareAuthorize::class,
'guest' => AppHttpMiddlewareRedirectIfAuthenticated::class,
'password.confirm' => IlluminateAuthMiddlewareRequirePassword::class,
'signed' => IlluminateRoutingMiddlewareValidateSignature::class,
'throttle' => IlluminateRoutingMiddlewareThrottleRequests::class,
'verified' => IlluminateAuthMiddlewareEnsureEmailIsVerified::class,
];
我们可以直接拿来用。当然了,上面的示例是在路由组内引入的中间件。对于极为特殊的中间件功能,不能在路由组内统一引用的,可以放到控制器的构造函数内调用。比如下面的代码:
代码语言:javascript复制class DashboardController extends Controller
{
public function __construct()
{
$this->middleware('auth');
$this->middleware('admin-auth')->only('admin');
$this->middleware('team-member')->except('admin');
}
}
因为控制器类已经继承了中间件的注册流程,所以可以有效使用中间件的拦截、验证功能。
加前缀
在规划路由时,能省则省,功能一致的放在一起,同时在路由数量多了之后,能够有效地使用前缀区分不同的功能模块,也是一个很好的实践。
为一组路由加前缀,就想注册中间件一样,在配置内手动指定,比如下面这样:
代码语言:javascript复制Route::group(['prefix' => 'api'], function () {
Route::get('/', function () {
// 路径 /api
});
Route::get('users', function () {
// 路径 /api/users
});
});
前缀是给url路径中路由部分指定的,我们还可以为二级域名指定路由,相似地,声明如下代码:
代码语言:javascript复制Route::group(['domain' => 'api.myapp.com'], function () {
Route::get('/', function () {
//
});
});
那么该路由组内所有路由,就仅对指定的二级域名起作用。当然了二级域名还要使用nginx的反向代理配合使用。
laravel的花样是真多啊!
不仅如此,我们还可以为路由组声明是指定的命名空间下的控制器所使用的。这样,可以通过把相似功能模块放在相同命名空间下,从而达到路由分组的目的。比如:
代码语言:javascript复制Route::group(['namespace' => 'API'], function () {
// 对应 AppHttpControllersAPIEventController
Route::get('api/', 'EventController@index');
});
写在最后
laravel是给web艺术家准备的,你想到的,想不到的,基础的,高级的功能都有了。没有的,你也可以手动实现轮子梦。从上面注册的路由方法,大家应该能有所感触。
Happy coding :-)
我是@程序员小助手,专注编程知识,圈子动态的IT领域原创作者