changeset 1353:25db29c8875e

Documented how the "Vary" response header field affects caching.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 14 Nov 2014 10:40:00 +0300
parents dbb618f60a54
children 53c4430f54c5
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, 80 insertions(+), 8 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_fastcgi_module"
         link="/en/docs/http/ngx_http_fastcgi_module.html"
         lang="en"
-        rev="23">
+        rev="24">
 
 <section id="summary">
 
@@ -543,6 +543,15 @@ If the header includes the <header>Set-C
 response will not be cached.
 </listitem>
 
+<listitem>
+If the header includes the <header>Vary</header> field
+with the special value “<literal>*</literal>”, such a
+response will not be cached (1.7.7).
+If the header includes the <header>Vary</header> field
+with another value, such a response will be cached
+taking into account the corresponding request header fields (1.7.7).
+</listitem>
+
 </list>
 Processing of one or more of these response header fields can be disabled
 using the <link id="fastcgi_ignore_headers"/> directive.
--- a/xml/en/docs/http/ngx_http_proxy_module.xml
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_proxy_module"
         link="/en/docs/http/ngx_http_proxy_module.html"
         lang="en"
-        rev="30">
+        rev="31">
 
 <section id="summary">
 
@@ -543,6 +543,15 @@ If the header includes the <header>Set-C
 response will not be cached.
 </listitem>
 
+<listitem>
+If the header includes the <header>Vary</header> field
+with the special value “<literal>*</literal>”, such a
+response will not be cached (1.7.7).
+If the header includes the <header>Vary</header> field
+with another value, such a response will be cached
+taking into account the corresponding request header fields (1.7.7).
+</listitem>
+
 </list>
 Processing of one or more of these response header fields can be disabled
 using the <link id="proxy_ignore_headers"/> directive.
--- a/xml/en/docs/http/ngx_http_scgi_module.xml
+++ b/xml/en/docs/http/ngx_http_scgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_scgi_module"
         link="/en/docs/http/ngx_http_scgi_module.html"
         lang="en"
-        rev="11">
+        rev="12">
 
 <section id="summary">
 
@@ -534,6 +534,15 @@ If the header includes the <header>Set-C
 response will not be cached.
 </listitem>
 
+<listitem>
+If the header includes the <header>Vary</header> field
+with the special value “<literal>*</literal>”, such a
+response will not be cached (1.7.7).
+If the header includes the <header>Vary</header> field
+with another value, such a response will be cached
+taking into account the corresponding request header fields (1.7.7).
+</listitem>
+
 </list>
 Processing of one or more of these response header fields can be disabled
 using the <link id="scgi_ignore_headers"/> directive.
--- a/xml/en/docs/http/ngx_http_uwsgi_module.xml
+++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Module ngx_http_uwsgi_module"
         link="/en/docs/http/ngx_http_uwsgi_module.html"
         lang="en"
-        rev="12">
+        rev="13">
 
 <section id="summary">
 
@@ -534,6 +534,15 @@ If the header includes the <header>Set-C
 response will not be cached.
 </listitem>
 
+<listitem>
+If the header includes the <header>Vary</header> field
+with the special value “<literal>*</literal>”, such a
+response will not be cached (1.7.7).
+If the header includes the <header>Vary</header> field
+with another value, such a response will be cached
+taking into account the corresponding request header fields (1.7.7).
+</listitem>
+
 </list>
 Processing of one or more of these response header fields can be disabled
 using the <link id="uwsgi_ignore_headers"/> directive.
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_fastcgi_module"
         link="/ru/docs/http/ngx_http_fastcgi_module.html"
         lang="ru"
-        rev="23">
+        rev="24">
 
 <section id="summary">
 
@@ -542,6 +542,15 @@ fastcgi_cache_valid any      1m;
 не будет кэшироваться.
 </listitem>
 
+<listitem>
+Ответ, в заголовке которого есть поле <header>Vary</header>
+со специальным значением “<literal>*</literal>”,
+не будет кэшироваться (1.7.7).
+Ответ, в заголовке которого есть поле <header>Vary</header>
+с другим значением, будет закэширован
+с учётом соответствующих полей заголовка запроса (1.7.7).
+</listitem>
+
 </list>
 Обработка одного или более из этих полей заголовка может быть отключена
 при помощи директивы <link id="fastcgi_ignore_headers"/>.
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_proxy_module"
         link="/ru/docs/http/ngx_http_proxy_module.html"
         lang="ru"
-        rev="30">
+        rev="31">
 
 <section id="summary">
 
@@ -543,6 +543,15 @@ proxy_cache_valid any      1m;
 не будет кэшироваться.
 </listitem>
 
+<listitem>
+Ответ, в заголовке которого есть поле <header>Vary</header>
+со специальным значением “<literal>*</literal>”,
+не будет кэшироваться (1.7.7).
+Ответ, в заголовке которого есть поле <header>Vary</header>
+с другим значением, будет закэширован
+с учётом соответствующих полей заголовка запроса (1.7.7).
+</listitem>
+
 </list>
 Обработка одного или более из этих полей заголовка может быть отключена
 при помощи директивы <link id="proxy_ignore_headers"/>.
--- a/xml/ru/docs/http/ngx_http_scgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_scgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_scgi_module"
         link="/ru/docs/http/ngx_http_scgi_module.html"
         lang="ru"
-        rev="11">
+        rev="12">
 
 <section id="summary">
 
@@ -533,6 +533,15 @@ scgi_cache_valid any      1m;
 не будет кэшироваться.
 </listitem>
 
+<listitem>
+Ответ, в заголовке которого есть поле <header>Vary</header>
+со специальным значением “<literal>*</literal>”,
+не будет кэшироваться (1.7.7).
+Ответ, в заголовке которого есть поле <header>Vary</header>
+с другим значением, будет закэширован
+с учётом соответствующих полей заголовка запроса (1.7.7).
+</listitem>
+
 </list>
 Обработка одного или более из этих полей заголовка может быть отключена
 при помощи директивы <link id="scgi_ignore_headers"/>.
--- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml
+++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml
@@ -10,7 +10,7 @@
 <module name="Модуль ngx_http_uwsgi_module"
         link="/ru/docs/http/ngx_http_uwsgi_module.html"
         lang="ru"
-        rev="12">
+        rev="13">
 
 <section id="summary">
 
@@ -533,6 +533,15 @@ uwsgi_cache_valid any      1m;
 не будет кэшироваться.
 </listitem>
 
+<listitem>
+Ответ, в заголовке которого есть поле <header>Vary</header>
+со специальным значением “<literal>*</literal>”,
+не будет кэшироваться (1.7.7).
+Ответ, в заголовке которого есть поле <header>Vary</header>
+с другим значением, будет закэширован
+с учётом соответствующих полей заголовка запроса (1.7.7).
+</listitem>
+
 </list>
 Обработка одного или более из этих полей заголовка может быть отключена
 при помощи директивы <link id="uwsgi_ignore_headers"/>.