Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_core_module.xml @ 503:aed015c3dedd
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> |