$sent_http_connection
变量 $sent_http_connection 保存在 HTTP 响应中发送给客户端的 'Connection' 头的值。 — 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' 头时返回空字符串;在将其用于日志记录或条件判断时请小心。
⚠
确保服务器的连接处理配置(例如,持久连接)已被适当定义,以便正确设置该头。