Mercurial > hg > nginx-site

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

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 полученных от другого сервера.