From c195b5231baad8b74682c7af63afb1c4c301266a Mon Sep 17 00:00:00 2001 From: Rich Bowen Date: Fri, 27 Nov 2009 18:10:47 +0000 Subject: [PATCH] Other minor cosmetic changes. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@884934 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/vhosts/mass.html.en | 41 ++++++++++++++++++++++----------- docs/manual/vhosts/mass.xml | 37 ++++++++++++++++++++--------- docs/manual/vhosts/mass.xml.ko | 2 +- docs/manual/vhosts/mass.xml.tr | 2 +- 4 files changed, 55 insertions(+), 27 deletions(-) diff --git a/docs/manual/vhosts/mass.html.en b/docs/manual/vhosts/mass.html.en index 6c78f3f955..a71d154eef 100644 --- a/docs/manual/vhosts/mass.html.en +++ b/docs/manual/vhosts/mass.html.en @@ -32,7 +32,8 @@
top
@@ -81,7 +81,9 @@ NameVirtualHost 111.22.33.44
  1. Your configuration file is smaller, so Apache starts - more quickly and uses less memory.
    2. + more quickly and uses less memory. Perhaps more importantly, the + smaller configuration is easier to maintain, and leaves less room + for errors.
  2. Adding virtual hosts is simply a matter of creating the appropriate directories in the filesystem and entries in the @@ -93,7 +95,9 @@ NameVirtualHost 111.22.33.44 this can be a bad idea anyway, because of the number of file descriptors needed. It is better to log to a pipe or a fifo, and arrange for the process at the other end to split up the log - files into one per virtual host.

    + files into one per virtual host. One example of such a process can + be found in the split-logfile + utility.

top
@@ -105,12 +109,15 @@ NameVirtualHost 111.22.33.44 used here is based on automatically inserting this information into the pathname of the file that is used to satisfy the request. This can be most easily done by using mod_vhost_alias - with Apache 2.0. Alternatively, mod_rewrite can be used. - Both of these modules are disabled by default; you must enable + with Apache 2.0. Alternatively, + mod_rewrite can + be used.

+

Both of these modules are disabled by default; you must enable one of them when configuring and building Apache if you want to use this technique.

-

