Mercurial > hg > nginx-site
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> |