Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_rewrite_module.xml @ 1873:2f851f71ff08

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented $scheme support in the "rewrite" directive.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 21 Dec 2016 22:52:16 +0300
parents 065978f4ece1
children 2a3c58dcb3e8
comparison
equal deleted inserted replaced
1872:f3f268ab3573 1873:2f851f71ff08
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Module ngx_http_rewrite_module" 10 <module name="Module ngx_http_rewrite_module"
11 link="/en/docs/http/ngx_http_rewrite_module.html" 11 link="/en/docs/http/ngx_http_rewrite_module.html"
12 lang="en" 12 lang="en"
13 rev="6"> 13 rev="7">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 The <literal>ngx_http_rewrite_module</literal> module is used to 18 The <literal>ngx_http_rewrite_module</literal> module is used to
262 If the specified regular expression matches a request URI, URI is changed 262 If the specified regular expression matches a request URI, URI is changed
263 as specified in the <value>replacement</value> string. 263 as specified in the <value>replacement</value> string.
264 The <literal>rewrite</literal> directives are executed sequentially 264 The <literal>rewrite</literal> directives are executed sequentially
265 in order of their appearance in the configuration file. 265 in order of their appearance in the configuration file.
266 It is possible to terminate further processing of the directives using flags. 266 It is possible to terminate further processing of the directives using flags.
267 If a replacement string starts with “<literal>http://</literal>” 267 If a replacement string starts with “<literal>http://</literal>”,
268 or “<literal>https://</literal>”, the processing stops and the 268 “<literal>https://</literal>”, or “<literal>$scheme</literal>”,
269 redirect is returned to a client. 269 the processing stops and the redirect is returned to a client.
270 </para> 270 </para>
271 271
272 <para> 272 <para>
273 An optional <value>flag</value> parameter can be one of: 273 An optional <value>flag</value> parameter can be one of:
274 <list type="tag"> 274 <list type="tag">
289 289
290 <tag-name><literal>redirect</literal></tag-name> 290 <tag-name><literal>redirect</literal></tag-name>
291 <tag-desc> 291 <tag-desc>
292 returns a temporary redirect with the 302 code; 292 returns a temporary redirect with the 302 code;
293 used if a replacement string does not start with 293 used if a replacement string does not start with
294 “<literal>http://</literal>” or “<literal>https://</literal>”; 294 “<literal>http://</literal>”, “<literal>https://</literal>”,
295 or “<literal>$scheme</literal>”;
295 </tag-desc> 296 </tag-desc>
296 297
297 <tag-name><literal>permanent</literal></tag-name> 298 <tag-name><literal>permanent</literal></tag-name>
298 <tag-desc> 299 <tag-desc>
299 returns a permanent redirect with the 301 code. 300 returns a permanent redirect with the 301 code.