Неявная привязка модели маршрута в Laravel 5.2

Статистика: Символов — 3 692/3 127 без пробелов (2 766/2 357 без кода):, слов — 410
Разметка: Wiki
Для тех, кто не знает, ((/docs/v5/routing#привязка привязка модели маршрута)) уже давно есть в Laravel, но в Laravel 5.2 она стала ещё проще.

Это одна из статей о новых функциях Laravel 5.2. Скоро будут ещё, не пропустите.

{{Cut}} 

  1. ((https://laravel.ru/posts/354 Проверка массива формы в Laravel 5.2))
  2. ((https://laravel.ru/posts/372 Неявная привязка модели маршрута в Laravel 5.2))
  3. ((https://laravel.ru/posts/379 Ограничение скорости запросов API в Laravel 5.2))
  4. ((https://laravel.ru/posts/380 Заготовка авторизации в Laravel 5.2))
  5. ((https://laravel.ru/posts/381 Множественные драйверы защиты авторизации (включая API) в Laravel 5.2))

==Основы привязки модели маршрута==
Предположим, что обычный шаблон для привязки URL-маршрута выглядит примерно так:
%%
Route::get('shoes/{id}', function ($id) {
  $shoe = Shoe::findOrFail($id);
  // Делаем, что нам надо
});
%%

И такое мне приходится делать часто. Разве не было бы лучше, если бы можно было написать %%findOrFail%% и просто сказать маршрутизатору Laravel, что этот маршрут соответствует %%Shoe%%? Это возможно. Просто скажите маршрутизатору в своём сервис-провайдере маршрута:
%%
$router->model('shoe', 'App\Shoe');
%%

Это значит, что "каждый раз, когда в маршруте есть параметр с именем %%shoe%%, это ID соответствующий экземляру %%App\Shoe%%". Тогда мы можем переписать этот код вот так:
%%
Route::get('shoes/{shoe}', function ($shoe) {
  // Делаем, что нам надо
});
%%

==Неявная привязка модели маршрута==
В  Laravel 5.2 ещё проще использовать привязку модели маршрута. Просто укажите тип параметра в замыкании маршрута (или методе своего контроллера) и назовите параметр также, как параметр маршрута, тогда он автоматически будет обработан как привязка модели маршрута:
%%
Route::get('shoes/{shoe}', function (App\Shoe $shoe) {
  // Делаем, что нам надо
});
%%

Значит теперь вы можете использовать преимущества привязки модели маршрута без необходимости определять что-либо в сервис-провайдере маршрута. Легко!

Это всё, что касается неявной привязки модели маршрута! А всё остальное уже было в 5.1.

==Малоизвестные возможности привязки модели маршрута==
Эти возможности появились до версии 5.2, поэтому они не связаны конкретно с неявной привязкой модели маршрута, но судя по всему они малоизвестны, так что сейчас я расскажу о них. 

===Настройка логики привязки модели маршрута===
Если вы хотите изменить логику, которую использует привязка модели маршрута для поиска и возврата экземпляра вашей модели, вы можете передать замыкание в качестве второго параметра явной привязки вместо передачи имени класса:
%%
$router->bind('shoe', function ($value) {
  return App\Shoe::where('slug', $value)->where('status', 'public')->first();
});
%%

===Настройка исключений привязки модели маршрута===
Также вы можете изменить исключения, которые выбрасывают привязки моделей маршрутов (когда они не могут найти экземпляр модели), передав замыкание в качестве третьего параметра:
%%
$router->model('user', 'App\User', function () {
  throw new NotFoundHttpException;
});
%%

===Изменение "ключа маршрута" модели Eloquent===
По умолчанию Laravel предполагает, что модель Eloquent должна направлять к сегментам URL по столбцу %%(t)id%%. Но что если вы хотите, чтобы она //всегда// направляла к "читаемому" адресу, как в моем примере с изменённой логикой привязки %%shoe%%?

Eloquent реализует контракт %%(t)Illuminate\Contracts\Routing\UrlRoutable%%, значит каждый объект Eloquent имеет метод %%getRouteKeyName()%%, который определяет, какое поле надо использовать для поиска этого объекта по URL. По умолчанию оно равно %%id%%, но вы можете переопределить его для каждой модели %%Eloquent%%:
%%
class Shoe extends Model 
{
  public function getRouteKeyName()
  {
    return 'slug';
  }
}
%%

Теперь вы можете использовать явную или неявную привязку модели маршрута, и она будет искать тот %%(t)shoe%%, в котором поле %%(t)slug%% совпадает с сегментом моего URL. Красота.