You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by co...@apache.org on 2020/12/17 14:41:53 UTC
svn commit: r1884555 - /httpd/httpd/trunk/docs/manual/vhosts/name-based.xml
Author: covener
Date: Thu Dec 17 14:41:53 2020
New Revision: 1884555
URL: http://svn.apache.org/viewvc?rev=1884555&view=rev
Log:
PR64997: clarify hostnames inside <virtualhost> tag
Modified:
httpd/httpd/trunk/docs/manual/vhosts/name-based.xml
Modified: httpd/httpd/trunk/docs/manual/vhosts/name-based.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/vhosts/name-based.xml?rev=1884555&r1=1884554&r2=1884555&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/vhosts/name-based.xml (original)
+++ httpd/httpd/trunk/docs/manual/vhosts/name-based.xml Thu Dec 17 14:41:53 2020
@@ -187,17 +187,23 @@
first have your DNS server properly configured to map those names to an IP
address associated with your server.</p>
+ <p>Typically, IP addresses of local interfaces or the wildcard '*' are specified within the
+ <directive type="section" module="core">virtualhost</directive> tag and hostnames are
+ specified only in <directive module="core">ServerName</directive> or <directive module="core"
+ >ServerAlias</directive>. When a hostname is specified within the virtualhost tag,
+ its addresses are resolved and added for IP based virtual host resolution and the hostname:port
+ combination is also checked prior to ServerName and ServerAlias checks for name-based virtual host
+ resolution. The use of hostnames within the virtualhost tag is relatively obscure, error prone,
+ and should generally be avoided.
+ </p>
+
<p>Name-based virtual hosts for the best-matching set of <directive
type="section" module="core">virtualhost</directive>s are processed
in the order they appear in the configuration. The first matching <directive
module="core">ServerName</directive> or <directive module="core"
>ServerAlias</directive> is used, with no different precedence for wildcards
- (nor for ServerName vs. ServerAlias). </p>
-
- <p>The complete list of names in the <directive module="core"
- >VirtualHost</directive>
- directive are treated just like a (non wildcard)
- <directive module="core">ServerAlias</directive>.</p>
+ (nor for ServerName vs. ServerAlias).
+ </p>
<p>Finally, you can fine-tune the configuration of the virtual hosts
by placing other directives inside the <directive type="section"