Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_mirror_module.xml @ 2016:e6de97d14f81
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> |