comparison xml/ru/docs/http/ngx_http_core_module.xml @ 625:af3f38e349eb

Removed terminal whitespace and fixed apostrophes used.
author Ruslan Ermilov <ru@nginx.com>
date Sat, 11 Aug 2012 04:55:25 +0000
parents 368a449e85b8
children 7e4805858796
comparison
equal deleted inserted replaced
624:4b5163be537f 625:af3f38e349eb
139 <syntax><value>путь</value></syntax> 139 <syntax><value>путь</value></syntax>
140 <default/> 140 <default/>
141 <context>location</context> 141 <context>location</context>
142 142
143 <para> 143 <para>
144 Задаёт замену для указанного location'а. 144 Задаёт замену для указанного location’а.
145 Например, при такой конфигурации 145 Например, при такой конфигурации
146 <example> 146 <example>
147 location /i/ { 147 location /i/ {
148 alias /data/w3/images/; 148 alias /data/w3/images/;
149 } 149 }
157 В значении параметра <value>путь</value> можно использовать переменные, 157 В значении параметра <value>путь</value> можно использовать переменные,
158 кроме <var>$document_root</var> и <var>$realpath_root</var>. 158 кроме <var>$document_root</var> и <var>$realpath_root</var>.
159 </para> 159 </para>
160 160
161 <para> 161 <para>
162 Если <literal>alias</literal> используется внутри location'а, заданного 162 Если <literal>alias</literal> используется внутри location’а, заданного
163 регулярным выражением, то регулярное выражение должно содержать 163 регулярным выражением, то регулярное выражение должно содержать
164 выделения, а сам <literal>alias</literal> — ссылки на эти выделения 164 выделения, а сам <literal>alias</literal> — ссылки на эти выделения
165 (0.7.40), например: 165 (0.7.40), например:
166 <example> 166 <example>
167 location ~ ^/users/(.+\.(?:gif|jpe?g|png))$ { 167 location ~ ^/users/(.+\.(?:gif|jpe?g|png))$ {
1328 location можно задать префиксной строкой или регулярным выражением. 1328 location можно задать префиксной строкой или регулярным выражением.
1329 Регулярные выражения задаются либо с префиксом “<literal>~*</literal>” 1329 Регулярные выражения задаются либо с префиксом “<literal>~*</literal>”
1330 (для поиска совпадения без учёта регистра символов), 1330 (для поиска совпадения без учёта регистра символов),
1331 либо с префиксом “<literal>~</literal>” (с учётом регистра). 1331 либо с префиксом “<literal>~</literal>” (с учётом регистра).
1332 Чтобы найти location, соответствующий запросу, вначале проверяются 1332 Чтобы найти location, соответствующий запросу, вначале проверяются
1333 location'ы, заданные префиксными строками (префиксные location'ы). 1333 location’ы, заданные префиксными строками (префиксные location’ы).
1334 Среди них ищется максимальное совпадение. 1334 Среди них ищется максимальное совпадение.
1335 Затем проверяются регулярные выражения, в порядке их следования 1335 Затем проверяются регулярные выражения, в порядке их следования
1336 в конфигурационном файле. 1336 в конфигурационном файле.
1337 Проверка регулярных выражений прекращается после первого же совпадения, 1337 Проверка регулярных выражений прекращается после первого же совпадения,
1338 и используется соответствующая конфигурация. 1338 и используется соответствующая конфигурация.
1339 Если совпадение с регулярным выражением не найдено, то используется 1339 Если совпадение с регулярным выражением не найдено, то используется
1340 конфигурация максимально совпавшего префиксного location'а. 1340 конфигурация максимально совпавшего префиксного location’а.
1341 </para> 1341 </para>
1342 1342
1343 <para> 1343 <para>
1344 location'ы могут быть вложенными, с некоторыми исключениями, 1344 location’ы могут быть вложенными, с некоторыми исключениями,
1345 о которых говорится ниже. 1345 о которых говорится ниже.
1346 </para> 1346 </para>
1347 1347
1348 <para> 1348 <para>
1349 Для операционных систем, нечувствительных к регистру символов, таких 1349 Для операционных систем, нечувствительных к регистру символов, таких
1350 как Mac OS X и Cygwin, сравнение с префиксными строками производится 1350 как Mac OS X и Cygwin, сравнение с префиксными строками производится
1351 без учёта регистра (0.7.7). 1351 без учёта регистра (0.7.7).
1352 Однако, сравнение ограничено только однобайтными locale'ями. 1352 Однако, сравнение ограничено только однобайтными locale’ями.
1353 </para> 1353 </para>
1354 1354
1355 <para> 1355 <para>
1356 Регулярные выражения могут содержать выделения (0.7.40), которые могут 1356 Регулярные выражения могут содержать выделения (0.7.40), которые могут
1357 затем использоваться в других директивах. 1357 затем использоваться в других директивах.
1358 </para> 1358 </para>
1359 1359
1360 <para> 1360 <para>
1361 Если у максимального совпавшего префиксного location'а указан префикс 1361 Если у максимального совпавшего префиксного location’а указан префикс
1362 “<literal>^~</literal>”, то регулярные выражения не проверяются. 1362 “<literal>^~</literal>”, то регулярные выражения не проверяются.
1363 </para> 1363 </para>
1364 1364
1365 <para> 1365 <para>
1366 Кроме того, с помощью префикса “<literal>=</literal>” можно задать точное 1366 Кроме того, с помощью префикса “<literal>=</literal>” можно задать точное
1367 совпадение URI и location. 1367 совпадение URI и location.
1368 При точном совпадении поиск сразу же прекращается. 1368 При точном совпадении поиск сразу же прекращается.
1369 Например, если запрос “<literal>/</literal>” случается часто, то 1369 Например, если запрос “<literal>/</literal>” случается часто, то
1370 указав “<literal>location = /</literal>”, можно ускорить обработку 1370 указав “<literal>location = /</literal>”, можно ускорить обработку
1371 этих запросов, так как поиск прекратится после первого же сравнения. 1371 этих запросов, так как поиск прекратится после первого же сравнения.
1372 Очевидно, что такой location не может иметь вложенные location'ы. 1372 Очевидно, что такой location не может иметь вложенные location’ы.
1373 </para> 1373 </para>
1374 1374
1375 <para> 1375 <para>
1376 <note> 1376 <note>
1377 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным 1377 В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным
1378 location'ом без префиксов “<literal>=</literal>” и “<literal>^~</literal>”, 1378 location’ом без префиксов “<literal>=</literal>” и “<literal>^~</literal>”,
1379 то поиск тоже сразу же прекращается и регулярные выражения также 1379 то поиск тоже сразу же прекращается и регулярные выражения также
1380 не проверяются. 1380 не проверяются.
1381 </note> 1381 </note>
1382 </para> 1382 </para>
1383 1383
1408 1408
1409 <para> 1409 <para>
1410 Префикс “<literal>@</literal>” задаёт именованный location. 1410 Префикс “<literal>@</literal>” задаёт именованный location.
1411 Такой location не используется при обычной обработке запросов, а 1411 Такой location не используется при обычной обработке запросов, а
1412 предназначен только для перенаправления в него запросов. 1412 предназначен только для перенаправления в него запросов.
1413 Такие location'ы не могут быть вложенными и не могут содержать 1413 Такие location’ы не могут быть вложенными и не могут содержать
1414 вложенные location'ы. 1414 вложенные location’ы.
1415 </para> 1415 </para>
1416 1416
1417 <!-- 1417 <!--
1418 <migration from="Apache" directive="Location" /> 1418 <migration from="Apache" directive="Location" />
1419 --> 1419 -->
1536 <context>http</context> 1536 <context>http</context>
1537 <context>server</context> 1537 <context>server</context>
1538 <context>location</context> 1538 <context>location</context>
1539 1539
1540 <para> 1540 <para>
1541 Разрешает или запрещает выдавать для MSIE клиентов refresh'ы вместо 1541 Разрешает или запрещает выдавать для MSIE клиентов refresh’ы вместо
1542 перенаправлений. 1542 перенаправлений.
1543 </para> 1543 </para>
1544 1544
1545 </directive> 1545 </directive>
1546 1546
1737 <context>http</context> 1737 <context>http</context>
1738 <context>server</context> 1738 <context>server</context>
1739 <context>location</context> 1739 <context>location</context>
1740 1740
1741 <para> 1741 <para>
1742 Разрешает или запрещает указывать порт в перенаправлениях, выдаваемых nginx'ом. 1742 Разрешает или запрещает указывать порт в перенаправлениях, выдаваемых nginx’ом.
1743 </para> 1743 </para>
1744 1744
1745 <para> 1745 <para>
1746 См. также директиву <link id="server_name_in_redirect"/>. 1746 См. также директиву <link id="server_name_in_redirect"/>.
1747 </para> 1747 </para>
2232 <context>http</context> 2232 <context>http</context>
2233 <context>server</context> 2233 <context>server</context>
2234 <context>location</context> 2234 <context>location</context>
2235 2235
2236 <para> 2236 <para>
2237 Разрешает или запрещает использовать в перенаправлениях, выдаваемых nginx'ом, 2237 Разрешает или запрещает использовать в перенаправлениях, выдаваемых nginx’ом,
2238 основное имя сервера, задаваемое директивой 2238 основное имя сервера, задаваемое директивой
2239 <link id="server_name"/>. 2239 <link id="server_name"/>.
2240 Если запрещено, то используется имя, указанное в поле <header>Host</header> 2240 Если запрещено, то используется имя, указанное в поле <header>Host</header>
2241 заголовка запроса. 2241 заголовка запроса.
2242 Если же этого поля нет, то используется IP-адрес сервера. 2242 Если же этого поля нет, то используется IP-адрес сервера.
2284 <context>http</context> 2284 <context>http</context>
2285 <context>server</context> 2285 <context>server</context>
2286 <context>location</context> 2286 <context>location</context>
2287 2287
2288 <para> 2288 <para>
2289 Разрешает или запрещает выдавать версию nginx'а в сообщениях об ошибках и 2289 Разрешает или запрещает выдавать версию nginx’а в сообщениях об ошибках и
2290 в поле <header>Server</header> заголовка ответа. 2290 в поле <header>Server</header> заголовка ответа.
2291 </para> 2291 </para>
2292 2292
2293 </directive> 2293 </directive>
2294 2294
2346 <context>location</context> 2346 <context>location</context>
2347 2347
2348 <para> 2348 <para>
2349 Проверяет существование файлов в заданном порядке и использует 2349 Проверяет существование файлов в заданном порядке и использует
2350 для обработки запроса первый найденный файл, причём обработка 2350 для обработки запроса первый найденный файл, причём обработка
2351 делается в контексте этого же location'а. 2351 делается в контексте этого же location’а.
2352 Путь к файлу строится из параметра <value>файл</value> 2352 Путь к файлу строится из параметра <value>файл</value>
2353 в соответствии с директивами 2353 в соответствии с директивами
2354 <link id="root"/> и <link id="alias"/>. 2354 <link id="root"/> и <link id="alias"/>.
2355 С помощью слэша в конце имени можно проверить существование каталога, 2355 С помощью слэша в конце имени можно проверить существование каталога,
2356 например, “<literal>$uri/</literal>”. 2356 например, “<literal>$uri/</literal>”.
2505 Достаточно полная таблица соответствий входит в дистрибутив nginx 2505 Достаточно полная таблица соответствий входит в дистрибутив nginx
2506 и находится в файле <path>conf/mime.types</path>. 2506 и находится в файле <path>conf/mime.types</path>.
2507 </para> 2507 </para>
2508 2508
2509 <para> 2509 <para>
2510 Для того, чтобы для определённого location'а для всех ответов 2510 Для того, чтобы для определённого location’а для всех ответов
2511 выдавался MIME-тип “<literal>application/octet-stream</literal>”, 2511 выдавался MIME-тип “<literal>application/octet-stream</literal>”,
2512 можно использовать следующее: 2512 можно использовать следующее:
2513 <example> 2513 <example>
2514 location /download/ { 2514 location /download/ {
2515 types { } 2515 types { }
2746 2746
2747 <tag-name><var>$request_body</var></tag-name> 2747 <tag-name><var>$request_body</var></tag-name>
2748 <tag-desc> 2748 <tag-desc>
2749 тело запроса 2749 тело запроса
2750 <para> 2750 <para>
2751 Значение переменной появляется в location'ах, обрабатываемых 2751 Значение переменной появляется в location’ах, обрабатываемых
2752 директивами 2752 директивами
2753 <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/> 2753 <link doc="ngx_http_proxy_module.xml" id="proxy_pass"/>
2754 и 2754 и
2755 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>. 2755 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_pass"/>.
2756 </para> 2756 </para>