Localzet Server and related projects documentation

Конфигурация и эксплуатация

Загрузка конфигурации

На старте Engine 9 bootstrap Events читает основной массив event, затем аналогичные конфигурации приложений и плагинов. Для каждой записи имя события => список callbacks bootstrap регистрирует listener. Некорректная структура или невызываемый callback приводит к RuntimeException при загрузке, поэтому проверяйте конфигурацию до запуска production.

return [
    'report.generated' => [
        [App\Listeners\SendReport::class, 'handle'],
    ],
];

Плагин может иметь собственный config/event.php. Обработчики классов для конфигурации разрешаются через контейнер support\Container.

Модель выполнения

emit() запускает callbacks синхронно в текущем процессе. Время выполнения listener входит в задержку операции, инициировавшей событие. Диспетчер хранит подписки в статических структурах процесса; он не реплицирует состояние между worker-процессами и не сохраняет сообщения при рестарте.

Для медленного I/O, повторных попыток, гарантированной доставки, расписания и межпроцессной координации используйте отдельный механизм фоновой обработки. Не помещайте в payload секреты, если они не нужны всем подписчикам.

Ошибки и безопасность

Исключение listener включается в результаты emit() и, если доступен logging Engine, записывается в журнал. Это не делает бизнес-операцию успешной: вызывающий код должен анализировать возвращаемое значение и отдельно принимать решение о retry/ошибке.

Конфигурационные файлы и сами listeners исполняются как код приложения. Не загружайте их из недоверенных источников. Авторизация не входит в Events: передаваемые события и payload контролирует вызывающий код, а обработчики должны проверять собственные предпосылки и права.