3分钟短文:Laravel路子真野啊!路由昵称前缀中间件

2020-10-21 10:15:15 浏览数 (1)

引言

上一章内容我们介绍了使用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领域原创作者

0 人点赞