В PHP 8.5 наконец-то будет clone with!

Как-то незаметно в PHP 8.5 приняли долгожданный RFC https://wiki.php.net/rfc/clone_with_v2.

1. Клонирование теперь не только языковая конструкция, но и функция clone(object $object, array $withProperties = []): object. Благодаря этому можно писать array_map(clone(...), $myObjects).

2. Вторым аргументом можно передать новые значения свойств для склонированного экземпляра. Переопределить можно любые видимые в текущей области свойства, в том числе readonly, что наконец-то даёт нам полный инструментарий для работы с иммутабельными структурами:

final readonly class Request
{
    public function __construct(
        public string $path = '',
        public array $headers = [],
    ) {}

    public function withPath(string $path): self
    {
        return clone($this, ['path' => $path]);
    }

    public function withHeader(string $name, string $value): self
    {
        return clone($this, ['headers' => [
            ...$this->headers,
            $name => $value,
        ]]);
    }
}

new Request()
    ->withPath('/phpyh')
    ->withHeader('Content-Type', 'application/json');

Почему это важная фича и как без неё обходиться прямо сейчас, подробно рассказал Brent Roose в ролике 📹 Cloning Readonly Classes in PHP 8.2.
____________

До конца завтрашнего дня билеты на Пых.конф’25 всего по 12 000 рублей!

Итоги конкурса факапов!

Тройка победителей:
🥇 Алексей Солодкий «phpMyLogin» (YouTube, VK Видео) — 74 голоса,
🥈 Никита Койдо «Тест-рассылка 18+» — 63 голоса,
🥉 Олег Мифле «Уверенность, стирающая товары» (YouTube, VK Видео) — 55 голосов.

👏 И я решил дополнительно наградить Максима Божко за три крутые истории: «Слэш судьбы», «Генdick» и «Финальный статус». Суммарно они набрали 135 голосов!

Все четверо получают бесплатные проходки на Пых.конф’25, а Алексей ещё и слоника Пых. Всем спасибо за истории и участие в голосовании!
____________

Кстати, про слоников. Недавно на planeta.ru опубликовал статус проекта. Вкратце, всё по плану, партия приедет ко мне в начале июля.

Опциональный $column_key в array_column

Я довольно часто использую array_column для индексации объектов и ассоциативных массивов по публичному свойству/ключу:

final readonly class Article
{
    public function __construct(
        public string $articleId,
        public string $title,
    ) {}
}

array_column(
    array: [
        new Article(Ramsey\Uuid\v7(), 'Люблю PHP'),
        new Article(Ramsey\Uuid\v7(), 'Безразличен к Go'),
        new Article(Ramsey\Uuid\v7(), 'Уважаю Scala'),
    ],
    column_key: null,
    index_key: 'articleId',
);

И с тех пор, как у нас появились именованные аргументы, очень хочется писать короче: array_column($articles, index_key: 'articleId'). А нельзя, потому что второй параметр $column_key обязательный.

Прямо сейчас у меня так много всяких организаторских дел, что я готов себе позволить отвлечься только на что-то очень полезное и нестандартное, чтобы качественно переключиться. И вот только что, буквально за 10 минут, состряпал простейший PR, который делает $column_key опциональным. Надеялся, что такое просто смержат после ревью, но уважаемый мейнтейнер Tim Düsterhus порекомендовал обсудить это изменение в internals. Что ж, письмо будет следующим отвлечением! А вы пока накиньте там лайков, пожалуйста.
____________

Вчера мне скинули видео готового слоника Пых, и я оплатил вторую половину счёта. Так что сегодня-завтра вся партия отправится в Москву транспортной компанией! Готовьте свои СДЕКи 😉

Слоны 💙 прилетели!

Thesis Amqp 1.0.0

Многие заметили, что в проекте Thesis уже несколько месяцев подряд происходит какая-то движуха. Если вкратце, мы с Вадимом решили под этим именем выпустить набор современных асинхронных компонентов для PHP, а в будущем, вероятно, и свой фреймворк.

Основной фокус на ближайшее время — реализация недостающих в экосистеме неблокирующих драйверов для эффективного взаимодействия с инфраструктурой (в планах NATS, Kafka, gRPC, Cassandra, YDB).

Сегодня мы рады анонсировать стабильный, готовый к продакшну релиз пакета thesis/amqp:
• под капотом файберы и AMPHP 3, так что клиент можно использовать как в асинхронных, так и синхронных рантаймах,
• API для работы с подтверждениями в режиме publisher confirms,
• API для работы с возвратами при отправке сообщений с флагом mandatory,
• API итераторов для упрощённого чтения сообщений из очереди,
• API публикации и получения сообщений эффективными батчами (меньше вызовов, потенциально умещаем несколько фреймов в 1 TCP-пакет),
• встроенная поддержка RPC,
• гибкая конфигурация и хорошо типизированный код.

$client = new Client(Config::default());

$channel = $client->channel();
$channel->confirmSelect();

$confirmation = $channel->publishBatch([
    new PublishMessage(
        message: new Message(
            body: 'Hello!',
            deliveryMode: DeliveryMode::Persistent,
            timestamp: new DateTimeImmutable(),
        ),
        exchange: 'x',
        routingKey: 'y',
        mandatory: true,
    ),
    // ...
]);

$result = $confirmation->await();

foreach ($result->unconfirmed as $unconfirmedMessage) {
    // ...
}

foreach ($result->unrouted as $unroutedMessage) {
    // ...
}

Мы сделали чат Thesis Community, где вы можете задавать вопросы, делиться идеями и предлагать улучшения.

У нас к вам две просьбы:
⭐️ поставить звезду thesis/amqp,
👩‍🎨 помочь с логотипом для проекта Thesis — лучший скетч (можно использовать ИИ) мы отдадим дизайнеру на отрисовку, а автору подарим слоника Пых.