Mercurial > hg > nginx-site
changeset 364:bb51d3e17dd0
Style fixed.
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_autoindex_module.xml +++ b/xml/en/docs/http/ngx_http_autoindex_module.xml @@ -12,8 +12,9 @@ The <literal>ngx_http_autoindex_module</literal> module produces a directory listing. Usually a request is passed to the <literal>ngx_http_autoindex_module</literal> -module when the <link doc="ngx_http_index_module.xml">ngx_http_index_module</link> -module could not find an index file. +module when the +<link doc="ngx_http_index_module.xml">ngx_http_index_module</link> module +could not find an index file. </para> </section> @@ -60,7 +61,6 @@ Specifies whether file sizes in the dire output exactly, or rounded to kilobytes, megabytes, and gigabytes. </para> - </directive>
--- a/xml/en/docs/http/ngx_http_core_module.xml +++ b/xml/en/docs/http/ngx_http_core_module.xml @@ -10,9 +10,9 @@ <directive name="aio"> <syntax> - <literal>on</literal> | - <literal>off</literal> | - <literal>sendfile</literal></syntax> + <literal>on</literal> | + <literal>off</literal> | + <literal>sendfile</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -91,9 +91,11 @@ In this configuration, <c-func>sendfile< the <c-def>SF_NODISKIO</c-def> flag which causes it not to block on disk I/O and instead report back when the data are not in memory; nginx then initiates an asynchronous data load by reading -one byte. The FreeBSD kernel then loads the first 128K bytes +one byte. +The FreeBSD kernel then loads the first 128K bytes of a file into memory, however next reads will only load data -in 16K chunks. This can be tuned using the +in 16K chunks. +This can be tuned using the <link id="read_ahead"/> directive. </para> @@ -226,9 +228,9 @@ It is usually 16K on other 64-bit platfo <directive name="client_body_in_file_only"> <syntax> - <literal>on</literal> | - <literal>clean</literal> | - <literal>off</literal></syntax> + <literal>on</literal> | + <literal>clean</literal> | + <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -278,10 +280,10 @@ variable, to save the number of copy ope <directive name="client_body_temp_path"> <syntax> - <value>path</value> - [<value>level1</value> - [<value>level2</value> - [<value>level3</value>]]]</syntax> + <value>path</value> + [<value>level1</value> + [<value>level2</value> + [<value>level3</value>]]]</syntax> <default>client_body_temp</default> <context>http</context> <context>server</context> @@ -464,9 +466,9 @@ using XFS under Linux, it needs to be in <directive name="error_page"> <syntax> - <value>code</value> ... - [<literal>=</literal>[<value>response</value>]] - <value>uri</value></syntax> + <value>code</value> ... + [<literal>=</literal>[<value>response</value>]] + <value>uri</value></syntax> <default/> <context>http</context> <context>server</context> @@ -527,9 +529,9 @@ location @fallback { <directive name="if_modified_since"> <syntax> - <literal>off</literal> | - <literal>exact</literal> | - <literal>before</literal></syntax> + <literal>off</literal> | + <literal>exact</literal> | + <literal>before</literal></syntax> <default>exact</default> <context>http</context> <context>server</context> @@ -673,8 +675,8 @@ After this many requests are made, the c <directive name="keepalive_timeout"> <syntax> - <value>timeout</value> - [<value>header_timeout</value>]</syntax> + <value>timeout</value> + [<value>header_timeout</value>]</syntax> <default>75s</default> <context>http</context> <context>server</context> @@ -839,9 +841,9 @@ location /flv/ { <directive name="lingering_close"> <syntax> - <literal>off</literal> | - <literal>on</literal> | - <literal>always</literal></syntax> + <literal>off</literal> | + <literal>on</literal> | + <literal>always</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -913,42 +915,42 @@ The “wait-read-ignore” cycle is repeated, but no longer than specified by the <directive name="listen"> <syntax> - <value>address</value>[:<value>port</value>] - [<literal>default_server</literal>] - [<literal>setfib</literal>=<value>number</value>] - [<literal>backlog</literal>=<value>number</value>] - [<literal>rcvbuf</literal>=<value>size</value>] - [<literal>sndbuf</literal>=<value>size</value>] - [<literal>accept_filter</literal>=<value>filter</value>] - [<literal>deferred</literal>] - [<literal>bind</literal>] - [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] - [<literal>ssl</literal>] - [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> + <value>address</value>[:<value>port</value>] + [<literal>default_server</literal>] + [<literal>setfib</literal>=<value>number</value>] + [<literal>backlog</literal>=<value>number</value>] + [<literal>rcvbuf</literal>=<value>size</value>] + [<literal>sndbuf</literal>=<value>size</value>] + [<literal>accept_filter</literal>=<value>filter</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <syntax> - <value>port</value> - [<literal>default_server</literal>] - [<literal>setfib</literal>=<value>number</value>] - [<literal>backlog</literal>=<value>number</value>] - [<literal>rcvbuf</literal>=<value>size</value>] - [<literal>sndbuf</literal>=<value>size</value>] - [<literal>accept_filter</literal>=<value>filter</value>] - [<literal>deferred</literal>] - [<literal>bind</literal>] - [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] - [<literal>ssl</literal>] - [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> + <value>port</value> + [<literal>default_server</literal>] + [<literal>setfib</literal>=<value>number</value>] + [<literal>backlog</literal>=<value>number</value>] + [<literal>rcvbuf</literal>=<value>size</value>] + [<literal>sndbuf</literal>=<value>size</value>] + [<literal>accept_filter</literal>=<value>filter</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <syntax> - <literal>unix:</literal><value>path</value> - [<literal>default_server</literal>] - [<literal>backlog</literal>=<value>number</value>] - [<literal>rcvbuf</literal>=<value>size</value>] - [<literal>sndbuf</literal>=<value>size</value>] - [<literal>accept_filter</literal>=<value>filter</value>] - [<literal>deferred</literal>] - [<literal>bind</literal>] - [<literal>ssl</literal>] - [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> + <literal>unix:</literal><value>path</value> + [<literal>default_server</literal>] + [<literal>backlog</literal>=<value>number</value>] + [<literal>rcvbuf</literal>=<value>size</value>] + [<literal>sndbuf</literal>=<value>size</value>] + [<literal>accept_filter</literal>=<value>filter</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <default>*:80 | *:8000</default> <context>server</context> @@ -971,7 +973,8 @@ IPv6 addresses (0.7.36) are specified in listen [::]:8000; listen [fe80::1]; </example> -UNIX-domain sockets (0.8.21) are specified with the “<literal>unix:</literal>” prefix: +UNIX-domain sockets (0.8.21) are specified with the “<literal>unix:</literal>” +prefix: <example> listen unix:/var/run/nginx.sock; </example> @@ -1157,11 +1160,11 @@ listen 127.0.0.1 default accept_filter=d <directive name="location"> <syntax block="yes">[ - <literal>=</literal> | - <literal>~</literal> | - <literal>~*</literal> | - <literal>^~</literal> - ] <value>uri</value></syntax> + <literal>=</literal> | + <literal>~</literal> | + <literal>~*</literal> | + <literal>^~</literal> + ] <value>uri</value></syntax> <syntax block="yes"><literal>@</literal><value>name</value></syntax> <default/> <context>server</context> @@ -1668,8 +1671,7 @@ and should not generally be used. <directive name="reset_timedout_connection"> -<syntax> - <literal>on</literal> | <literal>off</literal></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -2174,12 +2176,8 @@ send a file in full packets. <directive name="try_files"> -<syntax> - <value>file</value> ... - <value>uri</value></syntax> -<syntax> - <value>file</value> ... - =<value>code</value></syntax> +<syntax><value>file</value> ... <value>uri</value></syntax> +<syntax><value>file</value> ... =<value>code</value></syntax> <default/> <context>server</context> <context>location</context> @@ -2440,6 +2438,7 @@ For more information, please refer to </section> + <section id="variables" name="Embedded Variables"> <para>
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml +++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml @@ -183,11 +183,11 @@ will be cached. <directive name="fastcgi_cache_path"> <syntax> - <value>path</value> - [<literal>levels</literal>=<value>levels</value>] - <literal>keys_zone</literal>=<value>name</value>:<value>size</value> - [<literal>inactive</literal>=<value>time</value>] - [<literal>max_size</literal>=<value>size</value>]</syntax> + <value>path</value> + [<literal>levels</literal>=<value>levels</value>] + <literal>keys_zone</literal>=<value>name</value>:<value>size</value> + [<literal>inactive</literal>=<value>time</value>] + [<literal>max_size</literal>=<value>size</value>]</syntax> <default/> <context>http</context> @@ -239,15 +239,15 @@ when this size is exceeded it removes th <directive name="fastcgi_cache_use_stale"> <syntax> - <literal>error</literal> | - <literal>timeout</literal> | - <literal>invalid_header</literal> | - <literal>updating</literal> | - <literal>http_500</literal> | - <literal>http_503</literal> | - <literal>http_404</literal> | - <literal>off</literal> - ...</syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>updating</literal> | + <literal>http_500</literal> | + <literal>http_503</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>off</default> <context>http</context> <context>server</context> @@ -429,7 +429,7 @@ By default, a FastCGI server will close sending the response. When set to the value <literal>on</literal>, nginx will instruct a FastCGI server to keep connections open. -This in particular is necessary for +This in particular is necessary for <link doc="ngx_http_upstream_module.xml" id="keepalive"/> connections to FastCGI servers to function. </para> @@ -439,14 +439,14 @@ connections to FastCGI servers to functi <directive name="fastcgi_next_upstream"> <syntax> - <literal>error</literal> | - <literal>timeout</literal> | - <literal>invalid_header</literal> | - <literal>http_500</literal> | - <literal>http_503</literal> | - <literal>http_404</literal> | - <literal>off</literal> - ...</syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>http_500</literal> | + <literal>http_503</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>error timeout</default> <context>http</context> <context>server</context> @@ -821,8 +821,8 @@ parameters using the <link id="fastcgi_p <section id="variables" name="Embedded Variables"> <para> -The <literal>ngx_http_fastcgi_module</literal> module supports embedded variables -that can be used to set parameters using the +The <literal>ngx_http_fastcgi_module</literal> module supports embedded +variables that can be used to set parameters using the <link id="fastcgi_param"/> directive: <list type="tag">
--- a/xml/en/docs/http/ngx_http_gzip_module.xml +++ b/xml/en/docs/http/ngx_http_gzip_module.xml @@ -145,16 +145,16 @@ Sets the minimum HTTP version of a reque <directive name="gzip_proxied"> <syntax> - <literal>off</literal> | - <literal>expired</literal> | - <literal>no-cache</literal> | - <literal>no-store</literal> | - <literal>private</literal> | - <literal>no_last_modified</literal> | - <literal>no_etag</literal> | - <literal>auth</literal> | - <literal>any</literal> - ...</syntax> + <literal>off</literal> | + <literal>expired</literal> | + <literal>no-cache</literal> | + <literal>no-store</literal> | + <literal>private</literal> | + <literal>no_last_modified</literal> | + <literal>no_etag</literal> | + <literal>auth</literal> | + <literal>any</literal> + ...</syntax> <default>off</default> <context>http</context> <context>server</context>
--- a/xml/en/docs/http/ngx_http_headers_module.xml +++ b/xml/en/docs/http/ngx_http_headers_module.xml @@ -16,6 +16,7 @@ fields, and to add arbitrary fields to a </section> + <section id="example" name="Example Configuration"> <para>
--- a/xml/en/docs/http/ngx_http_image_filter_module.xml +++ b/xml/en/docs/http/ngx_http_image_filter_module.xml @@ -51,19 +51,21 @@ location = /empty { <section id="directives" name="Directives"> <directive name="image_filter"> - <syntax><literal>off</literal></syntax> - <syntax><literal>test</literal></syntax> - <syntax><literal>size</literal></syntax> - <syntax><literal>rotate</literal> - <literal>90</literal> | <literal>180</literal> | <literal>270</literal></syntax> - <syntax> - <literal>resize</literal> - <value>width</value> - <value>height</value></syntax> - <syntax> - <literal>crop</literal> - <value>width</value> - <value>height</value></syntax> +<syntax><literal>off</literal></syntax> +<syntax><literal>test</literal></syntax> +<syntax><literal>size</literal></syntax> +<syntax> + <literal>rotate</literal> + <literal>90</literal> | <literal>180</literal> | + <literal>270</literal></syntax> +<syntax> + <literal>resize</literal> + <value>width</value> + <value>height</value></syntax> +<syntax> + <literal>crop</literal> + <value>width</value> + <value>height</value></syntax> <default/> <context>location</context>
--- a/xml/en/docs/http/ngx_http_limit_conn_module.xml +++ b/xml/en/docs/http/ngx_http_limit_conn_module.xml @@ -154,6 +154,7 @@ to all further requests. </directive> + <directive name="limit_zone"> <syntax> <value>name</value>
--- a/xml/en/docs/http/ngx_http_log_module.xml +++ b/xml/en/docs/http/ngx_http_log_module.xml @@ -35,9 +35,9 @@ access_log /spool/logs/nginx-access.log <directive name="access_log"> <syntax> - <value>path</value> - [<value>format</value> - [<literal>buffer</literal>=<value>size</value>]]</syntax> + <value>path</value> + [<value>format</value> + [<literal>buffer</literal>=<value>size</value>]]</syntax> <syntax><literal>off</literal></syntax> <default>log/access.log combined</default> <context>http</context> @@ -49,8 +49,8 @@ access_log /spool/logs/nginx-access.log <para> Sets the path, format, and buffer size for the buffered log writes. Several logs can be specified on the same level. -The special value <literal>off</literal> cancels all <literal>access_log</literal> -directives on the current level. +The special value <literal>off</literal> cancels all +<literal>access_log</literal> directives on the current level. If format is not specified then the predefined format “<literal>combined</literal>” is used. </para> @@ -200,6 +200,7 @@ log_format combined '$remote_addr - $rem </directive> + <directive name="open_log_file_cache"> <syntax>
--- a/xml/en/docs/http/ngx_http_memcached_module.xml +++ b/xml/en/docs/http/ngx_http_memcached_module.xml @@ -75,12 +75,12 @@ It should be noted that this timeout can <directive name="memcached_next_upstream"> <syntax> - <literal>error</literal> | - <literal>timeout</literal> | - <literal>invalid_response</literal> | - <literal>not_found</literal> | - <literal>off</literal> - ...</syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_response</literal> | + <literal>not_found</literal> | + <literal>off</literal> + ...</syntax> <default>error timeout</default> <context>http</context> <context>server</context>
--- a/xml/en/docs/http/ngx_http_proxy_module.xml +++ b/xml/en/docs/http/ngx_http_proxy_module.xml @@ -211,11 +211,11 @@ will be cached. <directive name="proxy_cache_path"> <syntax> - <value>path</value> - [<literal>levels</literal>=<value>levels</value>] - <literal>keys_zone</literal>=<value>name</value>:<value>size</value> - [<literal>inactive</literal>=<value>time</value>] - [<literal>max_size</literal>=<value>size</value>]</syntax> + <value>path</value> + [<literal>levels</literal>=<value>levels</value>] + <literal>keys_zone</literal>=<value>name</value>:<value>size</value> + [<literal>inactive</literal>=<value>time</value>] + [<literal>max_size</literal>=<value>size</value>]</syntax> <default/> <context>http</context> @@ -267,17 +267,17 @@ when this size is exceeded it removes th <directive name="proxy_cache_use_stale"> <syntax> - <literal>error</literal> | - <literal>timeout</literal> | - <literal>invalid_header</literal> | - <literal>updating</literal> | - <literal>http_500</literal> | - <literal>http_502</literal> | - <literal>http_503</literal> | - <literal>http_504</literal> | - <literal>http_404</literal> | - <literal>off</literal> - ...</syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>updating</literal> | + <literal>http_500</literal> | + <literal>http_502</literal> | + <literal>http_503</literal> | + <literal>http_504</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>off</default> <context>http</context> <context>server</context> @@ -444,16 +444,16 @@ using the <link doc="ngx_http_core_modul <directive name="proxy_next_upstream"> <syntax> - <literal>error</literal> | - <literal>timeout</literal> | - <literal>invalid_header</literal> | - <literal>http_500</literal> | - <literal>http_502</literal> | - <literal>http_503</literal> | - <literal>http_504</literal> | - <literal>http_404</literal> | - <literal>off</literal> - ...</syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>http_500</literal> | + <literal>http_502</literal> | + <literal>http_503</literal> | + <literal>http_504</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>error timeout</default> <context>http</context> <context>server</context>
--- a/xml/en/docs/http/ngx_http_realip_module.xml +++ b/xml/en/docs/http/ngx_http_realip_module.xml @@ -54,9 +54,9 @@ replacement addresses. <directive name="real_ip_header"> <syntax> - <value>field</value> | - <literal>X-Real-IP</literal> | - <literal>X-Forwarded-For</literal></syntax> + <value>field</value> | + <literal>X-Real-IP</literal> | + <literal>X-Forwarded-For</literal></syntax> <default>X-Real-IP</default> <context>http</context> <context>server</context>
--- a/xml/en/docs/http/ngx_http_referer_module.xml +++ b/xml/en/docs/http/ngx_http_referer_module.xml @@ -44,11 +44,11 @@ if ($invalid_referer) { <directive name="valid_referers"> <syntax> - <literal>none</literal> | - <literal>blocked</literal> | - <literal>server_names</literal> | - <value>string</value> - ...</syntax> + <literal>none</literal> | + <literal>blocked</literal> | + <literal>server_names</literal> | + <value>string</value> + ...</syntax> <default/> <context>server</context> <context>location</context>
--- a/xml/en/docs/http/ngx_http_split_clients_module.xml +++ b/xml/en/docs/http/ngx_http_split_clients_module.xml @@ -32,6 +32,7 @@ http { index index${variant}.html; </example> </para> + </section>
--- a/xml/ru/docs/http/ngx_http_access_module.xml +++ b/xml/ru/docs/http/ngx_http_access_module.xml @@ -6,7 +6,6 @@ link="/ru/docs/http/ngx_http_access_module.html" lang="ru"> - <section id="summary"> <para>
--- a/xml/ru/docs/http/ngx_http_autoindex_module.xml +++ b/xml/ru/docs/http/ngx_http_autoindex_module.xml @@ -60,7 +60,6 @@ location / { каталога — точно, или округляя до килобайт, мегабайт и гигабайт. </para> - </directive>
--- a/xml/ru/docs/http/ngx_http_core_module.xml +++ b/xml/ru/docs/http/ngx_http_core_module.xml @@ -10,9 +10,9 @@ <directive name="aio"> <syntax> - <literal>on</literal> | - <literal>off</literal> | - <literal>sendfile</literal></syntax> + <literal>on</literal> | + <literal>off</literal> | + <literal>sendfile</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -223,9 +223,9 @@ chunked encoding, несмотря на требования стандарта. <directive name="client_body_in_file_only"> <syntax> - <literal>on</literal> | - <literal>clean</literal> | - <literal>off</literal></syntax> + <literal>on</literal> | + <literal>clean</literal> | + <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -273,10 +273,10 @@ chunked encoding, несмотря на требования стандарта. <directive name="client_body_temp_path"> <syntax> - <value>путь</value> - [<value>уровень1</value> - [<value>уровень2</value> - [<value>уровень3</value>]]]</syntax> + <value>путь</value> + [<value>уровень1</value> + [<value>уровень2</value> + [<value>уровень3</value>]]]</syntax> <default>client_body_temp</default> <context>http</context> <context>server</context> @@ -455,9 +455,9 @@ directio 4m; <directive name="error_page"> <syntax> - <value>код</value> ... - [<literal>=</literal>[<value>ответ</value>]] - <value>uri</value></syntax> + <value>код</value> ... + [<literal>=</literal>[<value>ответ</value>]] + <value>uri</value></syntax> <default/> <context>http</context> <context>server</context> @@ -516,9 +516,9 @@ location @fallback { <directive name="if_modified_since"> <syntax> - <literal>off</literal> | - <literal>exact</literal> | - <literal>before</literal></syntax> + <literal>off</literal> | + <literal>exact</literal> | + <literal>before</literal></syntax> <default>exact</default> <context>http</context> <context>server</context> @@ -661,8 +661,8 @@ location /404.html { <directive name="keepalive_timeout"> <syntax> - <value>таймаут</value> - [<value>заголовок_таймаута</value>]</syntax> + <value>таймаут</value> + [<value>заголовок_таймаута</value>]</syntax> <default>75s</default> <context>http</context> <context>server</context> @@ -824,9 +824,9 @@ location /flv/ { <directive name="lingering_close"> <syntax> - <literal>off</literal> | - <literal>on</literal> | - <literal>always</literal></syntax> + <literal>off</literal> | + <literal>on</literal> | + <literal>always</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -900,42 +900,42 @@ location /flv/ { <directive name="listen"> <syntax> - <value>адрес</value>[:<value>порт</value>] - [<literal>default_server</literal>] - [<literal>setfib</literal>=<value>число</value>] - [<literal>backlog</literal>=<value>число</value>] - [<literal>rcvbuf</literal>=<value>размер</value>] - [<literal>sndbuf</literal>=<value>размер</value>] - [<literal>accept_filter</literal>=<value>фильтр</value>] - [<literal>deferred</literal>] - [<literal>bind</literal>] - [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] - [<literal>ssl</literal>] - [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> + <value>адрес</value>[:<value>порт</value>] + [<literal>default_server</literal>] + [<literal>setfib</literal>=<value>число</value>] + [<literal>backlog</literal>=<value>число</value>] + [<literal>rcvbuf</literal>=<value>размер</value>] + [<literal>sndbuf</literal>=<value>размер</value>] + [<literal>accept_filter</literal>=<value>фильтр</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <syntax> - <value>порт</value> - [<literal>default_server</literal>] - [<literal>setfib</literal>=<value>число</value>] - [<literal>backlog</literal>=<value>число</value>] - [<literal>rcvbuf</literal>=<value>размер</value>] - [<literal>sndbuf</literal>=<value>размер</value>] - [<literal>accept_filter</literal>=<value>фильтр</value>] - [<literal>deferred</literal>] - [<literal>bind</literal>] - [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] - [<literal>ssl</literal>] - [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> + <value>порт</value> + [<literal>default_server</literal>] + [<literal>setfib</literal>=<value>число</value>] + [<literal>backlog</literal>=<value>число</value>] + [<literal>rcvbuf</literal>=<value>размер</value>] + [<literal>sndbuf</literal>=<value>размер</value>] + [<literal>accept_filter</literal>=<value>фильтр</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <syntax> - <literal>unix:</literal><value>путь</value> - [<literal>default_server</literal>] - [<literal>backlog</literal>=<value>число</value>] - [<literal>rcvbuf</literal>=<value>размер</value>] - [<literal>sndbuf</literal>=<value>размер</value>] - [<literal>accept_filter</literal>=<value>фильтр</value>] - [<literal>deferred</literal>] - [<literal>bind</literal>] - [<literal>ssl</literal>] - [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> + <literal>unix:</literal><value>путь</value> + [<literal>default_server</literal>] + [<literal>backlog</literal>=<value>число</value>] + [<literal>rcvbuf</literal>=<value>размер</value>] + [<literal>sndbuf</literal>=<value>размер</value>] + [<literal>accept_filter</literal>=<value>фильтр</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <default>*:80 | *:8000</default> <context>server</context> @@ -1145,11 +1145,11 @@ listen 127.0.0.1 default accept_filter=d <directive name="location"> <syntax block="yes">[ - <literal>=</literal> | - <literal>~</literal> | - <literal>~*</literal> | - <literal>^~</literal> - ] <value>uri</value></syntax> + <literal>=</literal> | + <literal>~</literal> | + <literal>~*</literal> | + <literal>^~</literal> + ] <value>uri</value></syntax> <syntax block="yes"><literal>@</literal><value>имя</value></syntax> <default/> <context>server</context> @@ -1318,7 +1318,8 @@ location ~* \.(gif|jpg|jpeg)$ { <para> Необходимо иметь в виду, что это преобразование необходимо для корректной проверки префиксных строк и регулярных выражений. -Если его не делать, то запрос “<literal>//scripts/one.php</literal>” не попадёт в +Если его не делать, то запрос “<literal>//scripts/one.php</literal>” +не попадёт в <example> location /scripts/ { ... @@ -1656,8 +1657,7 @@ open_file_cache_events on; <directive name="reset_timedout_connection"> -<syntax> - <literal>on</literal> | <literal>off</literal></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -2163,12 +2163,8 @@ server { <directive name="try_files"> -<syntax> - <value>файл</value> ... - <value>uri</value></syntax> -<syntax> - <value>файл</value> ... - =<value>код</value></syntax> +<syntax><value>файл</value> ... <value>uri</value></syntax> +<syntax><value>файл</value> ... =<value>код</value></syntax> <default/> <context>server</context> <context>location</context> @@ -2428,11 +2424,12 @@ location /download/ { </section> + <section id="variables" name="Встроенные переменные"> <para> -Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные переменные, -имена которых совпадают с именами переменных веб-сервера Apache. +Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные +переменные, имена которых совпадают с именами переменных веб-сервера Apache. Прежде всего, это переменные, представляющие из себя поля заголовка запроса клиента, такие как <var>$http_user_agent</var>, <var>$http_cookie</var> и тому подобное.
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml +++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml @@ -181,11 +181,11 @@ fastcgi_cache_key localhost:9000$request <directive name="fastcgi_cache_path"> <syntax> - <value>путь</value> - [<literal>levels</literal>=<value>уровни</value>] - <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value> - [<literal>inactive</literal>=<value>время</value>] - [<literal>max_size</literal>=<value>размер</value>]</syntax> + <value>путь</value> + [<literal>levels</literal>=<value>уровни</value>] + <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value> + [<literal>inactive</literal>=<value>время</value>] + [<literal>max_size</literal>=<value>размер</value>]</syntax> <default/> <context>http</context> @@ -207,7 +207,8 @@ fastcgi_cache_path /data/nginx/cache lev <para> Кэшируемый ответ сначала записывается во временный файл, а потом этот файл -переименовывается. Начиная с версии 0.8.9, временные файлы и кэш +переименовывается. +Начиная с версии 0.8.9, временные файлы и кэш могут располагаться на разных файловых системах, но нужно учитывать, что в этом случае вместо дешёвой операции переименовывания в пределах одной файловой системы файл копируется с одной файловой системы на другую. @@ -236,15 +237,15 @@ fastcgi_cache_path /data/nginx/cache lev <directive name="fastcgi_cache_use_stale"> <syntax> - <literal>error</literal> | - <literal>timeout</literal> | - <literal>invalid_header</literal> | - <literal>updating</literal> | - <literal>http_500</literal> | - <literal>http_503</literal> | - <literal>http_404</literal> | - <literal>off</literal> - ...</syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>updating</literal> | + <literal>http_500</literal> | + <literal>http_503</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>off</default> <context>http</context> <context>server</context> @@ -412,6 +413,7 @@ fastcgi_param SCRIPT_FILENAME /home/www/ </directive> + <directive name="fastcgi_keep_conn"> <syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> @@ -434,14 +436,14 @@ FastCGI-серверу оставлять соединения открытыми. <directive name="fastcgi_next_upstream"> <syntax> - <literal>error</literal> | - <literal>timeout</literal> | - <literal>invalid_header</literal> | - <literal>http_500</literal> | - <literal>http_503</literal> | - <literal>http_404</literal> | - <literal>off</literal> - ...</syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>http_500</literal> | + <literal>http_503</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>error timeout</default> <context>http</context> <context>server</context>
--- a/xml/ru/docs/http/ngx_http_gzip_module.xml +++ b/xml/ru/docs/http/ngx_http_gzip_module.xml @@ -145,16 +145,16 @@ gzip_types text/plain application/x <directive name="gzip_proxied"> <syntax> - <literal>off</literal> | - <literal>expired</literal> | - <literal>no-cache</literal> | - <literal>no-store</literal> | - <literal>private</literal> | - <literal>no_last_modified</literal> | - <literal>no_etag</literal> | - <literal>auth</literal> | - <literal>any</literal> - ...</syntax> + <literal>off</literal> | + <literal>expired</literal> | + <literal>no-cache</literal> | + <literal>no-store</literal> | + <literal>private</literal> | + <literal>no_last_modified</literal> | + <literal>no_etag</literal> | + <literal>auth</literal> | + <literal>any</literal> + ...</syntax> <default>off</default> <context>http</context> <context>server</context>
--- a/xml/ru/docs/http/ngx_http_headers_module.xml +++ b/xml/ru/docs/http/ngx_http_headers_module.xml @@ -16,6 +16,7 @@ </section> + <section id="example" name="Пример конфигурации"> <para> @@ -108,7 +109,7 @@ expires @15h30m; <para> Параметр <literal>max</literal> задаёт время -“<literal>Thu, 31 Dec 2037 23:55:55 GMT</literal>” +“<literal>Thu, 31 Dec 2037 23:55:55 GMT</literal>” (31 декабря 2037 23:55:55 GMT) для поля <header>Expires</header> и 10 лет для поля <header>Cache-Control</header>. </para>
--- a/xml/ru/docs/http/ngx_http_image_filter_module.xml +++ b/xml/ru/docs/http/ngx_http_image_filter_module.xml @@ -28,7 +28,7 @@ </section> -<section name="Пример конфигурации" id="example"> +<section id="example" name="Пример конфигурации"> <para> <example> @@ -48,22 +48,24 @@ location = /empty { </section> -<section name="Директивы" id="directives"> +<section id="directives" name="Директивы"> <directive name="image_filter"> - <syntax><literal>off</literal></syntax> - <syntax><literal>test</literal></syntax> - <syntax><literal>size</literal></syntax> - <syntax><literal>rotate</literal> - <literal>90</literal> | <literal>180</literal> | <literal>270</literal></syntax> - <syntax> - <literal>resize</literal> - <value>ширина</value> - <value>высота</value></syntax> - <syntax> - <literal>crop</literal> - <value>ширина</value> - <value>высота</value></syntax> +<syntax><literal>off</literal></syntax> +<syntax><literal>test</literal></syntax> +<syntax><literal>size</literal></syntax> +<syntax> + <literal>rotate</literal> + <literal>90</literal> | <literal>180</literal> | + <literal>270</literal></syntax> +<syntax> + <literal>resize</literal> + <value>ширина</value> + <value>высота</value></syntax> +<syntax> + <literal>crop</literal> + <value>ширина</value> + <value>высота</value></syntax> <default/> <context>location</context> @@ -169,7 +171,8 @@ location = /empty { <context>location</context> <para> -Задаёт желаемое <value>качество</value> преобразованного изображения в формате JPEG. +Задаёт желаемое <value>качество</value> преобразованного изображения +в формате JPEG. Допустимые значения находятся в диапазоне 1..100. Меньшим значениям обычно соответствует худшее качество изображения и меньший объём передаваемых данных.
--- a/xml/ru/docs/http/ngx_http_limit_req_module.xml +++ b/xml/ru/docs/http/ngx_http_limit_req_module.xml @@ -17,7 +17,8 @@ </section> -<section name="Пример конфигурации" id="example"> + +<section id="example" name="Пример конфигурации"> <para> <example> @@ -39,7 +40,7 @@ http { </section> -<section name="Директивы" id="directives"> +<section id="directives" name="Директивы"> <directive name="limit_req"> <syntax>
--- a/xml/ru/docs/http/ngx_http_log_module.xml +++ b/xml/ru/docs/http/ngx_http_log_module.xml @@ -35,9 +35,9 @@ access_log /spool/logs/nginx-access.log <directive name="access_log"> <syntax> - <value>путь</value> - [<value>формат</value> - [<literal>buffer</literal>=<value>размер</value>]]</syntax> + <value>путь</value> + [<value>формат</value> + [<literal>buffer</literal>=<value>размер</value>]]</syntax> <syntax><literal>off</literal></syntax> <default>log/access.log combined</default> <context>http</context> @@ -195,6 +195,7 @@ log_format combined '$remote_addr - $rem </directive> + <directive name="open_log_file_cache"> <syntax>
--- a/xml/ru/docs/http/ngx_http_memcached_module.xml +++ b/xml/ru/docs/http/ngx_http_memcached_module.xml @@ -75,12 +75,12 @@ server { <directive name="memcached_next_upstream"> <syntax> - <literal>error</literal> | - <literal>timeout</literal> | - <literal>invalid_response</literal> | - <literal>not_found</literal> | - <literal>off</literal> - ...</syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_response</literal> | + <literal>not_found</literal> | + <literal>off</literal> + ...</syntax> <default>error timeout</default> <context>http</context> <context>server</context>
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml +++ b/xml/ru/docs/http/ngx_http_proxy_module.xml @@ -209,11 +209,11 @@ proxy_cache_key $scheme$proxy_host$uri$i <directive name="proxy_cache_path"> <syntax> - <value>путь</value> - [<literal>levels</literal>=<value>уровни</value>] - <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value> - [<literal>inactive</literal>=<value>время</value>] - [<literal>max_size</literal>=<value>размер</value>]</syntax> + <value>путь</value> + [<literal>levels</literal>=<value>уровни</value>] + <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value> + [<literal>inactive</literal>=<value>время</value>] + [<literal>max_size</literal>=<value>размер</value>]</syntax> <default/> <context>http</context> @@ -235,7 +235,8 @@ proxy_cache_path /data/nginx/cache level <para> Кэшируемый ответ сначала записывается во временный файл, а потом этот файл -переименовывается. Начиная с версии 0.8.9, временные файлы и кэш +переименовывается. +Начиная с версии 0.8.9, временные файлы и кэш могут располагаться на разных файловых системах, но нужно учитывать, что в этом случае вместо дешёвой операции переименовывания в пределах одной файловой системы файл копируется с одной файловой системы на другую. @@ -264,17 +265,17 @@ proxy_cache_path /data/nginx/cache level <directive name="proxy_cache_use_stale"> <syntax> - <literal>error</literal> | - <literal>timeout</literal> | - <literal>invalid_header</literal> | - <literal>updating</literal> | - <literal>http_500</literal> | - <literal>http_502</literal> | - <literal>http_503</literal> | - <literal>http_504</literal> | - <literal>http_404</literal> | - <literal>off</literal> - ...</syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>updating</literal> | + <literal>http_500</literal> | + <literal>http_502</literal> | + <literal>http_503</literal> | + <literal>http_504</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>off</default> <context>http</context> <context>server</context> @@ -283,7 +284,8 @@ proxy_cache_path /data/nginx/cache level <para> Определяет, в каких случаях можно использовать устаревший закэшированный ответ, если при работе с проксированным -сервером возникла ошибка. Параметры директивы совпадают с параметрами +сервером возникла ошибка. +Параметры директивы совпадают с параметрами директивы <link id="proxy_next_upstream"/>. Кроме того, дополнительный параметр <literal>updating</literal> разрешает использовать устаревший закэшированный ответ, @@ -439,16 +441,16 @@ nginx не передаёт клиенту поля заголовка <header>Date</header>, <directive name="proxy_next_upstream"> <syntax> - <literal>error</literal> | - <literal>timeout</literal> | - <literal>invalid_header</literal> | - <literal>http_500</literal> | - <literal>http_502</literal> | - <literal>http_503</literal> | - <literal>http_504</literal> | - <literal>http_404</literal> | - <literal>off</literal> - ...</syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>http_500</literal> | + <literal>http_502</literal> | + <literal>http_503</literal> | + <literal>http_504</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>error timeout</default> <context>http</context> <context>server</context> @@ -825,8 +827,9 @@ proxy_set_header Host $http_host; <para> Однако, если это поле отсутствует в заголовке запроса клиента, то ничего -передаваться не будет. В этом случае лучше воспользоваться переменной -<var>$host</var>—её значение равно имени сервера в поле <header>Host</header> +передаваться не будет. +В этом случае лучше воспользоваться переменной <var>$host</var>—её +значение равно имени сервера в поле <header>Host</header> заголовка запроса, или же основному имени сервера, если поля нет: <example> proxy_set_header Host $host; @@ -860,7 +863,8 @@ proxy_set_header Accept-Encoding ""; <para> Определяет, использовать ли повторно SSL-сессии при -работе с проксированным сервером. Если в логах появляются ошибки +работе с проксированным сервером. +Если в логах появляются ошибки “<literal>SSL3_GET_FINISHED:digest check failed</literal>”, то можно попробовать выключить повторное использование сессий.
--- a/xml/ru/docs/http/ngx_http_realip_module.xml +++ b/xml/ru/docs/http/ngx_http_realip_module.xml @@ -54,9 +54,9 @@ real_ip_header X-Real-IP; <directive name="real_ip_header"> <syntax> - <value>поле</value> | - <literal>X-Real-IP</literal> | - <literal>X-Forwarded-For</literal></syntax> + <value>поле</value> | + <literal>X-Real-IP</literal> | + <literal>X-Forwarded-For</literal></syntax> <default>X-Real-IP</default> <context>http</context> <context>server</context>
--- a/xml/ru/docs/http/ngx_http_referer_module.xml +++ b/xml/ru/docs/http/ngx_http_referer_module.xml @@ -45,11 +45,11 @@ if ($invalid_referer) { <directive name="valid_referers"> <syntax> - <literal>none</literal> | - <literal>blocked</literal> | - <literal>server_names</literal> | - <value>строка</value> - ...</syntax> + <literal>none</literal> | + <literal>blocked</literal> | + <literal>server_names</literal> | + <value>строка</value> + ...</syntax> <default/> <context>server</context> <context>location</context>