Mercurial > hg > nginx-site
comparison xml/en/docs/http/ngx_http_map_module.xml @ 966:95c3c3bbf1ce
Text review.
author | Egor Nikitin <yegor.nikitin@gmail.com> |
---|---|
date | Wed, 14 Aug 2013 12:03:41 +0400 |
parents | 81ec181c084e |
children | 68b647a96448 |
comparison
equal
deleted
inserted
replaced
965:fadccc156188 | 966:95c3c3bbf1ce |
---|---|
68 </note> | 68 </note> |
69 </para> | 69 </para> |
70 | 70 |
71 <para> | 71 <para> |
72 <note> | 72 <note> |
73 Since variables are evaluated only when used, the mere existence | 73 Since variables are evaluated only when they are used, the mere declaration |
74 of even a large number of declared “<literal>map</literal>” variables | 74 even of a large number of “<literal>map</literal>” variables |
75 does not incur any extra costs for request processing. | 75 does not add any extra costs to request processing. |
76 </note> | 76 </note> |
77 </para> | 77 </para> |
78 | 78 |
79 <para> | 79 <para> |
80 Parameters inside the <literal>map</literal> block specify a mapping | 80 Parameters inside the <literal>map</literal> block specify a mapping |
115 resulting value will be an empty string. | 115 resulting value will be an empty string. |
116 </tag-desc> | 116 </tag-desc> |
117 | 117 |
118 <tag-name><literal>hostnames</literal></tag-name> | 118 <tag-name><literal>hostnames</literal></tag-name> |
119 <tag-desc> | 119 <tag-desc> |
120 allows to specify hostnames with a prefix or suffix mask, as source | 120 indicates that source values can be hostnames with a prefix or suffix mask: |
121 values, for example, | |
122 <example> | 121 <example> |
123 *.example.com 1; | 122 *.example.com 1; |
124 example.* 1; | 123 example.* 1; |
125 </example> | 124 </example> |
126 The following two records | 125 The following two records |
144 </list> | 143 </list> |
145 </para> | 144 </para> |
146 | 145 |
147 <para> | 146 <para> |
148 If the source value matches more than one of the specified variants, | 147 If the source value matches more than one of the specified variants, |
149 e.g. both mask and regular expression match, the first matching | 148 e.g. both a mask and a regular expression match, the first matching |
150 variant will be chosen, in the following order of precedence: | 149 variant will be chosen, in the following order of priority: |
151 <list type="enum"> | 150 <list type="enum"> |
152 | 151 |
153 <listitem> | 152 <listitem> |
154 string value without a mask | 153 string value without a mask |
155 </listitem> | 154 </listitem> |
184 <default>32|64|128</default> | 183 <default>32|64|128</default> |
185 <context>http</context> | 184 <context>http</context> |
186 | 185 |
187 <para> | 186 <para> |
188 Sets the bucket size for the <link id="map"/> variables hash tables. | 187 Sets the bucket size for the <link id="map"/> variables hash tables. |
189 Default value depends on the size of the processor’s cache line. | 188 Default value depends on the processor’s cache line size. |
190 Details of setting up hash tables are provided in a separate | 189 The details of setting up hash tables are provided in a separate |
191 <link doc="../hash.xml">document</link>. | 190 <link doc="../hash.xml">document</link>. |
192 </para> | 191 </para> |
193 | 192 |
194 </directive> | 193 </directive> |
195 | 194 |
200 <context>http</context> | 199 <context>http</context> |
201 | 200 |
202 <para> | 201 <para> |
203 Sets the maximum <value>size</value> of the <link id="map"/> variables | 202 Sets the maximum <value>size</value> of the <link id="map"/> variables |
204 hash tables. | 203 hash tables. |
205 Details of setting up hash tables are provided in a separate | 204 The details of setting up hash tables are provided in a separate |
206 <link doc="../hash.xml">document</link>. | 205 <link doc="../hash.xml">document</link>. |
207 </para> | 206 </para> |
208 | 207 |
209 </directive> | 208 </directive> |
210 | 209 |