events-router¶

Любая система начинается не с кода, а с того, что в ней происходит. Заказ оформили, оплатили, отменили. Пользователь зарегистрировался. Платёж не прошёл. На каждое такое событие кто-то должен отреагировать: списать товар со склада, отправить письмо, начислить бонусы, предупредить CRM.

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

events-router решает именно это. Все реакции на события описываются в одном файле — так же, как HTTP-маршруты в Slim:

<?php

return static function (EventRouter $events): void {

    $events->setPrefix('shop');

    $events->group('order', static function (RouteGroup $group): void {
        $group->listen('created', Listener\Order\ReserveStock::class);
        $group->listen('created', Listener\Order\SendConfirmationEmail::class);

        $group->group('{order_id}', static function (RouteGroup $order): void {
            $order->listen('paid', Listener\Order\MarkOrderPaid::class);
            $order->listen('paid', Listener\Bonuses\AccrueBonuses::class);
        })
            ->add(Middleware\Idempotency\IdempotencyGuard::class);
    })
        ->add(Middleware\EventLog\EventLogger::class);
};

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

Для кого¶

Для PHP-разработчиков, которые пишут маршруты в Slim и хотят так же писать реакции на события. Для проектов на Bitrix и без него, для синхронной рассылки из кода и для воркеров очередей. Если вы знаете, как устроен $app->group(...)->add(...), документация вам почти не понадобится. Почти.

Чем отличается от привычных диспетчеров¶

Язык¶

Документация — на русском. Сообщения библиотеки — исключения и лог — по умолчанию на русском, на английском — с ключом конфига 'locale' => 'en', см. Конфигурацию.

Как устроена документация¶

Документация разделена по тому, зачем вы сюда пришли.

Каждый пример на сайте — настоящий PHP-файл. Он выполняется в CI, а его вывод сверяется с тем, что напечатано на странице. Документация не может тихо разойтись с кодом: сборка просто не пройдёт.