|Practical mod_perl / HTML Book /|
B.9.1. Apache::AddHostPath—Adds Some or All of the Hostname and Port to the URI
This module transforms the requested URI based on the hostname and port number from the HTTP request header. It allows you to manage an arbitrary number of domains and subdomains all pointing to the same document root but for which you want a combination of shared and distinct files.
Essentially the module implements Apache's URI-translation phase by attempting to use some or all of the URL hostname and port number as the base of the URI. It simply does file and directory existence tests on a series of URIs (from most-specific to least-specific) and sets the URI to the most specific match.
For example, if the request is:
URL: http://www.example.org:8080/index.html URI: /index.html
Apache::AddHostPath would go through the following list of possible paths and set the new URI based on the first match that passes a -f or -d existence test:
$docRoot/org/example/www/8080/index.html $docRoot/org/example/www/index.html $docRoot/org/example/index.html $docRoot/org/index.html $docRoot/index.html
Available from CPAN. See the module manpage for more information.