A couple of things need to be `faked' to make the dynamic +

A couple of things need to be determined from the request in + order to make the dynamic virtual host look like a normal one. The most important is the server name, which is used by Apache to generate self-referential URLs etc. It is configured with the @@ -127,7 +134,7 @@ NameVirtualHost 111.22.33.44 or the DNS lookup fails, then the value configured with ServerName is used instead.

-

The other thing to 'fake' is the document root (configured +

The other thing to determine is the document root (configured with DocumentRoot and available to CGIs via the DOCUMENT_ROOT environment variable). In a normal configuration, this is used by the core module when @@ -140,19 +147,23 @@ NameVirtualHost 111.22.33.44 if any CGIs or SSI documents make use of it, they will get a misleading value.

+ +
top
-

Simple Dynamic Virtual Hosts

+

Dynamic Virtual Hosts with +mod_vhost_alias

This extract from httpd.conf implements the - virtual host arrangement outlined in the Motivation section above, but in a - generic fashion using mod_vhost_alias.

+ virtual host arrangement outlined in the Motivation section above + using mod_vhost_alias.

# get the server name from the Host: header
UseCanonicalName Off

# this log format can be split per-virtual-host based on the first field
+# using the split-logfile utility.
LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
CustomLog logs/access_log vcommon

@@ -167,6 +178,9 @@ VirtualScriptAlias /www/hosts/%0/cgi-bin name that is inserted into the filename is then derived from the IP address of the virtual host.

+

See the mod_vhost_alias documentation for more usage +examples.

+
top

A Virtually Hosted Homepages System

@@ -369,8 +383,7 @@ ScriptAlias /cgi-bin/ /www/std-cgi/
top
-

Using a Separate Virtual - Host Configuration File

+

Using a Separate Virtual Host Configuration File

This arrangement uses more advanced mod_rewrite features to work out the translation from virtual host to document diff --git a/docs/manual/vhosts/mass.xml b/docs/manual/vhosts/mass.xml index cbf11e0fc2..9e9c739fff 100644 --- a/docs/manual/vhosts/mass.xml +++ b/docs/manual/vhosts/mass.xml @@ -69,7 +69,9 @@ NameVirtualHost 111.22.33.44

  1. Your configuration file is smaller, so Apache starts - more quickly and uses less memory.
    2. + more quickly and uses less memory. Perhaps more importantly, the + smaller configuration is easier to maintain, and leaves less room + for errors.
  2. Adding virtual hosts is simply a matter of creating the appropriate directories in the filesystem and entries in the @@ -82,7 +84,10 @@ NameVirtualHost 111.22.33.44 href="fd-limits.html">number of file descriptors needed. It is better to log to a pipe or a fifo, and arrange for the process at the other end to split up the log - files into one per virtual host.

    + files into one per virtual host. One example of such a process can + be found in the split-logfile + utility.

    @@ -94,12 +99,15 @@ NameVirtualHost 111.22.33.44 used here is based on automatically inserting this information into the pathname of the file that is used to satisfy the request. This can be most easily done by using mod_vhost_alias - with Apache 2.0. Alternatively, mod_rewrite can be used. - Both of these modules are disabled by default; you must enable + with Apache 2.0. Alternatively, + mod_rewrite can + be used.

    +

    Both of these modules are disabled by default; you must enable one of them when configuring and building Apache if you want to use this technique.

    -

    A couple of things need to be `faked' to make the dynamic +

    A couple of things need to be determined from the request in + order to make the dynamic virtual host look like a normal one. The most important is the server name, which is used by Apache to generate self-referential URLs etc. It is configured with the @@ -117,7 +125,7 @@ NameVirtualHost 111.22.33.44 or the DNS lookup fails, then the value configured with ServerName is used instead.

    -

    The other thing to 'fake' is the document root (configured +

    The other thing to determine is the document root (configured with DocumentRoot and available to CGIs via the DOCUMENT_ROOT environment variable). In a normal configuration, this is used by the core module when @@ -130,20 +138,25 @@ NameVirtualHost 111.22.33.44 if any CGIs or SSI documents make use of it, they will get a misleading value.

    + + -
    Simple Dynamic Virtual Hosts +
    Dynamic Virtual Hosts with +mod_vhost_alias

    This extract from httpd.conf implements the virtual host arrangement outlined in the Motivation section above, but in a - generic fashion using mod_vhost_alias.

    + href="#motivation">Motivation section above + using mod_vhost_alias.

    # get the server name from the Host: header
    UseCanonicalName Off

    # this log format can be split per-virtual-host based on the first field
    +# using the split-logfile utility.
    LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
    CustomLog logs/access_log vcommon

    @@ -158,6 +171,9 @@ VirtualScriptAlias /www/hosts/%0/cgi-bin name that is inserted into the filename is then derived from the IP address of the virtual host.

    +

    See the mod_vhost_alias documentation for more usage +examples.

    +
    A Virtually Hosted Homepages System @@ -360,8 +376,7 @@ ScriptAlias /cgi-bin/ /www/std-cgi/
    -
    Using a Separate Virtual - Host Configuration File +
    Using a Separate Virtual Host Configuration File

    This arrangement uses more advanced mod_rewrite features to work out the translation from virtual host to document diff --git a/docs/manual/vhosts/mass.xml.ko b/docs/manual/vhosts/mass.xml.ko index 40e8467184..f88136f17d 100644 --- a/docs/manual/vhosts/mass.xml.ko +++ b/docs/manual/vhosts/mass.xml.ko @@ -1,7 +1,7 @@ - + +