Mercurial > hg > nginx-site
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 +++ b/xml/en/docs/http/ngx_http_core_module.xml @@ -2198,23 +2198,29 @@ Before 0.8.48, the machine's hostname wa </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 +++ b/xml/en/docs/http/server_names.xml @@ -57,11 +57,13 @@ exact names; </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 +++ b/xml/ru/docs/http/ngx_http_core_module.xml @@ -2183,23 +2183,29 @@ server { </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>