Каковы новые функции в Laravel 5.5?

Laravel 5.5 потребует PHP 7.0+. О возможностях этой современной версии PHP вы можете прочитать в нашем резюме .

Laravel 5.5 также станет следующим выпуском LTS (Long Term Support). Это означает исправления ошибок за два года и три года обновлений безопасности. Так было и с Laravel 5.1, но его двухлетнее окно исправлений ошибок подходит к концу в этом году. Без дальнейших церемоний, давайте посмотрим, что может предложить эта новая версия.

Создание нового проекта Laravel 5.5

Поскольку релиз еще не произошел официально, мы можем установить версию релиза dev, выполнив команду:

laravel new laravel55 --dev cd laravel55 php artisan key:generate 

Если вы предпочитаете не использовать установщик Laravel, вы также можете воспользоваться подходом Composer :

 composer create-project --prefer-dist --stability=dev laravel/laravel:dev-master cd laravel php artisan key:generate 

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

Рендеринг почтовых отправлений в браузер

Я чувствую, что это очень пригодится. В предыдущих версиях Laravel нам приходилось отправлять реальные электронные письма или использовать почтовый клиент, такой как Mailtrap, для проверки макетов электронной почты, и это не было забавной задачей. Такого больше не будет, так как в Laravel 5.5 можно напрямую отображать макет электронной почты в браузере.

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

 php artisan make:mail Welcome --markdown=emails.welcome 

Я предпочитаю подход уценки, так как мы получим шаблон с некоторым содержанием. Давайте откроем наш файл web.php и создадим тестовый маршрут для проверки макета электронной почты:

 Route::get('/email', function () { return new App\Mail\Welcome(); }); 

routes/web.php

Посещая маршрут /email мы сможем просмотреть шаблон электронной почты:

Что на самом деле происходит под капотом, так это то, что в Laravel 5.5 класс Mailable реализует контракт Mailable который имеет метод render() . Это реализация метода render() внутри lluminate/Mail/Mailable.php :

 public function render() { Container::getInstance()->call([$this, 'build']); return Container::getInstance()->make('mailer')->render( $this->buildView(), $this->buildViewData() ); } 

lluminate/Mail/Mailable.php

Это метод, который позволяет получить представление. Если бы мы попытались вернуть экземпляр класса, который не реализует контракт Renderable в наших маршрутах, мы бы получили UnexpectedValueException .

Пользовательские темы электронной почты

При использовании Markdown для электронной почты Laravel будет предоставлять тему по умолчанию. Тем не менее, некоторые люди могут предпочесть использовать собственные стили в своих шаблонах электронной почты для брендинга.

Чтобы использовать собственную тему для определенного почтового сообщения, мы сначала создаем пользовательский файл .css содержащий стили, которые мы хотим:

 touch resources/views/vendor/mail/html/themes/custom.css 

Затем мы указываем это имя файла как свойство в классе Mailable:

 class Welcome extends Mailable { protected $theme = 'custom'; [...] } 

app/Mail/Welcome.php

Таким образом, макет электронной почты будет основан на стилях, которые мы определили в файле custom.css . Преимущество такого подхода в том, что у нас могут быть разные темы для разных почтовых сообщений.

Вспомогательные функции исключения

Laravel 5.5 поставляется с двумя вспомогательными функциями исключений, которые помогут нам написать более выразительный код. Двумя помощниками являются методы throw_if и throw_unless . Оба принимают три аргумента, третий аргумент является необязательным.

Давайте посмотрим на различные реализации этих исключений:

 $number = 2; throw_if($number !== 3, new NotThreeException('Number is not three')); // or throw_if($number !== 3, NotThreeException::class, 'Number is not three'); 

С помощником throw_if исключение, если первый аргумент оценивается как true.

Реализация хелпера throw_unless ничем не отличается от того, что мы делали выше, с той лишь разницей, что исключение будет throw_unless только в том случае, если первый аргумент оценивается как false:

 $number = 2; throw_unless($number === 3, new NotThreeException('Number is not three')); // or throw_unless($number === 3, NotThreeException::class, 'Number is not three'); 

Не лучший пример, но служит нашим демонстрационным целям.

Представляем миграцию: свежая команда

