Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_map_module.xml @ 572:17ceffcc7ffb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Brought the ngx_http_map_module documentation up to date.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 05 Jul 2012 13:15:08 +0000
parents 9913f1d51c07
children be54c443235a
comparison
equal deleted inserted replaced
571:71d775bef043 572:17ceffcc7ffb
30 example.org 2; 30 example.org 2;
31 *.example.org 2; 31 *.example.org 2;
32 .example.net 3; 32 .example.net 3;
33 wap.* 4; 33 wap.* 4;
34 } 34 }
35
36 map $http_user_agent $mobile {
37 default 0;
38 "~Opera Mini" 1;
39 }
35 </example> 40 </example>
36 </para> 41 </para>
37 42
38 </section> 43 </section>
39 44
40 45
41 <section id="directives" name="Директивы"> 46 <section id="directives" name="Директивы">
42 47
43 <directive name="map"> 48 <directive name="map">
44 <syntax block="yes"> 49 <syntax block="yes">
45 <value>$переменная1</value> 50 <value>строка</value>
46 <value>$переменная2</value></syntax> 51 <value>$переменная</value></syntax>
47 <default/> 52 <default/>
48 <context>http</context> 53 <context>http</context>
49 54
50 <para> 55 <para>
51 Создаёт переменную, значение которой 56 Создаёт новую переменную, значение которой
52 зависит от значения исходной переменной. 57 зависит от значений одной или более исходных переменных,
53 Директива поддерживает три специальных параметра: 58 указанных в первом параметре.
59 <note>
60 До версии 0.9.0 в качестве первого параметра можно было
61 указать только одну переменную.
62 </note>
63 </para>
64
65 <para>
66 Параметры внутри блока <literal>map</literal> задают соответствие
67 между исходными и результирующими значениями.
68 </para>
69
70 <para>
71 Исходные значения задаются строками или регулярными выражениями (0.9.6).
72 </para>
73
74 <para>
75 Перед регулярным выражением ставится символ “<literal>~</literal>”,
76 если при сравнении следует учитывать регистр символов, либо символы
77 “<literal>~*</literal>” (1.0.4), если регистр символов учитывать не нужно.
78 Регулярное выражение может содержать именованные и позиционные выделения,
79 которые могут затем использоваться в других директивах совместно с
80 результирующей переменной.
81 </para>
82
83 <para>
84 Если исходное значение совпадает с именем одного из специальных параметров
85 (см. ниже), перед ним следует поставить символ “<literal>\</literal>”.
86 </para>
87
88 <para>
89 В качестве результирующего значения можно указать строку
90 или другую переменную (0.9.0).
91 </para>
92
93 <para>
94 Директива также поддерживает три специальных параметра:
54 <list type="tag"> 95 <list type="tag">
55 <tag-name><literal>default</literal> <value>значение</value></tag-name> 96 <tag-name><literal>default</literal> <value>значение</value></tag-name>
56 <tag-desc> 97 <tag-desc>
57 задаёт значение для второй переменной, если значение 98 задаёт результирующее значение, если исходное значение не
58 первой переменной не найдено. 99 совпадает ни с одним из перечисленных.
100 Если параметр <literal>default</literal> не указан, результирующим значением
101 по умолчанию будет пустая строка.
59 </tag-desc> 102 </tag-desc>
60 103
61 <tag-name><literal>hostnames</literal></tag-name> 104 <tag-name><literal>hostnames</literal></tag-name>
62 <tag-desc> 105 <tag-desc>
63 указывает, что в качестве исходных значений можно 106 указывает, что в качестве исходных значений можно
73 </example> 116 </example>
74 можно использовать одну: 117 можно использовать одну:
75 <example> 118 <example>
76 .example.com 1; 119 .example.com 1;
77 </example> 120 </example>
121 Этот параметр следует указывать перед списком значений.
78 </tag-desc> 122 </tag-desc>
79 123
80 <tag-name><literal>include</literal> <value>файл</value></tag-name> 124 <tag-name><literal>include</literal> <value>файл</value></tag-name>
81 <tag-desc> 125 <tag-desc>
82 включает файл со значениями. 126 включает файл со значениями.
83 Включений может быть несколько. 127 Включений может быть несколько.
84 </tag-desc> 128 </tag-desc>
129
130 </list>
131 </para>
132
133 <para>
134 Если исходному значению соответствует несколько из указанных вариантов,
135 например, одновременно подходят и маска, и регулярное выражение,
136 будет выбран первый подходящий вариант в следующем порядке приоритета:
137 <list type="enum">
138
139 <listitem>
140 строковое значение без маски
141 </listitem>
142
143 <listitem>
144 самое длинное строковое значение с маской в начале,
145 например “<literal>*.example.com</literal>”
146 </listitem>
147
148 <listitem>
149 самое длинное строковое значение с маской в конце,
150 например “<literal>mail.*</literal>”
151 </listitem>
152
153 <listitem>
154 первое подходящее регулярное выражение
155 (в порядке следования в конфигурационном файле)
156 </listitem>
157
158 <listitem>
159 значение по умолчанию (<literal>default</literal>)
160 </listitem>
85 161
86 </list> 162 </list>
87 </para> 163 </para>
88 164
89 </directive> 165 </directive>