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

引言

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

“昵称”

如果你的应用程序路由条目可以达到300到500条，光是管理这些路由地址不重复，或者是浏览某些部分的路由，都将是一件非常考验脑力的事儿。

有没有想过，能不能给路由起个名字，方便记忆，不用想着路由定义的多复杂，咱们直接用别名访问？laravel为我们考虑到了，比如路由这样写：

Route::get('members/{id}', 'MembersController@show')->name('members.show');

这样定义之后在HTML文件内比如有 a 标签，或者 form 表单的 action，填url地址的时候，就可以使用laravel的助手函数，这样来写：

<a href="<?php echo route('members.show', ['id' => 14]); ?>">

这样使用起来，就好像记一个函数名一样，然后通过数组传入绑定的位置参数，一般不容易写错，格式化也更好。比如我们之前讲述的，使用laravel的 Route::resource() 方法生成 restful 风格的api，那么如果对一个 Phone 模型相关的接口做别名，大概会是这样子的：

photos.index
photos.create
photos.store
photos.show
photos.edit
photos.update
photos.destroy

其实助手函数 route 提供的参数传入，可以灵活组装url，比如按照位置传入的数据，不指定键名，按顺序传入：

route('users.comments.show', [1, 2])
// http://myapp.com/users/1/comments/2

也可以明确键名，指定传入的位置参数：

route('users.comments.show', ['userId' => 1, 'commentId' => 2])
// http://myapp.com/users/1/comments/2

为了验证位置参数是否和数组键名绑定关系，我们颠倒传入的参数顺序，看看输出是否如预期：

route('users.comments.show', ['commentId' => 2, 'userId' => 1])
// http://myapp.com/users/1/comments/2

可见，route函数是按照键名绑定到位置参数的。如果传入的数组比可接受的数据要多，route函数会将其作为 get 方法的 querystring 进行传递：

route('users.comments.show', ['userId' => 1, 'commentId' => 2, 'opt' => 'a'])
// http://myapp.com/users/1/comments/2?opt=a

分组

分而治之，对于有相同类目的路由，应该归类到一起，成为一个组。这就是路由组的由来。我们来看一下，不附加任何额外的功能的组是如何声明的：

Route::group([], function () {
    Route::get('hello', function () {
        return 'Hello';
    });
    Route::get('world', function () {
        return 'World';
    });
});

有了分组，那么可以手动指定，这个分组内所有注册的路由，都要经过某个中间件，可以声明如下：

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 文件内，下面这一段是源码内自带的中间件：

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,
];

我们可以直接拿来用。当然了，上面的示例是在路由组内引入的中间件。对于极为特殊的中间件功能，不能在路由组内统一引用的，可以放到控制器的构造函数内调用。比如下面的代码：

class DashboardController extends Controller
{
    public function __construct()
    {
        $this->middleware('auth');
        $this->middleware('admin-auth')->only('admin');
        $this->middleware('team-member')->except('admin');
    }
}

因为控制器类已经继承了中间件的注册流程，所以可以有效使用中间件的拦截、验证功能。

加前缀

在规划路由时，能省则省，功能一致的放在一起，同时在路由数量多了之后，能够有效地使用前缀区分不同的功能模块，也是一个很好的实践。

为一组路由加前缀，就想注册中间件一样，在配置内手动指定，比如下面这样：

Route::group(['prefix' => 'api'], function () {
    Route::get('/', function () {
        // 路径 /api
    });
    Route::get('users', function () {
        // 路径 /api/users
    });
});

前缀是给url路径中路由部分指定的，我们还可以为二级域名指定路由，相似地，声明如下代码：

Route::group(['domain' => 'api.myapp.com'], function () {
    Route::get('/', function () {
    //
    });
});

那么该路由组内所有路由，就仅对指定的二级域名起作用。当然了二级域名还要使用nginx的反向代理配合使用。

laravel的花样是真多啊！

不仅如此，我们还可以为路由组声明是指定的命名空间下的控制器所使用的。这样，可以通过把相似功能模块放在相同命名空间下，从而达到路由分组的目的。比如：

Route::group(['namespace' => 'API'], function () {
     // 对应 AppHttpControllersAPIEventController
    Route::get('api/', 'EventController@index');
});

写在最后

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

Happy coding :-)

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