Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_map_module.xml @ 346:e5bf97f56d72

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Revision.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 23 Jan 2012 16:40:41 +0000
parents 4c6d2c614d2c
children aef88cb1d75c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
bfe3eff81d04 Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents: 110
diff changeset
1 <?xml version="1.0"?>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
4
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
5 <module name="Модуль ngx_http_map_module"
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
6 link="/ru/docs/http/ngx_http_map_module.html"
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
7 lang="ru">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
8
110
40eec261c2a6 Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents: 108
diff changeset
9 <section id="summary">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
10
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
11 <para>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
12 Модуль <literal>ngx_http_map_module</literal> создаёт переменные,
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
13 значения которых зависят от значений других переменных.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
14 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
15
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
16 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
18
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
19 <section id="example" name="Пример конфигурации">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
20
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
21 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
22 <example>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
23 map $http_host $name {
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
24 hostnames;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
25
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
26 default 0;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
27
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
28 example.com 1;
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
29 *.example.com 1;
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
30 test.com 2;
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
31 *.test.com 2;
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
32 .site.com 3;
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
33 wap.* 4;
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
34 }
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
35 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
36 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
37
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
38 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
39
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
40
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
41 <section id="directives" name="Директивы">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
42
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43 <directive name="map">
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
44 <syntax block="yes">
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
45 <value>$переменная1</value>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
46 <value>$переменная2</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
47 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
48 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
49
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
50 <para>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
51 Создаёт переменную, значение которой
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
52 зависит от значения исходной переменной.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
53 Директива поддерживает три специальных параметра:
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
54 <list type="tag">
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
55 <tag-name><literal>default</literal> <value>значение</value></tag-name>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
56 <tag-desc>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
57 задаёт значение для второй переменной, если значение
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
58 первой переменной не найдено.
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
59 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
60
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
61 <tag-name><literal>hostnames</literal></tag-name>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
62 <tag-desc>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
63 указывает, что в качестве исходных значений можно
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
64 использовать маску для первой или последней части имени хоста, например,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
65 <example>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
66 *.example.com 1;
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
67 example.* 1;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
68 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
69 Вместо двух записей
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
70 <example>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
71 example.com 1;
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
72 *.example.com 1;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
73 </example>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
74 можно использовать одну:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
75 <example>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
76 .example.com 1;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
77 </example>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
78 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
79
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
80 <tag-name><literal>include</literal> <value>файл</value></tag-name>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
81 <tag-desc>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
82 включает файл со значениями.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
83 Включений может быть несколько.
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
84 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
85
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
86 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
87 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
88
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
89 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
90
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
91
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
92 <directive name="map_hash_bucket_size">
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
93 <syntax><value>размер</value></syntax>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
94 <default>32|64|128</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
95 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
96
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
97 <para>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
98 Задаёт размер корзины в хэш-таблицах для переменных <link id="map"/>.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
99 Значение по умолчанию зависит от размера строки кэша процессора.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
100 Подробнее смотрите в документе по
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
101 <link doc="../hash.xml">настройке хэшей</link>.
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
102 </para>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
103
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
104 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
105
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
106
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
107 <directive name="map_hash_max_size">
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
108 <syntax><value>размер</value></syntax>
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
109 <default>2048</default>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
110 <context>http</context>
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 76
diff changeset
111
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
112 <para>
346
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
113 Задаёт максимальный размер хэш-таблиц для переменных <link id="map"/>.
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
114 Подробнее смотрите в документе по
e5bf97f56d72 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
115 <link doc="../hash.xml">настройке хэшей</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
116 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
117
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
118 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
119
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
120 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
121
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
122 </module>