Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_scgi_module.xml @ 1912:ec4af97e4403

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