diff xml/en/docs/http/ngx_http_core_module.xml @ 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 be54c443235a
children 764fbac1b8b4
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>