$sent_http_link

说明

当响应中设置了 Link 头时，NGINX 会使用 `$sent_http_link` 变量。该变量在 API 和 Web 服务中尤其有用，因为提供有关相关资源的信息可以增强客户端的处理和导航。该变量根据响应上下文中定义的 `Link` 头填充，通常由多个可能与当前资源相关的 URIs 构成。\n\n当生成 HTTP 响应时，如果通过配置或在 Lua 中的动态设置设定了 `Link` 头，`$sent_http_link` 将包含该值以供后续处理。它随后可用于重写、日志记录或进一步的响应处理。该变量的典型值是表示一个或多个 URIs 的字符串，通常带有指定的关系（例如 `rel=\"next\"` 或 `rel=\"prev\"`）。\n\n在 API 中实现分页时，该变量特别有用，允许客户端轻松推断下一页或上一页。通过适当设置 Link 头，NGINX 可以通过响应传递相关信息，而无需大量应用逻辑来处理这些引用。

配置示例

http {
    server {
        location /api {
            add_header Link "; rel='next'";
        }
    }
}