Mercurial > hg > nginx-site
changeset 3092:ca4c8ac67c0e
Documented Age header handling.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Wed, 31 Jul 2024 18:33:11 +0300 |
parents | 6cab598f14a1 |
children | a52c1f1493bf |
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_upstream_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_upstream_module.xml xml/ru/docs/http/ngx_http_uwsgi_module.xml |
diffstat | 10 files changed, 94 insertions(+), 34 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="54"> + rev="55"> <section id="summary"> @@ -649,6 +649,12 @@ with another value, such a response will taking into account the corresponding request header fields (1.7.7). </listitem> +<listitem> +If the header includes the <header>Age</header> field +and caching time is set with the <header>Cache-Control</header> field, +caching time is reduced accordingly (1.27.3). +</listitem> + </list> Processing of one or more of these response header fields can be disabled using the <link id="fastcgi_ignore_headers"/> directive. @@ -766,7 +772,7 @@ The following fields can be ignored: <he <header>X-Accel-Buffering</header> (1.1.6), <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, <header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44), -and <header>Vary</header> (1.7.7). +<header>Vary</header> (1.7.7), and <header>Age</header> (1.27.3). </para> <para> @@ -777,7 +783,7 @@ effect: <listitem> <header>X-Accel-Expires</header>, <header>Expires</header>, <header>Cache-Control</header>, <header>Set-Cookie</header>, -and <header>Vary</header> +<header>Vary</header>, and <header>Age</header> set the parameters of response <link id="fastcgi_cache_valid">caching</link>; </listitem>
--- 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="77"> + rev="78"> <section id="summary"> @@ -667,6 +667,12 @@ with another value, such a response will taking into account the corresponding request header fields (1.7.7). </listitem> +<listitem> +If the header includes the <header>Age</header> field +and caching time is set with the <header>Cache-Control</header> field, +caching time is reduced accordingly (1.27.3). +</listitem> + </list> Processing of one or more of these response header fields can be disabled using the <link id="proxy_ignore_headers"/> directive. @@ -1011,7 +1017,7 @@ The following fields can be ignored: <he <header>X-Accel-Buffering</header> (1.1.6), <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, <header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44), -and <header>Vary</header> (1.7.7). +<header>Vary</header> (1.7.7), and <header>Age</header> (1.27.3). </para> <para> @@ -1022,7 +1028,7 @@ effect: <listitem> <header>X-Accel-Expires</header>, <header>Expires</header>, <header>Cache-Control</header>, <header>Set-Cookie</header>, -and <header>Vary</header> +<header>Vary</header>, and <header>Age</header> set the parameters of response <link id="proxy_cache_valid">caching</link>; </listitem>
--- 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="42"> + rev="43"> <section id="summary"> @@ -640,6 +640,12 @@ with another value, such a response will taking into account the corresponding request header fields (1.7.7). </listitem> +<listitem> +If the header includes the <header>Age</header> field +and caching time is set with the <header>Cache-Control</header> field, +caching time is reduced accordingly (1.27.3). +</listitem> + </list> Processing of one or more of these response header fields can be disabled using the <link id="scgi_ignore_headers"/> directive. @@ -731,7 +737,7 @@ The following fields can be ignored: <he <header>X-Accel-Buffering</header> (1.1.6), <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, <header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44), -and <header>Vary</header> (1.7.7). +<header>Vary</header> (1.7.7), and <header>Age</header> (1.27.3). </para> <para> @@ -742,7 +748,7 @@ effect: <listitem> <header>X-Accel-Expires</header>, <header>Expires</header>, <header>Cache-Control</header>, <header>Set-Cookie</header>, -and <header>Vary</header> +<header>Vary</header>, and <header>Age</header> set the parameters of response <link id="scgi_cache_valid">caching</link>; </listitem>
--- a/xml/en/docs/http/ngx_http_upstream_module.xml +++ b/xml/en/docs/http/ngx_http_upstream_module.xml @@ -10,7 +10,7 @@ <module name="Module ngx_http_upstream_module" link="/en/docs/http/ngx_http_upstream_module.html" lang="en" - rev="90"> + rev="91"> <section id="summary"> @@ -574,6 +574,12 @@ are separated by commas and colons like <link id="var_upstream_addr">$upstream_addr</link> variable. </tag-desc> +<tag-name id="var_upstream_cache_age"><var>$upstream_cache_age</var> +</tag-name> +<tag-desc> +age of the cache item (1.27.3). +</tag-desc> + <tag-name id="var_upstream_cache_key"><var>$upstream_cache_key</var> </tag-name> <tag-desc>
--- 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="51"> + rev="52"> <section id="summary"> @@ -640,6 +640,12 @@ with another value, such a response will taking into account the corresponding request header fields (1.7.7). </listitem> +<listitem> +If the header includes the <header>Age</header> field +and caching time is set with the <header>Cache-Control</header> field, +caching time is reduced accordingly (1.27.3). +</listitem> + </list> Processing of one or more of these response header fields can be disabled using the <link id="uwsgi_ignore_headers"/> directive. @@ -731,7 +737,7 @@ The following fields can be ignored: <he <header>X-Accel-Buffering</header> (1.1.6), <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, <header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44), -and <header>Vary</header> (1.7.7). +<header>Vary</header> (1.7.7), and <header>Age</header> (1.27.3). </para> <para> @@ -742,7 +748,7 @@ effect: <listitem> <header>X-Accel-Expires</header>, <header>Expires</header>, <header>Cache-Control</header>, <header>Set-Cookie</header>, -and <header>Vary</header> +<header>Vary</header>, and <header>Age</header> set the parameters of response <link id="uwsgi_cache_valid">caching</link>; </listitem>
--- 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="54"> + rev="55"> <section id="summary"> @@ -649,6 +649,12 @@ fastcgi_cache_valid any 1m; с учётом соответствующих полей заголовка запроса (1.7.7). </listitem> +<listitem> +Если в заголовке ответа есть поле <header>Age</header> +и время кэширования определяется по полю <header>Cache-Control</header>, +время кэширования будет соответственно уменьшено (1.27.3). +</listitem> + </list> Обработка одного или более из этих полей заголовка может быть отключена при помощи директивы <link id="fastcgi_ignore_headers"/>. @@ -764,8 +770,8 @@ nginx не передаёт клиенту поля заголовка <header>Status</header> и <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6), <header>X-Accel-Buffering</header> (1.1.6), <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, -<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44) -и <header>Vary</header> (1.7.7). +<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44), +<header>Vary</header> (1.7.7) и <header>Age</header> (1.27.3). </para> <para> @@ -774,8 +780,8 @@ nginx не передаёт клиенту поля заголовка <header>Status</header> и <listitem> <header>X-Accel-Expires</header>, <header>Expires</header>, -<header>Cache-Control</header>, <header>Set-Cookie</header> -и <header>Vary</header> +<header>Cache-Control</header>, <header>Set-Cookie</header>, +<header>Vary</header> и <header>Age</header> задают параметры <link id="fastcgi_cache_valid">кэширования</link> ответа; </listitem>
--- 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="77"> + rev="78"> <section id="summary"> @@ -669,6 +669,12 @@ proxy_cache_valid any 1m; с учётом соответствующих полей заголовка запроса (1.7.7). </listitem> +<listitem> +Если в заголовке ответа есть поле <header>Age</header> +и время кэширования определяется по полю <header>Cache-Control</header>, +время кэширования будет соответственно уменьшено (1.27.3). +</listitem> + </list> Обработка одного или более из этих полей заголовка может быть отключена при помощи директивы <link id="proxy_ignore_headers"/>. @@ -1010,8 +1016,8 @@ NTLM</link> рекомендуется версия 1.1. <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6), <header>X-Accel-Buffering</header> (1.1.6), <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, -<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44) -и <header>Vary</header> (1.7.7). +<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44), +<header>Vary</header> (1.7.7) и <header>Age</header> (1.27.3). </para> <para> @@ -1020,8 +1026,8 @@ NTLM</link> рекомендуется версия 1.1. <listitem> <header>X-Accel-Expires</header>, <header>Expires</header>, -<header>Cache-Control</header>, <header>Set-Cookie</header> -и <header>Vary</header> +<header>Cache-Control</header>, <header>Set-Cookie</header>, +<header>Vary</header> и <header>Age</header> задают параметры <link id="proxy_cache_valid">кэширования</link> ответа; </listitem>
--- 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="42"> + rev="43"> <section id="summary"> @@ -640,6 +640,12 @@ scgi_cache_valid any 1m; с учётом соответствующих полей заголовка запроса (1.7.7). </listitem> +<listitem> +Если в заголовке ответа есть поле <header>Age</header> +и время кэширования определяется по полю <header>Cache-Control</header>, +время кэширования будет соответственно уменьшено (1.27.3). +</listitem> + </list> Обработка одного или более из этих полей заголовка может быть отключена при помощи директивы <link id="scgi_ignore_headers"/>. @@ -729,8 +735,8 @@ nginx не передаёт клиенту поля заголовка <header>Status</header> и <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6), <header>X-Accel-Buffering</header> (1.1.6), <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, -<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44) -и <header>Vary</header> (1.7.7). +<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44), +<header>Vary</header> (1.7.7) и <header>Age</header> (1.27.3). </para> <para> @@ -739,8 +745,8 @@ nginx не передаёт клиенту поля заголовка <header>Status</header> и <listitem> <header>X-Accel-Expires</header>, <header>Expires</header>, -<header>Cache-Control</header>, <header>Set-Cookie</header> -и <header>Vary</header> +<header>Cache-Control</header>, <header>Set-Cookie</header>, +<header>Vary</header> и <header>Age</header> задают параметры <link id="scgi_cache_valid">кэширования</link> ответа; </listitem>
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml +++ b/xml/ru/docs/http/ngx_http_upstream_module.xml @@ -10,7 +10,7 @@ <module name="Модуль ngx_http_upstream_module" link="/ru/docs/http/ngx_http_upstream_module.html" lang="ru" - rev="90"> + rev="91"> <section id="summary"> @@ -581,6 +581,12 @@ server { <link id="var_upstream_addr">$upstream_addr</link>. </tag-desc> +<tag-name id="var_upstream_cache_age"><var>$upstream_cache_age</var> +</tag-name> +<tag-desc> +возраст элемента кэша (1.27.3). +</tag-desc> + <tag-name id="var_upstream_cache_key"><var>$upstream_cache_key</var> </tag-name> <tag-desc>
--- 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="51"> + rev="52"> <section id="summary"> @@ -639,6 +639,12 @@ uwsgi_cache_valid any 1m; с учётом соответствующих полей заголовка запроса (1.7.7). </listitem> +<listitem> +Если в заголовке ответа есть поле <header>Age</header> +и время кэширования определяется по полю <header>Cache-Control</header>, +время кэширования будет соответственно уменьшено (1.27.3). +</listitem> + </list> Обработка одного или более из этих полей заголовка может быть отключена при помощи директивы <link id="uwsgi_ignore_headers"/>. @@ -728,8 +734,8 @@ nginx не передаёт клиенту поля заголовка <header>Status</header> и <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6), <header>X-Accel-Buffering</header> (1.1.6), <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>, -<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44) -и <header>Vary</header> (1.7.7). +<header>Cache-Control</header>, <header>Set-Cookie</header> (0.8.44), +<header>Vary</header> (1.7.7) и <header>Age</header> (1.27.3). </para> <para> @@ -738,8 +744,8 @@ nginx не передаёт клиенту поля заголовка <header>Status</header> и <listitem> <header>X-Accel-Expires</header>, <header>Expires</header>, -<header>Cache-Control</header>, <header>Set-Cookie</header> -и <header>Vary</header> +<header>Cache-Control</header>, <header>Set-Cookie</header>, +<header>Vary</header> и <header>Age</header> задают параметры <link id="uwsgi_cache_valid">кэширования</link> ответа; </listitem>