Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_fastcgi_module.xml @ 1909:399d0e188195

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented proxy_cache_background_update and friends.
author Yaroslav Zhuravlev <yar@nginx.com>
date Wed, 15 Feb 2017 23:16:54 +0300
parents 6839c258c473
children 41cf2c2d8c5c
comparison
equal deleted inserted replaced
1908:d6692a78a444 1909:399d0e188195
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="40"> 13 rev="41">
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
194 Defines a shared memory zone used for caching. 194 Defines a shared memory zone used for caching.
195 The same zone can be used in several places. 195 The same zone can be used in several places.
196 Parameter value can contain variables (1.7.9). 196 Parameter value can contain variables (1.7.9).
197 The <literal>off</literal> parameter disables caching inherited 197 The <literal>off</literal> parameter disables caching inherited
198 from the previous configuration level. 198 from the previous configuration level.
199 </para>
200
201 </directive>
202
203
204 <directive name="fastcgi_cache_background_update">
205 <syntax><literal>on</literal> | <literal>off</literal></syntax>
206 <default>off</default>
207 <context>http</context>
208 <context>server</context>
209 <context>location</context>
210 <appeared-in>1.11.10</appeared-in>
211
212 <para>
213 Allows starting a background subrequest
214 to update an expired cache item,
215 while a stale cached response is returned to the client.
216 Note that it is necessary to
217 <link id="fastcgi_cache_use_stale_updating">allow</link>
218 the usage of a stale cached response when it is being updated.
199 </para> 219 </para>
200 220
201 </directive> 221 </directive>
202 222
203 223
611 The <literal>error</literal> parameter also permits 631 The <literal>error</literal> parameter also permits
612 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
613 cannot be selected. 633 cannot be selected.
614 </para> 634 </para>
615 635
616 <para> 636 <para id="fastcgi_cache_use_stale_updating">
617 Additionally, the <literal>updating</literal> parameter permits 637 Additionally, the <literal>updating</literal> parameter permits
618 using a stale cached response if it is currently being updated. 638 using a stale cached response if it is currently being updated.
619 This allows minimizing the number of accesses to FastCGI servers 639 This allows minimizing the number of accesses to FastCGI servers
620 when updating cached data. 640 when updating cached data.
621 </para> 641 </para>