Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_scgi_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_scgi_module" | 10 <module name="Module ngx_http_scgi_module" |
11 link="/en/docs/http/ngx_http_scgi_module.html" | 11 link="/en/docs/http/ngx_http_scgi_module.html" |
12 lang="en" | 12 lang="en" |
13 rev="31"> | 13 rev="32"> |
14 | 14 |
15 <section id="summary"> | 15 <section id="summary"> |
16 | 16 |
17 <para> | 17 <para> |
18 The <literal>ngx_http_scgi_module</literal> module allows passing | 18 The <literal>ngx_http_scgi_module</literal> module allows passing |
620 | 620 |
621 <para> | 621 <para> |
622 The <literal>error</literal> parameter also permits | 622 The <literal>error</literal> parameter also permits |
623 using a stale cached response if an SCGI server to process a request | 623 using a stale cached response if an SCGI server to process a request |
624 cannot be selected. | 624 cannot be selected. |
625 The same behavior can be enabled with the | |
626 “<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” | |
627 extension of the <header>Cache-Control</header> response header field (1.11.10) | |
628 for a specified number of seconds after the response became stale, | |
629 however, this has lower priority than using the directive parameter. | |
630 </para> | 625 </para> |
631 | 626 |
632 <para id="scgi_cache_use_stale_updating"> | 627 <para id="scgi_cache_use_stale_updating"> |
633 Additionally, the <literal>updating</literal> parameter permits | 628 Additionally, the <literal>updating</literal> parameter permits |
634 using a stale cached response if it is currently being updated. | 629 using a stale cached response if it is currently being updated. |
635 This allows minimizing the number of accesses to SCGI servers | 630 This allows minimizing the number of accesses to SCGI servers |
636 when updating cached data. | 631 when updating cached data. |
637 The same behavior can be enabled with the | 632 </para> |
633 | |
634 <para> | |
635 Using a stale cached response | |
636 can also be enabled directly in the response header | |
637 for a specified number of seconds after the response became stale (1.11.10). | |
638 This has lower priority than using the directive parameters. | |
639 <list type="bullet" compact="no"> | |
640 | |
641 <listitem> | |
642 The | |
638 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” | 643 “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” |
639 extension of the <header>Cache-Control</header> response header field (1.11.10) | 644 extension of the <header>Cache-Control</header> header field permits |
640 for a specified number of seconds after the response became stale, | 645 using a stale cached response if it is currently being updated. |
641 however, this has lower priority than using the directive parameter. | 646 </listitem> |
647 | |
648 <listitem> | |
649 The | |
650 “<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” | |
651 extension of the <header>Cache-Control</header> header field permits | |
652 using a stale cached response in case of an error. | |
653 </listitem> | |
654 | |
655 </list> | |
642 </para> | 656 </para> |
643 | 657 |
644 <para> | 658 <para> |
645 To minimize the number of accesses to SCGI servers when | 659 To minimize the number of accesses to SCGI servers when |
646 populating a new cache element, the <link id="scgi_cache_lock"/> | 660 populating a new cache element, the <link id="scgi_cache_lock"/> |