comparison xml/ru/docs/http/ngx_http_core_module.xml @ 810:7c72c3e67e77

The "location" directive: improved wording. Differentiate between prefix locations and location directive's modifiers.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 10 Jan 2013 19:00:29 +0400
parents 32b8498cfb40
children ddd22f571529
comparison
equal deleted inserted replaced
809:175fa0144ebc 810:7c72c3e67e77
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Модуль ngx_http_core_module" 10 <module name="Модуль ngx_http_core_module"
11 link="/ru/docs/http/ngx_http_core_module.html" 11 link="/ru/docs/http/ngx_http_core_module.html"
12 lang="ru" 12 lang="ru"
13 rev="13"> 13 rev="14">
14 14
15 <section id="directives" name="Директивы"> 15 <section id="directives" name="Директивы">
16 16
17 <directive name="aio"> 17 <directive name="aio">
18 <syntax> 18 <syntax>
1364 слэшей на один. 1364 слэшей на один.
1365 </para> 1365 </para>
1366 1366
1367 <para> 1367 <para>
1368 location можно задать префиксной строкой или регулярным выражением. 1368 location можно задать префиксной строкой или регулярным выражением.
1369 Регулярные выражения задаются либо с префиксом “<literal>~*</literal>” 1369 Регулярные выражения задаются либо с модификатором “<literal>~*</literal>”
1370 (для поиска совпадения без учёта регистра символов), 1370 (для поиска совпадения без учёта регистра символов),
1371 либо с префиксом “<literal>~</literal>” (с учётом регистра). 1371 либо с модификатором “<literal>~</literal>” (с учётом регистра).
1372 Чтобы найти location, соответствующий запросу, вначале проверяются 1372 Чтобы найти location, соответствующий запросу, вначале проверяются
1373 location’ы, заданные префиксными строками (префиксные location’ы). 1373 location’ы, заданные префиксными строками (префиксные location’ы).
1374 Среди них ищется максимальное совпадение. 1374 Среди них ищется максимальное совпадение.
1375 Затем проверяются регулярные выражения, в порядке их следования 1375 Затем проверяются регулярные выражения, в порядке их следования
1376 в конфигурационном файле. 1376 в конфигурационном файле.
1396 Регулярные выражения могут содержать выделения (0.7.40), которые могут 1396 Регулярные выражения могут содержать выделения (0.7.40), которые могут
1397 затем использоваться в других директивах. 1397 затем использоваться в других директивах.
1398 </para> 1398 </para>
1399 1399
1400 <para> 1400 <para>
1401 Если у максимального совпавшего префиксного location’а указан префикс 1401 Если у максимального совпавшего префиксного location’а указан модификатор
1402 “<literal>^~</literal>”, то регулярные выражения не проверяются. 1402 “<literal>^~</literal>”, то регулярные выражения не проверяются.
1403 </para> 1403 </para>
1404 1404
1405 <para> 1405 <para>
1406 Кроме того, с помощью префикса “<literal>=</literal>” можно задать точное 1406 Кроме того, с помощью модификатора “<literal>=</literal>” можно задать точное
1407 совпадение URI и location. 1407 совпадение URI и location.
1408 При точном совпадении поиск сразу же прекращается. 1408 При точном совпадении поиск сразу же прекращается.
1409 Например, если запрос “<literal>/</literal>” случается часто, то 1409 Например, если запрос “<literal>/</literal>” случается часто, то
1410 указав “<literal>location = /</literal>”, можно ускорить обработку 1410 указав “<literal>location = /</literal>”, можно ускорить обработку
1411 этих запросов, так как поиск прекратится после первого же сравнения. 1411 этих запросов, так как поиск прекратится после первого же сравнения.
1413 </para> 1413 </para>
1414 1414
1415 <para> 1415 <para>
1416 <note> 1416 <note>
1417 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным 1417 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным
1418 location’ом без префиксов “<literal>=</literal>” и “<literal>^~</literal>”, 1418 location’ом без модификаторов “<literal>=</literal>” и “<literal>^~</literal>”,
1419 то поиск тоже сразу же прекращается и регулярные выражения также 1419 то поиск тоже сразу же прекращается и регулярные выражения также
1420 не проверяются. 1420 не проверяются.
1421 </note> 1421 </note>
1422 </para> 1422 </para>
1423 1423