Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_uwsgi_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_uwsgi_module" 10 <module name="Module ngx_http_uwsgi_module"
11 link="/en/docs/http/ngx_http_uwsgi_module.html" 11 link="/en/docs/http/ngx_http_uwsgi_module.html"
12 lang="en" 12 lang="en"
13 rev="32"> 13 rev="33">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 The <literal>ngx_http_uwsgi_module</literal> module allows passing 18 The <literal>ngx_http_uwsgi_module</literal> module allows passing
186 Defines a shared memory zone used for caching. 186 Defines a shared memory zone used for caching.
187 The same zone can be used in several places. 187 The same zone can be used in several places.
188 Parameter value can contain variables (1.7.9). 188 Parameter value can contain variables (1.7.9).
189 The <literal>off</literal> parameter disables caching inherited 189 The <literal>off</literal> parameter disables caching inherited
190 from the previous configuration level. 190 from the previous configuration level.
191 </para>
192
193 </directive>
194
195
196 <directive name="uwsgi_cache_background_update">
197 <syntax><literal>on</literal> | <literal>off</literal></syntax>
198 <default>off</default>
199 <context>http</context>
200 <context>server</context>
201 <context>location</context>
202 <appeared-in>1.11.10</appeared-in>
203
204 <para>
205 Allows starting a background subrequest
206 to update an expired cache item,
207 while a stale cached response is returned to the client.
208 Note that it is necessary to
209 <link id="uwsgi_cache_use_stale_updating">allow</link>
210 the usage of a stale cached response when it is being updated.
191 </para> 211 </para>
192 212
193 </directive> 213 </directive>
194 214
195 215
602 The <literal>error</literal> parameter also permits 622 The <literal>error</literal> parameter also permits
603 using a stale cached response if a uwsgi server to process a request 623 using a stale cached response if a uwsgi server to process a request
604 cannot be selected. 624 cannot be selected.
605 </para> 625 </para>
606 626
607 <para> 627 <para id="uwsgi_cache_use_stale_updating">
608 Additionally, the <literal>updating</literal> parameter permits 628 Additionally, the <literal>updating</literal> parameter permits
609 using a stale cached response if it is currently being updated. 629 using a stale cached response if it is currently being updated.
610 This allows minimizing the number of accesses to uwsgi servers 630 This allows minimizing the number of accesses to uwsgi servers
611 when updating cached data. 631 when updating cached data.
612 </para> 632 </para>