Пых

Ilija Tovilio, на текущий момент один из самых активных контрибьюторов в PHP, только что дал мне карму для публикации RFC и пожелал удачи! Буду считать это хорошим знаком! 💪

https://externals.io/message/122052#122053

Разберу самый частый комментарий к моему PR.

Многие полагают, что конструкция new A()->method() неоднозначна. Это заблуждение. По этой логике само выражение new A() в текущем PHP тоже неоднозначно, потому что можно представить, что сначала вызывается функция A(), а потом к её результату применяется new. Но это не так.

Грамматика для new выглядит следующим образом: T_NEW class_name_reference constructor_arguments, где class_name_reference — это либо class_name, либо new_variable, либо (expr) (именно в скобках). В свою очередь new_variable организована специально для new таким образом, что в ней не может быть вызовов со скобками. Получается, что сечайс в PHP мы можем создать объект через new тремя способами: new MyClass(), new $class(), new (getMyClass())(). То есть если хочется для имени класса использовать полноценное выражение с вызовами, нужно обязательно обернуть его в дополнительные скобки. Таким образом разрешается эта неоднозначность.

Мой PR никак не нарушает ничего из вышесказанного, лишь делает скобки вокруг всего new-выражения опциональными. По сути, это как вместо (MyClass::new())->method() писать просто MyClass::new()->method(). Приоритет однозначен и не требует уточнения, код легко читается слева направо. В Java и C# испокон веков можно писать именно так. То, что для вас сейчас непривычно, для джавистов и шарпистов — база.

Подтверждением моих слов служит также и то, что по изменённой мной грамматике Bison безошибочно генерирует LR(1) парсер, который потом успешно компилируется в PHP и проходит все тесты. LR(1) парсер является детерминированным и не допускает неоднозначностей в описании грамматики.

new MyClass()->method() без скобок!

Вдохновлённый митапом, разобрался с синтаксисом Bison и закинул свой первый Pull Request в исходники PHP. Это изменение позволит обращаться к объектам, созданным через new, не оборачивая их в скобки. Во избежание неоднозначности работать будет только при наличии скобок аргументов конструктора.

final class A
{
   const CONSTANT = 'constant';
   public static $staticProperty = 'staticProperty';
   public static function staticMethod() {}
   public $property = 'property';
   public function method() {}
   public function __invoke() {}
}

new A()::CONSTANT;
new A()::$staticProperty;
new A()::staticMethod();
new A()->property;
new A()->method();
new A()();

Поддерживаются также динамические имена классов и анонимные классы (см. тесты).

После первичного одобрения сделаю RFC. Пока накидайте лайков в PR, пожалуйста.

https://github.com/php/php-src/pull/13029

Мои слайды: https://vudaltsov.github.io/php83-slides/

🎅 Через пару часов PHP Community Meetup!

Затусим в конце года, как обычно! Обсудим PHP 8.3, заслушаем доклады, запустим опрос сообщества и наверняка похоливарим на разные темы.

Что будет:
• Евгений Прохоров прямо на наших глазах ускорит PHP,
• Кирилл Несмеянов докажет, что никто, кроме него, не знает PHP,
• шеф-повар Александр Макаров приготовит Composer под новым соусом,
• Валентин Удальцов (это я) покажу вам PHP 8.3 во всей красе.

Проведёт мероприятие Михаил Каморин, а подсказывать текст из-за кулис будет наш бессменный режиссёр и продюсер — Алиса Круглова!

Залетайте в трансляцию на PHP Point, будет весело, как мне сейчас! Всех ждём в 12 по Москве.

https://youtu.be/JyxGieyBj3k

Я сделал перегрузку методов для PHP!

К выходу PHP 8.3 я решил реализовать фичу, которая в новой версии не только не появилась, но и была окончательно выпилена (с чем я согласен).

Итак, вот мой вариант оверлоадинга/перегрузки/Ad-hoc-полиморфизма для PHP:

use Typhoon\Overloading\Overload;

final readonly class WhateverHandler
{
    public function handle(mixed ...$args): string
    {
        return Overload::call();
    }

    #[Overload('handle')]
    public function handleInt(int $int): string
    {
        return __METHOD__;
    }

    #[Overload('handle')]
    public function handleIntAndFloat(int $int = 0, float $float = M_E): string
    {
        return __METHOD__;
    }
}

$handler = new WhateverHandler();

// WhateverHandler::handleInt
var_dump($handler->handle(300));

// WhateverHandler::handleIntAndFloat
var_dump($handler->handle(float: 1.5));

В перегружаемый метод пишем один-единственный вызов Overload::call(). Он, кстати, специально ничего не принимает, чтобы упростить использование и избежать ошибок. Затем добавляем перегружающие методы с такой же статичностью/видимостью и помечаем их атрибутом #[Overload('перегружаемый метод')]. Вуаля! Теперь можно вызывать перегружаемый метод с аргументами различных типов, а Overload будет передавать поток управления в методы с подходящей сигнатурой.

