前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >3分钟短文:Laravel路子真野啊!路由昵称前缀中间件

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

原创
作者头像
程序员小助手
修改2020-10-21 10:15:15
1.5K0
修改2020-10-21 10:15:15
举报
文章被收录于专栏:程序员小助手程序员小助手

引言

上一章内容我们介绍了使用laravel路由动词定义方便的url,以及通过url参数绑定传递数据, 本文我们继续深入Route功能,学习一些提升生产力的方法,在现实场景中也非常实用。

img
img

“昵称”

如果你的应用程序路由条目可以达到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' => \App\Http\Middleware\Authenticate::class,
    'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
    'bindings' => \Illuminate\Routing\Middleware\SubstituteBindings::class,
    'cache.headers' => \Illuminate\Http\Middleware\SetCacheHeaders::class,
    'can' => \Illuminate\Auth\Middleware\Authorize::class,
    'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
    'password.confirm' => \Illuminate\Auth\Middleware\RequirePassword::class,
    'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
    'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
    'verified' => \Illuminate\Auth\Middleware\EnsureEmailIsVerified::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 () {
     // 对应 App\Http\Controllers\API\EventController
    Route::get('api/', 'EventController@index');
});

写在最后

laravel是给web艺术家准备的,你想到的,想不到的,基础的,高级的功能都有了。没有的,你也可以手动实现轮子梦。从上面注册的路由方法,大家应该能有所感触。

Happy coding :-)

我是@程序员小助手,专注编程知识,圈子动态的IT领域原创作者

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 引言
  • “昵称”
  • 分组
  • 加前缀
  • 写在最后
相关产品与服务
消息队列 TDMQ
消息队列 TDMQ (Tencent Distributed Message Queue)是腾讯基于 Apache Pulsar 自研的一个云原生消息中间件系列,其中包含兼容Pulsar、RabbitMQ、RocketMQ 等协议的消息队列子产品,得益于其底层计算与存储分离的架构,TDMQ 具备良好的弹性伸缩以及故障恢复能力。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档