Mercurial > hg > nginx-site
changeset 361:1018108c5068
Revision.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Thu, 26 Jan 2012 21:22:01 +0000 |
parents | 43f379b12b76 |
children | db6774c4c699 |
files | xml/ru/docs/http/ngx_http_memcached_module.xml |
diffstat | 1 files changed, 62 insertions(+), 56 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_memcached_module.xml Thu Jan 26 19:42:39 2012 +0000 +++ b/xml/ru/docs/http/ngx_http_memcached_module.xml Thu Jan 26 21:22:01 2012 +0000 @@ -2,35 +2,36 @@ <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> -<module name="Директивы модуля ngx_http_memcached_module" +<module name="Модуль ngx_http_memcached_module" link="/ru/docs/http/ngx_http_memcached_module.html" lang="ru"> <section id="summary"> <para> -Модуль ngx_http_memcached_module позволяет получать ответ из сервера memcached. -Ключ задаётся в переменной $memcached_key. +Модуль <literal>ngx_http_memcached_module</literal> позволяет получать +ответ из сервера memcached. +Ключ задаётся в переменной <var>$memcached_key</var>. Ответ в memcached должен быть предварительно помещён внешним по отношению -к nginx'у способом. +к nginx’у способом. </para> </section> -<section name="Пример конфигурации" id="example"> +<section id="example" name="Пример конфигурации"> <para> <example> server { location / { - set $memcached_key "$uri?$args"; - memcached_pass host:11211; - error_page 404 502 504 = @fallback; + set $memcached_key "$uri?$args"; + memcached_pass host:11211; + error_page 404 502 504 = @fallback; } location @fallback { - proxy_pass http://backend; + proxy_pass http://backend; } } </example> @@ -39,15 +40,17 @@ </section> -<section name="Директивы" id="directives"> +<section id="directives" name="Директивы"> <directive name="memcached_buffer_size"> <syntax><value>размер</value></syntax> -<default>4k/8k</default> -<context>http, server, location</context> +<default>4k|8k</default> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива задаёт размер буфера, в который будет читаться ответ, +Задаёт <value>размер</value> буфера, в который будет читаться ответ, получаемый от сервера memcached. Ответ синхронно передаётся клиенту сразу же по мере его поступления. </para> @@ -57,12 +60,14 @@ <directive name="memcached_connect_timeout"> <syntax><value>время</value></syntax> -<default>60</default> -<context>http, server, location</context> +<default>60s</default> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива задаёт таймаут для соединения с сервером memcached. -Необходимо иметь в виду, что этот таймаут не может быть больше 75 секунд. +Задаёт таймаут для установления соединения с сервером memcached. +Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд. </para> </directive> @@ -77,34 +82,30 @@ <literal>off</literal> ...</syntax> <default>error timeout</default> -<context>http, server, location</context> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива определяет, в каких случаях запрос будет передан следующему -серверу memcached: -<list type="bullet"> +Определяет, в каких случаях запрос будет передан следующему серверу: +<list type="tag"> -<listitem> -error — произшла ошибка соединения с сервером, передачи ему запроса или -чтения заголовка ответа сервера; -</listitem> +<tag-name><literal>error</literal></tag-name> +<tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или +чтения заголовка ответа сервера;</tag-desc> -<listitem> -timeout — произошёл таймаут во время соединения с сервером, -передачи ему запроса или чтения заголовка ответа сервера; -</listitem> +<tag-name><literal>timeout</literal></tag-name> +<tag-desc>произошёл таймаут во время соединения с сервером, +передачи ему запроса или чтения заголовка ответа сервера;</tag-desc> -<listitem> -invalid_response — сервер вернул пустой или неверный ответ; -</listitem> +<tag-name><literal>invalid_response</literal></tag-name> +<tag-desc>сервер вернул пустой или неверный ответ;</tag-desc> -<listitem> -not_found — сервер не нашёл ответ; -</listitem> +<tag-name><literal>not_found</literal></tag-name> +<tag-desc>сервер не нашёл ответ;</tag-desc> -<listitem> -off — запрещает передачу запроса следующему серверу; -</listitem> +<tag-name><literal>off</literal></tag-name> +<tag-desc>запрещает передачу запроса следующему серверу.</tag-desc> </list> </para> @@ -120,22 +121,23 @@ <directive name="memcached_pass"> -<syntax><value>URL</value></syntax> +<syntax><value>адрес</value></syntax> <default/> -<context>location, if в location, limit_except</context> +<context>location</context> +<context>if в location</context> <para> -Директива задаёт адрес сервера memcached. -Адрес может быть указан в виде доменного имени или адреса, и порта: +Задаёт адрес сервера memcached. +Адрес может быть указан в виде доменного имени или адреса, и порта, например, <example> - memcached_pass localhost:11211; +memcached_pass localhost:11211; </example> </para> <para> -Если доменное имя резолвится в несколько адресов, то все они будут -использоваться в режиме round-robin. -И кроме того, адрес может быть +Если доменному имени соответствует несколько адресов, то все они будут +использоваться по очереди (round-robin). +И, кроме того, адрес может быть <link doc="ngx_http_upstream_module.xml">группой серверов</link>. </para> @@ -144,15 +146,17 @@ <directive name="memcached_read_timeout"> <syntax><value>время</value></syntax> -<default>60</default> -<context>http, server, location</context> +<default>60s</default> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива задаёт таймаут при чтении ответа сервера memcached. +Задаёт таймаут при чтении ответа сервера memcached. Таймаут устанавливается не на всю передачу ответа, а только между двумя операциями чтения. -Если по истечении этого времени сервер ничего не передаст, -то nginx закрывает соединение. +Если по истечении этого времени сервер memcached ничего не передаст, +соединение закрывается. </para> </directive> @@ -160,15 +164,17 @@ <directive name="memcached_send_timeout"> <syntax><value>время</value></syntax> -<default>60</default> -<context>http, server, location</context> +<default>60s</default> +<context>http</context> +<context>server</context> +<context>location</context> <para> -Директива задаёт таймаут при передаче запроса серверу memcached. +Задаёт таймаут при передаче запроса серверу memcached. Таймаут устанавливается не на всю передачу запроса, а только между двумя операциями записи. -Если по истечении этого времени сервер не примет новых данных, -то nginx закрывает соединение. +Если по истечении этого времени сервер memcached не примет новых данных, +соединение закрывается. </para> </directive>