Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_fastcgi_module.xml @ 1912:ec4af97e4403
Split off header options from parameters in proxy_cache_use_stale and friends.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 21 Feb 2017 21:23:53 +0300 |
parents | 41cf2c2d8c5c |
children | 66a30a380fba |
comparison
equal
deleted
inserted
replaced
1911:f024ac0ec5c7 | 1912:ec4af97e4403 |
---|---|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
9 | 9 |
10 <module name="Module ngx_http_fastcgi_module" | 10 <module name="Module ngx_http_fastcgi_module" |
11 link="/en/docs/http/ngx_http_fastcgi_module.html" | 11 link="/en/docs/http/ngx_http_fastcgi_module.html" |
12 lang="en" | 12 lang="en" |
13 rev="42"> | 13 rev="43"> |
14 | 14 |
15 <section id="summary"> | 15 <section id="summary"> |
16 | 16 |
17 <para> | 17 <para> |
18 The <literal>ngx_http_fastcgi_module</literal> module allows passing | 18 The <literal>ngx_http_fastcgi_module</literal> module allows passing |
629 | 629 |
630 <para> | 630 <para> |
631 The <literal>error</literal> parameter also permits | 631 The <literal>error</literal> parameter also permits |
632 using a stale cached response if a FastCGI server to process a request | 632 using a stale cached response if a FastCGI server to process a request |
633 cannot be selected. | 633 cannot be selected. |
634 The same behavior can be enabled with the | |
635 “<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” | |
636 extension of the <header>Cache-Control</header> response header field (1.11.10) | |
637 for a specified number of seconds after the response became stale, | |
638 however, this has lower priority than using the directive parameter. | |
639 </para> | 634 </para> |
640 | 635 |
641 <para id="fastcgi_cache_use_stale_updating"> | 636 <para id="fastcgi_cache_use_stale_updating"> |
642 Additionally, the <literal>updating</literal> parameter permits | 637 Additionally, the <literal>updating</literal> parameter permits |
643 using a stale cached response if it is currently being updated. | 638 using a stale cached response if it is currently being updated. |
644 This allows minimizing the number of accesses to FastCGI servers | 639 This allows minimizing the number of accesses to FastCGI servers |
645 when updating cached data. | 640 when updating cached data. |
646 The same behavior can be enabled with the | 641 </para> |
642 | |
643 <para> | |
644 Using a stale cached response | |
645 can also be enabled directly in the response header | |
646 for a specified number of seconds after the response became stale (1.11.10). | |
647 This has lower priority than using the directive parameters. | |
648 <list type="bullet" compact="no"> | |
649 | |
650 <listitem> | |
651 The | |
647 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” | 652 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” |
648 extension of the <header>Cache-Control</header> response header field (1.11.10) | 653 extension of the <header>Cache-Control</header> header field permits |
649 for a specified number of seconds after the response became stale, | 654 using a stale cached response if it is currently being updated. |
650 however, this has lower priority than using the directive parameter. | 655 </listitem> |
656 | |
657 <listitem> | |
658 The | |
659 “<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” | |
660 extension of the <header>Cache-Control</header> header field permits | |
661 using a stale cached response in case of an error. | |
662 </listitem> | |
663 | |
664 </list> | |
651 </para> | 665 </para> |
652 | 666 |
653 <para> | 667 <para> |
654 To minimize the number of accesses to FastCGI servers when | 668 To minimize the number of accesses to FastCGI servers when |
655 populating a new cache element, the <link id="fastcgi_cache_lock"/> | 669 populating a new cache element, the <link id="fastcgi_cache_lock"/> |