rpc.pre_execute

Найважливіша подія: на ній бандл валідує й конвертує параметри, захоплює блокування і виконує сам метод. Ваш лістенер стає частиною цього конвеєра — де саме, визначає пріоритет.

Коли генерується

Один раз на кожне виконання методу: після промаху кешу й після того, як метод знайдено. Для будь-якого джерела запиту — HTTP, консоль, batch, Messenger, відкладене виконання notifications/callback, прогрів кешу.

Не генерується для кешованої відповіді, невідомого методу і прийому notifications/callback (метод виконується пізніше, і тоді подія буде).

Вбудовані лістенери

Що можна змінити

$event->params — це саме ті аргументи, з якими буде викликано метод. Ефект залежить від пріоритету:

• Ключ кешу рахується з сирих параметрів запиту, тож зміни $params на нього не впливають.
• Замінювати $event->rpcRequest не варто — це розсинхронізує сервер.

Зупинка поширення пропускає виклик методу. Підтримується лише сценарій помилки: згенеруйте rpc.error і зупиніть подію — так роблять вбудовані лістенери. Повернути успішний результат без виклику методу штатного способу немає.

public function __construct(private RpcEventFactory $events) {}

// ...
$this->events->fireError($event->rpcRequest, new RpcLogicException('Not allowed'));
$event->stopPropagation();

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

Значення параметра з контексту

Підставити ідентифікатор поточного клієнта замість того, що передав клієнт (захист від підміни):

#[AsEventListener(RpcEvent::PRE_EXECUTE, priority: 1001)]
final class TenantParamListener
{
    public function __construct(private TenantResolver $tenants) {}

    public function __invoke(RpcPreExecuteEvent $event): void
    {
        if (array_key_exists('tenantId', $event->params)) {
            $event->params['tenantId'] = $this->tenants->current();
        }
    }
}

Пріоритет 1001: після формування списку аргументів (1002), але до конвертації (1000).

Перевірка доступу до методу

#[AsEventListener(RpcEvent::PRE_EXECUTE, priority: 999)]
final class AccessListener
{
    public function __construct(private RpcEventFactory $events, private Acl $acl) {}

    public function __invoke(RpcPreExecuteEvent $event): void
    {
        if (!$this->acl->canCall($event->service->name)) {
            $this->events->fireError($event->rpcRequest, new RpcLogicException('Access denied'));
            $event->stopPropagation();
        }
    }
}

Інші ідеї

• вимірювання часу виконання (старт тут, фініш на rpc.post_execute / rpc.error);
• відкриття транзакції Doctrine перед виконанням методу;
• аудит змін: збереження параметрів методів, що змінюють дані.