comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 1909:399d0e188195

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="Модуль ngx_http_proxy_module" 10 <module name="Модуль ngx_http_proxy_module"
11 link="/ru/docs/http/ngx_http_proxy_module.html" 11 link="/ru/docs/http/ngx_http_proxy_module.html"
12 lang="ru" 12 lang="ru"
13 rev="54"> 13 rev="55">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 Модуль <literal>ngx_http_proxy_module</literal> позволяет передавать 18 Модуль <literal>ngx_http_proxy_module</literal> позволяет передавать
188 Задаёт зону разделяемой памяти, используемой для кэширования. 188 Задаёт зону разделяемой памяти, используемой для кэширования.
189 Одна и та же зона может использоваться в нескольких местах. 189 Одна и та же зона может использоваться в нескольких местах.
190 В значении параметра можно использовать переменные (1.7.9). 190 В значении параметра можно использовать переменные (1.7.9).
191 Параметр <literal>off</literal> запрещает кэширование, унаследованное 191 Параметр <literal>off</literal> запрещает кэширование, унаследованное
192 с предыдущего уровня конфигурации. 192 с предыдущего уровня конфигурации.
193 </para>
194
195 </directive>
196
197
198 <directive name="proxy_cache_background_update">
199 <syntax><literal>on</literal> | <literal>off</literal></syntax>
200 <default>off</default>
201 <context>http</context>
202 <context>server</context>
203 <context>location</context>
204 <appeared-in>1.11.10</appeared-in>
205
206 <para>
207 Позволяет запустить фоновый подзапрос
208 для обновления просроченного элемента кэша,
209 в то время как клиенту возвращается устаревший закэшированный ответ.
210 Использование устаревшего закэшированного ответа в момент его обновления
211 должно быть
212 <link id="proxy_cache_use_stale_updating">разрешено</link>.
193 </para> 213 </para>
194 214
195 </directive> 215 </directive>
196 216
197 217
630 Параметр <literal>error</literal> также позволяет использовать 650 Параметр <literal>error</literal> также позволяет использовать
631 устаревший закэшированный ответ при невозможности выбора 651 устаревший закэшированный ответ при невозможности выбора
632 проксированного сервера для обработки запроса. 652 проксированного сервера для обработки запроса.
633 </para> 653 </para>
634 654
635 <para> 655 <para id="proxy_cache_use_stale_updating">
636 Кроме того, дополнительный параметр <literal>updating</literal> 656 Кроме того, дополнительный параметр <literal>updating</literal>
637 разрешает использовать устаревший закэшированный ответ, 657 разрешает использовать устаревший закэшированный ответ,
638 если на данный момент он уже обновляется. 658 если на данный момент он уже обновляется.
639 Это позволяет минимизировать число обращений к проксированным серверам 659 Это позволяет минимизировать число обращений к проксированным серверам
640 при обновлении закэшированных данных. 660 при обновлении закэшированных данных.