Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_geoip_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 65750bdde8fb
comparison
equal deleted inserted replaced
345:b9a84ab82ec1 346:e5bf97f56d72
1 <?xml version="1.0"?> 1 <?xml version="1.0"?>
2 2
3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4 4
5 <module name="Директивы модуля ngx_http_geoip_module" 5 <module name="Модуль ngx_http_geoip_module"
6 link="/ru/docs/http/ngx_http_geoip_module.html" 6 link="/ru/docs/http/ngx_http_geoip_module.html"
7 lang="ru"> 7 lang="ru">
8 8
9 <section id="summary"> 9 <section id="summary">
10 10
11 <para> 11 <para>
12 Модуль ngx_http_geoip_module создаёт переменные, значения которых 12 Модуль <literal>ngx_http_geoip_module</literal> (0.8.6+) создаёт переменные,
13 зависят от IP-адреса клиента, используя готовые базы 13 значения которых зависят от IP-адреса клиента, используя готовые базы данных
14 <link url="http://www.maxmind.com">MaxMind</link> (0.8.6+). 14 <link url="http://www.maxmind.com">MaxMind</link>.
15 По умолчанию модуль не собирается, нужно разрешить его сборку 15 </para>
16 при конфигурировании параметром <literal>--with-http_geoip_module</literal>. 16
17 <para>
18 По умолчанию этот модуль не собирается, его сборку необходимо
19 разрешить с помощью конфигурационного параметра
20 <literal>--with-http_geoip_module</literal>.
21 <note>
17 Для сборки и работы этого модуля нужна библиотека 22 Для сборки и работы этого модуля нужна библиотека
18 <link url="http://www.maxmind.com/app/c">MaxMind GeoIP</link>. 23 <link url="http://www.maxmind.com/app/c">MaxMind GeoIP</link>.
19 24 </note>
20 </para> 25 </para>
21 26
22 </section> 27 </section>
23 28
24 29
25 <section name="Пример конфигурации" id="example"> 30 <section id="example" name="Пример конфигурации">
26 31
27 <para> 32 <para>
28 <example> 33 <example>
29 http { 34 http {
30 geoip_country GeoIP.dat; 35 geoip_country GeoIP.dat;
31 geoip_city GeoLiteCity.dat; 36 geoip_city GeoLiteCity.dat;
32 ... 37 ...
33 </example> 38 </example>
34 </para> 39 </para>
35 40
36 </section> 41 </section>
37 42
38 43
39 <section name="Директивы" id="directives"> 44 <section id="directives" name="Директивы">
40 45
41 <directive name="geoip_country"> 46 <directive name="geoip_country">
42 <syntax><value>база</value></syntax> 47 <syntax><value>база</value></syntax>
43 <default/> 48 <default/>
44 <context>http</context> 49 <context>http</context>
45 50
46 <para> 51 <para>
47 Директива geoip_country указывает базу для определения страны в зависимости 52 Задаёт базу данных для определения страны в зависимости
48 от значения IP-адреса клиента. 53 от значения IP-адреса клиента.
49 При использовании этой базы доступны следующие переменные: 54 При использовании этой базы данных доступны следующие переменные:
50 <list type="bullet"> 55 <list type="tag">
51 56
52 <listitem> 57 <tag-name><var>$geoip_country_code</var></tag-name>
53 $geoip_country_code; — двухбуквенный код страны, например, "RU", "US". 58 <tag-desc>
54 </listitem> 59 двухбуквенный код страны, например,
60 “<literal>RU</literal>”, “<literal>US</literal>”.
61 </tag-desc>
55 62
56 <listitem> 63 <tag-name><var>$geoip_country_code3</var></tag-name>
57 $geoip_country_code3; — трёхбуквенный код страны, например, "RUS", "USA". 64 <tag-desc>
58 </listitem> 65 трёхбуквенный код страны, например,
66 “<literal>RUS</literal>”, “<literal>USA</literal>”.
67 </tag-desc>
59 68
60 <listitem> 69 <tag-name><var>$geoip_country_name</var></tag-name>
61 $geoip_country_name; — название страны, например, "Russian Federation", 70 <tag-desc>
62 "United States". 71 название страны, например,
63 </listitem> 72 “<literal>Russian Federation</literal>”, “<literal>United States</literal>”.
73 </tag-desc>
64 74
65 </list> 75 </list>
66 </para> 76 </para>
67 77
68 </directive> 78 </directive>
72 <syntax><value>база</value></syntax> 82 <syntax><value>база</value></syntax>
73 <default/> 83 <default/>
74 <context>http</context> 84 <context>http</context>
75 85
76 <para> 86 <para>
77 Директива geoip_city указывает базу для определения страны, региона и города 87 Задаёт базу данных для определения страны, региона и города
78 в зависимости от значения IP-адреса клиента. 88 в зависимости от значения IP-адреса клиента.
79 При использовании этой базы доступны следующие переменные: 89 При использовании этой базы данных доступны следующие переменные:
80 <list type="bullet"> 90 <list type="tag">
81 91
82 <listitem> 92 <tag-name><var>$geoip_city_country_code</var></tag-name>
83 $geoip_city_country_code; — двухбуквенный код страны, например, "RU", "US". 93 <tag-desc>
84 </listitem> 94 двухбуквенный код страны, например,
95 “<literal>RU</literal>”, “<literal>US</literal>”.
96 </tag-desc>
85 97
86 <listitem> 98 <tag-name><var>$geoip_city_country_code3</var></tag-name>
87 $geoip_city_country_code3; — трёхбуквенный код страны, например, 99 <tag-desc>
88 "RUS", "USA". 100 трёхбуквенный код страны, например,
89 </listitem> 101 “<literal>RUS</literal>”, “<literal>USA</literal>”.
102 </tag-desc>
90 103
91 <listitem> 104 <tag-name><var>$geoip_city_country_name</var></tag-name>
92 $geoip_city_country_name; — название страны, например, "Russian Federation", 105 <tag-desc>
93 "United States". 106 название страны, например,
94 </listitem> 107 “<literal>Russian Federation</literal>”, “<literal>United States</literal>”.
108 </tag-desc>
95 109
96 <listitem> 110 <tag-name><var>$geoip_region</var></tag-name>
97 $geoip_region; — название региона страны (область, край, штат, 111 <tag-desc>
98 провинция, федеральная земля и тому подобное), например, "Moscow City", "DC". 112 название региона страны (область, край, штат,
99 </listitem> 113 провинция, федеральная земля и тому подобное), например,
114 “<literal>Moscow City</literal>”, “<literal>DC</literal>”.
115 </tag-desc>
100 116
101 <listitem> 117 <tag-name><var>$geoip_city</var></tag-name>
102 $geoip_city; — название города, например, "Moscow", "Washington". 118 <tag-desc>
103 </listitem> 119 название города, например,
120 “<literal>Moscow</literal>”, “<literal>Washington</literal>”.
121 </tag-desc>
104 122
105 <listitem> 123 <tag-name><var>$geoip_postal_code</var></tag-name>
106 $geoip_postal_code; — почтовый индекс. 124 <tag-desc>
107 </listitem> 125 почтовый индекс.
126 </tag-desc>
108 127
109 </list> 128 </list>
110 </para> 129 </para>
111 130
112 </directive> 131 </directive>