Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_uwsgi_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 37e082fd009c
children
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_uwsgi_module" 10 <module name="Модуль ngx_http_uwsgi_module"
11 link="/ru/docs/http/ngx_http_uwsgi_module.html" 11 link="/ru/docs/http/ngx_http_uwsgi_module.html"
12 lang="ru" 12 lang="ru"
13 rev="50"> 13 rev="51">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_uwsgi_module</literal> позволяет передавать 18 Модуль <literal>ngx_http_uwsgi_module</literal> позволяет передавать
381 [<literal>manager_files</literal>=<value>число</value>] 381 [<literal>manager_files</literal>=<value>число</value>]
382 [<literal>manager_sleep</literal>=<value>время</value>] 382 [<literal>manager_sleep</literal>=<value>время</value>]
383 [<literal>manager_threshold</literal>=<value>время</value>] 383 [<literal>manager_threshold</literal>=<value>время</value>]
384 [<literal>loader_files</literal>=<value>число</value>] 384 [<literal>loader_files</literal>=<value>число</value>]
385 [<literal>loader_sleep</literal>=<value>время</value>] 385 [<literal>loader_sleep</literal>=<value>время</value>]
386 [<literal>loader_threshold</literal>=<value>время</value>] 386 [<literal>loader_threshold</literal>=<value>время</value>]</syntax>
387 [<literal>purger</literal>=<literal>on</literal>|<literal>off</literal>]
388 [<literal>purger_files</literal>=<value>число</value>]
389 [<literal>purger_sleep</literal>=<value>время</value>]
390 [<literal>purger_threshold</literal>=<value>время</value>]</syntax>
391 <default/> 387 <default/>
392 <context>http</context> 388 <context>http</context>
393 389
394 <para> 390 <para>
395 Задаёт путь и другие параметры кэша. 391 Задаёт путь и другие параметры кэша.
430 <para> 426 <para>
431 Кроме того, все активные ключи и информация о данных хранятся в зоне 427 Кроме того, все активные ключи и информация о данных хранятся в зоне
432 разделяемой памяти, <value>имя</value> и <value>размер</value> которой 428 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
433 задаются параметром <literal>keys_zone</literal>. 429 задаются параметром <literal>keys_zone</literal>.
434 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей. 430 Зоны размером в 1 мегабайт достаточно для хранения около 8 тысяч ключей.
435 <note>
436 Как часть
437 <commercial_version>коммерческой подписки</commercial_version>
438 в зоне разделяемой памяти также хранится расширенная
439 <link doc="ngx_http_api_module.xml" id="http_caches_">информация</link> о кэше,
440 поэтому для хранения аналогичного количества ключей необходимо указывать
441 больший размер зоны.
442 Например
443 зоны размером в 1 мегабайт достаточно для хранения около 4 тысяч ключей.
444 </note>
445 </para> 431 </para>
446 432
447 <para> 433 <para>
448 Если к данным кэша не обращаются в течение времени, заданного параметром 434 Если к данным кэша не обращаются в течение времени, заданного параметром
449 <literal>inactive</literal>, то данные удаляются, независимо от их свежести. 435 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
482 Между итерациями делается пауза на время, заданное параметром 468 Между итерациями делается пауза на время, заданное параметром
483 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд). 469 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
484 </para> 470 </para>
485 471
486 <para> 472 <para>
487 Кроме того,
488 следующие параметры доступны как часть
489 <commercial_version>коммерческой подписки</commercial_version>:
490 </para>
491
492 <para>
493 <list type="tag">
494
495 <tag-name id="purger">
496 <literal>purger</literal>=<literal>on</literal>|<literal>off</literal>
497 </tag-name>
498 <tag-desc>
499 Указывает, будут ли записи в кэше, соответствующие
500 <link id="uwsgi_cache_purge">маске</link>,
501 удалены с диска при помощи процесса “cache purger” (1.7.12).
502 Установка параметра в значение <literal>on</literal>
503 (по умолчанию <literal>off</literal>)
504 активирует процесс “cache purger”, который
505 проходит по всем записям в кэше
506 и удаляет записи, соответствующие этой маске.
507 </tag-desc>
508
509 <tag-name id="purger_files">
510 <literal>purger_files</literal>=<value>число</value>
511 </tag-name>
512 <tag-desc>
513 Задаёт число элементов, которые будут сканироваться за одну итерацию (1.7.12).
514 По умолчанию <literal>purger_files</literal> равен 10.
515 </tag-desc>
516
517 <tag-name id="purger_threshold">
518 <literal>purger_threshold</literal>=<value>время</value>
519 </tag-name>
520 <tag-desc>
521 Задаёт продолжительность одной итерации (1.7.12).
522 По умолчанию <literal>purger_threshold</literal> равен 50 миллисекундам.
523 </tag-desc>
524
525 <tag-name id="purger_sleep">
526 <literal>purger_sleep</literal>=<value>время</value>
527 </tag-name>
528 <tag-desc>
529 Задаёт паузу между итерациями (1.7.12).
530 По умолчанию <literal>purger_sleep</literal> равен 50 миллисекундам.
531 </tag-desc>
532
533 </list>
534 </para>
535
536 <para>
537 <note> 473 <note>
538 В версиях 1.7.3, 1.7.7 и 1.11.10 формат заголовка кэша был изменён. 474 В версиях 1.7.3, 1.7.7 и 1.11.10 формат заголовка кэша был изменён.
539 При обновлении на более новую версию nginx 475 При обновлении на более новую версию nginx
540 ранее закэшированные ответы будут считаться недействительными. 476 ранее закэшированные ответы будут считаться недействительными.
541 </note>
542 </para>
543
544 </directive>
545
546
547 <directive name="uwsgi_cache_purge">
548 <syntax>строка ...</syntax>
549 <default/>
550 <context>http</context>
551 <context>server</context>
552 <context>location</context>
553 <appeared-in>1.5.7</appeared-in>
554
555 <para>
556 Задаёт условия, при которых запрос будет считаться запросом
557 на очистку кэша.
558 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
559 то запись в кэше с соответствующим
560 <link id="uwsgi_cache_key">ключом кэширования</link> удаляется.
561 В результате успешной операции возвращается ответ с кодом
562 <http-status code="204" text="No Content"/>.
563 </para>
564
565 <para>
566 Если <link id="uwsgi_cache_key">ключ кэширования</link>
567 запроса на очистку заканчивается
568 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
569 этой маске, будут удалены из кэша.
570 Тем не менее, эти записи будут оставаться на диске или до момента удаления
571 из-за <link id="uwsgi_cache_path">отсутствия обращения к данным</link>,
572 или до обработки их процессом “<link id="purger">cache purger</link>” (1.7.12),
573 или до попытки клиента получить к ним доступ.
574 </para>
575
576 <para>
577 Пример конфигурации:
578 <example>
579 uwsgi_cache_path /data/nginx/cache keys_zone=cache_zone:10m;
580
581 map $request_method $purge_method {
582 PURGE 1;
583 default 0;
584 }
585
586 server {
587 ...
588 location / {
589 uwsgi_pass http://backend;
590 uwsgi_cache cache_zone;
591 uwsgi_cache_key $uri;
592 uwsgi_cache_purge $purge_method;
593 }
594 }
595 </example>
596 <note>
597 Функциональность доступна как часть
598 <commercial_version>коммерческой подписки</commercial_version>.
599 </note> 477 </note>
600 </para> 478 </para>
601 479
602 </directive> 480 </directive>
603 481