Laravel 5.5 LTS обзор нового релиза

Сен 27, 2017 4 min read

Laravel 5.5 LTS обзор нового релиза

Совсем недавно вышел новый релиз Laravel под номером 5.5, новая версия LTS (long term support). Она включает исправления по багам за 2 года, исправления безопасности за 3 года и новые фичи, речь о которых и пойдет в данной статье.

Whoops пакет

Whoops пакет вернулся в Laravel 5.5, теперь стек трейс выглядит так же привлекательно как и в 4-той версии.

Дампинг коллекций

Теперь дебажить коллекции стало намного проще с фунциями dump и dd.

Например, dump, выводит результат:

collect([1,2,3])->map(function($i){
    return $i * 2;
})->dump()->reject(function($i){
    return $i < 3;
});

collect([1,2,3])->map(function($i){

return $i * 2;

})->dump()->reject(function($i){

return $i < 3;

});

Результат:

array:3 [▼
  0 => 2
  1 => 4
  2 => 6
]

array:3 [▼

0 => 2

1 => 4

2 => 6

]

В то же время dd (dd — dump and die) выводит тот же результат и останавливает цепочку:

collect([1,2,3])->map(function($i){
    return $i * 2;
})->dd()->reject(function($i){
    return $i < 3;
});

collect([1,2,3])->map(function($i){

return $i * 2;

})->dd()->reject(function($i){

return $i < 3;

});

Результат тот жe:

array:3 [▼
  0 => 2
  1 => 4
  2 => 6
]

array:3 [▼

0 => 2

1 => 4

2 => 6

]

Отображение исключений

В новом релизе, вы можете прорисовывать исключения путем определения нового метода render в классе исключения:

<?php

namespace App\Exceptions;

use App\Song;

class TerribleSongException extends \Exception
{
    /**
     * @var \App\Song
     */
    protected $song;

    public function __construct(Song $song)
    {
        $this->song = $song;
    }

    /**
     * @param \Illuminate\Http\Request $request
     */
    public function render($request)
    {
        return response("The song '{$this->song->title}' by '{$this->song->artist}' is terrible.");    
    }
}

<?php

namespace App\Exceptions;

use App\Song;

class TerribleSongException extends \Exception

{

/**

* @var \App\Song

protected $song;

public function __construct(Song $song)

{

$this->song = $song;

}

/**

* @param \Illuminate\Http\Request $request

public function render($request)

{

return response("The song '{$this->song->title}' by '{$this->song->artist}' is terrible.");

}

Теперь, просто, сделав throw new TerribleSongException(), Laravel сам отправит респонс. Также, можно, просто имплементировать Responsable интерфейс (контракт) для класса исключения. А что из себя представляет Responsable интерфейс, речь пойдет ниже.

Responsable интерфейс

Теперь перед созданием респонс объекта проверяется на Responsable интерфейс. Класс который имплементирует интерфейс может быть возвращен с контроллера:

public function store(Request $request)
{

    $song = new Song($data);
    $song->save();

    return new NewSongResponse($song);
}

public function store(Request $request)

{

$song = new Song($data);

$song->save();

return new NewSongResponse($song);

}

Сам класс может выглядеть так:

<?php

namespace App\Http\Responses;

use App\Song;
use Illuminate\Contracts\Support\Responsable;

class NewSongResponse implements Responsable
{
    /**
     * @var \App\Song
     */
    protected $song;

    /**
     * @param \App\Song $song
     */
    public function __construct(Song $song)
    {
       $this->song = $song; 
    }

    public function toResponse($request)
    {
        if ($request->wantsJson()) {
            return response()
                ->json($this->song)
                ->header('Location', route('songs.show', $this->song))
                ->setStatusCode(201);
        }

        return redirect()
            ->route('songs.show', $this->song);
    }
}

<?php

namespace App\Http\Responses;

use App\Song;

use Illuminate\Contracts\Support\Responsable;

class NewSongResponse implements Responsable