Вы, вероятно, оказались в ситуации, когда вам потребовалось восстановить базу данных. В предыдущих версиях Laravel мы достигли этого, выполнив команду php artisan migrate:refresh . Команда migrate:refresh откатывает все миграции на основе того, что указано в методе down для каждого файла миграции, а затем снова запускает миграции:

 "extra": { "laravel": { "providers": [ "Foo\\Bar\\ServiceProvider" ], "aliases": { "Bar": "Foo\\Bar\\Facade" } } } 

 php artisan vendor:publish --all 

 php artisan preset none 

 php artisan preset react 

 [...] use Illuminate\Filesystem\Filesystem; use Illuminate\Support\Arr; use Whoops\Handler\PrettyPageHandler; [...] class Handler extends ExceptionHandler { [...] protected function whoopsHandler() { return tap(new PrettyPageHandler, function ($handler) { $files = new Filesystem; $handler->setEditor('sublime'); $handler->handleUnconditionally(true); $handler->setApplicationPaths( array_flip(Arr::except( array_flip($files->directories(base_path())), [base_path('vendor')] )) ); }); } } 

 [...] public function report(Exception $exception) { if ($exception instanceof CustomException) { // Do something } if ($exception instanceof MyOtherException) { // Do something } if ($exception instanceof MyOtherCustomException) { // Do something } return parent::report($exception); } [...] 

 [...] class CustomException extends \Exception { public function report() { // send email } } [...] 

 php artisan make:factory Post 

 [...] $factory->define(App\Post::class, function (Faker $faker) { return [ // ]; }); 

 public function store() { $this->validate(request(), [ 'title' => 'required', 'body' => 'required' ]); // return Post::create(request()->only(['title', 'body'])); or return Post::create(request()->all()); } 

 public function store() { $post = $this->validate(request(), [ 'title' => 'required', 'body' => 'required' ]); return Post::create($post); } 

 public function store() { $post = request()->validate([ 'title' => 'required', 'body' => 'required' ]); return Post::create($post); } 

 $post = request()->validate([ 'title' => 'required', 'body' => 'required', 'notRequiredField' => '', ]); return Post::create($post); 

 php artisan make:rule CustomRule 

 class CustomRule implements Rule { [...] public function passes($attribute, $value) { return $value !== 'unwantedname'; } public function message() { return 'You cannot use that as your username'; } [...] } 

 use App\Rules\CustomRule; request()->validate([ 'username' => [ 'required', new CustomRule() ], 'anotherfield' => 'required|min:5' ]); 

  $posts = Post::all(); $posts ->dump() ->sorBy('title') ->dump() ->pluck('title') ->dump(); 

 Collection {#284 ▼ #items: array:3 [▼ 0 => Post {#285 } 1 => Post {#286 } 2 => Post {#287 } ] } Collection {#272 ▼ #items: array:3 [▼ 0 => Post {#285 } 2 => Post {#287 } 1 => Post {#286 } ] } Collection {#268 ▼ #items: array:3 [▼ 0 => "Aida Bosco" 1 => "Madge Leuschke" 2 => "Miss Bulah Armstrong Jr." ] } 

  $posts = Post::all(); $posts ->dump() ->sorBy('title') ->dd() ->pluck('title') ->dump(); 

 Collection {#284 ▼ #items: array:3 [▼ 0 => Post {#285 } 1 => Post {#286 } 2 => Post {#287 } ] } array:3 [▼ 0 => Post {#285 } 2 => Post {#287 } 1 => Post {#286 } ] 

 class Post extends Model { [...] protected $casts = [ 'somefield' => 'array', ]; [...] } 

 @if (auth()->check() && auth()->user()->isSubscribed()) <p>Subscribed</p> @else <p>Not Subscribed</p> @endif С @if (auth()->check() && auth()->user()->isSubscribed()) <p>Subscribed</p> @else <p>Not Subscribed</p> @endif 

 @subscribed <p>Subscribed</p> @else <p>Not Subscribed</p> @endsubscribed С @subscribed <p>Subscribed</p> @else <p>Not Subscribed</p> @endsubscribed 

 [...] use Illuminate\Support\Facades\Blade; class AppServiceProvider extends ServiceProvider { [...] public function boot() { Blade::if('subscribed', function () { return auth()->check() && auth()->user()->isSubscribed(); }); } [...] } 

 @if (auth()->check() && auth()->user()->isFollowing($user->id)) 

 Blade::if('following', function (User $user) { return auth()->check() && auth()->user()->isFollowing($user->id) }); 

 @following($user) <p>Following</p> @else <p>Not Following</p> @endfollowing 

 [...] protected function commands() { $this->load(__DIR__.'Commands'); require base_path('routes/console.php'); } [...] 

 Route::view('/welcome', 'welcome'); Route::redirect('home', 'dashboard');