echo_subrequest

'echo_subrequest' 指令用于执行子请求,并可选择捕获其输出以便进一步处理。

语法echo_subrequest uri (args ...);
默认值none
上下文location, if in location
参数2+

说明

'echo_subrequest' 指令在 NGINX echo module 中允许配置对指定的 URI 执行子请求。它可以接受两个或更多参数,其中第一个参数是子请求的 URI,后续参数是可选的,用于决定如何处理该子请求的输出。该指令对于通过利用现有端点来创建模块化响应或处理复杂的请求流程特别有用,无需在主请求处理流程中重复逻辑即可实现。

该指令可以放置在任何 location context 或位于 location context 内的 'if' block 中,使其在 NGINX 配置中成为一个多用途的工具。'echo_subrequest' 指令支持多种执行模式,允许用户提供额外参数来指定输出方法(例如,是否将响应体输出给客户端、记录附加信息等)。这种灵活性有助于简化配置并在处理需要相似响应的请求时减少冗余。

配置示例

location /parent {
    echo_subrequest /child arg1 arg2;
}

确保子请求中的请求路径相对于服务器根目录定义。

如果未妥善管理,过多的子请求可能导致性能瓶颈。

确保子请求中的 URI 返回有效响应;否则,错误可能会传播到父请求。

← 返回所有指令