comparison xml/ru/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
1269 <context>server</context> 1269 <context>server</context>
1270 <context>location</context> 1270 <context>location</context>
1271 1271
1272 <para> 1272 <para>
1273 Устанавливает конфигурацию в зависимости от URI запроса. 1273 Устанавливает конфигурацию в зависимости от URI запроса.
1274 </para>
1275
1276 <para>
1277 Для сопоставления используется URI запроса в нормализованном виде,
1278 после декодирования текста, заданного в виде “<literal>%XX</literal>”,
1279 преобразования относительных элементов пути “<literal>.</literal>” и
1280 “<literal>..</literal>” в реальные, и возможной
1281 <link id="merge_slashes">замены</link> двух и более подряд идущих
1282 слэшей на один.
1283 </para>
1284
1285 <para>
1274 location можно задать префиксной строкой или регулярным выражением. 1286 location можно задать префиксной строкой или регулярным выражением.
1275 Регулярные выражения задаются либо с префиксом “<literal>~*</literal>” 1287 Регулярные выражения задаются либо с префиксом “<literal>~*</literal>”
1276 (для поиска совпадения без учёта регистра символов), 1288 (для поиска совпадения без учёта регистра символов),
1277 либо с префиксом “<literal>~</literal>” (с учётом регистра). 1289 либо с префиксом “<literal>~</literal>” (с учётом регистра).
1278 Чтобы найти location, соответствующий запросу, вначале проверяются 1290 Чтобы найти location, соответствующий запросу, вначале проверяются
1425 <context>http</context> 1437 <context>http</context>
1426 <context>server</context> 1438 <context>server</context>
1427 1439
1428 <para> 1440 <para>
1429 Разрешает или запрещает преобразование URI путём замены двух и более подряд 1441 Разрешает или запрещает преобразование URI путём замены двух и более подряд
1430 идущих слэшей (“<literal>/</literal>”) в один. 1442 идущих слэшей (“<literal>/</literal>”) на один.
1431 </para> 1443 </para>
1432 1444
1433 <para> 1445 <para>
1434 Необходимо иметь в виду, что это преобразование необходимо для корректной 1446 Необходимо иметь в виду, что это преобразование необходимо для корректной
1435 проверки префиксных строк и регулярных выражений. 1447 проверки префиксных строк и регулярных выражений.
2788 поддерживающих опцию сокета <c-def>TCP_INFO</c-def> 2800 поддерживающих опцию сокета <c-def>TCP_INFO</c-def>
2789 </tag-desc> 2801 </tag-desc>
2790 2802
2791 <tag-name><var>$uri</var></tag-name> 2803 <tag-name><var>$uri</var></tag-name>
2792 <tag-desc> 2804 <tag-desc>
2793 текущий URI запроса 2805 текущий URI запроса в <link id="location">нормализованном</link> виде
2794 <para> 2806 <para>
2795 Он может отличаться от первоначального, например, при внутренних 2807 Значение <var>$uri</var> может изменяться в процессе обработки запроса,
2796 перенаправлениях или при использовании индексных файлов. 2808 например, при внутренних перенаправлениях
2809 или при использовании индексных файлов.
2797 </para> 2810 </para>
2798 </tag-desc> 2811 </tag-desc>
2799 2812
2800 </list> 2813 </list>
2801 </para> 2814 </para>