Mercurial > hg > nginx-site
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
101:b8fd014ec712 | 102:c76a257f3fd4 |
---|---|
7 lang="ru"> | 7 lang="ru"> |
8 | 8 |
9 <section name="Директивы" id="directives"> | 9 <section name="Директивы" id="directives"> |
10 | 10 |
11 <directive name="aio"> | 11 <directive name="aio"> |
12 <syntax>aio <value>[on|off|sendfile]</value></syntax> | 12 <syntax><value>[on|off|sendfile]</value></syntax> |
13 <default>aio off</default> | 13 <default>off</default> |
14 <context>http, server, location</context> | 14 <context>http, server, location</context> |
15 | 15 |
16 <para> | 16 <para> |
17 Директива (0.8.11) разрешает или запрещает использовать файловый AIO | 17 Директива (0.8.11) разрешает или запрещает использовать файловый AIO |
18 во FreeBSD и Linux. | 18 во FreeBSD и Linux. |
106 | 106 |
107 </directive> | 107 </directive> |
108 | 108 |
109 | 109 |
110 <directive name="alias"> | 110 <directive name="alias"> |
111 <syntax>alias <value>путь</value></syntax> | 111 <syntax><value>путь</value></syntax> |
112 <default/> | 112 <default/> |
113 <context>location</context> | 113 <context>location</context> |
114 | 114 |
115 <para> | 115 <para> |
116 Директива задаёт замену для указанного location'а. | 116 Директива задаёт замену для указанного location'а. |
155 | 155 |
156 </directive> | 156 </directive> |
157 | 157 |
158 | 158 |
159 <directive name="client_body_in_file_only"> | 159 <directive name="client_body_in_file_only"> |
160 <syntax>client_body_in_file_only <value>on|clean|off</value></syntax> | 160 <syntax><value>on|clean|off</value></syntax> |
161 <default>client_body_in_file_only off</default> | 161 <default>off</default> |
162 <context>http, server, location</context> | 162 <context>http, server, location</context> |
163 | 163 |
164 <para> | 164 <para> |
165 Директива определяет, сохранять ли всё тело запроса клиента в файл. | 165 Директива определяет, сохранять ли всё тело запроса клиента в файл. |
166 Директиву можно использовать для отладки и при использовании | 166 Директиву можно использовать для отладки и при использовании |
181 | 181 |
182 </directive> | 182 </directive> |
183 | 183 |
184 | 184 |
185 <directive name="client_body_in_single_buffer"> | 185 <directive name="client_body_in_single_buffer"> |
186 <syntax>client_body_in_single_buffer <value>on|off</value></syntax> | 186 <syntax><value>on|off</value></syntax> |
187 <default>client_body_in_single_buffer off</default> | 187 <default>off</default> |
188 <context>http, server, location</context> | 188 <context>http, server, location</context> |
189 | 189 |
190 <para> | 190 <para> |
191 Директива определяет, хранить ли всё тело запроса клиента в одном буфере. | 191 Директива определяет, хранить ли всё тело запроса клиента в одном буфере. |
192 Директива рекомендуется при использовании переменной $request_body | 192 Директива рекомендуется при использовании переменной $request_body |
195 | 195 |
196 </directive> | 196 </directive> |
197 | 197 |
198 | 198 |
199 <directive name="client_body_buffer_size"> | 199 <directive name="client_body_buffer_size"> |
200 <syntax>client_body_buffer_size <value>размер</value></syntax> | 200 <syntax><value>размер</value></syntax> |
201 <default>client_body_buffer_size 8k/16k</default> | 201 <default>8k/16k</default> |
202 <context>http, server, location</context> | 202 <context>http, server, location</context> |
203 | 203 |
204 <para> | 204 <para> |
205 Директива задаёт размер буфера для чтения тела запроса клиента. | 205 Директива задаёт размер буфера для чтения тела запроса клиента. |
206 Если тело запроса больше заданного буфера, то всё тело запроса или только | 206 Если тело запроса больше заданного буфера, то всё тело запроса или только |
211 | 211 |
212 </directive> | 212 </directive> |
213 | 213 |
214 | 214 |
215 <directive name="client_body_temp_path"> | 215 <directive name="client_body_temp_path"> |
216 <syntax>client_body_temp_path <value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ] | 216 <syntax><value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ] |
217 </value></syntax> | 217 </value></syntax> |
218 <default>client_body_temp_path client_body_temp</default> | 218 <default>client_body_temp</default> |
219 <context>http, server, location</context> | 219 <context>http, server, location</context> |
220 | 220 |
221 <para> | 221 <para> |
222 Директива задаёт имя каталога для хранения временных файлов с телом запроса | 222 Директива задаёт имя каталога для хранения временных файлов с телом запроса |
223 клиента. | 223 клиента. |
234 | 234 |
235 </directive> | 235 </directive> |
236 | 236 |
237 | 237 |
238 <directive name="client_body_timeout"> | 238 <directive name="client_body_timeout"> |
239 <syntax>client_body_timeout <value>время</value></syntax> | 239 <syntax><value>время</value></syntax> |
240 <default>client_body_timeout 60</default> | 240 <default>60</default> |
241 <context>http, server, location</context> | 241 <context>http, server, location</context> |
242 | 242 |
243 <para> | 243 <para> |
244 Директива задаёт таймаут при чтении тела запроса клиента. | 244 Директива задаёт таймаут при чтении тела запроса клиента. |
245 Таймаут устанавливается не на всю передачу тела запроса, | 245 Таймаут устанавливается не на всю передачу тела запроса, |
250 | 250 |
251 </directive> | 251 </directive> |
252 | 252 |
253 | 253 |
254 <directive name="client_header_buffer_size"> | 254 <directive name="client_header_buffer_size"> |
255 <syntax>client_header_buffer_size <value>размер</value></syntax> | 255 <syntax><value>размер</value></syntax> |
256 <default>client_header_buffer_size 1k</default> | 256 <default>1k</default> |
257 <context>http, server</context> | 257 <context>http, server</context> |
258 | 258 |
259 <para> | 259 <para> |
260 Директива задаёт размер буфера для чтения заголовка запроса клиента. | 260 Директива задаёт размер буфера для чтения заголовка запроса клиента. |
261 Для подавляющего большинства запросов вполне достаточно буфера размером в 1K. | 261 Для подавляющего большинства запросов вполне достаточно буфера размером в 1K. |
268 | 268 |
269 </directive> | 269 </directive> |
270 | 270 |
271 | 271 |
272 <directive name="client_header_timeout"> | 272 <directive name="client_header_timeout"> |
273 <syntax>client_header_timeout <value>время</value></syntax> | 273 <syntax><value>время</value></syntax> |
274 <default>client_header_timeout 60</default> | 274 <default>60</default> |
275 <context>http, server</context> | 275 <context>http, server</context> |
276 | 276 |
277 <para> | 277 <para> |
278 Директива задаёт таймаут при чтении заголовка запроса клиента. | 278 Директива задаёт таймаут при чтении заголовка запроса клиента. |
279 Если по истечении этого времени клиент не передаст полностью заголовок | 279 Если по истечении этого времени клиент не передаст полностью заголовок |
282 | 282 |
283 </directive> | 283 </directive> |
284 | 284 |
285 | 285 |
286 <directive name="client_max_body_size"> | 286 <directive name="client_max_body_size"> |
287 <syntax>client_max_body_size <value>размер</value></syntax> | 287 <syntax><value>размер</value></syntax> |
288 <default>client_max_body_size 1m</default> | 288 <default>1m</default> |
289 <context>http, server, location</context> | 289 <context>http, server, location</context> |
290 | 290 |
291 <para> | 291 <para> |
292 Директива задаёт максимально допустимый размер тела запроса клиента, | 292 Директива задаёт максимально допустимый размер тела запроса клиента, |
293 указываемый в строке "Content-Length" в заголовке запроса. | 293 указываемый в строке "Content-Length" в заголовке запроса. |
299 | 299 |
300 </directive> | 300 </directive> |
301 | 301 |
302 | 302 |
303 <directive name="default_type"> | 303 <directive name="default_type"> |
304 <syntax>default_type <value>MIME-тип</value></syntax> | 304 <syntax><value>MIME-тип</value></syntax> |
305 <default>default_type text/plain</default> | 305 <default>text/plain</default> |
306 <context>http, server, location</context> | 306 <context>http, server, location</context> |
307 | 307 |
308 <para> | 308 <para> |
309 Директива задаёт MIME-тип ответов по умолчанию. | 309 Директива задаёт MIME-тип ответов по умолчанию. |
310 </para> | 310 </para> |
311 | 311 |
312 </directive> | 312 </directive> |
313 | 313 |
314 | 314 |
315 <directive name="directio"> | 315 <directive name="directio"> |
316 <syntax>directio <value>[размер|off]</value></syntax> | 316 <syntax><value>[размер|off]</value></syntax> |
317 <default>directio off</default> | 317 <default>off</default> |
318 <context>http, server, location</context> | 318 <context>http, server, location</context> |
319 | 319 |
320 <para> | 320 <para> |
321 Директива (0.7.7) разрешает использовать флаги | 321 Директива (0.7.7) разрешает использовать флаги |
322 O_DIRECT (FreeBSD, Linux), F_NOCACHE (Mac OS X) или функцию directio() (Solaris) | 322 O_DIRECT (FreeBSD, Linux), F_NOCACHE (Mac OS X) или функцию directio() (Solaris) |
332 | 332 |
333 </directive> | 333 </directive> |
334 | 334 |
335 | 335 |
336 <directive name="directio_alignment"> | 336 <directive name="directio_alignment"> |
337 <syntax>directio_alignment <value>размер</value></syntax> | 337 <syntax><value>размер</value></syntax> |
338 <default>directio_alignment 512</default> | 338 <default>512</default> |
339 <context>http, server, location</context> | 339 <context>http, server, location</context> |
340 | 340 |
341 <para> | 341 <para> |
342 Директива (0.8.11) устанавливает выравнивание для | 342 Директива (0.8.11) устанавливает выравнивание для |
343 <link id="directio">directio</link>. | 343 <link id="directio">directio</link>. |
347 | 347 |
348 </directive> | 348 </directive> |
349 | 349 |
350 | 350 |
351 <directive name="error_page"> | 351 <directive name="error_page"> |
352 <syntax>error_page <value>код [код ...] [=|=ответ] uri</value> | 352 <syntax><value>код [код ...] [=|=ответ] uri</value> |
353 </syntax> | 353 </syntax> |
354 <default/> | 354 <default/> |
355 <context>http, server, location, if в location</context> | 355 <context>http, server, location, if в location</context> |
356 | 356 |
357 <para> | 357 <para> |
402 | 402 |
403 </directive> | 403 </directive> |
404 | 404 |
405 | 405 |
406 <directive name="if_modified_since"> | 406 <directive name="if_modified_since"> |
407 <syntax>if_modified_since <value>[off|exact|before]</value></syntax> | 407 <syntax><value>[off|exact|before]</value></syntax> |
408 <default>if_modified_since exact</default> | 408 <default>exact</default> |
409 <context>http, server, location</context> | 409 <context>http, server, location</context> |
410 | 410 |
411 <para> | 411 <para> |
412 Директива (0.7.24) определяет, как сравнивать время модификации ответа и | 412 Директива (0.7.24) определяет, как сравнивать время модификации ответа и |
413 время в заголовке запроса "If-Modified-Since": | 413 время в заголовке запроса "If-Modified-Since": |
432 | 432 |
433 </directive> | 433 </directive> |
434 | 434 |
435 | 435 |
436 <directive name="internal"> | 436 <directive name="internal"> |
437 <syntax>internal</syntax> | 437 <syntax/> |
438 <default/> | 438 <default/> |
439 <context>location</context> | 439 <context>location</context> |
440 | 440 |
441 <para> | 441 <para> |
442 Директива указывает, что данный location может использоваться только | 442 Директива указывает, что данный location может использоваться только |
473 | 473 |
474 </directive> | 474 </directive> |
475 | 475 |
476 | 476 |
477 <directive name="keepalive_requests"> | 477 <directive name="keepalive_requests"> |
478 <syntax>keepalive_requests <value>число</value></syntax> | 478 <syntax><value>число</value></syntax> |
479 <default>keepalive_requests 100</default> | 479 <default>100</default> |
480 <context>http, server, location</context> | 480 <context>http, server, location</context> |
481 | 481 |
482 <para> | 482 <para> |
483 Директива (0.8.0) задаёт максимальное число запросов, которые можно | 483 Директива (0.8.0) задаёт максимальное число запросов, которые можно |
484 сделать по одному keep-alive соединению. | 484 сделать по одному keep-alive соединению. |
486 | 486 |
487 </directive> | 487 </directive> |
488 | 488 |
489 | 489 |
490 <directive name="keepalive_timeout"> | 490 <directive name="keepalive_timeout"> |
491 <syntax>keepalive_timeout <value>время [время]</value></syntax> | 491 <syntax><value>время [время]</value></syntax> |
492 <default>keepalive_timeout 75</default> | 492 <default>75</default> |
493 <context>http, server, location</context> | 493 <context>http, server, location</context> |
494 | 494 |
495 <para> | 495 <para> |
496 Директива задаёт таймаут, в течение которого keep-alive соединение | 496 Директива задаёт таймаут, в течение которого keep-alive соединение |
497 с клиентом не будет закрыто со стороны сервера. | 497 с клиентом не будет закрыто со стороны сервера. |
503 | 503 |
504 </directive> | 504 </directive> |
505 | 505 |
506 | 506 |
507 <directive name="large_client_header_buffers"> | 507 <directive name="large_client_header_buffers"> |
508 <syntax>large_client_header_buffers <value>число размер</value> | 508 <syntax><value>число размер</value> |
509 </syntax> | 509 </syntax> |
510 <default>large_client_header_buffers 4 4k/8k</default> | 510 <default>4 4k/8k</default> |
511 <context>http, server</context> | 511 <context>http, server</context> |
512 | 512 |
513 <para> | 513 <para> |
514 Директива задаёт максимальное число и размер буферов для чтения | 514 Директива задаёт максимальное число и размер буферов для чтения |
515 большого заголовка запроса клиента. | 515 большого заголовка запроса клиента. |
526 | 526 |
527 </directive> | 527 </directive> |
528 | 528 |
529 | 529 |
530 <directive name="limit_except"> | 530 <directive name="limit_except"> |
531 <syntax>limit_except <value>методы</value> { ... }</syntax> | 531 <syntax><value>методы</value> { ... }</syntax> |
532 <default/> | 532 <default/> |
533 <context>location</context> | 533 <context>location</context> |
534 | 534 |
535 <para> | 535 <para> |
536 Директива ограничивает HTTP-методы, доступные внутри location. | 536 Директива ограничивает HTTP-методы, доступные внутри location. |
551 </directive> | 551 </directive> |
552 | 552 |
553 | 553 |
554 <directive name="limit_rate"> | 554 <directive name="limit_rate"> |
555 | 555 |
556 <syntax>limit_rate <value>скорость</value></syntax> | 556 <syntax><value>скорость</value></syntax> |
557 <default/> | 557 <default/> |
558 <context>http, server, location, if в location</context> | 558 <context>http, server, location, if в location</context> |
559 | 559 |
560 <para> | 560 <para> |
561 Директива задаёт скорость передачи ответа клиенту. | 561 Директива задаёт скорость передачи ответа клиенту. |
584 | 584 |
585 </directive> | 585 </directive> |
586 | 586 |
587 | 587 |
588 <directive name="limit_rate_after"> | 588 <directive name="limit_rate_after"> |
589 <syntax>limit_rate_after <value>размер</value></syntax> | 589 <syntax><value>размер</value></syntax> |
590 <default/> | 590 <default/> |
591 <context>http, server, location, if в location</context> | 591 <context>http, server, location, if в location</context> |
592 | 592 |
593 <para> | 593 <para> |
594 Директива (0.8.0) задаёт объём данных, после передачи которого | 594 Директива (0.8.0) задаёт объём данных, после передачи которого |
604 | 604 |
605 </directive> | 605 </directive> |
606 | 606 |
607 | 607 |
608 <directive name="listen"> | 608 <directive name="listen"> |
609 <syntax>listen <value>адрес:порт | 609 <syntax><value>адрес:порт |
610 [default|default_server| | 610 [default|default_server| |
611 [backlog=число | | 611 [backlog=число | |
612 rcvbuf=размер | | 612 rcvbuf=размер | |
613 sndbuf=размер | | 613 sndbuf=размер | |
614 accept_filter=фильтр | | 614 accept_filter=фильтр | |
615 deferred | | 615 deferred | |
616 bind | | 616 bind | |
617 ipv6only=[on|off] | | 617 ipv6only=[on|off] | |
618 ssl]] | 618 ssl]] |
619 </value></syntax> | 619 </value></syntax> |
620 <default>listen *:80 | *:8000</default> | 620 <default>*:80 | *:8000</default> |
621 <context>server</context> | 621 <context>server</context> |
622 | 622 |
623 <para> | 623 <para> |
624 Директива задаёт адрес и порт, на которых сервер принимает запросы. | 624 Директива задаёт адрес и порт, на которых сервер принимает запросы. |
625 Можно указать только адрес или только порт, кроме того, адрес может | 625 Можно указать только адрес или только порт, кроме того, адрес может |
731 | 731 |
732 </directive> | 732 </directive> |
733 | 733 |
734 | 734 |
735 <directive name="location"> | 735 <directive name="location"> |
736 <syntax>location [<value>=|~|~*|^~|@</value>] <value>/uri/</value> | 736 <syntax>[<value>=|~|~*|^~|@</value>] <value>/uri/</value> |
737 { ... }</syntax> | 737 { ... }</syntax> |
738 <default/> | 738 <default/> |
739 <context>server</context> | 739 <context>server</context> |
740 | 740 |
741 <para> | 741 <para> |
820 | 820 |
821 </directive> | 821 </directive> |
822 | 822 |
823 | 823 |
824 <directive name="log_not_found"> | 824 <directive name="log_not_found"> |
825 <syntax>log_not_found <value>[on|off]</value></syntax> | 825 <syntax><value>[on|off]</value></syntax> |
826 <default>log_not_found on</default> | 826 <default>on</default> |
827 <context>http, server, location</context> | 827 <context>http, server, location</context> |
828 | 828 |
829 <para> | 829 <para> |
830 Директива разрешает или запрещает записывать в error_log | 830 Директива разрешает или запрещает записывать в error_log |
831 ошибки о том, что файл не найден. | 831 ошибки о том, что файл не найден. |
833 | 833 |
834 </directive> | 834 </directive> |
835 | 835 |
836 | 836 |
837 <directive name="log_subrequest"> | 837 <directive name="log_subrequest"> |
838 <syntax>log_subrequest <value>[on|off]</value></syntax> | 838 <syntax><value>[on|off]</value></syntax> |
839 <default>log_subrequest off</default> | 839 <default>off</default> |
840 <context>http, server, location</context> | 840 <context>http, server, location</context> |
841 | 841 |
842 <para> | 842 <para> |
843 Директива разрешает или запрещает записывать в | 843 Директива разрешает или запрещает записывать в |
844 <link doc="ngx_http_log_module.xml" id="access_log">access_log</link> | 844 <link doc="ngx_http_log_module.xml" id="access_log">access_log</link> |
847 | 847 |
848 </directive> | 848 </directive> |
849 | 849 |
850 | 850 |
851 <directive name="merge_slashes"> | 851 <directive name="merge_slashes"> |
852 <syntax>merge_slashes <value>[on|off]</value></syntax> | 852 <syntax><value>[on|off]</value></syntax> |
853 <default>merge_slashes on</default> | 853 <default>on</default> |
854 <context>http, server</context> | 854 <context>http, server</context> |
855 | 855 |
856 <para> | 856 <para> |
857 Директива разрешает или запрещает объединять в URI два и более слэшей в один. | 857 Директива разрешает или запрещает объединять в URI два и более слэшей в один. |
858 </para> | 858 </para> |
884 | 884 |
885 </directive> | 885 </directive> |
886 | 886 |
887 | 887 |
888 <directive name="msie_padding"> | 888 <directive name="msie_padding"> |
889 <syntax>msie_padding <value>[on|off]</value></syntax> | 889 <syntax><value>[on|off]</value></syntax> |
890 <default>msie_padding on</default> | 890 <default>on</default> |
891 <context>http, server, location</context> | 891 <context>http, server, location</context> |
892 | 892 |
893 <para> | 893 <para> |
894 Директива разрешает или запрещает добавлять в ответы для MSIE | 894 Директива разрешает или запрещает добавлять в ответы для MSIE |
895 со статусом больше 400 | 895 со статусом больше 400 |
898 | 898 |
899 </directive> | 899 </directive> |
900 | 900 |
901 | 901 |
902 <directive name="msie_refresh"> | 902 <directive name="msie_refresh"> |
903 <syntax>msie_refresh <value>[on|off]</value></syntax> | 903 <syntax><value>[on|off]</value></syntax> |
904 <default>msie_refresh off</default> | 904 <default>off</default> |
905 <context>http, server, location</context> | 905 <context>http, server, location</context> |
906 | 906 |
907 <para> | 907 <para> |
908 Директива разрешает или запрещает выдавать для MSIE refresh'ы вместо | 908 Директива разрешает или запрещает выдавать для MSIE refresh'ы вместо |
909 редиректов. | 909 редиректов. |
911 | 911 |
912 </directive> | 912 </directive> |
913 | 913 |
914 | 914 |
915 <directive name="open_file_cache"> | 915 <directive name="open_file_cache"> |
916 <syntax>open_file_cache <value>max=N [inactive=время]|off</value> | 916 <syntax><value>max=N [inactive=время]|off</value> |
917 </syntax> | 917 </syntax> |
918 <default>open_file_cache off</default> | 918 <default>off</default> |
919 <context>http, server, location</context> | 919 <context>http, server, location</context> |
920 | 920 |
921 <para> | 921 <para> |
922 Директива задаёт кэш, в котором могут хранится | 922 Директива задаёт кэш, в котором могут хранится |
923 <list type="bullet"> | 923 <list type="bullet"> |
973 | 973 |
974 </directive> | 974 </directive> |
975 | 975 |
976 | 976 |
977 <directive name="open_file_cache_errors"> | 977 <directive name="open_file_cache_errors"> |
978 <syntax>open_file_cache_errors <value>on|off</value></syntax> | 978 <syntax><value>on|off</value></syntax> |
979 <default>open_file_cache_errors off</default> | 979 <default>off</default> |
980 <context>http, server, location</context> | 980 <context>http, server, location</context> |
981 | 981 |
982 <para> | 982 <para> |
983 Директива определяет, кэшировать или нет ошибки поиска файлов в | 983 Директива определяет, кэшировать или нет ошибки поиска файлов в |
984 <link id="open_file_cache"/>. | 984 <link id="open_file_cache"/>. |
986 | 986 |
987 </directive> | 987 </directive> |
988 | 988 |
989 | 989 |
990 <directive name="open_file_cache_min_uses"> | 990 <directive name="open_file_cache_min_uses"> |
991 <syntax>open_file_cache_min_uses <value>число</value></syntax> | 991 <syntax><value>число</value></syntax> |
992 <default>open_file_cache_min_uses 1</default> | 992 <default>1</default> |
993 <context>http, server, location</context> | 993 <context>http, server, location</context> |
994 | 994 |
995 <para> | 995 <para> |
996 Директива определяет минимальное число использований файла в течение | 996 Директива определяет минимальное число использований файла в течение |
997 времени, заданного параметром inactive в директиве | 997 времени, заданного параметром inactive в директиве |
1001 | 1001 |
1002 </directive> | 1002 </directive> |
1003 | 1003 |
1004 | 1004 |
1005 <directive name="open_file_cache_valid"> | 1005 <directive name="open_file_cache_valid"> |
1006 <syntax>open_file_cache_valid <value>время</value></syntax> | 1006 <syntax><value>время</value></syntax> |
1007 <default>open_file_cache_valid 60</default> | 1007 <default>60</default> |
1008 <context>http, server, location</context> | 1008 <context>http, server, location</context> |
1009 | 1009 |
1010 <para> | 1010 <para> |
1011 Директива определяет, через какое время нужно проверять актуальность | 1011 Директива определяет, через какое время нужно проверять актуальность |
1012 информации об элементе в <link id="open_file_cache"/>. | 1012 информации об элементе в <link id="open_file_cache"/>. |
1015 | 1015 |
1016 </directive> | 1016 </directive> |
1017 | 1017 |
1018 | 1018 |
1019 <directive name="optimize_server_names"> | 1019 <directive name="optimize_server_names"> |
1020 <syntax>optimize_server_names <value>[on|off]</value></syntax> | 1020 <syntax><value>[on|off]</value></syntax> |
1021 <default>optimize_server_names on</default> | 1021 <default>on</default> |
1022 <context>http, server</context> | 1022 <context>http, server</context> |
1023 | 1023 |
1024 <para> | 1024 <para> |
1025 Устаревшая директива. | 1025 Устаревшая директива. |
1026 </para> | 1026 </para> |
1038 | 1038 |
1039 </directive> | 1039 </directive> |
1040 | 1040 |
1041 | 1041 |
1042 <directive name="port_in_redirect"> | 1042 <directive name="port_in_redirect"> |
1043 <syntax>port_in_redirect <value>[on|off]</value></syntax> | 1043 <syntax><value>[on|off]</value></syntax> |
1044 <default>port_in_redirect on</default> | 1044 <default>on</default> |
1045 <context>http, server, location</context> | 1045 <context>http, server, location</context> |
1046 | 1046 |
1047 <para> | 1047 <para> |
1048 Директива разрешает или запрещает указывать порт в редиректах, | 1048 Директива разрешает или запрещает указывать порт в редиректах, |
1049 выдаваемых nginx'ом. | 1049 выдаваемых nginx'ом. |
1051 | 1051 |
1052 </directive> | 1052 </directive> |
1053 | 1053 |
1054 | 1054 |
1055 <directive name="read_ahead"> | 1055 <directive name="read_ahead"> |
1056 <syntax>read_ahead <value>размер</value></syntax> | 1056 <syntax><value>размер</value></syntax> |
1057 <default>read_ahead 0</default> | 1057 <default>0</default> |
1058 <context>http, server, location</context> | 1058 <context>http, server, location</context> |
1059 | 1059 |
1060 <para> | 1060 <para> |
1061 Директива задаёт ядру размер предчтения при работе с файлами. | 1061 Директива задаёт ядру размер предчтения при работе с файлами. |
1062 Под Линуксом используется системный вызов | 1062 Под Линуксом используется системный вызов |
1074 | 1074 |
1075 </directive> | 1075 </directive> |
1076 | 1076 |
1077 | 1077 |
1078 <directive name="recursive_error_pages"> | 1078 <directive name="recursive_error_pages"> |
1079 <syntax>recursive_error_pages <value>[on|off]</value></syntax> | 1079 <syntax><value>[on|off]</value></syntax> |
1080 <default>recursive_error_pages off</default> | 1080 <default>off</default> |
1081 <context>http, server, location</context> | 1081 <context>http, server, location</context> |
1082 | 1082 |
1083 <para> | 1083 <para> |
1084 Директива разрешает или запрещает делать несколько перенаправлений через | 1084 Директива разрешает или запрещает делать несколько перенаправлений через |
1085 директиву <link id="error_page"/>. | 1085 директиву <link id="error_page"/>. |
1087 | 1087 |
1088 </directive> | 1088 </directive> |
1089 | 1089 |
1090 | 1090 |
1091 <directive name="reset_timedout_connection"> | 1091 <directive name="reset_timedout_connection"> |
1092 <syntax>reset_timedout_connection <value>[on|off]</value></syntax> | 1092 <syntax><value>[on|off]</value></syntax> |
1093 <default>reset_timedout_connection off</default> | 1093 <default>off</default> |
1094 <context>http, server, location</context> | 1094 <context>http, server, location</context> |
1095 | 1095 |
1096 <para> | 1096 <para> |
1097 Директива разрешает или запрещает сбрасывать соединение по таймауту. | 1097 Директива разрешает или запрещает сбрасывать соединение по таймауту. |
1098 Сброс делается следующим образом — перед закрытием сокета для него | 1098 Сброс делается следующим образом — перед закрытием сокета для него |
1109 | 1109 |
1110 </directive> | 1110 </directive> |
1111 | 1111 |
1112 | 1112 |
1113 <directive name="resolver"> | 1113 <directive name="resolver"> |
1114 <syntax>resolver <value>адрес</value></syntax> | 1114 <syntax><value>адрес</value></syntax> |
1115 <default/> | 1115 <default/> |
1116 <context>http, server, location</context> | 1116 <context>http, server, location</context> |
1117 | 1117 |
1118 <para> | 1118 <para> |
1119 Директива задаёт адрес name-сервера, например: | 1119 Директива задаёт адрес name-сервера, например: |
1124 | 1124 |
1125 </directive> | 1125 </directive> |
1126 | 1126 |
1127 | 1127 |
1128 <directive name="resolver_timeout"> | 1128 <directive name="resolver_timeout"> |
1129 <syntax>resolver_timeout <value>время</value></syntax> | 1129 <syntax><value>время</value></syntax> |
1130 <default>resolver_timeout 30s</default> | 1130 <default>30s</default> |
1131 <context>http, server, location</context> | 1131 <context>http, server, location</context> |
1132 | 1132 |
1133 <para> | 1133 <para> |
1134 Директива задаёт таймаут для определения имени, например: | 1134 Директива задаёт таймаут для определения имени, например: |
1135 <example> | 1135 <example> |
1139 | 1139 |
1140 </directive> | 1140 </directive> |
1141 | 1141 |
1142 | 1142 |
1143 <directive name="root"> | 1143 <directive name="root"> |
1144 <syntax>root <value>путь</value></syntax> | 1144 <syntax><value>путь</value></syntax> |
1145 <default>root html</default> | 1145 <default>html</default> |
1146 <context>http, server, location, if в location</context> | 1146 <context>http, server, location, if в location</context> |
1147 | 1147 |
1148 <para> | 1148 <para> |
1149 Директива задаёт корневой каталог для запросов. | 1149 Директива задаёт корневой каталог для запросов. |
1150 Например, при такой конфигурации | 1150 Например, при такой конфигурации |
1168 | 1168 |
1169 </directive> | 1169 </directive> |
1170 | 1170 |
1171 | 1171 |
1172 <directive name="satisfy"> | 1172 <directive name="satisfy"> |
1173 <syntax>satisfy <value>all|any</value></syntax> | 1173 <syntax><value>all|any</value></syntax> |
1174 <default>satisfy all</default> | 1174 <default>all</default> |
1175 <context>location</context> | 1175 <context>location</context> |
1176 | 1176 |
1177 <para> | 1177 <para> |
1178 Директива разрешает доступ при хотя бы одной успешной проверке, | 1178 Директива разрешает доступ при хотя бы одной успешной проверке, |
1179 выполненной модулями <link doc="ngx_http_access_module.xml">ngx_http_access_module</link> | 1179 выполненной модулями <link doc="ngx_http_access_module.xml">ngx_http_access_module</link> |
1193 | 1193 |
1194 </directive> | 1194 </directive> |
1195 | 1195 |
1196 | 1196 |
1197 <directive name="satisfy_any"> | 1197 <directive name="satisfy_any"> |
1198 <syntax>satisfy_any <value>on|off</value></syntax> | 1198 <syntax><value>on|off</value></syntax> |
1199 <default>satisfy_any off</default> | 1199 <default>off</default> |
1200 <context>location</context> | 1200 <context>location</context> |
1201 | 1201 |
1202 <para> | 1202 <para> |
1203 Директива переименована в директиву <link id="satisfy"/>. | 1203 Директива переименована в директиву <link id="satisfy"/>. |
1204 </para> | 1204 </para> |
1205 | 1205 |
1206 </directive> | 1206 </directive> |
1207 | 1207 |
1208 | 1208 |
1209 <directive name="send_timeout"> | 1209 <directive name="send_timeout"> |
1210 <syntax>send_timeout <value>время</value></syntax> | 1210 <syntax><value>время</value></syntax> |
1211 <default>send_timeout 60</default> | 1211 <default>60</default> |
1212 <context>http, server, location</context> | 1212 <context>http, server, location</context> |
1213 | 1213 |
1214 <para> | 1214 <para> |
1215 Директива задаёт таймаут при передаче ответа клиенту. | 1215 Директива задаёт таймаут при передаче ответа клиенту. |
1216 Таймаут устанавливается не на всю передачу ответа, | 1216 Таймаут устанавливается не на всю передачу ответа, |
1221 | 1221 |
1222 </directive> | 1222 </directive> |
1223 | 1223 |
1224 | 1224 |
1225 <directive name="sendfile"> | 1225 <directive name="sendfile"> |
1226 <syntax>sendfile <value>[on|off]</value></syntax> | 1226 <syntax><value>[on|off]</value></syntax> |
1227 <default>sendfile off</default> | 1227 <default>off</default> |
1228 <context>http, server, location</context> | 1228 <context>http, server, location</context> |
1229 | 1229 |
1230 <para> | 1230 <para> |
1231 Директива разрешает или запрещает использовать sendfile(). | 1231 Директива разрешает или запрещает использовать sendfile(). |
1232 </para> | 1232 </para> |
1233 | 1233 |
1234 </directive> | 1234 </directive> |
1235 | 1235 |
1236 | 1236 |
1237 <directive name="server"> | 1237 <directive name="server"> |
1238 <syntax>server { ... }</syntax> | 1238 <syntax>{ ... }</syntax> |
1239 <default/> | 1239 <default/> |
1240 <context>http</context> | 1240 <context>http</context> |
1241 | 1241 |
1242 <para> | 1242 <para> |
1243 Директива задаёт конфигурацию для виртуального сервера. | 1243 Директива задаёт конфигурацию для виртуального сервера. |
1253 | 1253 |
1254 </directive> | 1254 </directive> |
1255 | 1255 |
1256 | 1256 |
1257 <directive name="server_name"> | 1257 <directive name="server_name"> |
1258 <syntax>server_name <value>имя [...]</value></syntax> | 1258 <syntax><value>имя [...]</value></syntax> |
1259 <default>server_name hostname</default> | 1259 <default>hostname</default> |
1260 <context>server</context> | 1260 <context>server</context> |
1261 | 1261 |
1262 <para> | 1262 <para> |
1263 Директива задаёт имена виртуального сервера, например: | 1263 Директива задаёт имена виртуального сервера, например: |
1264 <example> | 1264 <example> |
1379 | 1379 |
1380 </directive> | 1380 </directive> |
1381 | 1381 |
1382 | 1382 |
1383 <directive name="server_name_in_redirect"> | 1383 <directive name="server_name_in_redirect"> |
1384 <syntax>server_name_in_redirect <value>[on|off]</value></syntax> | 1384 <syntax><value>[on|off]</value></syntax> |
1385 <default>server_name_in_redirect on</default> | 1385 <default>on</default> |
1386 <context>http, server, location</context> | 1386 <context>http, server, location</context> |
1387 | 1387 |
1388 <para> | 1388 <para> |
1389 Директива разрешает или запрещает использовать в редиректах, выдаваемых | 1389 Директива разрешает или запрещает использовать в редиректах, выдаваемых |
1390 nginx'ом, основное имя сервера, задаваемое директивой | 1390 nginx'ом, основное имя сервера, задаваемое директивой |
1396 | 1396 |
1397 </directive> | 1397 </directive> |
1398 | 1398 |
1399 | 1399 |
1400 <directive name="server_names_hash_max_size"> | 1400 <directive name="server_names_hash_max_size"> |
1401 <syntax>server_names_hash_max_size <value>число</value></syntax> | 1401 <syntax><value>число</value></syntax> |
1402 <default>server_names_hash_max_size 512</default> | 1402 <default>512</default> |
1403 <context>http</context> | 1403 <context>http</context> |
1404 | 1404 |
1405 <para> | 1405 <para> |
1406 Директива задаёт максимальный размер хэш-таблиц имён серверов. | 1406 Директива задаёт максимальный размер хэш-таблиц имён серверов. |
1407 Подробнее смотри в <link doc="../hash.xml">описании | 1407 Подробнее смотри в <link doc="../hash.xml">описании |
1410 | 1410 |
1411 </directive> | 1411 </directive> |
1412 | 1412 |
1413 | 1413 |
1414 <directive name="server_names_hash_bucket_size"> | 1414 <directive name="server_names_hash_bucket_size"> |
1415 <syntax>server_names_hash_bucket_size <value>число</value></syntax> | 1415 <syntax><value>число</value></syntax> |
1416 <default>server_names_hash_bucket_size 32/64/128</default> | 1416 <default>32/64/128</default> |
1417 <context>http</context> | 1417 <context>http</context> |
1418 | 1418 |
1419 <para> | 1419 <para> |
1420 Директива задаёт размер корзины в хэш-таблицах имён серверов. | 1420 Директива задаёт размер корзины в хэш-таблицах имён серверов. |
1421 Значение по умолчанию зависит от размера строки кэша процессора. | 1421 Значение по умолчанию зависит от размера строки кэша процессора. |
1425 | 1425 |
1426 </directive> | 1426 </directive> |
1427 | 1427 |
1428 | 1428 |
1429 <directive name="server_tokens"> | 1429 <directive name="server_tokens"> |
1430 <syntax>server_tokens <value>[on|off]</value></syntax> | 1430 <syntax><value>[on|off]</value></syntax> |
1431 <default>server_tokens on</default> | 1431 <default>on</default> |
1432 <context>http, server, location</context> | 1432 <context>http, server, location</context> |
1433 | 1433 |
1434 <para> | 1434 <para> |
1435 Директива разрешает или запрещает выдавать версию nginx'а | 1435 Директива разрешает или запрещает выдавать версию nginx'а |
1436 в сообщениях об ошибках и в строке заголовка ответа "Server". | 1436 в сообщениях об ошибках и в строке заголовка ответа "Server". |
1438 | 1438 |
1439 </directive> | 1439 </directive> |
1440 | 1440 |
1441 | 1441 |
1442 <directive name="tcp_nodelay"> | 1442 <directive name="tcp_nodelay"> |
1443 <syntax>tcp_nodelay <value>[on|off]</value></syntax> | 1443 <syntax><value>[on|off]</value></syntax> |
1444 <default>tcp_nodelay on</default> | 1444 <default>on</default> |
1445 <context>http, server, location</context> | 1445 <context>http, server, location</context> |
1446 | 1446 |
1447 <para> | 1447 <para> |
1448 Директива разрешает или запрещает использовать опцию TCP_NODELAY. | 1448 Директива разрешает или запрещает использовать опцию TCP_NODELAY. |
1449 Опция включаются только при переходе соединения в состояние keep-alive. | 1449 Опция включаются только при переходе соединения в состояние keep-alive. |
1451 | 1451 |
1452 </directive> | 1452 </directive> |
1453 | 1453 |
1454 | 1454 |
1455 <directive name="tcp_nopush"> | 1455 <directive name="tcp_nopush"> |
1456 <syntax>tcp_nopush <value>[on|off]</value></syntax> | 1456 <syntax><value>[on|off]</value></syntax> |
1457 <default>tcp_nopush off</default> | 1457 <default>off</default> |
1458 <context>http, server, location</context> | 1458 <context>http, server, location</context> |
1459 | 1459 |
1460 <para> | 1460 <para> |
1461 Директива разрешает или запрещает использовать опции | 1461 Директива разрешает или запрещает использовать опции |
1462 TCP_NOPUSH во FreeBSD или TCP_CORK в Linux. | 1462 TCP_NOPUSH во FreeBSD или TCP_CORK в Linux. |
1478 | 1478 |
1479 </directive> | 1479 </directive> |
1480 | 1480 |
1481 | 1481 |
1482 <directive name="try_files"> | 1482 <directive name="try_files"> |
1483 <syntax>try_files <value>файл [файл ...] (uri|=код)</value></syntax> | 1483 <syntax><value>файл [файл ...] (uri|=код)</value></syntax> |
1484 <default/> | 1484 <default/> |
1485 <context>location</context> | 1485 <context>location</context> |
1486 | 1486 |
1487 <para> | 1487 <para> |
1488 Директива проверяет существование файлов в заданном порядке | 1488 Директива проверяет существование файлов в заданном порядке |
1600 | 1600 |
1601 </directive> | 1601 </directive> |
1602 | 1602 |
1603 | 1603 |
1604 <directive name="types"> | 1604 <directive name="types"> |
1605 <syntax>types <value>{ ... }</value></syntax> | 1605 <syntax><value>{ ... }</value></syntax> |
1606 <default>see below</default> | 1606 <default> |
1607 { | |
1608 text/html html; | |
1609 image/gif gif; | |
1610 image/jpeg jpg; | |
1611 } | |
1612 </default> | |
1607 <context>http, server, location</context> | 1613 <context>http, server, location</context> |
1608 | 1614 |
1609 <para> | 1615 <para> |
1610 Директива задаёт соответствие расширения и MIME-типов ответов. | 1616 Директива задаёт соответствие расширения и MIME-типов ответов. |
1611 Одному MIME-типу может соответствовать несколько расширений. | 1617 Одному MIME-типу может соответствовать несколько расширений. |
1612 По умолчанию используется такие соответствия: | |
1613 <example> | |
1614 types { | |
1615 text/html html; | |
1616 image/gif gif; | |
1617 image/jpeg jpg; | |
1618 } | |
1619 </example> | |
1620 </para> | 1618 </para> |
1621 | 1619 |
1622 <para> | 1620 <para> |
1623 Достаточно полная таблица соответствий входит в дистрибутив | 1621 Достаточно полная таблица соответствий входит в дистрибутив |
1624 и находится в файле conf/mime.types. | 1622 и находится в файле conf/mime.types. |
1637 | 1635 |
1638 </directive> | 1636 </directive> |
1639 | 1637 |
1640 | 1638 |
1641 <directive name="underscores_in_headers"> | 1639 <directive name="underscores_in_headers"> |
1642 <syntax>underscores_in_headers <value>[on|off]</value></syntax> | 1640 <syntax><value>[on|off]</value></syntax> |
1643 <default>underscores_in_headers off</default> | 1641 <default>off</default> |
1644 <context>http, server</context> | 1642 <context>http, server</context> |
1645 | 1643 |
1646 <para> | 1644 <para> |
1647 Директива разрешает или запрещает использование символов подчёркивания | 1645 Директива разрешает или запрещает использование символов подчёркивания |
1648 в строках заголовка запроса клиента. | 1646 в строках заголовка запроса клиента. |