Я сразу, как только вышла новость о релизе, решил, что нужно посмотреть, пощупать и разобраться, чего же изменилось. Да-да, на днях, а именно 8 февраля 2022, вышел официальный релиз Laravel 9, который включает довольно много новых улучшений. Для тех же из нас, кто не боится таких слов, как alpha и beta, девятая версия фреймворка давно не новость и уже в работе.

Теперь эта версия будет поддерживаться дольше (LTS), и разработчики фреймворка пришли к решению не выпускать новые версии каждые 6 месяцев, а делать это раз в год - в феврале. Судя из расписания, эта версия останется актуальной год, а обновления безопасности будут выпускаться вплоть до 2025 года.

Версия языка

Новый Laravel работает только с php 8.0 и выше. Почему это так? Как мы увидим далее, разработчики воплотили в девятом фреймворке немало фишек последней версии языка, а значит, что использование php7 означало бы потерю именно этих нововведений.

composer create-project laravel/laravel example-app

Команда создала директорию, наполнила ее файлами нового проекта и установила зависимости, среди которых основным является laravel/framework версии v9.0.2. Как видим, релизную версию уже патчат.

Новые помощники

Представлены две новые функции-помощника, которые, выполняя уже встроенный ранее функционал, делают это гораздо удобнее.

Добавленная функция str создает объект класса Illuminate\Support\Stringable для переданной строки. Это позволяет применять к тексту все методы манипуляции строкой, доступные данному классу. Такая возможность существовала и в 8 версии фреймворка и реализовывалась через Str::of, но теперь получается немного лаконичнее.

<?php

Route::get('/', function () {
    return str('Hello, ') // Создаем класс из строки
      ->append('Max')     // Метод добавления в конец строки
      ->upper();          // Метод делает все буквы строки заглавными
});

Функция to_route создает редирект на существующий роут по его имени. Мы можем воспользоваться ей как в наших роутах, так и вернуть ее результат из метода контроллера.

<?php

// Главная страница
Route::get('/', function () {
    return view('welcome');
})->name('home'); // Имя роута для главной страницы

// Старый способ редиректа по имени роута
Route::get('/test', function () {
    return redirect()->route('home');
});

// Новый способ редиректа с помощью функции to_route
Route::get('/new_test', function () {
    return to_route('home');
});

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

<?php

Route::get('/', function () {
	return to_route('users.show',    // Наименование роута
  	['user' => 1],                 // Параметры роута
    302,                           // Код статуса редиректа
    ['X-Framework' => 'Laravel']); // Дополнительные заголовки
});

Также благодаря базированию на языке PHP 8, в классе \Illuminate\Support\Str добавилась поддержка таких функций для работы со строкой как str_contains(), str_starts_with() и str_ends_with().

Страница исключений

Встроенная в фреймворк страница сообщения об исключении была и раньше крайне удобной, информативной и симпатичной. Теперь в ней изменилось оформление. Добавлены возможность переключения темы на светлую/темную, настройка функционала "открыть в редакторе" и др.

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

Анонимные миграции

Возможность создавать миграции в виде анонимных классов появилось чуть ранее в Laravel 8.37. А затем в 9 - это стало своего рода стандартом, и при вызове консольной команды php artisan make:migration создается класс без названия, расширяющий Migration. Довольно таки небольшое изменение, но мне показалось достаточно интересным, чтобы отметить и его.

Миграция, добавляющаяся в database/migrations при создании проекта:

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('password_resets', function (Blueprint $table) {
            $table->string('email')->index();
            $table->string('token');
            $table->timestamp('created_at')->nullable();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('password_resets');
    }
};

Полнотекстовая индексация

Если мы пользуемся такими реляционными системами БД как MySQL или PostgreSQL, то можем прям в миграции добавить для текстовых полей полнотекстовую индексацию. При чем это делается всего лишь вызовом одного метода:

<?php

$table->text('bio')->fulltext();

По таким полям мы можем искать специальными методами полнотекстового поиска whereFullText и orWhereFullText, добавляя их как условие where. Эти методы преобразуются в SQL запросы поиска по индексу текста.

<?php

$users = DB::table('users')
           ->whereFullText('bio', 'php developer')
           ->get();

Общий контроллер

Используя методы роутера controller и group, появилась возможность объединять несколько роутов в одну группу с общим для них контроллером. Это довольно удобно и позволяет экономить на количестве кода, не указывая одно и тоже в нескольких строках. Если раньше нам пришлось бы писать как-то так:

<?php
use \App\Http\Controllers\UsersController;

Route::get('/users', [UsersController::class, 'index']);
Route::get('/users/{id}', [UsersController::class, 'showOne']);

То теперь можно это сгруппировать:

<?php
use \App\Http\Controllers\UsersController;

Route::controller(UsersController::class)->group(function () {
  Route::get('/users', 'index');
  Route::get('/users/{id}', 'showOne');
});

Scoped Bindings в роутерах

Благодаря усилиям разработчика из Амстердама Клаудио Деккера (Claudio Dekker) была реализована и внедрена удобная возможность связывать параметры строки запроса между собой. Лично я не сразу смог понять, что за связанность такая, но на примере кода все становится "ясно-понятно".

Предположим, что мы создали таблицы с пользователями и статьями, причем каждая статья относится к определенному пользователю, как многое-к-одному. То есть у каждого пользователя есть статьи, которые он написал. И вот мы сделали url для вывода списка статей: /users/{user}/posts. Отсюда логично построить url для вывода отдельной статьи конкретного пользователя по следующей ссылке: /users/{user}/posts/{post}.

