push_stream_channel_deleted_message_text

Директива push_stream_channel_deleted_message_text задаёт сообщение, отправляемое при удалении канала.

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

Описание

push_stream_channel_deleted_message_text используется в NGINX Push Stream Module для задания пользовательского сообщения, которое будет отправлено всем подписчикам при удалении указанного канала. Это сообщение может использоваться для информирования пользователей об удалении канала, обеспечивая большую прозрачность и возможность взаимодействия в приложениях, использующих потоковую передачу в реальном времени. Директива принимает один аргумент — текст отправляемого сообщения.

При настройке этой директивы строка сообщения должна быть заключена в кавычки. Это обеспечит корректный разбор и регистрацию сообщения в контексте конфигурации NGINX. Кроме того, точная формулировка сообщения об удалении может быть адаптирована в соответствии с требованиями приложения, предоставляя разработчикам гибкость для передачи подписчикам контекстно-зависимой информации, когда канал больше недоступен. Если эта директива не указана, подписчикам не будет отправлено сообщение об удалении, что может быть предпочтительнее в приложениях, где такие уведомления не требуются.

Директива должна быть определена в http-контексте файла конфигурации NGINX и обычно используется вместе с другими связанными директивами, такими как push_stream_shared_memory_size и push_stream_max_messages_stored_per_channel, чтобы полностью определить поведение push stream channels в приложении. Правильное использование этой директивы помогает поддерживать бесшовный пользовательский опыт при динамическом управлении каналами.

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

http {
    push_stream_shared_memory_size 32M;
    push_stream_channel_deleted_message_text "Channel has been deleted";
}

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

Если директива опущена, сообщения об удалении отправляться не будут, что может запутать подписчиков.

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