Mercurial > hg > nginx-site

changeset 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 d6692a78a444
children 41cf2c2d8c5c
files xml/en/docs/http/ngx_http_fastcgi_module.xml xml/en/docs/http/ngx_http_proxy_module.xml xml/en/docs/http/ngx_http_scgi_module.xml xml/en/docs/http/ngx_http_uwsgi_module.xml xml/ru/docs/http/ngx_http_fastcgi_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_scgi_module.xml xml/ru/docs/http/ngx_http_uwsgi_module.xml
diffstat 8 files changed, 176 insertions(+), 16 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml	Tue Feb 14 18:46:35 2017 +0300
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml	Wed Feb 15 23:16:54 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="40">
+        rev="41">
 
 <section id="summary">
 
@@ -201,6 +201,26 @@
 </directive>
 
 
+<directive name="fastcgi_cache_background_update">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.11.10</appeared-in>
+
+<para>
+Allows starting a background subrequest
+to update an expired cache item,
+while a stale cached response is returned to the client.
+Note that it is necessary to
+<link id="fastcgi_cache_use_stale_updating">allow</link>
+the usage of a stale cached response when it is being updated.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_cache_bypass">
 <syntax><value>string</value> ...</syntax>
 <default/>
@@ -613,7 +633,7 @@
 cannot be selected.
 </para>
 
-<para>
+<para id="fastcgi_cache_use_stale_updating">
 Additionally, the <literal>updating</literal> parameter permits
 using a stale cached response if it is currently being updated.
 This allows minimizing the number of accesses to FastCGI servers
--- a/xml/en/docs/http/ngx_http_proxy_module.xml	Tue Feb 14 18:46:35 2017 +0300
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml	Wed Feb 15 23:16:54 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="54">
+        rev="55">
 
 <section id="summary">
 
@@ -195,6 +195,26 @@
 </directive>
 
 
+<directive name="proxy_cache_background_update">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.11.10</appeared-in>
+
+<para>
+Allows starting a background subrequest
+to update an expired cache item,
+while a stale cached response is returned to the client.
+Note that it is necessary to
+<link id="proxy_cache_use_stale_updating">allow</link>
+the usage of a stale cached response when it is being updated.
+</para>
+
+</directive>
+
+
 <directive name="proxy_cache_bypass">
 <syntax><value>string</value> ...</syntax>
 <default/>
@@ -631,7 +651,7 @@
 cannot be selected.
 </para>
 
-<para>
+<para id="proxy_cache_use_stale_updating">
 Additionally, the <literal>updating</literal> parameter permits
 using a stale cached response if it is currently being updated.
 This allows minimizing the number of accesses to proxied servers
--- a/xml/en/docs/http/ngx_http_scgi_module.xml	Tue Feb 14 18:46:35 2017 +0300
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml	Wed Feb 15 23:16:54 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_scgi_module"
         link="/en/docs/http/ngx_http_scgi_module.html"
         lang="en"
-        rev="29">
+        rev="30">
 
 <section id="summary">
 
@@ -193,6 +193,26 @@
 </directive>
 
 
+<directive name="scgi_cache_background_update">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.11.10</appeared-in>
+
+<para>
+Allows starting a background subrequest
+to update an expired cache item,
+while a stale cached response is returned to the client.
+Note that it is necessary to
+<link id="scgi_cache_use_stale_updating">allow</link>
+the usage of a stale cached response when it is being updated.
+</para>
+
+</directive>
+
+
 <directive name="scgi_cache_bypass">
 <syntax><value>string</value> ...</syntax>
 <default/>
@@ -604,7 +624,7 @@
 cannot be selected.
 </para>
 
-<para>
+<para id="scgi_cache_use_stale_updating">
 Additionally, the <literal>updating</literal> parameter permits
 using a stale cached response if it is currently being updated.
 This allows minimizing the number of accesses to SCGI servers
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml	Tue Feb 14 18:46:35 2017 +0300
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml	Wed Feb 15 23:16:54 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_uwsgi_module"
         link="/en/docs/http/ngx_http_uwsgi_module.html"
         lang="en"
-        rev="32">
+        rev="33">
 
 <section id="summary">
 
@@ -193,6 +193,26 @@
 </directive>
 
 
+<directive name="uwsgi_cache_background_update">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.11.10</appeared-in>
+
+<para>
+Allows starting a background subrequest
+to update an expired cache item,
+while a stale cached response is returned to the client.
+Note that it is necessary to
+<link id="uwsgi_cache_use_stale_updating">allow</link>
+the usage of a stale cached response when it is being updated.
+</para>
+
+</directive>
+
+
 <directive name="uwsgi_cache_bypass">
 <syntax><value>string</value> ...</syntax>
 <default/>
@@ -604,7 +624,7 @@
 cannot be selected.
 </para>
 
