Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_fastcgi_module.xml @ 3043:9eadb98ec770

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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