Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_fastcgi_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_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"/>