Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_referer_module.xml @ 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 | 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 |