Главный вопрос, конечно, скорость. Но несмотря на то, что это реализация в первом приближении и есть идеи по улучшению, уже работает достаточно шустро. Благодаря мемоизации в воркерах капитальной разницы с прямым вызовом не будет, особенно если перегруженных методов не очень много. Для PHP-FPM предусмотрен кэш с поддержкой OPcache (примерно как в докладе).

Короче, ставьте, экспериментируйте, закидывайте идеи в комментарии и в Issues в репозиторий.

https://github.com/typhoon-php/overloading

P.S. Всех с третьей восьмёркой! 🎉

Кэш через OPcache на RnD PHP #6

Трансляция: https://www.youtube.com/live/8ZzAqhgmBFg?t=204
Слайды: https://vudaltsov.github.io/cache-via-opcache/

Service Dumper Bundle

При работе с DI в Symfony бывает полезно вывести сервис на экран, чтобы убедиться, что он правильно сконфигурирован. Да, есть очень полезные команды debug:container, debug:autowiring и lint:container, они помогают отладить контейнер, но это не то же самое, что увидеть дамп реального объекта.

Год назад я добавил в проект консольную команду, которая выводила на экран любой сервис. Для простоты она переиспользовала test.service_container из FrameworkBundle для доступа к приватным сервисам.

Недавно утилитка пригодилась мне на курсе. Когда мы проходим Symfony Dependency Injection, я всегда показываю, как выглядят сконфигурированные серисы в рантайме. Становится гораздо понятнее, как работает тот же tagged_locator или inline_service.

До сих пор я таскал команду из проекта в проект, но вчера, наконец, оформил её в виде бандла. На этот раз я скопировал и упростил оригинальные TestServiceContainerWeakRefPass и TestServiceContainerRealRefPass, чтобы не зависеть от FrameworkBundle и деталей объявления test.service_container, добавил разные варианты вывода сервисов на экран (var_dump, symfony/var-dumper, xdebug_break, кастом), а также разрешил менять алгоритм поиска сервисов по id.

В общем, ставьте, пробуйте, предлагайте идеи по улучшению!

https://github.com/phpyh/service-dumper-bundle

Ответочка для https://t.me/tg_5minphp/1211.

Кэш через OPcache на RnD PHP

В субботу наконец-то выступлю в Ростове-на-Дону! Два года назад митап отменили из-за вспышки ковида, поэтому смыслом поездки стало знакомство с городом, Николаем @drup8 и его замечательной семьёй. В этот раз проблема только в том, что не получится быстренько долететь на самолёте, но к поездам мне не привыкать.

Мой сказ будет хардкорным: порефлексим, попишем в приват, повызываем opcache_* функции. Хорошо, что меня поставили первым, загружу всех в самом начале. 😈

Также в программе доклады Александра Дубовского про инструменты профилирования и Сергея Ивченко про Transactional Outbox.

Регистрация: https://php-rnd.timepad.ru/event/2663787/. Ставь 🤝, если придёшь. Для всех остальных будет трансляция.

Курсы, деньги, две работы

Вчера с Петром записали подкаст про мои пертурбации в этом году. Рассказал, почему я ушёл с двух работ подряд, как запустил курс хардкорного PHP ну и конечно же про доходы.

https://t.me/tg_5minphp/1214

Упрощаем тесты с участием файлов

Представим, что мы написали функцию parseCSVFile, которая принимает путь до CSV-файла и возвращает распарсенные данные в удобном нам формате. Как её протестировать?

Первая мысль — написать несколько CSV-файликов, положить их рядом с тестом, а в самом тесте сравнить результат их парсинга с ожидаемыми значениями. Очень просто, но неудобно: тест разбросан по нескольким файлам, сложно читать и вносить изменения.

Вторая мысль — mikey179/vfsstream. Это пакет, который позволяет налету в памяти создавать файловую систему и взаимодействовать с ней как с реальной. Круто, но для тестирования нашей простенькой функции слишком мощно.

А теперь третий вариант, оптимальный. В PHP есть data stream wrapper (а-ля RFC 2397), который позволяет инлайнить содержимое файла прямо в "путь". Формула проста: data://{MIME-тип},{Содержимое}. В итоге тест будет выглядеть так:

$csv = <<<'CSV'
    data://text/csv,PHP Version,2022-01,2022-07,2023-01,2023-07
    8.0,23.9%,20.6%,16.2%,12.3%
    8.1,9.1%,24.5%,38.8%,39.3%
    8.2,0.0%,0.0%,4.7%,17.2%
    CSV;
$expected = [...];

$parsed = parseCSVFile($csv);

self::assertSame($expected, $parsed);

https://www.php.net/manual/ru/wrappers.data.php

