push_stream_wildcard_channel_prefix

Директива `push_stream_wildcard_channel_prefix` задаёт префикс для каналов, использующих сопоставление с подстановочными символами в модуле NGINX Push Stream.

Синтаксисpush_stream_wildcard_channel_prefix prefix;
По умолчаниюnone
Контекстhttp
Аргументы1

Описание

Директива push_stream_wildcard_channel_prefix используется для определения префикса для каналов, которые используют шаблоны с подстановочными символами для сопоставления запросов подписчиков. Это особенно полезно, когда необходимо обрабатывать несколько каналов под общим префиксом, при этом позволяя различать их по шаблонам с подстановочными символами. Установив эту директиву, подписчики могут подключаться к каналам, используя такие шаблоны, как channel_* в рамках указанного префикса, что облегчает упорядоченное управление большим количеством каналов.

Когда разработчик приложения или администратор настраивает эту директиву, это повышает гибкость обработки подписок на каналы в модуле NGINX Push Stream. Например, если префикс установлен как chat/, подписчики смогут обращаться к каналам вроде chat/general или chat/support, что улучшает ясность в организации каналов. Директива необходима в сценариях, требующих динамической подписки, поскольку она позволяет более эффективно маршрутизировать сообщения к соответствующим каналам на основе шаблонов, заданных пользователем.

Примечательно, что директиву можно разместить в контексте http, применив таким образом глобальный префикс ко всем соответствующим подпискам на каналы. Однако важно убедиться, что используемый префикс не конфликтует с существующими именами каналов, поскольку это может привести к непредвиденному поведению или проблемам с маршрутизацией сообщений в приложении. Тщательные соглашения об именовании и чёткая документация по предполагаемому использованию каналов снизят эти риски.

Пример конфига

http {
    push_stream_wildcard_channel_prefix /chat/;

    server {
        location /pub {
            push_stream_publisher admin;
            push_stream_channels_path $arg_id;
        }

        location /sub {
            push_stream_subscriber;
            push_stream_channels_path $arg_id;
        }
    }
}

Убедитесь, что префикс не конфликтует с существующими именами каналов, чтобы избежать проблем с маршрутизацией.

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

← Ко всем директивам