push_stream_footer_template
Определяет шаблон для сообщений нижнего колонтитула в ответах push stream.
Описание
Директива push_stream_footer_template позволяет пользователям задать собственный шаблон HTML-футера для сообщений, передаваемых по push stream. Когда подписчик получает сообщение, этот шаблон футера будет добавлен к содержимому сообщения перед отправкой клиенту. Эта функция особенно полезна для внедрения дополнительного HTML или JavaScript-контента, который должен быть включён в окончательный вывод, например закрывающие теги или скрипты, необходимые для обработки дальнейших взаимодействий на стороне клиента.
Шаблон футера может содержать любой корректный HTML-контент и может быть как статическим, так и содержать динамические значения, основанные на состоянии подписки. Такая гибкость позволяет разработчикам улучшать пользовательский опыт, предоставляя контекстно-зависимые детали или ресурсы, обогащающие потоковые данные.
Чтобы использовать эту директиву, её можно указать в контекстах http, server или location в зависимости от архитектуры приложения. Аргумент этой директивы должен быть одной строкой, представляющей шаблон футера. Необходимо учитывать корректную обработку HTML-сущностей и экранирования, чтобы итоговый вывод был корректным HTML.
Пример конфига
http {
push_stream_footer_template "";
server {
location /sub {
push_stream_subscriber;
push_stream_channels_path $arg_channel;
}
}
}Убедитесь, что шаблон нижнего колонтитула является валидным HTML, чтобы избежать проблем с отображением на стороне клиента.
Будьте осторожны с динамическим содержимым, чтобы предотвратить уязвимости XSS, если задействован ввод пользователя.