Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_fastcgi_module.xml @ 3043:9eadb98ec770
Free nginx: removed commercial version documentation.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Wed, 14 Feb 2024 20:05:49 +0300 |
parents | 4add6ae1296f |
children | ca4c8ac67c0e |
comparison
equal
deleted
inserted
replaced
3042:19e4897acb84 | 3043:9eadb98ec770 |
---|---|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
9 | 9 |
10 <module name="Модуль ngx_http_fastcgi_module" | 10 <module name="Модуль ngx_http_fastcgi_module" |
11 link="/ru/docs/http/ngx_http_fastcgi_module.html" | 11 link="/ru/docs/http/ngx_http_fastcgi_module.html" |
12 lang="ru" | 12 lang="ru" |
13 rev="53"> | 13 rev="54"> |
14 | 14 |
15 <section id="summary"> | 15 <section id="summary"> |
16 | 16 |
17 <para> | 17 <para> |
18 Модуль <literal>ngx_http_fastcgi_module</literal> позволяет передавать | 18 Модуль <literal>ngx_http_fastcgi_module</literal> позволяет передавать |
391 [<literal>manager_files</literal>=<value>число</value>] | 391 [<literal>manager_files</literal>=<value>число</value>] |
392 [<literal>manager_sleep</literal>=<value>время</value>] | 392 [<literal>manager_sleep</literal>=<value>время</value>] |
393 [<literal>manager_threshold</literal>=<value>время</value>] | 393 [<literal>manager_threshold</literal>=<value>время</value>] |
394 [<literal>loader_files</literal>=<value>число</value>] | 394 [<literal>loader_files</literal>=<value>число</value>] |
395 [<literal>loader_sleep</literal>=<value>время</value>] | 395 [<literal>loader_sleep</literal>=<value>время</value>] |
396 [<literal>loader_threshold</literal>=<value>время</value>] | 396 [<literal>loader_threshold</literal>=<value>время</value>]</syntax> |
397 [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>] | |
398 [<literal>purger_files</literal>=<value>число</value>] | |
399 [<literal>purger_sleep</literal>=<value>время</value>] | |
400 [<literal>purger_threshold</literal>=<value>время</value>]</syntax> | |
401 <default/> | 397 <default/> |
402 <context>http</context> | 398 <context>http</context> |
403 | 399 |
404 <para> | 400 <para> |
405 Задаёт путь и другие параметры кэша. | 401 Задаёт путь и другие параметры кэша. |
440 <para> | 436 <para> |
441 Кроме того, все активные ключи и информация о данных хранятся в зоне | 437 Кроме того, все активные ключи и информация о данных хранятся в зоне |
442 разделяемой памяти, <value>имя</value> и <value>размер</value> которой | 438 разделяемой памяти, <value>имя</value> и <value>размер</value> которой |
443 задаются параметром <literal>keys_zone</literal>. | 439 задаются параметром <literal>keys_zone</literal>. |
444 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей. | 440 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей. |
445 <note> | |
446 Как часть | |
447 <commercial_version>коммерческой подписки</commercial_version> | |
448 в зоне разделяемой памяти также хранится расширенная | |
449 <link doc="ngx_http_api_module.xml" id="http_caches_">информация</link> о кэше, | |
450 поэтому для хранения аналогичного количества ключей необходимо указывать | |
451 больший размер зоны. | |
452 Например | |
453 зоны размером в 1 мегабайт достаточно для хранения около 4 тысяч ключей. | |
454 </note> | |
455 </para> | 441 </para> |
456 | 442 |
457 <para> | 443 <para> |
458 Если к данным кэша не обращаются в течение времени, заданного параметром | 444 Если к данным кэша не обращаются в течение времени, заданного параметром |
459 <literal>inactive</literal>, то данные удаляются, независимо от их свежести. | 445 <literal>inactive</literal>, то данные удаляются, независимо от их свежести. |
492 Между итерациями делается пауза на время, заданное параметром | 478 Между итерациями делается пауза на время, заданное параметром |
493 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд). | 479 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд). |
494 </para> | 480 </para> |
495 | 481 |
496 <para> | 482 <para> |
497 Кроме того, | |
498 следующие параметры доступны как часть | |
499 <commercial_version>коммерческой подписки</commercial_version>: | |
500 </para> | |
501 | |
502 <para> | |
503 <list type="tag"> | |
504 | |
505 <tag-name id="purger"> | |
506 <literal>purger</literal>=<literal>on</literal>|<literal>off</literal> | |
507 </tag-name> | |
508 <tag-desc> | |
509 Указывает, будут ли записи в кэше, соответствующие | |
510 <link id="fastcgi_cache_purge">маске</link>, | |
511 удалены с диска при помощи процесса “cache purger” (1.7.12). | |
512 Установка параметра в значение <literal>on</literal> | |
513 (по умолчанию <literal>off</literal>) | |
514 активирует процесс “cache purger”, который | |
515 проходит по всем записям в кэше | |
516 и удаляет записи, соответствующие этой маске. | |
517 </tag-desc> | |
518 | |
519 <tag-name id="purger_files"> | |
520 <literal>purger_files</literal>=<value>число</value> | |
521 </tag-name> | |
522 <tag-desc> | |
523 Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12). | |
524 По умолчанию <literal>purger_files</literal> равен 10. | |
525 </tag-desc> | |
526 | |
527 <tag-name id="purger_threshold"> | |
528 <literal>purger_threshold</literal>=<value>время</value> | |
529 </tag-name> | |
530 <tag-desc> | |
531 Задаёт продолжительность одной итерации (1.7.12). | |
532 По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам. | |
533 </tag-desc> | |
534 | |
535 <tag-name id="purger_sleep"> | |
536 <literal>purger_sleep</literal>=<value>время</value> | |
537 </tag-name> | |
538 <tag-desc> | |
539 Задаёт паузу между итерациями (1.7.12). | |
540 По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам. | |
541 </tag-desc> | |
542 | |
543 </list> | |
544 </para> | |
545 | |
546 <para> | |
547 <note> | 483 <note> |
548 В версиях 1.7.3, 1.7.7 и 1.11.10 формат заголовка кэша был изменён. | 484 В версиях 1.7.3, 1.7.7 и 1.11.10 формат заголовка кэша был изменён. |
549 При обновлении на более новую версию nginx | 485 При обновлении на более новую версию nginx |
550 ранее закэшированные ответы будут считаться недействительными. | 486 ранее закэшированные ответы будут считаться недействительными. |
551 </note> | |
552 </para> | |
553 | |
554 </directive> | |
555 | |
556 | |
557 <directive name="fastcgi_cache_purge"> | |
558 <syntax>строка ...</syntax> | |
559 <default/> | |
560 <context>http</context> | |
561 <context>server</context> | |
562 <context>location</context> | |
563 <appeared-in>1.5.7</appeared-in> | |
564 | |
565 <para> | |
566 Задаёт условия, при которых запрос будет считаться запросом | |
567 на очистку кэша. | |
568 Если значение хотя бы одного из строковых параметров непустое и не равно “0”, | |
569 то запись в кэше с соответствующим | |
570 <link id="fastcgi_cache_key">ключом кэширования</link> удаляется. | |
571 В результате успешной операции возвращается ответ с кодом | |
572 <http-status code="204" text="No Content"/>. | |
573 </para> | |
574 | |
575 <para> | |
576 Если <link id="fastcgi_cache_key">ключ кэширования</link> | |
577 запроса на очистку заканчивается | |
578 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие | |
579 этой маске, будут удалены из кэша. | |
580 Тем не менее, эти записи будут оставаться на диске или до момента удаления | |
581 из-за <link id="fastcgi_cache_path">отсутствия обращения к данным</link>, | |
582 или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12), | |
583 или до попытки клиента получить к ним доступ. | |
584 </para> | |
585 | |
586 <para> | |
587 Пример конфигурации: | |
588 <example> | |
589 fastcgi_cache_path /data/nginx/cache keys_zone=cache_zone:10m; | |
590 | |
591 map $request_method $purge_method { | |
592 PURGE 1; | |
593 default 0; | |
594 } | |
595 | |
596 server { | |
597 ... | |
598 location / { | |
599 fastcgi_pass http://backend; | |
600 fastcgi_cache cache_zone; | |
601 fastcgi_cache_key $uri; | |
602 fastcgi_cache_purge $purge_method; | |
603 } | |
604 } | |
605 </example> | |
606 <note> | |
607 Функциональность доступна как часть | |
608 <commercial_version>коммерческой подписки</commercial_version>. | |
609 </note> | 487 </note> |
610 </para> | 488 </para> |
611 | 489 |
612 </directive> | 490 </directive> |
613 | 491 |