Commit 2c9d624b authored by Tony Finch's avatar Tony Finch
Browse files

fix some inconsistencies and add a paragraph explainint how to include a 

"." in the expansion string immediately after a % directive.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@84775 13f79535-47bb-0310-9956-ffa450edef68
parent c260bd44

docs/manual/mod/mod_vhost_alias.html

+18 −5
Changes for docs/manual/mod/mod_vhost_alias.html: 18 added lines, 5 removed lines.
Original line number Diff line number Diff line
@@ -102,7 +102,7 @@ do this you might use the following in your configuration file: 
</PRE>

A request for <CODE>http://www.example.isp.com/directory/file.html</CODE>

will be satisfied by the file

<CODE>/usr/local/apache/isp.com/e/x/a/example/directory/file.html</CODE>.

<CODE>/usr/local/apache/vhosts/isp.com/e/x/a/example/directory/file.html</CODE>.

A more even spread of files can be achieved by hashing from the end of

the name, for example:

<PRE>
@@ -123,16 +123,29 @@ For IP-based virtual hosting you might use the following in your 
configuration file:

<PRE>

	UseCanonicalName DNS

	VirtualDocumentRootIP	/usr/local/apache/vhost/%1/%2/%3/%4/docs

	VirtualScriptAliasIP	/usr/local/apache/vhost/%1/%2/%3/%4/cgi-bin

	VirtualDocumentRootIP	/usr/local/apache/vhosts/%1/%2/%3/%4/docs

	VirtualScriptAliasIP	/usr/local/apache/vhosts/%1/%2/%3/%4/cgi-bin

</PRE>

A request for <CODE>http://www.example.isp.com/directory/file.html</CODE>

would be satisfied by the file

<CODE>/usr/local/apache/10/20/30/40/docs/directory/file.html</CODE> if

<CODE>/usr/local/apache/vhosts/10/20/30/40/docs/directory/file.html</CODE> if

the IP address of <CODE>www.example.com</CODE> were 10.20.30.40.

A request for <CODE>http://www.example.isp.com/cgi-bin/script.pl</CODE>

would be satisfied by executing the program

<CODE>/usr/local/apache/10/20/30/40/cgi-bin/script.pl</CODE>.

<CODE>/usr/local/apache/vhosts/10/20/30/40/cgi-bin/script.pl</CODE>.

</P>



<P>

If you want to include the <CODE>.</CODE> character in a

<CODE>VirtualDocumentRoot</CODE> directive, but it clashes with a

<CODE>%</CODE> directive, you can work around the problem in the

following way:

<PRE>

	VirtualDocumentRoot	/usr/local/apache/vhosts/%2.0.%3.0

</PRE>

A request for <CODE>http://www.example.isp.com/directory/file.html</CODE>

will be satisfied by the file

<CODE>/usr/local/apache/vhosts/example.isp/directory/file.html</CODE>.

</P>



<P>