-<para>
+<para id="uwsgi_cache_use_stale_updating">
 Additionally, the <literal>updating</literal> parameter permits
 using a stale cached response if it is currently being updated.
 This allows minimizing the number of accesses to uwsgi servers
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Tue Feb 14 18:46:35 2017 +0300
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml	Wed Feb 15 23:16:54 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="40">
+        rev="41">
 
 <section id="summary">
 
@@ -201,6 +201,26 @@
 </directive>
 
 
+<directive name="fastcgi_cache_background_update">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.11.10</appeared-in>
+
+<para>
+Позволяет запустить фоновый подзапрос
+для обновления просроченного элемента кэша,
+в то время как клиенту возвращается устаревший закэшированный ответ.
+Использование устаревшего закэшированного ответа в момент его обновления
+должно быть
+<link id="fastcgi_cache_use_stale_updating">разрешено</link>.
+</para>
+
+</directive>
+
+
 <directive name="fastcgi_cache_bypass">
 <syntax><value>строка</value> ...</syntax>
 <default/>
@@ -612,7 +632,7 @@
 FastCGI-сервера для обработки запроса.
 </para>
 
-<para>
+<para id="fastcgi_cache_use_stale_updating">
 Кроме того, дополнительный параметр <literal>updating</literal>
 разрешает использовать устаревший закэшированный ответ,
 если на данный момент он уже обновляется.
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Tue Feb 14 18:46:35 2017 +0300
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Wed Feb 15 23:16:54 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="54">
+        rev="55">
 
 <section id="summary">
 
@@ -195,6 +195,26 @@
 </directive>
 
 
+<directive name="proxy_cache_background_update">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.11.10</appeared-in>
+
+<para>
+Позволяет запустить фоновый подзапрос
+для обновления просроченного элемента кэша,
+в то время как клиенту возвращается устаревший закэшированный ответ.
+Использование устаревшего закэшированного ответа в момент его обновления
+должно быть
+<link id="proxy_cache_use_stale_updating">разрешено</link>.
+</para>
+
+</directive>
+
+
 <directive name="proxy_cache_bypass">
 <syntax><value>строка</value> ...</syntax>
 <default/>
@@ -632,7 +652,7 @@
 проксированного сервера для обработки запроса.
 </para>
 
-<para>
+<para id="proxy_cache_use_stale_updating">
 Кроме того, дополнительный параметр <literal>updating</literal>
 разрешает использовать устаревший закэшированный ответ,
 если на данный момент он уже обновляется.
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml	Tue Feb 14 18:46:35 2017 +0300
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml	Wed Feb 15 23:16:54 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_scgi_module"
         link="/ru/docs/http/ngx_http_scgi_module.html"
         lang="ru"
-        rev="29">
+        rev="30">
 
 <section id="summary">
 
@@ -193,6 +193,26 @@
 </directive>
 
 
+<directive name="scgi_cache_background_update">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.11.10</appeared-in>
+
+<para>
+Позволяет запустить фоновый подзапрос
+для обновления просроченного элемента кэша,
+в то время как клиенту возвращается устаревший закэшированный ответ.
+Использование устаревшего закэшированного ответа в момент его обновления
+должно быть
+<link id="scgi_cache_use_stale_updating">разрешено</link>.
+</para>
+
+</directive>
+
+
 <directive name="scgi_cache_bypass">
 <syntax><value>строка</value> ...</syntax>
 <default/>
@@ -603,7 +623,7 @@
 SCGI-сервера для обработки запроса.
 </para>
 
-<para>
+<para id="scgi_cache_use_stale_updating">
 Кроме того, дополнительный параметр <literal>updating</literal>
 разрешает использовать устаревший закэшированный ответ,
 если на данный момент он уже обновляется.
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Tue Feb 14 18:46:35 2017 +0300
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml	Wed Feb 15 23:16:54 2017 +0300
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_uwsgi_module"
         link="/ru/docs/http/ngx_http_uwsgi_module.html"
         lang="ru"
-        rev="32">
+        rev="33">
 
 <section id="summary">
 
@@ -192,6 +192,26 @@
 </directive>
 
 
+<directive name="uwsgi_cache_background_update">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>http</context>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.11.10</appeared-in>
+
+<para>
+Позволяет запустить фоновый подзапрос
+для обновления просроченного элемента кэша,
+в то время как клиенту возвращается устаревший закэшированный ответ.
+Использование устаревшего закэшированного ответа в момент его обновления
+должно быть
+<link id="uwsgi_cache_use_stale_updating">разрешено</link>.
+</para>
+
+</directive>
+
+
 <directive name="uwsgi_cache_bypass">
 <syntax><value>строка</value> ...</syntax>
 <default/>
@@ -602,7 +622,7 @@
 uwsgi-сервера для обработки запроса.
 </para>
 
-<para>
+<para id="uwsgi_cache_use_stale_updating">
 Кроме того, дополнительный параметр <literal>updating</literal>
 разрешает использовать устаревший закэшированный ответ,
 если на данный момент он уже обновляется.