Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_core_module.xml @ 503:aed015c3dedd

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented URI normalization rules, including %-decoding. Aligned the description of the $uri variable accordingly.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 24 Apr 2012 06:35:12 +0000
parents 76a8eca844d0
children 657848837328
comparison
equal deleted inserted replaced
502:6520338cdf0a 503:aed015c3dedd
1286 <context>server</context> 1286 <context>server</context>
1287 <context>location</context> 1287 <context>location</context>
1288 1288
1289 <para> 1289 <para>
1290 Sets a configuration based on a request URI. 1290 Sets a configuration based on a request URI.
1291 </para>
1292
1293 <para>
1294 The matching is performed against a normalized URI,
1295 after decoding a text encoded in the “<literal>%XX</literal>” form,
1296 resolving references to relative path components “<literal>.</literal>”
1297 and “<literal>..</literal>”, and possible
1298 <link id="merge_slashes">compression</link> of two or more
1299 adjacent slashes into a single slash.
1300 </para>
1301
1302 <para>
1291 A location can either be defined by a prefix string, or by a regular expression. 1303 A location can either be defined by a prefix string, or by a regular expression.
1292 Regular expressions are specified by prepending them with the 1304 Regular expressions are specified by prepending them with the
1293 “<literal>~*</literal>” prefix (for case-insensitive matching), or with the 1305 “<literal>~*</literal>” prefix (for case-insensitive matching), or with the
1294 “<literal>~</literal>” prefix (for case-sensitive matching). 1306 “<literal>~</literal>” prefix (for case-sensitive matching).
1295 To find a location matching a given request, nginx first checks 1307 To find a location matching a given request, nginx first checks
2806 that support the <c-def>TCP_INFO</c-def> socket option 2818 that support the <c-def>TCP_INFO</c-def> socket option
2807 </tag-desc> 2819 </tag-desc>
2808 2820
2809 <tag-name><var>$uri</var></tag-name> 2821 <tag-name><var>$uri</var></tag-name>
2810 <tag-desc> 2822 <tag-desc>
2811 current URI in request 2823 current URI in request, <link id="location">normalized</link>
2812 <para> 2824 <para>
2813 It may differ from an original, e.g. when doing internal redirects, 2825 The value of <var>$uri</var> may change during request processing,
2814 or when using index files. 2826 e.g. when doing internal redirects, or when using index files.
2815 </para> 2827 </para>
2816 </tag-desc> 2828 </tag-desc>
2817 2829
2818 </list> 2830 </list>
2819 </para> 2831 </para>