Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_memcached_module.xml @ 76:4a4caa566120

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Russian documentation import. Changes in module.dtd: <example> now allowed to contain <value> and <emphasis> elements (we need this to show important parts in examples), less strict checking of <directive> syntax (we don't want to fully document some directives, notably deprecated ones). Known issues: 1. <syntax> elements are preserved as is, they will require manual conversion (likely to some not-yet-existed format a la DocBook cmdsynopsis, as currently used one seems to be incomplete); 2. <value> no longer corresponds to replaceable content, and it's use in examples isn't correct; 3. <link doc="document#fragment"> doesn't work with current xslt, either should be supported or changed to <link doc="document" id="fragment">. The following files are intentionally omitted: maillists.xml (support.xml should be used instead), experimental.xml (obsolete), faq.xml (conflicts with existing one, needs discussion). Not yet linked to site.
author Maxim Dounin <mdounin@mdounin.ru>
date Tue, 11 Oct 2011 12:57:50 +0000
parents
children 1d315ef37215
comparison
equal deleted inserted replaced
75:2bf4cd2787c5 76:4a4caa566120
1 <?xml version="1.0" encoding="utf-8"?>
2
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4
5 <module name="Директивы модуля ngx_http_memcached_module"
6 link="/ru/docs/http/ngx_http_memcached_module.html"
7 lang="ru">
8
9 <section name="" id="summary">
10
11 <para>
12 Модуль ngx_http_memcached_module позволяет получать ответ из сервера memcached.
13 Ключ задаётся в переменной $memcached_key.
14 Ответ в memcached должен быть предварительно помещён внешним по отношению
15 к nginx'у способом.
16 </para>
17
18 </section>
19
20
21 <section name="Пример конфигурации" id="example">
22
23 <para>
24 <example>
25 server {
26 location / {
27 set $memcached_key "$uri?$args";
28 memcached_pass host:11211;
29 error_page 404 502 504 = @fallback;
30 }
31
32 location @fallback {
33 proxy_pass http://backend;
34 }
35 }
36 </example>
37 </para>
38
39 </section>
40
41
42 <section name="Директивы" id="directives">
43
44 <directive name="memcached_buffer_size">
45 <syntax>memcached_buffer_size <value>размер</value></syntax>
46 <default>memcached_buffer_size 4k/8k</default>
47 <context>http, server, location</context>
48
49 <para>
50 Директива задаёт размер буфера, в который будет читаться ответ,
51 получаемый от cервера memcached.
52 Ответ синхронно передаётся клиенту сразу же по мере его поступления.
53 </para>
54
55 </directive>
56
57
58 <directive name="memcached_connect_timeout">
59 <syntax>memcached_connect_timeout <value>время</value></syntax>
60 <default>memcached_connect_timeout 60</default>
61 <context>http, server, location</context>
62
63 <para>
64 Директива задаёт таймаут для соединения с cервером memcached.
65 Необходимо иметь в виду, что этот таймаут не может быть больше 75 секунд.
66 </para>
67
68 </directive>
69
70
71 <directive name="memcached_next_upstream">
72 <syntax>memcached_next_upstream
73 <value>[error|timeout|invalid_response|not_found|off]</value>
74 </syntax>
75 <default>memcached_next_upstream error timeout</default>
76 <context>http, server, location</context>
77
78 <para>
79 Директива определяет, в каких случаях запрос будет передан следующему
80 серверу memcached:
81 <list type="bullet">
82
83 <listitem>
84 error — произшла ошибка соединения с сервером, передачи ему запроса или
85 чтения заголовка ответа сервера;
86 </listitem>
87
88 <listitem>
89 timeout — произошёл таймаут во время соединения с сервером,
90 передачи ему запроса или чтения заголовка ответа сервера;
91 </listitem>
92
93 <listitem>
94 invalid_response — сервер вернул пустой или неверный ответ;
95 </listitem>
96
97 <listitem>
98 not_found — сервер не нашёл ответ;
99 </listitem>
100
101 <listitem>
102 off — запрещает передачу запроса следующему серверу;
103 </listitem>
104
105 </list>
106 </para>
107
108 <para>
109 Необходимо понимать, что передача запроса следующему серверу возможна
110 только при условии, что клиенту ещё ничего не передавалось.
111 То есть, если ошибка или таймаут возникли в середине передачи ответа,
112 то исправить это уже невозможно.
113 </para>
114
115 </directive>
116
117
118 <directive name="memcached_pass">
119 <syntax>memcached_pass <value>URL</value></syntax>
120 <default>нет</default>
121 <context>location, if в location, limit_except</context>
122
123 <para>
124 Директива задаёт адрес сервера memcached.
125 Адрес может быть указан в виде доменного имени или адреса и порта:
126 <example>
127 memcached_pass localhost:11211;
128 </example>
129 </para>
130
131 <para>
132 Если доменное имя резолвится в несколько адресов, то все они будут
133 использоваться в режиме round-robin.
134 И кроме того, адрес может быть
135 <link doc="ngx_http_upstream.xml">группой серверов</link>.
136 </para>
137
138 </directive>
139
140
141 <directive name="memcached_read_timeout">
142 <syntax>memcached_read_timeout <value>время</value></syntax>
143 <default>memcached_read_timeout 60</default>
144 <context>http, server, location</context>
145
146 <para>
147 Директива задаёт таймаут при чтении ответа сервера memcached.
148 Таймаут устанавливается не на всю передачу ответа,
149 а только между двумя операциями чтения.
150 Если по истечении этого времени сервер ничего не передаст,
151 то nginx закрывает соединение.
152 </para>
153
154 </directive>
155
156
157 <directive name="memcached_send_timeout">
158 <syntax>memcached_send_timeout <value>время</value></syntax>
159 <default>memcached_send_timeout 60</default>
160 <context>http, server, location</context>
161
162 <para>
163 Директива задаёт таймаут при передаче запроса серверу memcached.
164 Таймаут устанавливается не на всю передачу запроса,
165 а только между двумя операциями записи.
166 Если по истечении этого времени сервер не примет новых данных,
167 то nginx закрывает соединение.
168 </para>
169
170 </directive>
171
172 </section>
173
174 </module>