$sent_http_*

Описание

В NGINX префиксная переменная $sent_http_ автоматически создаётся, когда в блоке server или location устанавливаются определённые заголовки ответа. Для каждого заголовка HTTP-ответа, отправляемого клиенту, существует соответствующая переменная с префиксом $sent_http_. Например, если вы отправляете HTTP-заголовок 'X-My-Header' из конфигурации сервера, соответствующая переменная будет $sent_http_x_my_header. Эти переменные позволяют получить доступ к значениям HTTP-заголовков, которые были отправлены в ответе, непосредственно в конфигурации NGINX или в форматах логов. Эта переменная особенно полезна в сценариях, когда необходимо выполнять условную запись в лог или настраивать вывод на основе значений конкретных заголовков. Переменные $sent_http_ заполняются только в том случае, если соответствующие заголовки действительно установлены в ответе. Если заголовок не установлен, соответствующая переменная будет пустой. Этот механизм помогает отслеживать и управлять различной информацией о заголовках, что имеет решающее значение в таких сценариях, как отладка или проверка поведения сервера, особенно при тестировании.

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

location /example {
    add_header X-My-Header "MyValue";
    add_header X-Another-Header "AnotherValue";

    # Log sent headers
    access_log /var/log/nginx/example.log custom_format;
}

log_format custom_format 'Sent HTTP Headers: $sent_http_x_my_header, $sent_http_x_another_header';