You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by rb...@apache.org on 2002/11/18 23:50:53 UTC
cvs commit: httpd-2.0/docs/manual/vhosts name-based.xml name-based.html.en
rbowen 2002/11/18 14:50:53
Modified: docs/manual/vhosts name-based.xml name-based.html.en
Log:
Minor clarification on a few points. Added note about what "older
browsers" means. <indent> formatting on example blocks.
Revision Changes Path
1.5 +28 -8 httpd-2.0/docs/manual/vhosts/name-based.xml
Index: name-based.xml
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/vhosts/name-based.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- name-based.xml 10 Nov 2002 20:36:26 -0000 1.4
+++ name-based.xml 18 Nov 2002 22:50:53 -0000 1.5
@@ -92,19 +92,21 @@
<code><VirtualHost></code> directive should be the same as the
argument to the <code>NameVirtualHost</code> directive (ie, an IP
address, or <code>*</code> for all addresses). Inside each
- <code><VirtualHost></code> block, you will need at minimum a /
+ <code><VirtualHost></code> block, you will need at minimum a
<directive module="core">ServerName</directive> directive to
designate which host is served and a <directive
module="core">DocumentRoot</directive> directive to
show where in the filesystem the content for that host lives.</p>
- <p>If you are adding virtual hosts to an existing web server, you
+ <note><title>Main host goes away</title>
+ If you are adding virtual hosts to an existing web server, you
must also create a <VirtualHost> block for the existing host.
The <code>ServerName</code> and <code>DocumentRoot</code> included in
this virtual host should be the same as the global
<code>ServerName</code> and <code>DocumentRoot</code>. List this
virtual host first in the configuration file so that it will act as
- the default host.</p>
+ the default host.
+ </note>
<p>For example, suppose that you are serving the domain
<code>www.domain.tld</code> and you wish to add the virtual host
@@ -115,28 +117,37 @@
NameVirtualHost *<br />
<br />
<VirtualHost *><br />
+ <indent>
ServerName www.domain.tld<br />
+ ServerAlias domain.tld *.domain.tld<br />
DocumentRoot /www/domain<br />
+ </indent>
</VirtualHost><br />
<br />
<VirtualHost *><br />
- ServerName www.otherdomain.tld<br />
+ <indent>ServerName www.otherdomain.tld<br />
DocumentRoot /www/otherdomain<br />
+ </indent>
</VirtualHost><br />
</example>
<p>You can alternatively specify an explicit IP address in place of
the * in both the <code>NameVirtualHost</code> and
- <code><VirtualHost></code> directives.</p>
+ <code><VirtualHost></code> directives. For example, you might
+ want to do this in order to run some name-based virtual hosts on one
+ IP address, and either IP-based, or another set of name-based
+ virtual hosts on another address.</p>
<p>Many servers want to be accessible by more than one name. This is
possible with the <directive module="core">ServerAlias</directive>
directive, placed inside the <VirtualHost> section. For
- example if you add this to the first <VirtualHost> block
- above</p>
+ example in the first <VirtualHost> block above, the <directive
+ module="core">ServerAlias</directive> directive indicates that the
+ listed names are other names which people can use to see that same
+ web site:</p>
<example>
- ServerAlias domain.tld *.domain.tld
+ ServerAlias domain.tld *.domain.tld
</example>
<p>then requests for all hosts in the <code>domain.tld</code> domain
@@ -188,6 +199,13 @@
pages from the first virtual host listed for that IP address
(the <cite>primary</cite> name-based virtual host).</p>
+ <note><title>How much older?</title>
+ Please note that when we say older, we really do mean older. You are
+ very unlikely to encounter one of these browsers in use today. All
+ current versions of any browser send the <code>Host</code> header as
+ required for name-based virtual hosts.
+ </note>
+
<p>There is a possible workaround with the <directive
module="core">ServerPath</directive>
directive, albeit a slightly cumbersome one:</p>
@@ -198,9 +216,11 @@
NameVirtualHost 111.22.33.44<br />
<br />
<VirtualHost 111.22.33.44><br />
+ <indent>
ServerName www.domain.tld<br />
ServerPath /domain<br />
DocumentRoot /web/domain<br />
+ </indent>
</VirtualHost><br />
</example>
1.23 +27 -8 httpd-2.0/docs/manual/vhosts/name-based.html.en
Index: name-based.html.en
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/vhosts/name-based.html.en,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- name-based.html.en 10 Nov 2002 20:36:26 -0000 1.22
+++ name-based.html.en 18 Nov 2002 22:50:53 -0000 1.23
@@ -64,18 +64,20 @@
<code><VirtualHost></code> directive should be the same as the
argument to the <code>NameVirtualHost</code> directive (ie, an IP
address, or <code>*</code> for all addresses). Inside each
- <code><VirtualHost></code> block, you will need at minimum a /
+ <code><VirtualHost></code> block, you will need at minimum a
<code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> directive to
designate which host is served and a <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> directive to
show where in the filesystem the content for that host lives.</p>
- <p>If you are adding virtual hosts to an existing web server, you
+ <div class="note"><h3>Main host goes away</h3>
+ If you are adding virtual hosts to an existing web server, you
must also create a <VirtualHost> block for the existing host.
The <code>ServerName</code> and <code>DocumentRoot</code> included in
this virtual host should be the same as the global
<code>ServerName</code> and <code>DocumentRoot</code>. List this
virtual host first in the configuration file so that it will act as
- the default host.</p>
+ the default host.
+ </div>
<p>For example, suppose that you are serving the domain
<code>www.domain.tld</code> and you wish to add the virtual host
@@ -86,28 +88,36 @@
NameVirtualHost *<br />
<br />
<VirtualHost *><br />
+ <span class="indent">
ServerName www.domain.tld<br />
+ ServerAlias domain.tld *.domain.tld<br />
DocumentRoot /www/domain<br />
+ </span>
</VirtualHost><br />
<br />
<VirtualHost *><br />
- ServerName www.otherdomain.tld<br />
+ <span class="indent">ServerName www.otherdomain.tld<br />
DocumentRoot /www/otherdomain<br />
+ </span>
</VirtualHost><br />
</code></p></div>
<p>You can alternatively specify an explicit IP address in place of
the * in both the <code>NameVirtualHost</code> and
- <code><VirtualHost></code> directives.</p>
+ <code><VirtualHost></code> directives. For example, you might
+ want to do this in order to run some name-based virtual hosts on one
+ IP address, and either IP-based, or another set of name-based
+ virtual hosts on another address.</p>
<p>Many servers want to be accessible by more than one name. This is
possible with the <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>
directive, placed inside the <VirtualHost> section. For
- example if you add this to the first <VirtualHost> block
- above</p>
+ example in the first <VirtualHost> block above, the <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> directive indicates that the
+ listed names are other names which people can use to see that same
+ web site:</p>
<div class="example"><p><code>
- ServerAlias domain.tld *.domain.tld
+ ServerAlias domain.tld *.domain.tld
</code></p></div>
<p>then requests for all hosts in the <code>domain.tld</code> domain
@@ -156,6 +166,13 @@
pages from the first virtual host listed for that IP address
(the <cite>primary</cite> name-based virtual host).</p>
+ <div class="note"><h3>How much older?</h3>
+ Please note that when we say older, we really do mean older. You are
+ very unlikely to encounter one of these browsers in use today. All
+ current versions of any browser send the <code>Host</code> header as
+ required for name-based virtual hosts.
+ </div>
+
<p>There is a possible workaround with the <code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code>
directive, albeit a slightly cumbersome one:</p>
@@ -165,9 +182,11 @@
NameVirtualHost 111.22.33.44<br />
<br />
<VirtualHost 111.22.33.44><br />
+ <span class="indent">
ServerName www.domain.tld<br />
ServerPath /domain<br />
DocumentRoot /web/domain<br />
+ </span>
</VirtualHost><br />
</code></p></div>