Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_fastcgi_module.xml @ 271:4c6d2c614d2c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Cleaned up XML tag mess: - all of <parameter> and <code>, and some of <dirname>, <value>, and <command> were replaced by <literal>; - the rest of <dirname> were replaced by links; - <argument> were replaced by <value>; - <value> is now rendered in HTML in italic; - <literal> and <path> can now contain <value>. Cleaned up terminology mess: - directives take "parameters".
author Ruslan Ermilov <ru@nginx.com>
date Fri, 23 Dec 2011 17:29:59 +0000
parents fe72da550150
children b481f078e223
comparison
equal deleted inserted replaced
270:945d7299c26c 271:4c6d2c614d2c
53 53
54 </directive> 54 </directive>
55 55
56 56
57 <directive name="fastcgi_buffers"> 57 <directive name="fastcgi_buffers">
58 <syntax><value>число размер</value></syntax> 58 <syntax><value>число</value> <value>размер</value></syntax>
59 <default>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 Директива задаёт число и размер буферов для одного соединения,
68 68
69 </directive> 69 </directive>
70 70
71 71
72 <directive name="fastcgi_cache"> 72 <directive name="fastcgi_cache">
73 <syntax><value>[зона|off]</value></syntax> 73 <syntax><value>зона</value> | <literal>off</literal></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><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 Директива задаёт условия, при которых ответ не будет браться из кэша.
117 117
118 </directive> 118 </directive>
119 119
120 120
121 <directive name="fastcgi_cache_path"> 121 <directive name="fastcgi_cache_path">
122 <syntax><value>путь [levels=уровни] 122 <syntax>
123 keys_zone=название:размер [inactive=время] [max_size=размер]</value></syntax> 123 <value>путь</value>
124 [<literal>levels</literal>=<value>уровни</value>]
125 <literal>keys_zone</literal>=<value>название</value>:<value>размер</value>
126 [<literal>inactive</literal>=<value>время</value>]
127 [<literal>max_size</literal>=<value>размер</value>]</syntax>
124 <default/> 128 <default/>
125 <context>http</context> 129 <context>http</context>
126 130
127 <para> 131 <para>
128 Директива задаёт путь и другие параметры кэша. Данные кэша хранятся в файлах. 132 Директива задаёт путь и другие параметры кэша. Данные кэша хранятся в файлах.
178 182
179 </directive> 183 </directive>
180 184
181 185
182 <directive name="fastcgi_cache_valid"> 186 <directive name="fastcgi_cache_valid">
183 <syntax><value>ответ [ответ ...] время</value> 187 <syntax><value>ответ</value> ... <value>время</value>
184 </syntax> 188 </syntax>
185 <default/> 189 <default/>
186 <context>http, server, location</context> 190 <context>http, server, location</context>
187 191
188 <para> 192 <para>
215 219
216 </directive> 220 </directive>
217 221
218 222
219 <directive name="fastcgi_cache_use_stale"> 223 <directive name="fastcgi_cache_use_stale">
220 <syntax><value>[error | timeout | invalid_header 224 <syntax>
221 | updating | http_500 | http_503 | http_404 | off] 225 <literal>error</literal> |
222 [...]</value></syntax> 226 <literal>timeout</literal> |
227 <literal>invalid_header</literal> |
228 <literal>updating</literal> |
229 <literal>http_500</literal> |
230 <literal>http_503</literal> |
231 <literal>http_404</literal> |
232 <literal>off</literal>
233 ...</syntax>
223 <default>off</default> 234 <default>off</default>
224 <context>http, server, location</context> 235 <context>http, server, location</context>
225 236
226 237
227 <para> 238 <para>
285 296
286 </directive> 297 </directive>
287 298
288 299
289 <directive name="fastcgi_ignore_client_abort"> 300 <directive name="fastcgi_ignore_client_abort">
290 <syntax><value>[on|off]</value></syntax> 301 <syntax><literal>on</literal> | <literal>off</literal></syntax>
291 <default>off</default> 302 <default>off</default>
292 <context>http, server, location</context> 303 <context>http, server, location</context>
293 304
294 305
295 <para> 306 <para>
299 310
300 </directive> 311 </directive>
301 312
302 313
303 <directive name="fastcgi_ignore_headers"> 314 <directive name="fastcgi_ignore_headers">
304 <syntax><value>имя [имя ...]</value></syntax> 315 <syntax><value>имя</value> ...</syntax>
305 <default/> 316 <default/>
306 <context>http, server, location</context> 317 <context>http, server, location</context>
307 318
308 <para> 319 <para>
309 Директива fastcgi_ignore_headers запрещает обработку некоторых 320 Директива fastcgi_ignore_headers запрещает обработку некоторых
315 326
316 </directive> 327 </directive>
317 328
318 329
319 <directive name="fastcgi_intercept_errors"> 330 <directive name="fastcgi_intercept_errors">
320 <syntax><value>on|off</value></syntax> 331 <syntax><literal>on</literal> | <literal>off</literal></syntax>
321 <default>off</default> 332 <default>off</default>
322 <context>http, server, location</context> 333 <context>http, server, location</context>
323 334
324 <para> 335 <para>
325 Директива определяет, передавать ли клиенту ответы FastCGI-сервера с кодом 336 Директива определяет, передавать ли клиенту ответы FastCGI-сервера с кодом
329 340
330 </directive> 341 </directive>
331 342
332 343
333 <directive name="fastcgi_no_cache"> 344 <directive name="fastcgi_no_cache">
334 <syntax><value>строка [...]</value></syntax> 345 <syntax><value>строка</value> ...</syntax>
335 <default/> 346 <default/>
336 <context>http, server, location</context> 347 <context>http, server, location</context>
337 348
338 <para> 349 <para>
339 Директива задаёт условия, при которых ответ не будет сохраняться в кэш. 350 Директива задаёт условия, при которых ответ не будет сохраняться в кэш.
350 </directive> 361 </directive>
351 362
352 363
353 <directive name="fastcgi_next_upstream"> 364 <directive name="fastcgi_next_upstream">
354 <syntax> 365 <syntax>
355 <value>[error|timeout|invalid_header|http_500|http_503|http_404|off]</value> 366 <literal>error</literal> |
356 </syntax> 367 <literal>timeout</literal> |
368 <literal>invalid_header</literal> |
369 <literal>http_500</literal> |
370 <literal>http_503</literal> |
371 <literal>http_404</literal> |
372 <literal>off</literal>
373 ...</syntax>
357 <default>error timeout</default> 374 <default>error timeout</default>
358 <context>http, server, location</context> 375 <context>http, server, location</context>
359 376
360 377
361 <para> 378 <para>
405 </directive> 422 </directive>
406 423
407 424
408 <directive name="fastcgi_param"> 425 <directive name="fastcgi_param">
409 <syntax> 426 <syntax>
410 <argument>параметр значение</argument> 427 <value>параметр</value> <value>значение</value>
411 [<parameter>if_not_empty</parameter>] 428 [<literal>if_not_empty</literal>]</syntax>
412 </syntax>
413 <default/> 429 <default/>
414 <context>http, server, location</context> 430 <context>http, server, location</context>
415 431
416 <para> 432 <para>
417 Директива задаёт параметр, который будут передаваться FastCGI-серверу. 433 Директива задаёт параметр, который будут передаваться FastCGI-серверу.
418 В качестве значения можно использовать текст, переменные и их комбинации. 434 В качестве значения можно использовать текст, переменные и их комбинации.
419 Директивы наследуются с предыдущего уровня при условии, что на данном 435 Директивы наследуются с предыдущего уровня при условии, что на данном
420 уровне не описаны свои директивы <code>fastcgi_param</code>. 436 уровне не описаны свои директивы <literal>fastcgi_param</literal>.
421 </para> 437 </para>
422 438
423 <para> 439 <para>
424 Ниже приведён пример минимально необходимых параметров для PHP: 440 Ниже приведён пример минимально необходимых параметров для PHP:
425 <example> 441 <example>
442 </example> 458 </example>
443 </para> 459 </para>
444 460
445 <para> 461 <para>
446 Если PHP был собран с параметром конфигурации 462 Если PHP был собран с параметром конфигурации
447 <command>--enable-force-cgi-redirect</command>, то нужно передавать 463 <literal>--enable-force-cgi-redirect</literal>, то нужно передавать
448 параметр REDIRECT_STATUS со значением "200": 464 параметр REDIRECT_STATUS со значением "200":
449 <example> 465 <example>
450 fastcgi_param REDIRECT_STATUS 200; 466 fastcgi_param REDIRECT_STATUS 200;
451 </example> 467 </example>
452 </para> 468 </para>
453 469
454 <para> 470 <para>
455 Если директива указана с флагом <parameter>if_not_empty</parameter> (1.1.11), 471 Если директива указана с флагом <literal>if_not_empty</literal> (1.1.11),
456 то такой параметр с пустым значением передаваться на сервер не будет: 472 то такой параметр с пустым значением передаваться на сервер не будет:
457 <example> 473 <example>
458 fastcgi_param HTTPS $https if_not_empty; 474 fastcgi_param HTTPS $https if_not_empty;
459 </example> 475 </example>
460 </para> 476 </para>
557 573
558 </directive> 574 </directive>
559 575
560 576
561 <directive name="fastcgi_store"> 577 <directive name="fastcgi_store">
562 <syntax><value>on | off | строка </value></syntax> 578 <syntax>
579 <literal>on</literal> |
580 <literal>off</literal> |
581 <value>строка</value></syntax>
563 <default>off</default> 582 <default>off</default>
564 <context>http, server, location</context> 583 <context>http, server, location</context>
565 584
566 <para> 585 <para>
567 Директива разрешает сохранение на диск файлов. 586 Директива разрешает сохранение на диск файлов.
615 634
616 </directive> 635 </directive>
617 636
618 637
619 <directive name="fastcgi_store_access"> 638 <directive name="fastcgi_store_access">
620 <syntax><value>пользователи:права [пользователи:права] 639 <syntax><value>пользователи</value>:<value>права</value> ...</syntax>
621 ...</value></syntax>
622 <default>user:rw</default> 640 <default>user:rw</default>
623 <context>http, server, location</context> 641 <context>http, server, location</context>
624 642
625 <para> 643 <para>
626 Директива задаёт права доступа для создаваемых файлов и каталогов, например, 644 Директива задаёт права доступа для создаваемых файлов и каталогов, например,
639 657
640 </directive> 658 </directive>
641 659
642 660
643 <directive name="fastcgi_temp_path"> 661 <directive name="fastcgi_temp_path">
644 <syntax><value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ] 662 <syntax><value>путь</value> [<value>уровень1</value> [<value>уровень2</value> [<value>уровень3</value>]]]</syntax>
645 </value></syntax>
646 <default>fastcgi_temp</default> 663 <default>fastcgi_temp</default>
647 <context>http, server, location</context> 664 <context>http, server, location</context>
648 665
649 <para> 666 <para>
650 Директива задаёт имя каталога для хранения временных файлов 667 Директива задаёт имя каталога для хранения временных файлов