Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_fastcgi_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 |
---|---|
37 | 37 |
38 | 38 |
39 <section name="Директивы" id="directives"> | 39 <section name="Директивы" id="directives"> |
40 | 40 |
41 <directive name="fastcgi_buffer_size"> | 41 <directive name="fastcgi_buffer_size"> |
42 <syntax>fastcgi_buffer_size <value>размер</value></syntax> | 42 <syntax><value>размер</value></syntax> |
43 <default>fastcgi_buffer_size 4k/8k</default> | 43 <default>4k/8k</default> |
44 <context>http, server, location</context> | 44 <context>http, server, location</context> |
45 | 45 |
46 <para> | 46 <para> |
47 Директива задаёт размер буфера, в который будет читаться | 47 Директива задаёт размер буфера, в который будет читаться |
48 первая часть ответа, получаемого от FastCGI-сервера. | 48 первая часть ответа, получаемого от FastCGI-сервера. |
53 | 53 |
54 </directive> | 54 </directive> |
55 | 55 |
56 | 56 |
57 <directive name="fastcgi_buffers"> | 57 <directive name="fastcgi_buffers"> |
58 <syntax>fastcgi_buffers <value>число размер</value></syntax> | 58 <syntax><value>число размер</value></syntax> |
59 <default>fastcgi_buffers 8 4k/8k</default> | 59 <default>8 4k/8k</default> |
60 <context>http, server, location</context> | 60 <context>http, server, location</context> |
61 | 61 |
62 <para> | 62 <para> |
63 Директива задаёт число и размер буферов для одного соединения, | 63 Директива задаёт число и размер буферов для одного соединения, |
64 в которые будет читаться ответ, получаемый от FastCGI-сервера. | 64 в которые будет читаться ответ, получаемый от FastCGI-сервера. |
68 | 68 |
69 </directive> | 69 </directive> |
70 | 70 |
71 | 71 |
72 <directive name="fastcgi_cache"> | 72 <directive name="fastcgi_cache"> |
73 <syntax>fastcgi_cache <value>[зона|off]</value></syntax> | 73 <syntax><value>[зона|off]</value></syntax> |
74 <default>off</default> | 74 <default>off</default> |
75 <context>http, server, location</context> | 75 <context>http, server, location</context> |
76 | 76 |
77 <para> | 77 <para> |
78 Директива задаёт зону для кэширования. | 78 Директива задаёт зону для кэширования. |
83 | 83 |
84 </directive> | 84 </directive> |
85 | 85 |
86 | 86 |
87 <directive name="fastcgi_cache_bypass"> | 87 <directive name="fastcgi_cache_bypass"> |
88 <syntax>fastcgi_cache_bypass <value>строка [...]</value></syntax> | 88 <syntax><value>строка [...]</value></syntax> |
89 <default/> | 89 <default/> |
90 <context>http, server, location</context> | 90 <context>http, server, location</context> |
91 | 91 |
92 <para> | 92 <para> |
93 Директива задаёт условия, при которых ответ не будет браться из кэша. | 93 Директива задаёт условия, при которых ответ не будет браться из кэша. |
102 | 102 |
103 </directive> | 103 </directive> |
104 | 104 |
105 | 105 |
106 <directive name="fastcgi_cache_key"> | 106 <directive name="fastcgi_cache_key"> |
107 <syntax>fastcgi_cache_key <value>строка</value></syntax> | 107 <syntax><value>строка</value></syntax> |
108 <default/> | 108 <default/> |
109 <context>http, server, location</context> | 109 <context>http, server, location</context> |
110 | 110 |
111 <para> | 111 <para> |
112 Директива задаёт ключ для кэширования, например, | 112 Директива задаёт ключ для кэширования, например, |
117 | 117 |
118 </directive> | 118 </directive> |
119 | 119 |
120 | 120 |
121 <directive name="fastcgi_cache_path"> | 121 <directive name="fastcgi_cache_path"> |
122 <syntax>fastcgi_cache_path <value>путь [levels=уровни] | 122 <syntax><value>путь [levels=уровни] |
123 keys_zone=название:размер [inactive=время] [max_size=размер]</value></syntax> | 123 keys_zone=название:размер [inactive=время] [max_size=размер]</value></syntax> |
124 <default/> | 124 <default/> |
125 <context>http</context> | 125 <context>http</context> |
126 | 126 |
127 <para> | 127 <para> |
165 | 165 |
166 </directive> | 166 </directive> |
167 | 167 |
168 | 168 |
169 <directive name="fastcgi_cache_min_uses"> | 169 <directive name="fastcgi_cache_min_uses"> |
170 <syntax>fastcgi_cache_min_uses <value>число</value></syntax> | 170 <syntax><value>число</value></syntax> |
171 <default>fastcgi_cache_min_uses 1</default> | 171 <default>1</default> |
172 <context>http, server, location</context> | 172 <context>http, server, location</context> |
173 | 173 |
174 <para> | 174 <para> |
175 Директива задаёт число запросов, после которого ответ будет | 175 Директива задаёт число запросов, после которого ответ будет |
176 закэширован. | 176 закэширован. |
178 | 178 |
179 </directive> | 179 </directive> |
180 | 180 |
181 | 181 |
182 <directive name="fastcgi_cache_valid"> | 182 <directive name="fastcgi_cache_valid"> |
183 <syntax>fastcgi_cache_valid <value>ответ [ответ ...] время</value> | 183 <syntax><value>ответ [ответ ...] время</value> |
184 </syntax> | 184 </syntax> |
185 <default/> | 185 <default/> |
186 <context>http, server, location</context> | 186 <context>http, server, location</context> |
187 | 187 |
188 <para> | 188 <para> |
215 | 215 |
216 </directive> | 216 </directive> |
217 | 217 |
218 | 218 |
219 <directive name="fastcgi_cache_use_stale"> | 219 <directive name="fastcgi_cache_use_stale"> |
220 <syntax>fastcgi_cache_use_stale <value>[error | timeout | invalid_header | 220 <syntax><value>[error | timeout | invalid_header |
221 | updating | http_500 | http_503 | http_404 | off] | 221 | updating | http_500 | http_503 | http_404 | off] |
222 [...]</value></syntax> | 222 [...]</value></syntax> |
223 <default>fastcgi_cache_use_stale off</default> | 223 <default>off</default> |
224 <context>http, server, location</context> | 224 <context>http, server, location</context> |
225 | 225 |
226 | 226 |
227 <para> | 227 <para> |
228 Директива определяет, в каких случаях можно использовать | 228 Директива определяет, в каких случаях можно использовать |
235 | 235 |
236 </directive> | 236 </directive> |
237 | 237 |
238 | 238 |
239 <directive name="fastcgi_connect_timeout"> | 239 <directive name="fastcgi_connect_timeout"> |
240 <syntax>fastcgi_connect_timeout <value>время</value></syntax> | 240 <syntax><value>время</value></syntax> |
241 <default>fastcgi_connect_timeout 60</default> | 241 <default>60</default> |
242 <context>http, server, location</context> | 242 <context>http, server, location</context> |
243 | 243 |
244 <para> | 244 <para> |
245 Директива задаёт таймаут для соединения с FastCGI-сервером. | 245 Директива задаёт таймаут для соединения с FastCGI-сервером. |
246 Необходимо иметь в виду, что этот таймаут не может быть больше 75 секунд. | 246 Необходимо иметь в виду, что этот таймаут не может быть больше 75 секунд. |
248 | 248 |
249 </directive> | 249 </directive> |
250 | 250 |
251 | 251 |
252 <directive name="fastcgi_index"> | 252 <directive name="fastcgi_index"> |
253 <syntax>fastcgi_index <value>имя</value></syntax> | 253 <syntax><value>имя</value></syntax> |
254 <default/> | 254 <default/> |
255 <context>http, server, location</context> | 255 <context>http, server, location</context> |
256 | 256 |
257 <para> | 257 <para> |
258 Директива задаёт имя файла, который при создании переменной | 258 Директива задаёт имя файла, который при создании переменной |
269 | 269 |
270 </directive> | 270 </directive> |
271 | 271 |
272 | 272 |
273 <directive name="fastcgi_hide_header"> | 273 <directive name="fastcgi_hide_header"> |
274 <syntax>fastcgi_hide_header <value>имя</value></syntax> | 274 <syntax><value>имя</value></syntax> |
275 <default/> | |
275 <context>http, server, location</context> | 276 <context>http, server, location</context> |
276 | 277 |
277 <para> | 278 <para> |
278 nginx не передаёт клиенту строки заголовка "Status" и "X-Accel-..." | 279 nginx не передаёт клиенту строки заголовка "Status" и "X-Accel-..." |
279 из ответа FastCGI-сервера. | 280 из ответа FastCGI-сервера. |
284 | 285 |
285 </directive> | 286 </directive> |
286 | 287 |
287 | 288 |
288 <directive name="fastcgi_ignore_client_abort"> | 289 <directive name="fastcgi_ignore_client_abort"> |
289 <syntax>fastcgi_ignore_client_abort <value>[on|off]</value></syntax> | 290 <syntax><value>[on|off]</value></syntax> |
290 <default>fastcgi_ignore_client_abort off</default> | 291 <default>off</default> |
291 <context>http, server, location</context> | 292 <context>http, server, location</context> |
292 | 293 |
293 | 294 |
294 <para> | 295 <para> |
295 Директива определяет, закрывать ли соединение с FastCGI-сервером | 296 Директива определяет, закрывать ли соединение с FastCGI-сервером |
298 | 299 |
299 </directive> | 300 </directive> |
300 | 301 |
301 | 302 |
302 <directive name="fastcgi_ignore_headers"> | 303 <directive name="fastcgi_ignore_headers"> |
303 <syntax>fastcgi_ignore_headers <value>имя [имя ...]</value></syntax> | 304 <syntax><value>имя [имя ...]</value></syntax> |
305 <default/> | |
304 <context>http, server, location</context> | 306 <context>http, server, location</context> |
305 | 307 |
306 <para> | 308 <para> |
307 Директива fastcgi_ignore_headers запрещает обработку некоторых | 309 Директива fastcgi_ignore_headers запрещает обработку некоторых |
308 строк заголовка из ответа FastCGI-сервера. | 310 строк заголовка из ответа FastCGI-сервера. |
313 | 315 |
314 </directive> | 316 </directive> |
315 | 317 |
316 | 318 |
317 <directive name="fastcgi_intercept_errors"> | 319 <directive name="fastcgi_intercept_errors"> |
318 <syntax>fastcgi_intercept_errors <value>on|off</value></syntax> | 320 <syntax><value>on|off</value></syntax> |
319 <default>fastcgi_intercept_errors off</default> | 321 <default>off</default> |
320 <context>http, server, location</context> | 322 <context>http, server, location</context> |
321 | 323 |
322 <para> | 324 <para> |
323 Директива определяет, передавать ли клиенту ответы FastCGI-сервера с кодом | 325 Директива определяет, передавать ли клиенту ответы FastCGI-сервера с кодом |
324 больше или равные 400 или же перенаправлять их на обработку nginx'у с помощью | 326 больше или равные 400 или же перенаправлять их на обработку nginx'у с помощью |
327 | 329 |
328 </directive> | 330 </directive> |
329 | 331 |
330 | 332 |
331 <directive name="fastcgi_no_cache"> | 333 <directive name="fastcgi_no_cache"> |
332 <syntax>fastcgi_no_cache <value>строка [...]</value></syntax> | 334 <syntax><value>строка [...]</value></syntax> |
333 <default/> | 335 <default/> |
334 <context>http, server, location</context> | 336 <context>http, server, location</context> |
335 | 337 |
336 <para> | 338 <para> |
337 Директива задаёт условия, при которых ответ не будет сохраняться в кэш. | 339 Директива задаёт условия, при которых ответ не будет сохраняться в кэш. |
347 | 349 |
348 </directive> | 350 </directive> |
349 | 351 |
350 | 352 |
351 <directive name="fastcgi_next_upstream"> | 353 <directive name="fastcgi_next_upstream"> |
352 <syntax>fastcgi_next_upstream | 354 <syntax> |
353 <value>[error|timeout|invalid_header|http_500|http_503|http_404|off]</value> | 355 <value>[error|timeout|invalid_header|http_500|http_503|http_404|off]</value> |
354 </syntax> | 356 </syntax> |
355 <default>fastcgi_next_upstream error timeout</default> | 357 <default>error timeout</default> |
356 <context>http, server, location</context> | 358 <context>http, server, location</context> |
357 | 359 |
358 | 360 |
359 <para> | 361 <para> |
360 Директива определяет, в каких случаях запрос будет передан следующему серверу: | 362 Директива определяет, в каких случаях запрос будет передан следующему серверу: |
402 | 404 |
403 </directive> | 405 </directive> |
404 | 406 |
405 | 407 |
406 <directive name="fastcgi_param"> | 408 <directive name="fastcgi_param"> |
407 <syntax>fastcgi_param <value>параметр значение</value></syntax> | 409 <syntax><value>параметр значение</value></syntax> |
408 <default/> | 410 <default/> |
409 <context>http, server, location</context> | 411 <context>http, server, location</context> |
410 | 412 |
411 <para> | 413 <para> |
412 Директива задаёт параметр, который будут передаваться FastCGI-серверу. | 414 Директива задаёт параметр, который будут передаваться FastCGI-серверу. |
448 | 450 |
449 </directive> | 451 </directive> |
450 | 452 |
451 | 453 |
452 <directive name="fastcgi_pass"> | 454 <directive name="fastcgi_pass"> |
453 <syntax>fastcgi_pass <value>fastcgi-server</value></syntax> | 455 <syntax><value>fastcgi-server</value></syntax> |
454 <default/> | 456 <default/> |
455 <context>location, if в location</context> | 457 <context>location, if в location</context> |
456 | 458 |
457 <para> | 459 <para> |
458 Директива задаёт адрес FastCGI-сервера. | 460 Директива задаёт адрес FastCGI-сервера. |
475 | 477 |
476 </directive> | 478 </directive> |
477 | 479 |
478 | 480 |
479 <directive name="fastcgi_pass_header"> | 481 <directive name="fastcgi_pass_header"> |
480 <syntax>fastcgi_pass_header <value>имя</value></syntax> | 482 <syntax><value>имя</value></syntax> |
483 <default/> | |
481 <context>http, server, location</context> | 484 <context>http, server, location</context> |
482 | 485 |
483 <para> | 486 <para> |
484 Директива разрешает передавать клиенту запрещённые для передачи строки. | 487 Директива разрешает передавать клиенту запрещённые для передачи строки. |
485 </para> | 488 </para> |
486 | 489 |
487 </directive> | 490 </directive> |
488 | 491 |
489 | 492 |
490 <directive name="fastcgi_read_timeout"> | 493 <directive name="fastcgi_read_timeout"> |
491 <syntax>fastcgi_read_timeout <value>время</value></syntax> | 494 <syntax><value>время</value></syntax> |
492 <default>fastcgi_read_timeout 60</default> | 495 <default>60</default> |
493 <context>http, server, location</context> | 496 <context>http, server, location</context> |
494 | 497 |
495 <para> | 498 <para> |
496 Директива задаёт таймаут при чтении ответа FastCGI-сервера. | 499 Директива задаёт таймаут при чтении ответа FastCGI-сервера. |
497 Таймаут устанавливается не на всю передачу ответа, | 500 Таймаут устанавливается не на всю передачу ответа, |
501 </para> | 504 </para> |
502 | 505 |
503 </directive> | 506 </directive> |
504 | 507 |
505 | 508 |
506 <directive name="fastcgi_redirect_errors"> | |
507 <syntax>fastcgi_redirect_errors <value>on|off</value></syntax> | |
508 | |
509 <para> | |
510 Директива переименована в <link id="fastcgi_intercept_errors"/>. | |
511 </para> | |
512 | |
513 </directive> | |
514 | |
515 | |
516 <directive name="fastcgi_send_timeout"> | 509 <directive name="fastcgi_send_timeout"> |
517 <syntax>fastcgi_send_timeout <value>время</value></syntax> | 510 <syntax><value>время</value></syntax> |
518 <default>fastcgi_send_timeout 60</default> | 511 <default>60</default> |
519 <context>http, server, location</context> | 512 <context>http, server, location</context> |
520 | 513 |
521 <para> | 514 <para> |
522 Директива задаёт таймаут при передаче запроса FastCGI-серверу. | 515 Директива задаёт таймаут при передаче запроса FastCGI-серверу. |
523 Таймаут устанавливается не на всю передачу запроса, | 516 Таймаут устанавливается не на всю передачу запроса, |
528 | 521 |
529 </directive> | 522 </directive> |
530 | 523 |
531 | 524 |
532 <directive name="fastcgi_split_path_info"> | 525 <directive name="fastcgi_split_path_info"> |
533 <syntax>fastcgi_split_path_info <value>regex</value></syntax> | 526 <syntax><value>regex</value></syntax> |
534 <default/> | 527 <default/> |
535 <context>location</context> | 528 <context>location</context> |
536 | 529 |
537 <para> | 530 <para> |
538 Директива задаёт регулярное выражение, выделяющее | 531 Директива задаёт регулярное выражение, выделяющее |
553 | 546 |
554 </directive> | 547 </directive> |
555 | 548 |
556 | 549 |
557 <directive name="fastcgi_store"> | 550 <directive name="fastcgi_store"> |
558 <syntax>fastcgi_store <value>on | off | строка </value></syntax> | 551 <syntax><value>on | off | строка </value></syntax> |
559 <default>fastcgi_store off</default> | 552 <default>off</default> |
560 <context>http, server, location</context> | 553 <context>http, server, location</context> |
561 | 554 |
562 <para> | 555 <para> |
563 Директива разрешает сохранение на диск файлов. | 556 Директива разрешает сохранение на диск файлов. |
564 Параметр "on" сохраняет файлы в соответствии с путями, указаными в директивах | 557 Параметр "on" сохраняет файлы в соответствии с путями, указаными в директивах |
611 | 604 |
612 </directive> | 605 </directive> |
613 | 606 |
614 | 607 |
615 <directive name="fastcgi_store_access"> | 608 <directive name="fastcgi_store_access"> |
616 <syntax>fastcgi_store_access <value>пользователи:права [пользователи:права] | 609 <syntax><value>пользователи:права [пользователи:права] |
617 ...</value></syntax> | 610 ...</value></syntax> |
618 <default>fastcgi_store_access user:rw</default> | 611 <default>user:rw</default> |
619 <context>http, server, location</context> | 612 <context>http, server, location</context> |
620 | 613 |
621 <para> | 614 <para> |
622 Директива задаёт права доступа для создаваемых файлов и каталогов, например, | 615 Директива задаёт права доступа для создаваемых файлов и каталогов, например, |
623 <example> | 616 <example> |
635 | 628 |
636 </directive> | 629 </directive> |
637 | 630 |
638 | 631 |
639 <directive name="fastcgi_temp_path"> | 632 <directive name="fastcgi_temp_path"> |
640 <syntax>fastcgi_temp_path <value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ] | 633 <syntax><value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ] |
641 </value></syntax> | 634 </value></syntax> |
642 <default>fastcgi_temp_path fastcgi_temp</default> | 635 <default>fastcgi_temp</default> |
643 <context>http, server, location</context> | 636 <context>http, server, location</context> |
644 | 637 |
645 <para> | 638 <para> |
646 Директива задаёт имя каталога для хранения временных файлов | 639 Директива задаёт имя каталога для хранения временных файлов |
647 полученных от другого сервера. | 640 полученных от другого сервера. |