Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_mirror_module.xml @ 2016:e6de97d14f81

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the mirror module.
author Yaroslav Zhuravlev <yar@nginx.com>
date Fri, 04 Aug 2017 18:24:38 +0300
parents
children 03538fa2acfe
comparison
equal deleted inserted replaced
2015:75cb57264e52 2016:e6de97d14f81
1 <?xml version="1.0"?>
2
3 <!--
4 Copyright (C) Nginx, Inc.
5 -->
6
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8
9 <module name="Модуль ngx_http_mirror_module"
10 link="/ru/docs/http/ngx_http_mirror_module.html"
11 lang="ru"
12 rev="1">
13
14 <section id="summary">
15
16 <para>
17 Модуль <literal>ngx_http_mirror_module</literal> (1.13.4) позволяет
18 зеркалировать исходный запрос
19 при помощи создания фоновых зеркалирующих подзапросов.
20 Результат зеркалирующих подзапросов игнорируется.
21 </para>
22
23 </section>
24
25
26 <section id="example" name="Пример конфигурации">
27
28 <para>
29 <example>
30 location / {
31 mirror /mirror;
32 proxy_pass http://backend;
33 }
34
35 location /mirror {
36 internal;
37 proxy_pass http://test_backend$request_uri;
38 }
39 </example>
40 </para>
41
42 </section>
43
44
45 <section id="directives" name="Директивы">
46
47 <directive name="mirror">
48 <syntax><value>uri</value> | <literal>off</literal></syntax>
49 <default>off</default>
50 <context>http</context>
51 <context>server</context>
52 <context>location</context>
53
54 <para>
55 Задаёт URI, на который будет зеркалироваться исходный запрос.
56 На одном уровне может использоваться несколько зеркал.
57 </para>
58
59 </directive>
60
61
62 <directive name="mirror_request_body">
63 <syntax><literal>on</literal> | <literal>off</literal></syntax>
64 <default>on</default>
65 <context>http</context>
66 <context>server</context>
67 <context>location</context>
68
69 <para>
70 Позволяет зеркалировать исходное тело запроса.
71 Если включено, то тело запроса клиента будет прочитано
72 перед созданием зеркалирующих подзапросов.
73 В этом случае будет отключено
74 небуферизованное проксирование тела запроса клиента, задаваемое директивами
75 <link doc="ngx_http_proxy_module.xml" id="proxy_request_buffering">proxy_request_bufferning</link>,
76 <link doc="ngx_http_fastcgi_module.xml" id="fastcgi_request_buffering">fastcgi_request_bufferning</link>,
77 <link doc="ngx_http_scgi_module.xml" id="scgi_request_buffering">scgi_request_bufferning</link>
78 и
79 <link doc="ngx_http_uwsgi_module.xml" id="uwsgi_request_buffering">uwsgi_request_bufferning</link>.
80 <example>
81 location / {
82 mirror /mirror;
83 mirror_request_body off;
84 proxy_pass http://backend;
85 }
86
87 location /mirror {
88 internal;
89 proxy_pass http://log_backend;
90 proxy_pass_request_body off;
91 proxy_set_header Content-Length "";
92 proxy_set_header X-Original-URI $request_uri;
93 }
94 </example>
95 </para>
96
97 </directive>
98
99 </section>
100
101 </module>