nginx Module ngx http sub module

不念不忘少年蓝@ 2023-10-06 14:03 4阅读 0赞

**1 Summary**

The ngx\_http\_sub\_module module is a filter that modifies a response by replacing one specified string by another.

This module is not built by default, it should be enabled with the \--with-http\_sub\_module configuration parameter.

**2 Example Configuration**

location / \{ sub\_filter ’<a href="http://127.0.0.1:8080/’ ’<a href="https://$host/’; sub\_filter ’<img src="http://127.0.0.1:8080/’ ’<img src="https://$host/’; sub\_filter\_once on;

**3 Directives**

**sub filter**

Syntax: **sub\_filter** *string replacement*;

Default —

Context: http, server, location

Sets a string to replace and a replacement string. The string to replace is matched ignoring the case. The string to replace (1.9.4) and replacement string can contain variables. Several sub\_filter directives can be specified on one configuration level (1.9.4). These directives are inherited from the previous level if and only if there are no sub\_filter directives defined on the current level.

**sub filter last modified**

Syntax: **sub\_filter\_last\_modified**on | off;

Default off

Context: http, server, location

This directive appeared in version 1.5.1.

Allows preserving the Last-Modified header field from the original response during replacement to facilitate response caching.

By default, the header field is removed as contents of the response are modified during processing. **sub filter once**

Syntax: **sub\_filter\_once**on | off;

Default on

Context: http, server, location

Indicates whether to look for each string to replace once or repeatedly. **sub filter types**

Syntax: **sub\_filter\_types** *mime-type* ...;