echo
`echo` 指令将在响应体中输出指定的字符串或数据。
nginx Echo module
·
locationif in location
语法echo string;
默认值none
上下文location, if in location
参数any
说明
echo 指令允许 NGINX 在响应 HTTP 请求时直接向客户端返回字符串或数据。它可在多种上下文中使用，例如 location 或在 location 内的 if 语句中。该指令非常灵活，接受任何字符串作为返回给客户端的参数。它还可以处理特殊格式，包括变量和表达式，使其成为在 NGINX 配置中输出自定义消息或信息的强大工具。\n\n执行时，echo 指令将指定的字符串作为 HTTP 响应体的一部分发送。该指令可以与其他与 echo 相关的命令结合使用，例如 echo_sleep、echo_flush 和 echo_reset_timer，从而允许更复杂的交互和对输出的控制。例如，echo_sleep 可以引入延迟，而 echo_flush 可以在处理的不同阶段发送部分响应。\n\n此外，由于 echo 与上下文相关，它可以放在条件中，根据某些请求参数或头动态确定输出内容。这使得 echo 不仅是一个直接的输出机制，还是更动态响应系统的一部分。
配置示例
location /greet {
echo "Hello, welcome to NGINX!";
}⚠
确保字符串被正确引用以避免语法错误。
⚠
注意不要以与其他输出处理指令（例如 return 或 rewrite）冲突的方式使用 echo。
⚠
输出及其处理可能与某些设置不兼容，例如缓冲或客户端超时配置。