sub_filter_once

说明

`sub_filter_once` 指令在 NGINX 的 `http`、`server` 或 `location` 上下文中使用，用于决定由 `sub_filter` 指令执行的子字符串替换的行为。当设置为 `on` 时，替换只会应用于响应正文中被指定字符串的第一次出现。相反，如果设置为 `off`，`sub_filter` 会处理该子字符串的所有实例，并在编译输出中对它们进行修改。这在处理存在多个相同字符串且只需一次替换而不想修改每个实例的场景中特别有用——从而避免对响应上下文造成意外更改。 该指令接受布尔值（'on' 或 'off'）。默认情况下通常设置为 `off`，即允许进行多次替换，除非另行指定。要启用 `sub_filter_once`，需要在 NGINX 中启用 `sub` 模块，这是该指令正常工作的关键。另一个需要注意的点是，还必须配置 `sub_filter` 以明确标识要替换的特定子字符串，然后再根据 `sub_filter_once` 的设置应用单次或多次替换。

配置示例

sub_filter 'old_text' 'new_text';
sub_filter_once on;