Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_referer_module.xml @ 501:3878cc99d454

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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 9913f1d51c07
children be54c443235a
comparison
equal deleted inserted replaced
500:9b440a217907 501:3878cc99d454
41 </section> 41 </section>
42 42
43 43
44 <section id="directives" name="Директивы"> 44 <section id="directives" name="Директивы">
45 45
46 <directive name="referer_hash_bucket_size">
47 <syntax><value>размер</value></syntax>
48 <default>64</default>
49 <context>server</context>
50 <context>location</context>
51 <appeared-in>1.0.5</appeared-in>
52
53 <para>
54 Задаёт размер корзины хэш-таблиц со значениями <header>Referer</header>.
55 Подробнее смотрите в документе по
56 <link doc="../hash.xml">настройке хэшей</link>.
57 </para>
58
59 </directive>
60
61
62 <directive name="referer_hash_max_size">
63 <syntax><value>размер</value></syntax>
64 <default>2048</default>
65 <context>server</context>
66 <context>location</context>
67 <appeared-in>1.0.5</appeared-in>
68
69 <para>
70 Задаёт максимальный <value>размер</value> хэш-таблиц со значениями
71 <header>Referer</header>.
72 Подробнее смотрите в документе по
73 <link doc="../hash.xml">настройке хэшей</link>.
74 </para>
75
76 </directive>
77
78
46 <directive name="valid_referers"> 79 <directive name="valid_referers">
47 <syntax> 80 <syntax>
48 <literal>none</literal> | 81 <literal>none</literal> |
49 <literal>blocked</literal> | 82 <literal>blocked</literal> |
50 <literal>server_names</literal> | 83 <literal>server_names</literal> |
55 <context>location</context> 88 <context>location</context>
56 89
57 <para> 90 <para>
58 Задаёт значения поля <header>Referer</header> заголовка запроса, при 91 Задаёт значения поля <header>Referer</header> заголовка запроса, при
59 которых встроенная переменная <var>$invalid_referer</var> будет иметь 92 которых встроенная переменная <var>$invalid_referer</var> будет иметь
60 значение 0. 93 пустую строку в качестве значения.
94 В противном случае значение переменной равно “<literal>1</literal>”.
95 Поиск совпадения производится без учёта регистра символов.
61 </para> 96 </para>
62 97
63 <para> 98 <para>
64 Параметры могут быть следующие: 99 Параметры могут быть следующие:
65 <list type="tag"> 100 <list type="tag">
72 <tag-name><literal>blocked</literal></tag-name> 107 <tag-name><literal>blocked</literal></tag-name>
73 <tag-desc> 108 <tag-desc>
74 поле <header>Referer</header> в заголовке запроса присутствует, 109 поле <header>Referer</header> в заголовке запроса присутствует,
75 но его значение удалено межсетевым экраном (firewall) или прокси-сервером; 110 но его значение удалено межсетевым экраном (firewall) или прокси-сервером;
76 к таким значениям относятся строки, не начинающиеся на 111 к таким значениям относятся строки, не начинающиеся на
77 “<literal>http://</literal>”; 112 “<literal>http://</literal>” или “<literal>https://</literal>”;
78 </tag-desc> 113 </tag-desc>
79 114
80 <tag-name><literal>server_names</literal></tag-name> 115 <tag-name><literal>server_names</literal></tag-name>
81 <tag-desc> 116 <tag-desc>
82 в поле <header>Referer</header> заголовка запроса указано одно 117 в поле <header>Referer</header> заголовка запроса указано одно
92 127
93 <tag-name>регулярное выражение</tag-name> 128 <tag-name>регулярное выражение</tag-name>
94 <tag-desc> 129 <tag-desc>
95 в начале должен быть символ “<literal>~</literal>”. 130 в начале должен быть символ “<literal>~</literal>”.
96 Необходимо учитывать, что на совпадение с выражением будет проверяться 131 Необходимо учитывать, что на совпадение с выражением будет проверяться
97 текст, начинающийся после “<literal>http://</literal>”. 132 текст, начинающийся после “<literal>http://</literal>”
133 или “<literal>https://</literal>”.
98 </tag-desc> 134 </tag-desc>
99 135
100 </list> 136 </list>
101 </para> 137 </para>
102 138