{

/**

* @var \App\Song

protected $song;

/**

* @param \App\Song $song

public function __construct(Song $song)

{

$this->song = $song;

}

public function toResponse($request)

{

if ($request->wantsJson()) {

return response()

->json($this->song)

->header('Location', route('songs.show', $this->song))

->setStatusCode(201);

}

return redirect()

->route('songs.show', $this->song);

}

Валидация запроса

В более поздних версиях Laravel для валидации запроса использовался метод validate с контроллера:

<?php

$this->validate(request(), [
        'name' => 'required',
        'age' => 'required|numeric',           	 
]);

<?php

$this->validate(request(), [

'name' => 'required',

'age' => 'required|numeric',

]);

Сейчас же появился более удобный вызов с самого объекта запроса:

<?php

$data = request()->validate([
    	'name' => 'required',
        'age' => 'required|numeric'<strong>,</strong>   	 
]);

<?php

$data = request()->validate([

'name' => 'required',

'age' => 'required|numeric'<strong>,</strong>

]);

На выходе получаем массив ($data) — аналог вызову Request::only():

<?php

[
    	'name' => 'Alex',
        'age' => '21',   	 
];

<?php

[

'name' => 'Alex',

'age' => '21',

];

Кастомные валидационные объекты и замыкания

Начиная с версии 5.5 кроме возможности создания кастомных методов валидации Validator::extend появилась возможность писать валидаторы имплементируя Rule интерфейc.

Для генерации валидатора, вызываем artisan:

$ php artisan make:rule AgeValidationRule

1	$ php artisan make:rule AgeValidationRule

Получаем класс в котором нужно описать два метода, passes и message:

<!-- app/Rules/AgeValidationRule.php -->
<?php

namespace App\Rules;

use Illuminate\Contracts\Validation\Rule;

class AgeValidationRule implements Rule
{
    public function passes($attribute, $value)
    {
        return $value >= 18;
    }

    public function message()
    {
        return 'The User is under the age of 18';
    }
}

<?php

namespace App\Rules;

use Illuminate\Contracts\Validation\Rule;

class AgeValidationRule implements Rule

{

public function passes($attribute, $value)

{

return $value >= 18;

}

public function message()

{

return 'The User is under the age of 18';

}

Использовать класс можно следующим образом:

<?php

request()->validate([
    'age' => [new AgeValidationRule]
]);

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

<?php

request()->validate([
    'age' => [function ($attribute, $value, $fail) {
        if ($value <= 18) {
            $fail( 'The User is under the age of 18');
        }
    }]
]);

<?php

request()->validate([

'age' => [new AgeValidationRule]

]);

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

<?php

request()->validate([

'age' => [function ($attribute, $value, $fail) {

if ($value <= 18) {

$fail( 'The User is under the age of 18');

}

}]

]);

Новые директивы @auth и @guest

Раньше мы писали о директиве Blade::if версии 5.5. В новой версии 5.5 появились две новые директивы: @auth и @guest которые вы можете использовать в файлах шаблонов.

В предыдущих версиях вы могли использовать такие варианты проверки аутентификации пользователя:

@if (auth()->check())
       {{--  authenticated  --}}
@endif

@if (auth()->guest())

@if (auth()->check())

@endif

@if (auth()->guest())

Сейчас вы можете использовать эти директивы в более упрощенном виде:

@auth()
	Welcome {{ user()->name }}
@endauth

@guest
	Welcome Guest!
@endguest

@auth()

Welcome {{ user()->name }}

@endauth

@guest

Welcome Guest!

@endguest

Пресеты для фронтенда

Пресеты — это предустановки для фроненд-фреймворков которые можно сгенерировать при помощи новой команды в artisan. Когда вы начинаете новый проект на Laravel 5.5, у вас уже по-умолчанию установлен фреймворк Vue2.js.

В новой версии Laravel 5.5 вы можете выбрать 4 предустановленных варианта для генерации фронтенда: “none”, “bootstrap”, “vue”, “react”:

Набираем в командной строке с установленным проектом:

php artisan help preset
Использование:
preset <type>

Аргументы type типы пресетов (none, bootstrap, vue, react)

# Использовать react
$ php artisan preset react

# Удалить все фреймворки
$ php artisan preset none

# Использовать react

$ php artisan preset react

# Удалить все фреймворки

$ php artisan preset none

Factory файлы

Теперь для каждой модели можно делать отдельную фабрику с помощью команды:

php artisan make:factory --model=User UserFactory

1	php artisan make:factory --model=User UserFactory

Или при генерировании модели добавить новый ключ:

php artisan make:model -fm User

1	php artisan make:model -fm User

Если же использовать ключ all, то получим модель, миграцию и фабрику:

php artisan make:model --all

1	php artisan make:model --all

Миграция с migrate:fresh

При работе с миграциями в Laravel есть migrate:refresh команда, которая откатывает миграцию назад. В новой версии 5.5 была добавлена команда migrate:fresh которая попросту удаляет все таблицы базы данных и запускает миграцию.

RefreshDatabase Trait

Появился новый трейт для миграции базы данных для тестирования. Этот новый trait использует наиболее оптимальный подход к переносу тестовой базы данных в зависимости от того, используете ли вы in-memory базу данных или традиционную базу данных. Можно обойтись и старыми DatabaseTransactions и DatabaseMigrations не используя RefreshDatabase.

Новый withoutExceptionHandling() метод

Теперь тесты наследуют withoutExceptionHandling метод, который позволяет отключать обработку исключений в коде, для того чтобы отработать его в assert-е теста.

Автоопределение пакетов в Laravel

Для подключения и активации пакета, теперь достаточно просто запустить композер:

composer require barryvdh/laravel-debugbar:dev-master

Больше ничего делать ненужно!

Также можно включить пакет только в дев среду, исполнив:

composer require-dev barryvdh/laravel-debugbar:dev-master

1	composer require-dev barryvdh/laravel-debugbar:dev-master

Вместо выводов

Как видно, Laravel продолжает радовать своих фанов вкусными ништячками. Еще больше нововведений ждем в версии 5.6.

Beedevs Blog