Всем привет!

Это дайджест новостей от CutCode. Давайте посмотрим, что произошло за прошедший месяц в мире PHP и Laravel.

Новости PHP

Первые альфа-версии PHP 8.4 доступны для тестирования

Вышли первые две альфа-версии, дающие начало выпуска PHP 8.4. Обновления будут выходить каждые две недели по определенному графику, а финальный выпуск ожидается 21 ноября.

Заморозка функций ожидается 13 августа, а это значит, что некоторые изменения еще могут попасть в выпуск. На данный момент наиболее заметными являются следующие изменения:

Хуки свойств
Вызов `new` без скобок
Изменения JIT
Новая поддержка HTML5
Функции для работы с массивами: array_find, array_find_key, array_any и array_all.

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

Поздравляю Кельвина, Саки и Эрика!

Вышли PHP 8.2.21 и PHP 8.3.9

Выпуски с исправлениями ошибок вышли по расписанию.

Ядро PHP

Большинство новостей, связанных с ядром PHP подробно освещаются в серии PHP Core Roundup от PHP Foundation, мы лишь быстро по ним пробежимся:

📊RFC: Static class

RFC, о котором мы говорили в прошлом выпуске, отклонен после голосования.

📊RFC: Lazy Objects

Еще один RFC из прошлого выпуска, после проведения голосования был принят

📣RFC: Allow int type argument to BCMath function

В настоящее время функции BCMath принимают значения только в виде строк. Saki Takamachi предлагает разрешить передавать целочисленные значения.

📊RFC: Add bcdivmod to BCMath

На данный момент в PHP существует функция bcdiv для деления чисел произвольной точности, а также функция bcmod для получения остатка после деления. Saki Takamachi предлагает добавить новую функцию bcdivmod, чтобы получать частное и остаток за одну операцию в виде массива.

📣RFC: Property hook improvements

После внедрения хуков свойств, Ilija Tovilo и Larry Garfield нашли способ реорганизовать логику, чтобы увеличить производительность.

📣RFC: Asymmetric Visibility v2

Ilija Tovilo и Larry Garfield представили вторую версию своего RFC, который был отклонен в прошлом году. Ребята предлагают добавить синтаксис, подобный Swift, чтобы разрешить свойствам иметь отдельную («асимметричную») видимость для операций чтения и записи.

Laravel дайджест

Обновления Laravel

11.14. Adding Pest stubs to publish command

https://github.com/laravel/framework/pull/51933

PR затрагивает стабы. Уже давно PEST по-дефолту в Laravel, но при этом при публикации, стабов по PEST не было. Теперь будут.

11.14. Adds support for Markdown extensions to the Stringable class

https://github.com/laravel/framework/pull/51932

PR затрагивает Stringable-метод Markdown. Мы уже знаем, что этот метод также стал поддерживать extensions. Теперь передавать расширение в метод Markdown мы сможем через helper Stringable:

$html = str('# My Heading')->markdown(extensions: [new HeadingPermalinksExtension()]);

11.14. Improvements for the ServeCommand (add more loves & elevate DX)

https://github.com/laravel/framework/pull/51957

PR затрагивает команду по запуску виртуального сервера и немного ее прокачивает. Output до этого показывал время ответа в секундах и не все эндпоинты реквестов. После этого PR мы видим все эндпоинты каждого реквеста и также видим время ответа в миллисекундах:

11.14. Add support for acting on attributes through container

https://github.com/laravel/framework/pull/51934

Крутой PR, его еще не добавили в документацию, по крайней мере я не заметил. Итак, сервис контейнер теперь также будет поддерживать атрибуты. Появился метод whenHas (на самом деле чуть позже в процессе ревью PR он переименован whenHas attributes, но сути не меняет). Давайте взглянем например:

#[Attribute(Attribute::TARGET_PARAMETER)]

class AuthGuard implements ContextualAttribute

{

	public function __construct(

		public readonly string $name

	) {}

}

Далее, на уровне контейнера и нового метода мы делаем проверку. Если при Resolve сервиса через контейнер у определенного свойства будет этот атрибут, то в функции мы решаем, что именно в данном случае мы с вами вернем.

final class MyService

{
	public function __construct(
        #[AuthGuard('api')]
        private readonly Guard $guard
    ) {}
}

$service = Container::getInstance()->make(MyService::class);

Вот, например, у нас есть сервис, мы его получаем через контейнер, мы вешаем атрибут AuthGuard и указываем, что name у нас API. И в таком случае при резолве этого сервиса у нас в свойстве guard будет не просто guard, а у нас сразу будет с указанным name API.

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

Container::getInstance()->afterResolvingAttribute(

    attribute: OnTenant::class,
    callback: function (OnTenant $attribute, Connector $connector) {
        $connector->onTenant($attribute->tenant);
    }

);

Мы получаем зависимость, которую резолвим через DI, если на ней висит указанный атрибут. И в данном примере мы видим коннектор с атрибутом OnTenant и после резолва мы в этот коннектор дополнительно прокидываем определенную логику.

11.15. feat: add generics to Eloquent Builder and Relations

https://github.com/laravel/framework/pull/51851

