Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_fastcgi_module.xml @ 1909:399d0e188195
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> |