Mercurial > hg > nginx-site
changeset 1912:ec4af97e4403
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 | f024ac0ec5c7 |
children | 03520b017a3c |
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, 196 insertions(+), 80 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml Fri Feb 17 17:58:53 2017 +0300 +++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml Tue Feb 21 21:23:53 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="42"> + rev="43"> <section id="summary"> @@ -631,11 +631,6 @@ The <literal>error</literal> parameter also permits using a stale cached response if a FastCGI server to process a request cannot be selected. -The same behavior can be enabled with the -“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” -extension of the <header>Cache-Control</header> response header field (1.11.10) -for a specified number of seconds after the response became stale, -however, this has lower priority than using the directive parameter. </para> <para id="fastcgi_cache_use_stale_updating"> @@ -643,11 +638,30 @@ using a stale cached response if it is currently being updated. This allows minimizing the number of accesses to FastCGI servers when updating cached data. -The same behavior can be enabled with the +</para> + +<para> +Using a stale cached response +can also be enabled directly in the response header +for a specified number of seconds after the response became stale (1.11.10). +This has lower priority than using the directive parameters. +<list type="bullet" compact="no"> + +<listitem> +The “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” -extension of the <header>Cache-Control</header> response header field (1.11.10) -for a specified number of seconds after the response became stale, -however, this has lower priority than using the directive parameter. +extension of the <header>Cache-Control</header> header field permits +using a stale cached response if it is currently being updated. +</listitem> + +<listitem> +The +“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” +extension of the <header>Cache-Control</header> header field permits +using a stale cached response in case of an error. +</listitem> + +</list> </para> <para>
--- a/xml/en/docs/http/ngx_http_proxy_module.xml Fri Feb 17 17:58:53 2017 +0300 +++ b/xml/en/docs/http/ngx_http_proxy_module.xml Tue Feb 21 21:23:53 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="56"> + rev="57"> <section id="summary"> @@ -649,11 +649,6 @@ The <literal>error</literal> parameter also permits using a stale cached response if a proxied server to process a request cannot be selected. -The same behavior can be enabled with the -“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” -extension of the <header>Cache-Control</header> response header field (1.11.10) -for a specified number of seconds after the response became stale, -however, this has lower priority than using the directive parameter. </para> <para id="proxy_cache_use_stale_updating"> @@ -661,11 +656,30 @@ using a stale cached response if it is currently being updated. This allows minimizing the number of accesses to proxied servers when updating cached data. -The same behavior can be enabled with the +</para> + +<para> +Using a stale cached response +can also be enabled directly in the response header +for a specified number of seconds after the response became stale (1.11.10). +This has lower priority than using the directive parameters. +<list type="bullet" compact="no"> + +<listitem> +The “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” -extension of the <header>Cache-Control</header> response header field (1.11.10) -for a specified number of seconds after the response became stale, -however, this has lower priority than using the directive parameter. +extension of the <header>Cache-Control</header> header field permits +using a stale cached response if it is currently being updated. +</listitem> + +<listitem> +The +“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” +extension of the <header>Cache-Control</header> header field permits +using a stale cached response in case of an error. +</listitem> + +</list> </para> <para>
--- a/xml/en/docs/http/ngx_http_scgi_module.xml Fri Feb 17 17:58:53 2017 +0300 +++ b/xml/en/docs/http/ngx_http_scgi_module.xml Tue Feb 21 21:23:53 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="31"> + rev="32"> <section id="summary"> @@ -622,11 +622,6 @@ The <literal>error</literal> parameter also permits using a stale cached response if an SCGI server to process a request cannot be selected. -The same behavior can be enabled with the -“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” -extension of the <header>Cache-Control</header> response header field (1.11.10) -for a specified number of seconds after the response became stale, -however, this has lower priority than using the directive parameter. </para> <para id="scgi_cache_use_stale_updating"> @@ -634,11 +629,30 @@ using a stale cached response if it is currently being updated. This allows minimizing the number of accesses to SCGI servers when updating cached data. -The same behavior can be enabled with the +</para> + +<para> +Using a stale cached response +can also be enabled directly in the response header +for a specified number of seconds after the response became stale (1.11.10). +This has lower priority than using the directive parameters. +<list type="bullet" compact="no"> + +<listitem> +The “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” -extension of the <header>Cache-Control</header> response header field (1.11.10) -for a specified number of seconds after the response became stale, -however, this has lower priority than using the directive parameter. +extension of the <header>Cache-Control</header> header field permits +using a stale cached response if it is currently being updated. +</listitem> + +<listitem> +The +“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” +extension of the <header>Cache-Control</header> header field permits +using a stale cached response in case of an error. +</listitem> + +</list> </para> <para>
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml Fri Feb 17 17:58:53 2017 +0300 +++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml Tue Feb 21 21:23:53 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="34"> + rev="35"> <section id="summary"> @@ -622,11 +622,6 @@ The <literal>error</literal> parameter also permits using a stale cached response if a uwsgi server to process a request cannot be selected. -The same behavior can be enabled with the -“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” -extension of the <header>Cache-Control</header> response header field (1.11.10) -for a specified number of seconds after the response became stale, -however, this has lower priority than using the directive parameter. </para> <para id="uwsgi_cache_use_stale_updating"> @@ -634,11 +629,30 @@ using a stale cached response if it is currently being updated. This allows minimizing the number of accesses to uwsgi servers when updating cached data. -The same behavior can be enabled with the +</para> + +<para> +Using a stale cached response +can also be enabled directly in the response header +for a specified number of seconds after the response became stale (1.11.10). +This has lower priority than using the directive parameters. +<list type="bullet" compact="no"> + +<listitem> +The “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” -extension of the <header>Cache-Control</header> response header field (1.11.10) -for a specified number of seconds after the response became stale, -however, this has lower priority than using the directive parameter. +extension of the <header>Cache-Control</header> header field permits +using a stale cached response if it is currently being updated. +</listitem> + +<listitem> +The +“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” +extension of the <header>Cache-Control</header> header field permits +using a stale cached response in case of an error. +</listitem> + +</list> </para> <para>
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml Fri Feb 17 17:58:53 2017 +0300 +++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml Tue Feb 21 21:23:53 2017 +0300 @@ -10,7 +10,7 @@ <module name="Модуль ngx_http_fastcgi_module" link="/ru/docs/http/ngx_http_fastcgi_module.html" lang="ru" - rev="42"> + rev="43"> <section id="summary"> @@ -629,11 +629,6 @@ Параметр <literal>error</literal> также позволяет использовать устаревший закэшированный ответ при невозможности выбора FastCGI-сервера для обработки запроса. -Подобное поведение может быть также задано при помощи расширения -“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” -поля <header>Cache-Control</header> заголовка ответа (1.11.10) -на определённое количество секунд после того, как ответ стал устаревшим, -но такой способ имеет меньший приоритет, чем задание параметра директивы. </para> <para id="fastcgi_cache_use_stale_updating"> @@ -642,11 +637,31 @@ если на данный момент он уже обновляется. Это позволяет минимизировать число обращений к FastCGI-серверам при обновлении закэшированных данных. -Подобное поведение может быть также задано при помощи расширения +</para> + +<para> +Использование устаревшего закэшированного ответа +может также быть разрешено непосредственно в заголовке ответа +на определённое количество секунд после того, как ответ устарел (1.11.10). +Такой способ менее приоритетен, чем задание параметров директивы. +<list type="bullet" compact="no"> + +<listitem> +Расширение “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” -поля <header>Cache-Control</header> заголовка ответа (1.11.10) -на определённое количество секунд после того, как ответ стал устаревшим, -но такой способ имеет меньший приоритет, чем задание параметра директивы. +поля заголовка <header>Cache-Control</header> разрешает +использовать устаревший закэшированный ответ, +если на данный момент он уже обновляется. +</listitem> + +<listitem> +Расширение +“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” +поля заголовка <header>Cache-Control</header> разрешает +использовать устаревший закэшированный ответ в случае ошибки. +</listitem> + +</list> </para> <para>
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml Fri Feb 17 17:58:53 2017 +0300 +++ b/xml/ru/docs/http/ngx_http_proxy_module.xml Tue Feb 21 21:23:53 2017 +0300 @@ -10,7 +10,7 @@ <module name="Модуль ngx_http_proxy_module" link="/ru/docs/http/ngx_http_proxy_module.html" lang="ru" - rev="56"> + rev="57"> <section id="summary"> @@ -649,11 +649,6 @@ Параметр <literal>error</literal> также позволяет использовать устаревший закэшированный ответ при невозможности выбора проксированного сервера для обработки запроса. -Подобное поведение может быть также задано при помощи расширения -“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” -поля <header>Cache-Control</header> заголовка ответа (1.11.10) -на определённое количество секунд после того, как ответ стал устаревшим, -но такой способ имеет меньший приоритет, чем задание параметра директивы. </para> <para id="proxy_cache_use_stale_updating"> @@ -662,11 +657,31 @@ если на данный момент он уже обновляется. Это позволяет минимизировать число обращений к проксированным серверам при обновлении закэшированных данных. -Подобное поведение может быть также задано при помощи расширения +</para> + +<para> +Использование устаревшего закэшированного ответа +может также быть разрешено непосредственно в заголовке ответа +на определённое количество секунд после того, как ответ устарел (1.11.10). +Такой способ менее приоритетен, чем задание параметров директивы. +<list type="bullet" compact="no"> + +<listitem> +Расширение “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” -поля <header>Cache-Control</header> заголовка ответа (1.11.10) -на определённое количество секунд после того, как ответ стал устаревшим, -но такой способ имеет меньший приоритет, чем задание параметра директивы. +поля заголовка <header>Cache-Control</header> разрешает +использовать устаревший закэшированный ответ, +если на данный момент он уже обновляется. +</listitem> + +<listitem> +Расширение +“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” +поля заголовка <header>Cache-Control</header> разрешает +использовать устаревший закэшированный ответ в случае ошибки. +</listitem> + +</list> </para> <para>
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml Fri Feb 17 17:58:53 2017 +0300 +++ b/xml/ru/docs/http/ngx_http_scgi_module.xml Tue Feb 21 21:23:53 2017 +0300 @@ -10,7 +10,7 @@ <module name="Модуль ngx_http_scgi_module" link="/ru/docs/http/ngx_http_scgi_module.html" lang="ru" - rev="31"> + rev="32"> <section id="summary"> @@ -620,11 +620,6 @@ Параметр <literal>error</literal> также позволяет использовать устаревший закэшированный ответ при невозможности выбора SCGI-сервера для обработки запроса. -Подобное поведение может быть также задано при помощи расширения -“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” -поля <header>Cache-Control</header> заголовка ответа (1.11.10) -на определённое количество секунд после того, как ответ стал устаревшим, -но такой способ имеет меньший приоритет, чем задание параметра директивы. </para> <para id="scgi_cache_use_stale_updating"> @@ -633,11 +628,31 @@ если на данный момент он уже обновляется. Это позволяет минимизировать число обращений к SCGI-серверам при обновлении закэшированных данных. -Подобное поведение может быть также задано при помощи расширения +</para> + +<para> +Использование устаревшего закэшированного ответа +может также быть разрешено непосредственно в заголовке ответа +на определённое количество секунд после того, как ответ устарел (1.11.10). +Такой способ менее приоритетен, чем задание параметров директивы. +<list type="bullet" compact="no"> + +<listitem> +Расширение “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” -поля <header>Cache-Control</header> заголовка ответа (1.11.10) -на определённое количество секунд после того, как ответ стал устаревшим, -но такой способ имеет меньший приоритет, чем задание параметра директивы. +поля заголовка <header>Cache-Control</header> разрешает +использовать устаревший закэшированный ответ, +если на данный момент он уже обновляется. +</listitem> + +<listitem> +Расширение +“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” +поля заголовка <header>Cache-Control</header> разрешает +использовать устаревший закэшированный ответ в случае ошибки. +</listitem> + +</list> </para> <para>
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml Fri Feb 17 17:58:53 2017 +0300 +++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml Tue Feb 21 21:23:53 2017 +0300 @@ -10,7 +10,7 @@ <module name="Модуль ngx_http_uwsgi_module" link="/ru/docs/http/ngx_http_uwsgi_module.html" lang="ru" - rev="34"> + rev="35"> <section id="summary"> @@ -619,11 +619,6 @@ Параметр <literal>error</literal> также позволяет использовать устаревший закэшированный ответ при невозможности выбора uwsgi-сервера для обработки запроса. -Подобное поведение может быть также задано при помощи расширения -“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” -поля <header>Cache-Control</header> заголовка ответа (1.11.10) -на определённое количество секунд после того, как ответ стал устаревшим, -но такой способ имеет меньший приоритет, чем задание параметра директивы. </para> <para id="uwsgi_cache_use_stale_updating"> @@ -632,11 +627,31 @@ если на данный момент он уже обновляется. Это позволяет минимизировать число обращений к uwsgi-серверам при обновлении закэшированных данных. -Подобное поведение может быть также задано при помощи расширения +</para> + +<para> +Использование устаревшего закэшированного ответа +может также быть разрешено непосредственно в заголовке ответа +на определённое количество секунд после того, как ответ устарел (1.11.10). +Такой способ менее приоритетен, чем задание параметров директивы. +<list type="bullet" compact="no"> + +<listitem> +Расширение “<link url="https://tools.ietf.org/html/rfc5861#section-3">stale-while-revalidate</link>” -поля <header>Cache-Control</header> заголовка ответа (1.11.10) -на определённое количество секунд после того, как ответ стал устаревшим, -но такой способ имеет меньший приоритет, чем задание параметра директивы. +поля заголовка <header>Cache-Control</header> разрешает +использовать устаревший закэшированный ответ, +если на данный момент он уже обновляется. +</listitem> + +<listitem> +Расширение +“<link url="https://tools.ietf.org/html/rfc5861#section-4">stale-if-error</link>” +поля заголовка <header>Cache-Control</header> разрешает +использовать устаревший закэшированный ответ в случае ошибки. +</listitem> + +</list> </para> <para>