Laravel 路由的隐式绑定和显式绑定

路由的隐式绑定和显示绑定

在学习 Laravel 的过程中，见识过控制器中，函数传递类型提示为某个 Eloquent 模型的变量之后，函数中就可以直接获取该模型的相关数据参数的神奇操作。就是利用了路由的隐式绑定和显示绑定，我就先不看底层如何实现的，先具体学习一下这一功能。

隐式绑定

官方的描述：
Laravel 会自动解析定义在路由或控制器行为中与类型提示的变量名匹配的路由段名称的 Eloquent 模型

我们下面的例子中也就是： 类型提示的变量名 = 路由段名称 = Eloquent 模型 = user

Route::get('users/{user}', UsersController@show);

该路由，则是匹配了 User Eloquent 模型，Laravel 会自动注入与请求 URI 中传入的 ID（即为 {user} 参数的值） 匹配的用户模型实例。当然，对应的 UsersController 控制器要引入对应的模型文件。

use App\User;

同时，控制器的 show 方法，要传入该模型实例。

public function show(User $user)
{
    dd($user->toArray());
}

当然你也可以不引入对应的模型文件，直接在 show 方法的参数中用完全限定名称引入相关模型文件

public function show(\App\User $user)
{
    dd($user->toAyyay());
}

参考 PHP 手册 - 语言参考的类与对象、命名空间章节

自定义键名

如果你不想用 ID 这个数据库字段来检索模型实例，你也可以在对应 Eloquent 模型上，对 getRouteKeyName 方法进行重写。
我尝试使用 users 表中的 name 字段来获取模型实例，即如下
app\User.php （这是你的模型文件的路径，根据你来定也可以是 app/Models/User.php）

public function getRouteKeyName()
{
    return 'name';
}

这个时候，浏览器访问 xxx.app/users/lara 就可以获取 'users' 表中，name 字段值为 'lara' 的模型实例。

这个地方我在数据库中插入了另一个同样的 name 为 lara 的值，但是获取的实例只有第一个。
还有一个地方需要注意的是，此时的路由也必须是 {user}，不能是其他，比如 {name}

显式绑定

Q&A

Q：那如果我不想用 {user} 作为路由段名称，想用其他的名称，比如 {name} 怎么办呢？
A：用显式绑定，将你想要绑定的名称指定给路由，同时，重写模型文件的 getRouteKeyName 方法

app/Providers/RouteServiceProvider.php

public function boot()
{
    parent::boot();
    Route::model('name', \App\User::class);
}

你也可以绑定给其他路由了

Route::get('profile/{name}', function(\App\User $user){
    dd($user->toArray());
});

自定义逻辑

那么回到之前的问题，「这个地方我在数据库中插入了另一个同样的 name 为 lara 的值，但是获取的实例只有第一个。」
我们想找到 id 为 2， 且 name 为 lara 的模型实例的时候，我们需要自定义绑定的逻辑

app/Providers/RouteServiceProvider.php

public function boot()
{
    parent::boot();
    Route::bind('name', function ($value) {
        return \App\User::where('name', $value)->find(2);
    });
}

其他

当我们使用路由资源的时候

Route::resource('user', 'UsersController');

许多路由已经进行了隐式绑定，你可以在环境中查看你的路由

$ php artisan route:list

最后

以上整理均为自己的理解，如有错误，还望指正。

本作品采用《CC 协议》，转载必须注明作者和本文链接