blob: dd7f0f4f91e789fe001e95ddf27d5d44da43f24a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
=encoding utf-8
=head1 NAME
ngx_http_sub_module - Module ngx_http_sub_module
=head1
The C<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
C<--with-http_sub_module>
configuration parameter.
=head1 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;
}
=head1 Directives
=head2 sub_filter
B<syntax:> sub_filter I<I<C<string>> I<C<replacement>>>
B<context:> I<http>
B<context:> I<server>
B<context:> I<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 C<sub_filter> directives
can be specified on the same configuration level (1.9.4).
These directives are inherited from the previous configuration level
if and only if there are no C<sub_filter> directives
defined on the current level.
=head2 sub_filter_last_modified
B<syntax:> sub_filter_last_modified I<C<on> E<verbar> C<off>>
B<default:> I<off>
B<context:> I<http>
B<context:> I<server>
B<context:> I<location>
This directive appeared in version 1.5.1.
Allows preserving the C<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.
=head2 sub_filter_once
B<syntax:> sub_filter_once I<C<on> E<verbar> C<off>>
B<default:> I<on>
B<context:> I<http>
B<context:> I<server>
B<context:> I<location>
Indicates whether to look for each string to replace
once or repeatedly.
=head2 sub_filter_types
B<syntax:> sub_filter_types I<I<C<mime-type>> ...>
B<default:> I<textE<sol>html>
B<context:> I<http>
B<context:> I<server>
B<context:> I<location>
Enables string replacement in responses with the specified MIME types
in addition to “C<textE<sol>html>”.
The special value “C<*>” matches any MIME type (0.8.29).
|
