nginx-site: xml/ru/docs/http/ngx_http_core

comparison xml/ru/docs/http/ngx_http_core_module.xml @ 102:c76a257f3fd4

The directive name is now automatically printed in <default> and <syntax>. Specifying <default> is made non-optional. Visible changes: - "types" and "proxy_set_header" get proper defaults (not yet displayed nicely); - "fastcgi_hide_header", "fastcgi_ignore_headers", "fastcgi_pass_header", "proxy_hide_header", "proxy_ignore_headers", and "proxy_pass_header" now have their (empty) defaults documented; - mentions of "fastcgi_redirect_errors" and "proxy_redirect_errors" which are long unsupported were removed.

author	Ruslan Ermilov <ru@nginx.com>
date	Wed, 19 Oct 2011 05:15:24 +0000
parents	1d315ef37215
children	56457a474903

comparison

equal deleted inserted replaced

-:b8fd014ec712
+:c76a257f3fd4
 lang="ru">
 <section name="Директивы" id="directives">
 <directive name="aio">
-<syntax>aio <value>[on|off|sendfile]</value></syntax>
+<syntax><value>[on|off|sendfile]</value></syntax>
-<default>aio off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива (0.8.11) разрешает или запрещает использовать файловый AIO
 во FreeBSD и Linux.
 </directive>
 <directive name="alias">
-<syntax>alias <value>путь</value></syntax>
+<syntax><value>путь</value></syntax>
 <default/>
 <context>location</context>
 <para>
 Директива задаёт замену для указанного location'а.
 </directive>
 <directive name="client_body_in_file_only">
-<syntax>client_body_in_file_only <value>on|clean|off</value></syntax>
+<syntax><value>on|clean|off</value></syntax>
-<default>client_body_in_file_only off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива определяет, сохранять ли всё тело запроса клиента в файл.
 Директиву можно использовать для отладки и при использовании
 </directive>
 <directive name="client_body_in_single_buffer">
-<syntax>client_body_in_single_buffer <value>on|off</value></syntax>
+<syntax><value>on|off</value></syntax>
-<default>client_body_in_single_buffer off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива определяет, хранить ли всё тело запроса клиента в одном буфере.
 Директива рекомендуется при использовании переменной $request_body
 </directive>
 <directive name="client_body_buffer_size">
-<syntax>client_body_buffer_size <value>размер</value></syntax>
+<syntax><value>размер</value></syntax>
-<default>client_body_buffer_size 8k/16k</default>
+<default>8k/16k</default>
 <context>http, server, location</context>
 <para>
 Директива задаёт размер буфера для чтения тела запроса клиента.
 Если тело запроса больше заданного буфера, то всё тело запроса или только
 </directive>
 <directive name="client_body_temp_path">
-<syntax>client_body_temp_path <value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ]
+<syntax><value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ]
 </value></syntax>
-<default>client_body_temp_path client_body_temp</default>
+<default>client_body_temp</default>
 <context>http, server, location</context>
 <para>
 Директива задаёт имя каталога для хранения временных файлов с телом запроса
 клиента.
 </directive>
 <directive name="client_body_timeout">
-<syntax>client_body_timeout <value>время</value></syntax>
+<syntax><value>время</value></syntax>
-<default>client_body_timeout 60</default>
+<default>60</default>
 <context>http, server, location</context>
 <para>
 Директива задаёт таймаут при чтении тела запроса клиента.
 Таймаут устанавливается не на всю передачу тела запроса,
 </directive>
 <directive name="client_header_buffer_size">
-<syntax>client_header_buffer_size <value>размер</value></syntax>
+<syntax><value>размер</value></syntax>
-<default>client_header_buffer_size 1k</default>
+<default>1k</default>
 <context>http, server</context>
 <para>
 Директива задаёт размер буфера для чтения заголовка запроса клиента.
 Для подавляющего большинства запросов вполне достаточно буфера размером в 1K.
 </directive>
 <directive name="client_header_timeout">