ContainerBuilder в PHP-конфигах Symfony

@oneNevan на курсе показал крутую штуку: в PHP-конфигах Symfony можно запрашивать не только конфигураторы сервисов и расширений DI, но и текущую среду, а также ContainerBuilder!

Последнее безумно удобно в сложных инфраструктурных модулях, которые помимо сервисов добавляют свои CompilerPass-ы, автоконфигурируемые интерфейсы и обработчики атрибутов. Получается, можно не тянуться в Kernel::build через весь проект, чтобы всё это настроить.

В документации Symfony про такие чудеса ни слова. Узнать о них можно лишь "случайно" заглянув в код. 😅
Оказывается, в доке есть пример с ContainerBuilder, спасибо @SymfonyAnton, раскрыл глаза. 👀

Выше я, конечно, подразумевал модульную структуру проекта, при которой конфиг пакета размещается вутри него самого, а не в config (смотрите мой доклад про package-by-feature и модульный скелетон для Symfony).

Ремонт Logitech MX ERGO, часть 2

Вчера я решил третью проблему своего трекбола: поменял кнопки. Оказалось, что оригинальные японские Omron D2FС-F-7N(10M) весьма неплохие, но рассчитаны на 10 миллионов кликов (указано в маркировке), так что, вероятно, они своё честно отслужили. У Omron целая серия таких элементов с разными характеристиками, все они взаимозаменяемы. Но, посоветовавшись с одним мышиным мастером, я в итоге выбрал геймерские Каilh GM 8.0 (80М). Заказал на Авито, так как терпеть ещё месяц прерывающееся перетаскивание невмоготу, а разница в цене для разовой покупки не так принципиальна: 500 рублей за пару против ~300 на AliExpress.

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

В третий раз собрал свой бедный трекбол, и наконец-то всё работает идеально! Надеюсь, несколько лет ещё прослужит.

Как разбить итератор на батчи?

Представим, что нам надо распарсить какой-то гигантский документ и сформировать вставки в базу по 10к элементов. Для решения этой задачи не обязательно писать кастомный итератор, можно всё сделать "на коленке". Оборачиваем генератор с распарсенными данными в NoRewindIterator, чтобы избежать его перемотки, а затем применяем LimitIterator до тех пор, пока не закончатся данные:

final readonly class Importer
{
  private const BATCH_SIZE = 10_000;

  public function __construct(private Connection $connection) {}

  public function import(): void
  {
    foreach ($this->parseBatched() as $batch) {
      $sqlValues = '';
      $values = [];

      foreach ($batch as $value) {
        $sqlValues .= ($sqlValues === '' ? '' : ',') . '(?)';
        $values[] = $value;
      }

      $this->connection->execute(
        'insert into data (val) values ' . $sqlValues,
        $values,
      );
    }
  }

  private function parseBatched(): Generator
  {
    $parsed = new NoRewindIterator($this->parse());

    while ($parsed->valid()) {
      yield new LimitIterator($parsed, limit: self::BATCH_SIZE);
    }
  }

  private function parse(): Generator
  {
    // ...
  }
}

Valentin Gyver или не софтом единым

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

Выбор трекболов на рынке невелик, самый крутой — Logitech MX Ergo. Посудите сами: удобный шарик под большой палец, Bluethooth с поддержкой 2-ух устройств, эргономичный дизайн с изменяемым углом наклона, миддл-клик, отклонение колёсика и ещё 3 кнопки, программируемые в удобном macOS-совместимое приложение Logi Options+. Короче, шедевр.

Конкретно трекболом, который в разных агрегатных состояниях вы видите на фото, я пользуюсь с 2019-ого года (в Happy Inc. у меня был ещё один такой же в офисе). За это время он, конечно, постарел: microUSB разъём для зарядки, аккумулятор держит меньше месяца, левая кнопка мыши иногда пропускает клики. Ну а раз Logitech не обновляет трекбол, трекбол обновляю я!

Накануне забрал запчасти с Алика и вчера ночью решил первые две проблемы: проапгрейдил разъём до Type C и поставил новый аккумулятор большей ёмкости (1200 махов вместо 500). При пайке разъёма, конечно, пришлось поколхозить, потому что Type C шире и китайский вариант, уже готовый для моей простой пятивольтовой задачи, имеет две гигантские ножки. Но в итоге вышло приемлемо. И да, за счёт более ёмкого аккумулятора трекбол стал тяжелее (подковал блоху 😅), но это абсолютно неважно, ведь его не надо двигать! Также сфоткал кнопки левого и правого клика: их закажу и поменяю потом. Кстати, если кто-то в курсе, какие служат дольше, буду очень благодарен.

О результатах судите по фото. В процессе ремонта я испытал куда больший кайф, чем от покупки нового устройства. Этот трекбол точно заслужил такого отношения!