changeset 501:3878cc99d454

Bring ngx_http_referer_module docs up to date, including: - Documented directives "referer_hash_bucket_size" and "referer_hash_max_size". - Fixed "false" value of the $invalid_referer variable, documented "true" value. - Documented that search for a match of valid referers is case-insensitive.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 24 Apr 2012 06:20:31 +0000
parents 9b440a217907
children 6520338cdf0a
files xml/ru/docs/http/ngx_http_referer_module.xml
diffstat 1 files changed, 39 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_referer_module.xml	Mon Apr 23 13:38:59 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_referer_module.xml	Tue Apr 24 06:20:31 2012 +0000
@@ -43,6 +43,39 @@
 
 <section id="directives" name="Директивы">
 
+<directive name="referer_hash_bucket_size">
+<syntax><value>размер</value></syntax>
+<default>64</default>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.0.5</appeared-in>
+
+<para>
+Задаёт размер корзины хэш-таблиц со значениями <header>Referer</header>.
+Подробнее смотрите в документе по
+<link doc="../hash.xml">настройке хэшей</link>.
+</para>
+
+</directive>
+
+
+<directive name="referer_hash_max_size">
+<syntax><value>размер</value></syntax>
+<default>2048</default>
+<context>server</context>
+<context>location</context>
+<appeared-in>1.0.5</appeared-in>
+
+<para>
+Задаёт максимальный <value>размер</value> хэш-таблиц со значениями
+<header>Referer</header>.
+Подробнее смотрите в документе по
+<link doc="../hash.xml">настройке хэшей</link>.
+</para>
+
+</directive>
+
+
 <directive name="valid_referers">
 <syntax>
     <literal>none</literal> |
@@ -57,7 +90,9 @@
 <para>
 Задаёт значения поля <header>Referer</header> заголовка запроса, при
 которых встроенная переменная <var>$invalid_referer</var> будет иметь
-значение 0.
+пустую строку в качестве значения.
+В противном случае значение переменной равно “<literal>1</literal>”.
+Поиск совпадения производится без учёта регистра символов.
 </para>
 
 <para>
@@ -74,7 +109,7 @@
 поле <header>Referer</header> в заголовке запроса присутствует,
 но его значение удалено межсетевым экраном (firewall) или прокси-сервером;
 к таким значениям относятся строки, не начинающиеся на
-“<literal>http://</literal>”;
+“<literal>http://</literal>” или “<literal>https://</literal>”;
 </tag-desc>
 
 <tag-name><literal>server_names</literal></tag-name>
@@ -94,7 +129,8 @@
 <tag-desc>
 в начале должен быть символ “<literal>~</literal>”.
 Необходимо учитывать, что на совпадение с выражением будет проверяться
-текст, начинающийся после “<literal>http://</literal>”.
+текст, начинающийся после “<literal>http://</literal>”
+или “<literal>https://</literal>”.
 </tag-desc>
 
 </list>