-<syntax>client_header_timeout <value>время</value></syntax>
+<syntax><value>время</value></syntax>
-<default>client_header_timeout 60</default>
+<default>60</default>
 <context>http, server</context>
 <para>
 Директива задаёт таймаут при чтении заголовка запроса клиента.
 Если по истечении этого времени клиент не передаст полностью заголовок
 </directive>
 <directive name="client_max_body_size">
-<syntax>client_max_body_size <value>размер</value></syntax>
+<syntax><value>размер</value></syntax>
-<default>client_max_body_size 1m</default>
+<default>1m</default>
 <context>http, server, location</context>
 <para>
 Директива задаёт максимально допустимый размер тела запроса клиента,
 указываемый в строке "Content-Length" в заголовке запроса.
 </directive>
 <directive name="default_type">
-<syntax>default_type <value>MIME-тип</value></syntax>
+<syntax><value>MIME-тип</value></syntax>
-<default>default_type text/plain</default>
+<default>text/plain</default>
 <context>http, server, location</context>
 <para>
 Директива задаёт MIME-тип ответов по умолчанию.
 </para>
 </directive>
 <directive name="directio">
-<syntax>directio <value>[размер|off]</value></syntax>
+<syntax><value>[размер|off]</value></syntax>
-<default>directio off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива (0.7.7) разрешает использовать флаги
 O_DIRECT (FreeBSD, Linux), F_NOCACHE (Mac OS X) или функцию directio() (Solaris)
 </directive>
 <directive name="directio_alignment">
-<syntax>directio_alignment <value>размер</value></syntax>
+<syntax><value>размер</value></syntax>
-<default>directio_alignment 512</default>
+<default>512</default>
 <context>http, server, location</context>
 <para>
 Директива (0.8.11) устанавливает выравнивание для
 <link id="directio">directio</link>.
 </directive>
 <directive name="error_page">
-<syntax>error_page <value>код [код ...] [=|=ответ] uri</value>
+<syntax><value>код [код ...] [=|=ответ] uri</value>
 </syntax>
 <default/>
 <context>http, server, location, if в location</context>
 <para>
 </directive>
 <directive name="if_modified_since">
-<syntax>if_modified_since <value>[off|exact|before]</value></syntax>
+<syntax><value>[off|exact|before]</value></syntax>
-<default>if_modified_since exact</default>
+<default>exact</default>
 <context>http, server, location</context>
 <para>
 Директива (0.7.24) определяет, как сравнивать время модификации ответа и
 время в заголовке запроса "If-Modified-Since":
 </directive>
 <directive name="internal">
-<syntax>internal</syntax>
+<syntax/>
 <default/>
 <context>location</context>
 <para>
 Директива указывает, что данный location может использоваться только
 </directive>
 <directive name="keepalive_requests">
-<syntax>keepalive_requests <value>число</value></syntax>
+<syntax><value>число</value></syntax>
-<default>keepalive_requests 100</default>
+<default>100</default>
 <context>http, server, location</context>
 <para>
 Директива (0.8.0) задаёт максимальное число запросов, которые можно
 сделать по одному keep-alive соединению.
 </directive>
 <directive name="keepalive_timeout">
-<syntax>keepalive_timeout <value>время [время]</value></syntax>
+<syntax><value>время [время]</value></syntax>
-<default>keepalive_timeout 75</default>
+<default>75</default>
 <context>http, server, location</context>
 <para>
 Директива задаёт таймаут, в течение которого keep-alive соединение
 с клиентом не будет закрыто со стороны сервера.
 </directive>
 <directive name="large_client_header_buffers">
-<syntax>large_client_header_buffers <value>число размер</value>
+<syntax><value>число размер</value>
 </syntax>
-<default>large_client_header_buffers 4 4k/8k</default>
+<default>4 4k/8k</default>
 <context>http, server</context>
 <para>
 Директива задаёт максимальное число и размер буферов для чтения
 большого заголовка запроса клиента.
 </directive>
 <directive name="limit_except">
