ngx_link_func_subrequest

ngx_link_func_subrequest 指令便于在 NGINX 中调用子请求,并提供可配置的选项。

语法ngx_link_func_subrequest flag;
默认值none
上下文server, location
参数1+

说明

ngx_link_func_subrequest 指令允许用户触发对指定 URI 的子请求,同时对这些请求的处理方式提供额外控制。该指令可以接受一个或多个参数,用于指定决定子请求行为的标志。可用标志包括 check_status(使服务器在继续之前等待响应);incl_body(在子请求中包含请求体);以及 incl_args(在子请求过程中包含参数)。这种灵活性对于希望使用 NGINX 服务器架构将服务器响应动态关联到其应用的开发者尤其有用。

配置后,该指令确保子请求在 NGINX 服务器的上下文中执行,使开发者能够控制不仅后端应用的调用,还能控制数据如何传递以及如何处理来自这些应用的响应。有效使用该指令可以提升应用性能并启用更复杂的工作流,例如在单个 NGINX 请求流中聚合来自多次应用调用的响应。

配置示例

location /example {
    ngx_link_func_subrequest incl_body incl_args;
}

错误地使用多个 flags 可能导致意外行为。

确保与此指令关联的应用已正确编译,并且可被 NGINX 访问。

配置错误可能导致 NGINX 无法启动或重新加载。

← 返回所有指令