Мы используем два параметра независимых друг от друга для идентификаторов пользователя и статьи. Это позволит сопоставлять любого пользователя с любым постом. Конечно, этого нам не нужно, но и делать проверку вручную - идея так себе. Новый метод scopeBindings сделает это за нас.

<?php

use App\Models\Post;
use App\Models\User;

Route::get('/users/{user}/posts/{post}', function (User $user, Post $post) {
    return $post;
})->scopeBindings();

Теперь, если мы попытаемся открыть статью несоответствующую пользователю (связь по внешнему ключу в таблице с другим пользователем), то получим страницу 404 ошибки:

Также есть возможность объединить в одну группу роуты, для которых важно соблюдение связывания параметров:

<?php

Route::scopeBindings()->group(function () {
    Route::get('/users/{user}/posts/{post}', function (User $user, Post $post) {
        return $post;
    });
  
    Route::get('/users/{user}/comments/{comment}', function (User $user, Comment $comment
        return $comment;
    });
});

Laravel Scout

Полнотекстовый поиск по отдельным параметрам Eloquent моделей, основанный на драйвере базы данных - вот, что представляет из себя этот Scout. Он отлично подходит для поиска по тексту в небольших и даже среднего размера базах. Если наша база вполне умещается на одном сервере, тогда мы можем не использовать такие драйверы как Algolia или MeiliSerach, а воспользоваться простым и удобным Scout с драйвером MySQL/PostgreSQL.

Для начала нужно установить Laravel Scout и выбрать его провайдер-класс для полнотекстового поиска:

composer require laravel/scout
php artisan vendor:publish

Which provider or tag's files would you like to publish?:
  [0 ] Publish files from all providers and tags listed below
  [1 ] Provider: Fruitcake\Cors\CorsServiceProvider
  [2 ] Provider: Illuminate\Foundation\Providers\FoundationServiceProvider
  [3 ] Provider: Illuminate\Mail\MailServiceProvider
  [4 ] Provider: Illuminate\Notifications\NotificationServiceProvider
  [5 ] Provider: Illuminate\Pagination\PaginationServiceProvider
  [6 ] Provider: Laravel\Sail\SailServiceProvider
  [7 ] Provider: Laravel\Sanctum\SanctumServiceProvider
  [8 ] Provider: Laravel\Scout\ScoutServiceProvider
  [9 ] Provider: Laravel\Tinker\TinkerServiceProvider
  [10] Provider: Spatie\LaravelIgnition\IgnitionServiceProvider
  [11] Tag: cors
  [12] Tag: laravel-errors
  [13] Tag: laravel-mail
  [14] Tag: laravel-notifications
  [15] Tag: laravel-pagination
  [16] Tag: sail
  [17] Tag: sail-bin
  [18] Tag: sail-docker
  [19] Tag: sanctum-config
  [20] Tag: sanctum-migrations
 > 8
 
 Copied File [/vendor/laravel/scout/config/scout.php] To [/config/scout.php]

Был создан конфигурационный файл для Scout. И в нем мы можем установить нужный нам драйвер database.

Теперь можно настраивать поиск по в классах - моделях, чтобы определить какие модели имеют поддержку полнотекстового поиска и по каким полям. И обязательно добавим трейт Searchable к модели, что позволит использовать все необходимые нам методы поиска. Как видно из скриншота ниже, кроме имени я добавил поиск и к нестандартному полю bio (биография).

Поищем всех пользователей, у которых в биографии есть упоминание обучения в ВУЗе.

<?php

Route::get('/', function () {
    return \App\Models\User::search('институт')->get();
})->name('home');

Покрытие кода тестами

В Laravel 9 мы теперь можем генерировать отчет о покрытии кода тестами с помощью консольной команды php artisan test. Давайте посмотрим, что отобразится, если запустить команду как и раньше.

Если посмотрим подсказку по команде запуска тестов, то увидим 2 новых ключа --coverage и --min[=MIN].

php artisan help test

Usage:
  test [options]

Options:
      --without-tty         Disable output to TTY
      --coverage            Indicates whether code coverage information should be collected
      --min[=MIN]           Indicates the minimum threshold enforcement for code coverage

Coverage - указывает, следует ли собирать информацию о покрытии кода.

Min - минимальное пороговое значение для покрытия кода. Другими словами, это возможность указать, какой минимальный уровень покрытия кода тестами для нас удовлетворителен.

Я запускаю команду в консоли, но вижу ошибку.

Не установлен драйвер, но, думаю, это легко починить, установив Xdebug для php. Как несложно было догадаться по скриншотам, у меня MacOS, поэтому воспользуюсь встроенными утилитами для установки и перезапуска сервисов. Предположу, что на другие ОС установка не намного сложнее.

pecl install xdebug
brew services restart php
brew services restart nginx

Казалось бы, запускаем команду и радуемся результату, но нет, опять ошибка.

Xdebug ругается о том, что не установлен режим покрытия кода тестами. Это мы легко исправляем и видим красивое описание покрытия кода.

Пару слов в конце

С публикацией нового релиза, мы увидели немало полезных новшеств, поддержку и реализацию возможностей последней версии языка. Мы уже увидели два патча, и возможно будет еще несколько, прежде чем фреймворк станет по-настоящему достоин продакшна. Но мои руки уже чешутся, чтобы обновиться на проектах до последней 9 версии Laravel.