-<syntax>limit_except <value>методы</value> { ... }</syntax>
+<syntax><value>методы</value> { ... }</syntax>
 <default/>
 <context>location</context>
 <para>
 Директива ограничивает HTTP-методы, доступные внутри location.
 </directive>
 <directive name="limit_rate">
-<syntax>limit_rate <value>скорость</value></syntax>
+<syntax><value>скорость</value></syntax>
 <default/>
 <context>http, server, location, if в location</context>
 <para>
 Директива задаёт скорость передачи ответа клиенту.
 </directive>
 <directive name="limit_rate_after">
-<syntax>limit_rate_after <value>размер</value></syntax>
+<syntax><value>размер</value></syntax>
 <default/>
 <context>http, server, location, if в location</context>
 <para>
 Директива (0.8.0) задаёт объём данных, после передачи которого
 </directive>
 <directive name="listen">
-<syntax>listen <value>адрес:порт
+<syntax><value>адрес:порт
 [default|default_server|
 [backlog=число |
 rcvbuf=размер |
 sndbuf=размер |
 accept_filter=фильтр |
 deferred |
 bind |
 ipv6only=[on|off] |
 ssl]]
 </value></syntax>
-<default>listen *:80 | *:8000</default>
+<default>*:80 | *:8000</default>
 <context>server</context>
 <para>
 Директива задаёт адрес и порт, на которых сервер принимает запросы.
 Можно указать только адрес или только порт, кроме того, адрес может
 </directive>
 <directive name="location">
-<syntax>location [<value>=|~|~*|^~|@</value>] <value>/uri/</value>
+<syntax>[<value>=|~|~*|^~|@</value>] <value>/uri/</value>
 { ... }</syntax>
 <default/>
 <context>server</context>
 <para>
 </directive>
 <directive name="log_not_found">
-<syntax>log_not_found <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>log_not_found on</default>
+<default>on</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает записывать в error_log
 ошибки о том, что файл не найден.
 </directive>
 <directive name="log_subrequest">
-<syntax>log_subrequest <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>log_subrequest off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает записывать в
 <link doc="ngx_http_log_module.xml" id="access_log">access_log</link>
 </directive>
 <directive name="merge_slashes">
-<syntax>merge_slashes <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>merge_slashes on</default>
+<default>on</default>
 <context>http, server</context>
 <para>
 Директива разрешает или запрещает объединять в URI два и более слэшей в один.
 </para>
 </directive>
 <directive name="msie_padding">
-<syntax>msie_padding <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>msie_padding on</default>
+<default>on</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает добавлять в ответы для MSIE
 со статусом больше 400
 </directive>
 <directive name="msie_refresh">
-<syntax>msie_refresh <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>msie_refresh off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает выдавать для MSIE refresh'ы вместо
 редиректов.
 </directive>
 <directive name="open_file_cache">
-<syntax>open_file_cache <value>max=N [inactive=время]|off</value>
+<syntax><value>max=N [inactive=время]|off</value>
 </syntax>
-<default>open_file_cache off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива задаёт кэш, в котором могут хранится
 <list type="bullet">
 </directive>
 <directive name="open_file_cache_errors">
-<syntax>open_file_cache_errors <value>on|off</value></syntax>
+<syntax><value>on|off</value></syntax>
-<default>open_file_cache_errors off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива определяет, кэшировать или нет ошибки поиска файлов в
 <link id="open_file_cache"/>.
 </directive>
 <directive name="open_file_cache_min_uses">
-<syntax>open_file_cache_min_uses <value>число</value></syntax>
+<syntax><value>число</value></syntax>
-<default>open_file_cache_min_uses 1</default>
+<default>1</default>
 <context>http, server, location</context>
 <para>
 Директива определяет минимальное число использований файла в течение
 времени, заданного параметром inactive в директиве
 </directive>
 <directive name="open_file_cache_valid">
