changeset 587:5bb7716cae7e

Documented in more depth how server names are matched.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 12 Jul 2012 09:58:35 +0000
parents 6aa162f9d925
children 23b4435dd0f3
files xml/en/docs/http/ngx_http_core_module.xml xml/en/docs/http/server_names.xml xml/ru/docs/http/ngx_http_core_module.xml
diffstat 3 files changed, 26 insertions(+), 12 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_core_module.xml	Thu Jul 12 05:06:07 2012 +0000
+++ b/xml/en/docs/http/ngx_http_core_module.xml	Thu Jul 12 09:58:35 2012 +0000
@@ -2198,23 +2198,29 @@
 </para>
 
 <para>
-The name checking order is as follows:
+When searching for a virtual server by name,
+if name matches more than one of the specified variants,
+e.g. both mask and regular expression match, the first matching
+variant will be choosen, in the following order of precedence:
 <list type="enum">
 
 <listitem>
-full names
+full name
 </listitem>
 
 <listitem>
-names with the prefix mask, e.g. “<literal>*.example.com</literal>”
+longest name with a prefix mask,
+e.g. “<literal>*.example.com</literal>”
 </listitem>
 
 <listitem>
-names with the suffix mask, e.g. “<literal>mail.*</literal>”
+longest name with a suffix mask,
+e.g. “<literal>mail.*</literal>”
 </listitem>
 
 <listitem>
-regular expressions
+first matching regular expression
+(in order of appearance in a configuration file)
 </listitem>
 
 </list>
--- a/xml/en/docs/http/server_names.xml	Thu Jul 12 05:06:07 2012 +0000
+++ b/xml/en/docs/http/server_names.xml	Thu Jul 12 09:58:35 2012 +0000
@@ -57,11 +57,13 @@
 </listitem>
 
 <listitem>
-wildcard names starting with an asterisk: <url>*.example.org</url>;
+wildcard names starting with an asterisk: <url>*.example.org</url>
+(longest first);
 </listitem>
 
 <listitem>
-wildcard names ending with an asterisk: <url>mail.*</url>;
+wildcard names ending with an asterisk: <url>mail.*</url>
+(longest first);
 </listitem>
 
 <listitem>
--- a/xml/ru/docs/http/ngx_http_core_module.xml	Thu Jul 12 05:06:07 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_core_module.xml	Thu Jul 12 09:58:35 2012 +0000
@@ -2183,23 +2183,29 @@
 </para>
 
 <para>
-Порядок проверки имён следующий:
+При поиске виртуального сервера по имени,
+если имени соответствует несколько из указанных вариантов,
+например, одновременно подходят и маска, и регулярное выражение,
+будет выбран первый подходящий вариант в следующем порядке приоритета:
 <list type="enum">
 
 <listitem>
-полные имена
+полное имя
 </listitem>
 
 <listitem>
-имена с маской в начале имени, например “<literal>*.example.com</literal>”
+самое длинное имя с маской в начале,
+например “<literal>*.example.com</literal>”
 </listitem>
 
 <listitem>
-имена с маской в конце имени, например “<literal>mail.*</literal>”
+самое длинное имя с маской в конце,
+например “<literal>mail.*</literal>”
 </listitem>
 
 <listitem>
-регулярные выражения
+первое подходящее регулярное выражение
+(в порядке следования в конфигурационном файле)
 </listitem>
 
 </list>