echo_after_body
`echo_after_body` 指令允许在 HTTP 响应主体发送给客户端之后输出附加响应。
nginx Echo module
·
locationif in location
语法echo_after_body;
默认值none
上下文location, if in location
参数any
说明
echo_after_body 指令可在 ngx_http_echo 上下文中使用,以在响应主体的主要内容发送完毕后发送附加内容。此行为使服务器能够启动复杂的响应工作流,在该工作流中可以分别操作头部和主体。与该指令关联的命令可以包含任何有效的 NGINX 指令,从而实现对响应内容的强大定制。
当调用此指令时,即使在主体已写入客户端之后,也允许对请求进行进一步处理。例如,在某些场景中,可能需要在响应完成后发送某些信息性消息或日志条目,而不阻塞客户端。通过使用此指令,例如可以在生成操作的服务器日志的同时仍允许客户端即时接收其主要响应。由于客户端无需等待额外任务完成即可收到请求内容,这可以帮助改善服务的感知性能。
配置示例
location /example {
echo "Response body sent";
echo_after_body "This message comes after the body";
}⚠
请确保在调用此指令之前已发送主体内容,因为它专为在主体发送之后使用。
⚠
将 echo_after_body 与响应修改一起使用可能导致意外结果,因为在主体发送后连接状态可能已被改变。