Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_rewrite_module.xml @ 548:95a970603b0f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Brought the "return" documentation up to date.
author Ruslan Ermilov <ru@nginx.com>
date Sun, 24 Jun 2012 18:58:23 +0000
parents 1702722eca07
children be54c443235a
comparison
equal deleted inserted replaced
547:32dd85720515 548:95a970603b0f
164 164
165 </directive> 165 </directive>
166 166
167 167
168 <directive name="return"> 168 <directive name="return">
169 <syntax><value>код</value></syntax> 169 <syntax><value>код</value> [<value>текст</value>]</syntax>
170 <syntax><value>код</value> <value>URL</value></syntax>
171 <syntax><value>URL</value></syntax>
170 <default/> 172 <default/>
171 <context>server</context> 173 <context>server</context>
172 <context>location</context> 174 <context>location</context>
173 <context>if</context> 175 <context>if</context>
174 176
175 <para> 177 <para>
176 Завершает обработку и возвращает клиенту указанный <value>код</value>. 178 Завершает обработку и возвращает клиенту указанный <value>код</value>.
177 Можно возвращать следующие коды: 204, 400, 179 Нестандартный код 444 закрывает соединение без передачи
178 402 — 406, 408, 410, 411, 413, 416 и 500 — 504.
179 Кроме того, нестандартный код 444 закрывает соединение без передачи
180 заголовка ответа. 180 заголовка ответа.
181 </para>
182
183 <para>
184 Начиная с версии 0.8.42 можно задать
185 либо URL перенаправления (для кодов 301, 302, 303 и 307),
186 либо <value>текст</value> тела ответа (для остальных кодов).
187 В тексте тела ответа и URL перенаправления можно использовать переменные.
188 Как частный случай, URL перенаправления может быть задан как URI,
189 локальный для данного сервера, при этом полный URL перенаправления
190 формируется согласно схеме запроса (<var>$scheme</var>) и директив
191 <link doc="ngx_http_core_module.xml" id="server_name_in_redirect"/> и
192 <link doc="ngx_http_core_module.xml" id="port_in_redirect"/>.
193 </para>
194
195 <para>
196 Кроме того, в качестве единственного параметра можно указать
197 <value>URL</value> для временного перенаправления с кодом 302.
198 Такой параметр должен начинаться со строк “<literal>http://</literal>”,
199 “<literal>https://</literal>” или “<literal>$scheme</literal>”.
200 В <value>URL</value> можно использовать переменные.
201 </para>
202
203 <para>
204 <note>
205 До версии 0.7.51 можно было возвращать только следующие коды:
206 204, 400, 402 — 406, 408, 410, 411, 413, 416 и 500 — 504.
207 </note>
208
209 <note>
210 До версий 1.1.16 и 1.0.13 код 307 не обрабатывался как перенаправление.
211 </note>
181 </para> 212 </para>
182 213
183 </directive> 214 </directive>
184 215
185 216
232 <tag-desc> 263 <tag-desc>
233 возвращает постоянное перенаправление с кодом 301. 264 возвращает постоянное перенаправление с кодом 301.
234 </tag-desc> 265 </tag-desc>
235 266
236 </list> 267 </list>
268 Полный URL перенаправлений формируется согласно
269 схеме запроса (<var>$scheme</var>) и директив
270 <link doc="ngx_http_core_module.xml" id="server_name_in_redirect"/> и
271 <link doc="ngx_http_core_module.xml" id="port_in_redirect"/>.
237 </para> 272 </para>
238 273
239 <para> 274 <para>
240 Пример: 275 Пример:
241 <example> 276 <example>