nginx-site: xml/ru/docs/http/ngx_http_rewrite

annotate xml/ru/docs/http/ngx_http_rewrite_module.xml @ 391:1702722eca07

Cleaned up terminology and language used.

author	Ruslan Ermilov <ru@nginx.com>
date	Fri, 03 Feb 2012 12:18:35 +0000
parents	b838f6e9192e
children	95a970603b0f

rev	line source
222 bfe3eff81d04 Removed redundant encoding specification. Ruslan Ermilov <ru@nginx.com> parents: 110 diff changeset	1 <?xml version="1.0"?>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	4
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	5 <module name="Модуль ngx_http_rewrite_module"
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	6 link="/ru/docs/http/ngx_http_rewrite_module.html"
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	7 lang="ru">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	8
110 40eec261c2a6 Added proper support for anonymous sections, notably for the summary. Ruslan Ermilov <ru@nginx.com> parents: 108 diff changeset	9 <section id="summary">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	10
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	11 <para>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	12 Модуль <literal>ngx_http_rewrite_module</literal> позволяет
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	13 изменять URI с помощью регулярных выражений, делать перенаправления
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	14 и выбирать конфигурацию по условию.
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	15 </para>
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	16
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	17 <para>
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	18 Директивы модуля <literal>ngx_http_rewrite_module</literal>
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	19 обрабатываются в следующем порядке:
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	20 <list type="bullet">
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	21
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	22 <listitem>
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	23 выполняются директивы этого модуля, описанные на уровне
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	24 <link doc="ngx_http_core_module.xml" id="server">сервера</link>;
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	25 </listitem>
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	26
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	27 <listitem>
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	28 ищется location для запроса;
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	29 </listitem>
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	30
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	31 <listitem>
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	32 выполняются директивы этого модуля, описанные в выбранном
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	33 <link doc="ngx_http_core_module.xml" id="location"/>,
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	34 и если они изменяли URI, то ищется новый location для уже нового URI.
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	35 Этот цикл может повторяться до 10 раз, после чего возвращается
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	36 ошибка <http-status code="500" text="Internal Server Error"/>.
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	37 </listitem>
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	38
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	39 </list>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	40 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	41
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	42 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	43
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	44
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	45 <section id="directives" name="Директивы">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	46
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	47 <directive name="break">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	48 <syntax/>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	49 <default/>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	50 <context>server</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	51 <context>location</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	52 <context>if</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	53
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	54 <para>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	55 Завершает обработку текущего набора директив модуля
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	56 <literal>ngx_http_rewrite_module</literal>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	57 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	58
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	59 <para>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	60 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	61 <example>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	62 if ($slow) {
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	63 limit_rate 10k;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	64 break;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	65 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	66 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	67 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	68
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	69 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	70
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	71
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	72 <directive name="if">
108 72524ae53106 Explicitly marked directives with the block syntax. Such directives will Ruslan Ermilov <ru@nginx.com> parents: 106 diff changeset	73 <syntax block="yes">(<value>условие</value>)</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	74 <default/>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	75 <context>server</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	76 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	77
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	78 <para>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	79 Проверяется указанное <value>условие</value>.
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	80 Если оно истинно, то выполняются указанные в фигурных скобках директивы
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	81 этого модуля и запросу назначается конфигурация, указанная внутри
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	82 директивы <literal>if</literal>.
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	83 Конфигурации внутри директив <literal>if</literal> наследуются с
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	84 предыдущего уровня конфигурации.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	85 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	86
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	87 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	88 В качестве условия могут быть заданы:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	89 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	90
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	91 <listitem>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	92 имя переменной; ложными значениями переменной являются пустая строка
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	93 или любая строка, начинающаяся на “<literal>0</literal>”;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	94 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	95
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	96 <listitem>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	97 сравнение переменной со строкой с помощью операторов
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	98 “<literal>=</literal>” и “<literal>!=</literal>”;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	99 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	100
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	101 <listitem>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	102 соответствие переменной регулярному выражению с учётом
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	103 регистра символов — “<literal>~</literal>” и без него — “<literal>~*</literal>”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	104 В регулярных выражениях можно использовать выделения, которые затем
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	105 доступны в виде переменных <var>$1</var>..<var>$9</var>.
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	106 Также можно использовать отрицательные операторы “<literal>!~</literal>”
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	107 и “<literal>!~*</literal>”.
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	108 Если в регулярном выражении встречаются символы “<literal>}</literal>”
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	109 или “<literal>;</literal>”, то всё выражение следует заключить в одинарные
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	110 или двойные кавычки.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	111 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	112
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	113 <listitem>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	114 проверка существования файла с помощью операторов “<literal>-f</literal>”
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	115 и “<literal>!-f</literal>”;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	116 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	117
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	118 <listitem>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	119 проверка существования каталога с помощью операторов “<literal>-d</literal>”
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	120 и “<literal>!-d</literal>”;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	121 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	122
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	123 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	124 проверка существования файла, каталога или символической ссылки
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	125 с помощью операторов “<literal>-e</literal>” и “<literal>!-e</literal>”;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	126 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	127
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	128 <listitem>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	129 проверка исполняемости файла с помощью операторов “<literal>-x</literal>”
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	130 и “<literal>!-x</literal>”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	131 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	132
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	133 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	134 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	135
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	136 <para>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	137 Примеры:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	138 <example>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	139 if ($http_user_agent ~ MSIE) {
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	140 rewrite ^(.*)$ /msie/$1 break;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	141 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	142
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	143 if ($http_cookie ~* "id=([^;]+)(?:;\|$)") {
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	144 set $id $1;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	145 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	146
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	147 if ($request_method = POST) {
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	148 return 405;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	149 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	150
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	151 if ($slow) {
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	152 limit_rate 10k;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	153 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	154
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	155 if ($invalid_referer) {
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	156 return 403;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	157 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	158 </example>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	159 <note>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	160 Значение встроенной переменной <var>$invalid_referer</var> задаётся директивой
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	161 <link doc="ngx_http_referer_module.xml" id="valid_referers"/>.
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	162 </note>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	163 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	164
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	165 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	166
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	167
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	168 <directive name="return">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	169 <syntax><value>код</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	170 <default/>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	171 <context>server</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	172 <context>location</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	173 <context>if</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	174
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	175 <para>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	176 Завершает обработку и возвращает клиенту указанный <value>код</value>.
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	177 Можно возвращать следующие коды: 204, 400,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	178 402 — 406, 408, 410, 411, 413, 416 и 500 — 504.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	179 Кроме того, нестандартный код 444 закрывает соединение без передачи
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	180 заголовка ответа.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	181 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	182
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	183 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	184
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	185
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	186 <directive name="rewrite">
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	187 <syntax>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	188 <value>regex</value>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	189 <value>замена</value>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	190 [<value>флаг</value>]</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	191 <default/>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	192 <context>server</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	193 <context>location</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	194 <context>if</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	195
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	196 <para>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	197 Если указанное регулярное выражение соответствует URI, URI изменяется
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	198 в соответствии со строкой замены.
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	199 Директивы <literal>rewrite</literal> выполняются последовательно,
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	200 в порядке их следования в конфигурационном файле.
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	201 С помощью флагов можно прекратить дальнейшую обработку директив.
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	202 Если строка замены начинается с “<literal>http://</literal>” или
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	203 “<literal>https://</literal>”, то обработка завершается и клиенту
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	204 возвращается перенаправление.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	205 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	206
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	207 <para>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	208 Необязательный параметр <value>флаг</value> может быть одним из:
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	209 <list type="tag">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	210
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	211 <tag-name><literal>last</literal></tag-name>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	212 <tag-desc>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	213 завершает обработку текущего набора директив модуля
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	214 <literal>ngx_http_rewrite_module</literal>,
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	215 после чего ищется новый location, соответствующий изменённому URI;
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	216 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	217
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	218 <tag-name><literal>break</literal></tag-name>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	219 <tag-desc>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	220 завершает обработку текущего набора директив модуля
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	221 <literal>ngx_http_rewrite_module</literal>;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	222 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	223
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	224 <tag-name><literal>redirect</literal></tag-name>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	225 <tag-desc>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	226 возвращает временное перенаправление с кодом 302;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	227 используется, если заменяющая строка не начинается с
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	228 “<literal>http://</literal>” или “<literal>https://</literal>”;
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	229 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	230
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	231 <tag-name><literal>permanent</literal></tag-name>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	232 <tag-desc>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	233 возвращает постоянное перенаправление с кодом 301.
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	234 </tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	235
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	236 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	237 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	238
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	239 <para>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	240 Пример:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	241 <example>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	242 server {
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	243 ...
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	244 rewrite ^(/download/.)/media/(.)\..*$ $1/mp3/$2.mp3 last;
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	245 rewrite ^(/download/.)/audio/(.)\..*$ $1/mp3/$2.ra last;
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	246 return 403;
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	247 ...
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	248 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	249 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	250 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	251
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	252 <para>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	253 Если же эти директивы поместить в location “<literal>/download/</literal>”,
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	254 то нужно заменить флаг <literal>last</literal> на <literal>break</literal>,
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	255 иначе nginx сделает 10 циклов и вернёт ошибку 500:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	256 <example>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	257 location /download/ {
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	258 rewrite ^(/download/.)/media/(.)\..*$ $1/mp3/$2.mp3 break;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	259 rewrite ^(/download/.)/audio/(.)\..*$ $1/mp3/$2.ra break;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	260 return 403;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	261 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	262 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	263 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	264
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	265 <para>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	266 Если в строке замены указаны новые аргументы запроса, то предыдущие
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	267 аргументы запроса добавляются после них.
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	268 Если такое поведение нежелательно, можно отказаться от этого добавления,
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	269 указав в конце строки замены знак вопроса, например:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	270 <example>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	271 rewrite ^/users/(.*)$ /show?user=$1? last;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	272 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	273 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	274
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	275 <para>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	276 Если в регулярном выражении встречаются символы “<literal>}</literal>”
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	277 или “<literal>;</literal>”, то всё выражение следует заключить в одинарные
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	278 или двойные кавычки.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	279 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	280
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	281 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	282
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	283
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	284 <directive name="set">
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	285 <syntax><value>переменная</value> <value>значение</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	286 <default/>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	287 <context>server</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	288 <context>location</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	289 <context>if</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	290
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	291 <para>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	292 Устанавливает значение указанной переменной.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	293 В качестве значения можно использовать текст, переменные и их комбинации.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	294 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	295
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	296 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	297
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	298
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	299 <directive name="uninitialized_variable_warn">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	300 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	301 <default>on</default>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	302 <context>http</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	303 <context>server</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	304 <context>location</context>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	305 <context>if</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	306
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	307 <para>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	308 Определяет, нужно ли писать в лог предупреждения о неинициализированных
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	309 переменных.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	310 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	311
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	312 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	313
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	314 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	315
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	316
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	317 <section id="internals" name="Внутреннее устройство">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	318
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	319 <para>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	320 Директивы модуля <literal>ngx_http_rewrite_module</literal>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	321 компилируются на стадии конфигурации во внутренние инструкции,
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	322 интерпретируемые во время обработки запроса.
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	323 Интерпретатор представляет из себя простую стековую виртуальную машину.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	324 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	325
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	326 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	327 Например, директивы
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	328 <example>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	329 location /download/ {
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	330 if ($forbidden) {
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	331 return 403;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	332 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	333
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	334 if ($slow) {
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	335 limit_rate 10k;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	336 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	337
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	338 rewrite ^/(download/.)/media/(.)\..*$ /$1/mp3/$2.mp3 break;
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	339 }
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	340 </example>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	341 будут транслированы в такие инструкции:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	342 <example>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	343 переменная $forbidden
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	344 проверка на ноль
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	345 возврат 403
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	346 завершение всего кода
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	347 переменная $slow
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	348 проверка на ноль
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	349 проверка регулярного выражения
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	350 копирование "/"
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	351 копирование $1
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	352 копирование "/mp3/"
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	353 копирование $2
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	354 копирование ".mp3"
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	355 завершение регулярного выражения
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	356 завершение всего кода
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	357 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	358 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	359
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	360 <para>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	361 Обратите внимание, что инструкций для директивы
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	362 <link doc="ngx_http_core_module.xml" id="limit_rate"/>
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	363 нет, поскольку она не имеет отношения к модулю
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	364 <literal>ngx_http_rewrite_module</literal>.
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	365 Для блока <link id="if"/> создаётся отдельная конфигурация,
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	366 Если условие истинно, запрос получает эту конфигурацию,
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	367 и в ней <literal>limit_rate</literal> равен 10k.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	368 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	369
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	370 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	371 Директиву
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	372 <example>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	373 rewrite ^/(download/.)/media/(.)\..*$ /$1/mp3/$2.mp3 break;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	374 </example>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	375 можно сделать на одну инструкцию меньше, если в регулярном выражении перенести
1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	376 первый слэш внутрь скобок:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	377 <example>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	378 rewrite ^(<emphasis>/</emphasis>download/.)/media/(.)\..*$ $1/mp3/$2.mp3 break;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	379 </example>
391 1702722eca07 Cleaned up terminology and language used. Ruslan Ermilov <ru@nginx.com> parents: 382 diff changeset	380 Тогда соответствующие инструкции будут выглядеть так:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	381 <example>
382 b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	382 проверка регулярного выражения
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	383 копирование $1
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	384 копирование "/mp3/"
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	385 копирование $2
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	386 копирование ".mp3"
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	387 завершение регулярного выражения
b838f6e9192e Revision. Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	388 завершение всего кода
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	389 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	390 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	391
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	392 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	393
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	394 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_rewrite_module.xml @ 391:1702722eca07