push_stream_header_template

Директива push_stream_header_template задаёт пользовательский шаблон заголовка для ответов push stream.

Синтаксисpush_stream_header_template template_string;
По умолчаниюnone
Контекстhttp, server, location
Аргументы1

Описание

Директива push_stream_header_template — это параметр конфигурации, используемый в NGINX Push Stream Module, который позволяет задавать шаблон для заголовков, отправляемых вместе с ответами push stream. Она может быть указана в контекстах http, server или location и определяет, как будут форматироваться заголовки на основе заданного шаблона.

Эта директива принимает один аргумент — строку шаблона заголовка. В шаблоне могут использоваться плейсхолдеры, включающие такие переменные, как идентификаторы каналов или данные сообщений, что позволяет динамически вставлять содержимое в заголовки сообщений push stream. Конфигурация позволяет разработчикам настраивать поведение на стороне клиента, особенно в приложениях реального времени, где структура отправляемых данных имеет решающее значение.

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

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

http {
    push_stream_header_template "Custom-Header: {channel_id} {message}";
}

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

Будьте осторожны с пользовательским вводом в шаблонах заголовков, чтобы предотвратить уязвимости, связанные с инъекцией заголовков.

Проверьте поведение как в контексте подписчика, так и в контексте издателя, чтобы подтвердить ожидаемые значения заголовков.

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