changeset 504:695f83494c19

Emphasized on what the "updating" parameter of the "proxy_cache_use_stale" directive achieves. Referenced the "proxy_cache_lock" directive from there, which has similar effect when populating a new cache element.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 24 Apr 2012 06:54:47 +0000
parents aed015c3dedd
children 837bcf62b628
files xml/en/docs/http/ngx_http_proxy_module.xml xml/ru/docs/http/ngx_http_proxy_module.xml
diffstat 2 files changed, 22 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_proxy_module.xml	Tue Apr 24 06:35:12 2012 +0000
+++ b/xml/en/docs/http/ngx_http_proxy_module.xml	Tue Apr 24 06:54:47 2012 +0000
@@ -314,8 +314,19 @@
 This directives determines in which cases it is permitted.
 The directive’s parameters match those of the
 <link id="proxy_next_upstream"/> directive.
+</para>
+
+<para>
 Additionally, the <literal>updating</literal> parameter permits
 to use a stale cached response if it is currently being updated.
+This allows to minimize the number of accesses to proxied servers
+when updating cached data.
+</para>
+
+<para>
+To minimize the number of accesses to proxied servers when
+populating a new cache element, the <link id="proxy_cache_lock"/>
+directive can be used.
 </para>
 
 </directive>
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml	Tue Apr 24 06:35:12 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml	Tue Apr 24 06:54:47 2012 +0000
@@ -312,9 +312,20 @@
 сервером возникла ошибка.
 Параметры директивы совпадают с параметрами
 директивы <link id="proxy_next_upstream"/>.
+</para>
+
+<para>
 Кроме того, дополнительный параметр <literal>updating</literal>
 разрешает использовать устаревший закэшированный ответ,
 если на данный момент он уже обновляется.
+Это позволяет минимизировать число обращений к проксированным серверам
+при обновлении закэшированных данных.
+</para>
+
+<para>
+Чтобы минимизировать число обращений к проксированным серверам при
+заполнении нового элемента кэша, можно воспользоваться директивой
+<link id="proxy_cache_lock"/>.
 </para>
 
 </directive>