$sent_http_connection

Переменная $sent_http_connection содержит значение заголовка 'Connection', отправляемого клиенту в HTTP-ответе. — NGINX Core (HTTP)

$sent_http_connection NGINX Core (HTTP)

Описание

Переменная $sent_http_connection в NGINX фиксирует значение ответного заголовка 'Connection', который отправляется клиенту. Этот заголовок указывает клиенту, следует ли удерживать соединение с сервером открытым после обработки текущего запроса. Типичными значениями для этой переменной могут быть 'keep-alive' или 'close', в зависимости от конфигурации сервера и характера запроса клиента. Эта переменная преимущественно полезна в сценариях, когда серверу нужно динамически изменять поведение соединения на основе запроса клиента или шаблонов его использования. Например, если некоторые клиенты запрашивают постоянные соединения, сервер может отвечать соответствующим образом. Значение $sent_http_connection устанавливается в процессе обработки запроса, конкретно при формировании заголовков ответа. Присваиваемое значение определяется директивами конфигурации сервера в соответствующем контексте. Важно отметить, что если заголовок 'Connection' не указан в конфигурации или не установлен явно во время обработки, эта переменная не будет содержать никакого значения и поэтому её следует осторожно использовать в условных выражениях или в логах, чтобы избежать непреднамеренного отображения пустых заголовков.

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

server {
    listen 80;
    location / {
        add_header Connection $sent_http_connection;
    }
}

Подсистема

http

Кэшируется

Да

Контексты

http, server, location

$sent_http_connection возвращает пустую строку, если заголовок 'Connection' не задан в ответе; будьте осторожны при использовании его в логировании или условных выражениях.

Убедитесь, что настройки обработки подключений сервера (например, постоянные соединения) корректно заданы, чтобы этот заголовок устанавливался правильно.