PR у нас затрагивает Eloquent Builder и отношения, добавляя дженерики. Тем самым, в конечном итоге это упростит нам жизнь, и мы будем понимать, что именно у нас будет возвращаться в коллекциях определенных отношений и соответственно самих билдеров модели.

11.15. Add support for mime types in Resend mail transport

https://github.com/laravel/framework/pull/52006

PR у нас затрагивает класс mailable:

public function attachments(): array

{
    return [
        Attachment::fromPath('/path/to/file')
                ->as('name.pdf')
                ->withMime('application/pdf'),
    ];
}

добавлен метод withMime и для attachment мы сразу можем указать MimeType через Builder.

11.15. Feat: improve Factory generics, add generics to HasFactory

https://github.com/laravel/framework/pull/52005

Не уходим далеко от темы дженериков, также улучшения дошли до фабрик.

И мы также к трейту можем указать, какую именно фабрику будет возвращать модель:

// before

class User extends Authenticatable

{
    use HasFactory;
    protected function newFactory(): UserFactory
    {
        return UserFactory::new();
    }
}

// after

class User extends Authenticatable

{
    /** @use HasFactory<UserFactory> */
    use HasFactory;
    protected static string $factory = UserFactory::class;
}

Очень полезно, так скоро дойдем и до того, что будем справляться и без плагина Laravel IDEA.

11.15. Ask About View Next To Name For Create Mail Command

https://github.com/laravel/framework/pull/52057

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

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

11.15. Make Router Tappable

https://github.com/laravel/framework/pull/52051

Большой PR, который у нас затрагивает роутер. Добавился трейт Tappable. Тем самым в роутере у нас будет доступен метод метод tap. Если у вас большая инфраструктура: пакетная, с доменами, теперь не придется как ранее подключать кучу файлов, так же дополнительно в тестах подключать эти файлы и все будет выглядеть следующим образом:

class RouteRegistrar

{
    private const string ENDPOINT = 'redacted';
    public function __invoke(Router $router)
    {
        $router->post(self::ENDPOINT, WebhookController::class)->name(self::ENDPOINT);
    }
}

$router
    ->tap(new Redacted1Webhooks\RouteRegistrar())
    ->tap(new Redacted2Webhooks\RouteRegistrar())
    ->tap(new Redacted3Webhooks\RouteRegistrar())
    ->tap(new Redacted4Webhooks\RouteRegistrar());

есть удобный класс, есть метод tap чтобы быстро их объявить и так же объявить в тестах, если это требуется.

11.16. Install Laravel Reverb version 1.0 instead of @beta

https://github.com/laravel/framework/pull/52096

Если используете Reverb при выполнении команды по установке Broadcasting, до этого устанавливалась бета-версия Reverb, а теперь же будет устанавливаться версия 1.0

11.16. Include 'success' console component

https://github.com/laravel/framework/pull/52112

PR затрагивает консольные команды, и также был добавлен компонент Success для вывода успешного уведомления. На скриншоте видим как это будет выглядеть:

11.17. Add whereLike clause to query builder

https://github.com/laravel/framework/pull/52147

PR затрагивает query builder. Для тех, кто через Macroable прописывал дополнительно в builder методы whereLike, whereNotLike, orWhereLike, orWhereNotLike. Теперь все это будет в коробке.

whereLike($column, $value, $caseSensitive = false): Выполняет запрос LIKE с возможностью учета регистра.

whereNotLike($column, $value, $caseSensitive = false): Выполняет запрос NOT LIKE с возможностью учета регистра.

orWhereLike($column, $value, $caseSensitive = false): Добавляет предложение OR LIKE с дополнительной чувствительностью к регистру

orWhereNotLike($column, $value, $caseSensitive = false): Добавляет предложение OR NOT LIKE с дополнительной чувствительностью к регистру

После этого PR вы сможете добиться того же самого по тому же запросу.

$users = DB::table('users')
    ->whereLike('email', 'john.doe@example.com')
    ->get();

или для поиска с учетом регистра

$users = DB::table('users')
    ->whereLike('email', 'John.Doe@example.com', true)
    ->get();

PostgreSQL использует оператор ilike для операций, нечувствительных к регистру, и оператор like для операций, чувствительных к регистру.

MySQL использует оператор like для операций, нечувствительных к регистру, и оператор like binary для операций, чувствительных к регистру.

SQLite использует оператор like для операций, нечувствительных к регистру. Для операций, чувствительных к регистру, SQLite поддерживает оператор glob, который преобразует привязки, заменяя символы _ и %.

SQL Server по умолчанию использует оператор like. Чувствительность к регистру в SQL Server определяется сортировкой базы данных или столбца. Если флаг чувствительности к регистру установлен в значение true, система выдаст исключение.

Также поддержка Postgres с ilike. Все это теперь в коробке. Пожалуйста, пользуйтесь.

В документации я пока что всего этого не заметил, но думаю к выпуску этого дайджеста либо на днях добавят.

11.17. Allow microsecond travel

https://github.com/laravel/framework/pull/52190

Tim Macdonald добавил поддержку микросекунд в travel функционал. Пример:

travel(5)->microseconds()

Видео-версия дайджеста:

PHP и Laravel дайджест новостей за июль 2024 года