Новые возможности в Laravel 5.2

Russian (Pусский) translation by Sergey Zhuk (you can also view the original English article)

В этой статье я рассмотрю новые возможности Laravel 5.2 и опишу по порядку каждую из них. Вот список нововведений:

Неявная привязка модели к маршруту
Валидация массивов в форме
Middleware для ограничения запросов к API
Группы middleware
Генерация аутентификации
Разные драйвера для аутентификации

Несколько драйверов для аутентификации

Эта возможность может оказаться полезной особенно, когда нужно использовать Doctrine ORM аутентификацию с несколькими провайдерами. В моих проектах я предпочитаю иметь отдельную аутентификацию для админов и отдельную для пользователей; данная возможность поможет очень легко получить это. Рассмотрим пример config/auth.php:

//...
    'guards' => [
        'user' => [
            'driver' => 'session',
            'provider' => 'users',
        ],
        'admin' => [
            'driver' => 'session',
            'provider' => 'admin',
        ],

        'api' => [
            'driver' => 'token',
            'provider' => 'users',
        ],
    ],
//...
    'providers' => [
        'users' => [
            'driver' => 'doctrine',
            'model' =>  App\Entities\Users::class,
        ],
        'admin' => [
            'driver' => 'doctrine',
            'model' =>  App\Entities\Admin::class,
        ],
    ],

Теперь мы можем использовать Auth::attempt([...]), здесь Laravel вызовет аутентификатора по умолчанию; таким образом если нужно вызвать другого аутентификатора, то нужно указать его имя, например Auth::guard('admin').

Для аутентификации вашей группы маршрутов определенным аутентификатором, можно просто указать его имя:

1	Route::group(['middleware' =>['auth:admin']], function () {
2	//...
3	}

Иногда, вместо простого логина в вашем приложении, вы хотите чтобы пользователи добавляли api_token к концу строки запроса и использовали его для аутентификации запроса. TokenGuard поможет вам легко достичь этой цели.

Если вы хотите использовать аутентификацию по токену, то сначала нужно добавить уникальное поле api_token, длиной в 60 символов в таблицу вашей модели. Теперь вы легко можете использовать аутентификатор api в вашем приложении.

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

Одна из новых возможность в Laravel 5.2 и которая является довольно практичной - привязка модели к маршруту. Вы можете привязать модель к вашему маршруту; но сначала сделаем эту привязку вручную:

1	Route::get('user/{id}', function ($id) {
2	$user = Users::findOrFail($id);
3	// ...
4	});

Или же можно сделать что-то вроде такого:

  //...
  $router->model('user', 'App\User');
  //...

  $router->get('profile/{user}', function(App\User $user) {
    //
});

С Laravel 5.2 это сделать очень легко. Просто передайте параметр в замыкание с маршрутом, и вы автоматически можете рассматривать его как привязку модели:

1	Route::get('user/{id}', function (App\User $user) {
2	//...
3	});

Теперь стало еще легче привязывать модель к маршруту.

По умолчанию Laravel осуществляет привязку по полю id. Но если вы хотите поменять это поведение, то это можно сделать следующим образом:

class User extends Model 
{
    public function getRouteKeyName()
    {
        return 'UserEmail';
    }
}

Eloquent реализует интерфейс Illuminate\Contracts\Routing\UrlRoutable, так что вы можете переопределить метод getRouteKeyName(). Он определяет какое поле в таблице использовать для поиска по параметру из URL.

Группы middleware

Как мы могли увидеть выше, мы создали несколько аутентификаций для админа и для пользователей. В таком случае, если вы хотите привязать несколько middleware к группе маршрутов пользователя, то с Laravel 5.2 вы можете создать для них окрашенное название и использовать его.

Чтобы определить группу middleware, следует внести изменения в файл kernel.php в папке https:

protected $middlewareGroups = [
     //...
    'admin' => [
        'acl',
        'web',
        'auth',
    ]
];

И теперь вы легко можете использовать группу в в ваших маршрутах.

Middleware для ограничения запросов по API

Если вы используете API стороннего приложения, такого как например GitHub, для запросов с использованием базовой аутентификации или OAuth, то вы можете выполнять до 5000 запросов в час. Этот лимит называется ограничением скорости. Если вы хотите иметь что-то похожее в своем приложении, то можете использовать новую возможность Laravel 5.2. В Laravel 5.2 было добавлено новое throttle middleware, которое следит за ограничениями скорости запросов. Например вы можете сделать что-то вроде этого:

Route::group(['prefix' => 'api', 'middleware' => 'throttle'], function () {
    Route::get('user', function () {
        return Users::all();
    });
});

По умолчанию в kernel.php middleware throttle позволяет 60 попыток в минуту:

1	//...
2	'api' => [
3	'throttle:60,1',
4	'auth:api',
5	],

Вы можете изменить это пожеланию или даже настроить для определенного роутера.

Route::group(['prefix' => 'api', 'middleware' => 'throttle:10,1000'], function () {
    Route::get('user', function () {
        return Users::all();
    });
});

Заготовки для аутентификации

Laravel 5.2 предоставляет быстрый способ сгенерировать все, что вам нужно для аутентификации с помощью одной команды:

1	php artisan make:auth

С помощью этой команды в вашем приложении будут сгенерированы пути и файлы отображений для логина и регистрации. Мои пути выглядят следующим образом:

1	Route::group(['middleware' => 'web'], function () {
2	Route::auth();
3	Route::get('/home', 'HomeController@index');
4	});

Метод Route::auht() это сокращение для определения следующих путей:

// Authentication Routes...
$this->get('login', 'Auth\AuthController@showLoginForm');
$this->post('login', 'Auth\AuthController@login');
$this->get('logout', 'Auth\AuthController@logout');

// Registration Routes...
$this->get('register', 'Auth\AuthController@showRegistrationForm');
$this->post('register', 'Auth\AuthController@register');

// Password Reset Routes...
$this->get('password/reset/{token?}', 'Auth\PasswordController@showResetForm');
$this->post('password/email', 'Auth\PasswordController@sendResetLinkEmail');
$this->post('password/reset', 'Auth\PasswordController@reset');

Так же будет сгенерирован HomeController, который отвечает за запросы логина на основную панель вашего приложения. Но вы также можете настроить или вообще убрать этот контроллер, все зависит от требований вашего приложения.

Валидация массивов в форме

Одна интересная вещь, с которой мне приходилось работать, это данные формы в виде массивов в HTML. Если вы укажите что-нибудь в квадратных скобках, то результирующий массив станет ассоциативным, иначе он будет простым:

<form action="" method="POST">
    <input type="text" name="name[first]">
    <input type="text" name="name[last]">
    <input type="submit">
</form>

Результат PHP print_r($_POST) будет следующим:

array(
     'name' => array(
         'first' => ''
         'last' => ''
     )
 )

Это поможет вам упростить процесс валидации и работы с формами. Теперь рассмотрим валидацию наших полей в Laravel 5.2:

    public function Validator()
    {
        $this->validate(Request::all(), [
            'name.*.first' => 'required|string',
            'name.*.last' => 'string',
        ]);
    }

Возможно, вы заметили, что форма проверки выглядит как name.*.last, со звездочкой в середине, которая означает, что вы могли бы добавить ключ массива или что-нибудь еще, что вам может понадобиться.

Заключение

Laravel 5.2 был довольно маленьким релизом, который позволит вам работать лучше и быстрее. Как вы могли заметить, многие из этих возможностей также легки в освоении.