-<syntax>open_file_cache_valid <value>время</value></syntax>
+<syntax><value>время</value></syntax>
-<default>open_file_cache_valid 60</default>
+<default>60</default>
 <context>http, server, location</context>
 <para>
 Директива определяет, через какое время нужно проверять актуальность
 информации об элементе в <link id="open_file_cache"/>.
 </directive>
 <directive name="optimize_server_names">
-<syntax>optimize_server_names <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>optimize_server_names on</default>
+<default>on</default>
 <context>http, server</context>
 <para>
 Устаревшая директива.
 </para>
 </directive>
 <directive name="port_in_redirect">
-<syntax>port_in_redirect <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>port_in_redirect on</default>
+<default>on</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает указывать порт в редиректах,
 выдаваемых nginx'ом.
 </directive>
 <directive name="read_ahead">
-<syntax>read_ahead <value>размер</value></syntax>
+<syntax><value>размер</value></syntax>
-<default>read_ahead  0</default>
+<default>0</default>
 <context>http, server, location</context>
 <para>
 Директива задаёт ядру размер предчтения при работе с файлами.
 Под Линуксом используется системный вызов
 </directive>
 <directive name="recursive_error_pages">
-<syntax>recursive_error_pages <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>recursive_error_pages off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает делать несколько перенаправлений через
 директиву <link id="error_page"/>.
 </directive>
 <directive name="reset_timedout_connection">
-<syntax>reset_timedout_connection <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>reset_timedout_connection off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает сбрасывать соединение по таймауту.
 Сброс делается следующим образом — перед закрытием сокета для него
 </directive>
 <directive name="resolver">
-<syntax>resolver <value>адрес</value></syntax>
+<syntax><value>адрес</value></syntax>
 <default/>
 <context>http, server, location</context>
 <para>
 Директива задаёт адрес name-сервера, например:
 </directive>
 <directive name="resolver_timeout">
-<syntax>resolver_timeout <value>время</value></syntax>
+<syntax><value>время</value></syntax>
-<default>resolver_timeout 30s</default>
+<default>30s</default>
 <context>http, server, location</context>
 <para>
 Директива задаёт таймаут для определения имени, например:
 <example>
 </directive>
 <directive name="root">
-<syntax>root <value>путь</value></syntax>
+<syntax><value>путь</value></syntax>
-<default>root html</default>
+<default>html</default>
 <context>http, server, location, if в location</context>
 <para>
 Директива задаёт корневой каталог для запросов.
 Например, при такой конфигурации
 </directive>
 <directive name="satisfy">
-<syntax>satisfy <value>all|any</value></syntax>
+<syntax><value>all|any</value></syntax>
-<default>satisfy all</default>
+<default>all</default>
 <context>location</context>
 <para>
 Директива разрешает доступ при хотя бы одной успешной проверке,
 выполненной модулями <link doc="ngx_http_access_module.xml">ngx_http_access_module</link>
 </directive>
 <directive name="satisfy_any">
-<syntax>satisfy_any <value>on|off</value></syntax>
+<syntax><value>on|off</value></syntax>
-<default>satisfy_any off</default>
+<default>off</default>
 <context>location</context>
 <para>
 Директива переименована в директиву <link id="satisfy"/>.
 </para>
 </directive>
 <directive name="send_timeout">
-<syntax>send_timeout <value>время</value></syntax>
+<syntax><value>время</value></syntax>
-<default>send_timeout 60</default>
+<default>60</default>
 <context>http, server, location</context>
 <para>
 Директива задаёт таймаут при передаче ответа клиенту.
 Таймаут устанавливается не на всю передачу ответа,
 </directive>
 <directive name="sendfile">
-<syntax>sendfile <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>sendfile off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает использовать sendfile().
 </para>
 </directive>
 <directive name="server">
