Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_fastcgi_module.xml @ 271:4c6d2c614d2c
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 Директива задаёт имя каталога для хранения временных файлов |