-<syntax>server { ... }</syntax>
+<syntax>{ ... }</syntax>
 <default/>
 <context>http</context>
 <para>
 Директива задаёт конфигурацию для виртуального сервера.
 </directive>
 <directive name="server_name">
-<syntax>server_name <value>имя [...]</value></syntax>
+<syntax><value>имя [...]</value></syntax>
-<default>server_name hostname</default>
+<default>hostname</default>
 <context>server</context>
 <para>
 Директива задаёт имена виртуального сервера, например:
 <example>
 </directive>
 <directive name="server_name_in_redirect">
-<syntax>server_name_in_redirect <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>server_name_in_redirect on</default>
+<default>on</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает использовать в редиректах, выдаваемых
 nginx'ом, основное имя сервера, задаваемое директивой
 </directive>
 <directive name="server_names_hash_max_size">
-<syntax>server_names_hash_max_size <value>число</value></syntax>
+<syntax><value>число</value></syntax>
-<default>server_names_hash_max_size 512</default>
+<default>512</default>
 <context>http</context>
 <para>
 Директива задаёт максимальный размер хэш-таблиц имён серверов.
 Подробнее смотри в <link doc="../hash.xml">описании
 </directive>
 <directive name="server_names_hash_bucket_size">
-<syntax>server_names_hash_bucket_size <value>число</value></syntax>
+<syntax><value>число</value></syntax>
-<default>server_names_hash_bucket_size 32/64/128</default>
+<default>32/64/128</default>
 <context>http</context>
 <para>
 Директива задаёт размер корзины в хэш-таблицах имён серверов.
 Значение по умолчанию зависит от размера строки кэша процессора.
 </directive>
 <directive name="server_tokens">
-<syntax>server_tokens <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>server_tokens on</default>
+<default>on</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает выдавать версию nginx'а
 в сообщениях об ошибках и в строке заголовка ответа "Server".
 </directive>
 <directive name="tcp_nodelay">
-<syntax>tcp_nodelay <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>tcp_nodelay on</default>
+<default>on</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает использовать опцию TCP_NODELAY.
 Опция включаются только при переходе соединения в состояние keep-alive.
 </directive>
 <directive name="tcp_nopush">
-<syntax>tcp_nopush <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>tcp_nopush off</default>
+<default>off</default>
 <context>http, server, location</context>
 <para>
 Директива разрешает или запрещает использовать опции
 TCP_NOPUSH во FreeBSD или TCP_CORK в Linux.
 </directive>
 <directive name="try_files">
-<syntax>try_files <value>файл [файл ...] (uri|=код)</value></syntax>
+<syntax><value>файл [файл ...] (uri|=код)</value></syntax>
 <default/>
 <context>location</context>
 <para>
 Директива проверяет существование файлов в заданном порядке
 </directive>
 <directive name="types">
-<syntax>types <value>{ ... }</value></syntax>
+<syntax><value>{ ... }</value></syntax>
-<default>see below</default>
+<default>
+{
+text/html  html;
+image/gif  gif;
+image/jpeg jpg;
+}
+</default>
 <context>http, server, location</context>
 <para>
 Директива задаёт соответствие расширения и MIME-типов ответов.
 Одному MIME-типу может соответствовать несколько расширений.
-По умолчанию используется такие соответствия:
-<example>
-types {
-text/html    html;
-image/gif    gif;
-image/jpeg   jpg;
-}
-</example>
 </para>
 <para>
 Достаточно полная таблица соответствий входит в дистрибутив
 и находится в файле conf/mime.types.
 </directive>
 <directive name="underscores_in_headers">
-<syntax>underscores_in_headers <value>[on|off]</value></syntax>
+<syntax><value>[on|off]</value></syntax>
-<default>underscores_in_headers off</default>
+<default>off</default>
 <context>http, server</context>
 <para>
 Директива разрешает или запрещает использование символов подчёркивания
 в строках заголовка запроса клиента.

Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_core_module.xml @ 102:c76a257f3fd4