Mod redirect » History » Revision 21
Revision 20 (heavyhttpd, 2009-01-11 03:10) → Revision 21/36 (heavyhttpd, 2009-01-11 06:06)
h1. URL Redirection
h2. Module: mod_redirect
.. meta::
:keywords: lighttpd, redirect
.. contents:: Table of Contents
h2. Description
The redirect module is used to specify redirects for a set of URLs.
h2. Options
h3. url.redirect
Redirects a set of URLs externally
e.g.
<pre>
url.redirect = ( "^/show/([0-9]+)/([0-9]+)$" => "http://www.example.org/show.php?isdn=$1&page$2",
"^/get/([0-9]+)/([0-9]+)$" => "http://www.example.org/get.php?isdn=$1&page$2" )
# make an external redirect
# from any www.host (with www.) to the host (without www.)
$HTTP["host"] =~ "^www\.(.*)$" {
url.redirect = ( "^/(.*)" => "http://%1/$1" )
}
</pre>
Note that the "%1" in the url.redirect target refers to the parenthesized subexpression in the conditional regexp (.*). It does *not* necessarily have the meaning that "%1" would have in evhost.path-pattern (where it would mean 'top-level domain'). If In general, url.redirect is specified within a regex conditional, does not use the % patterns are replaced by the corresponding groups from the condition regex. substitutions that evhost.path-pattern does. %1 is replaced with Rather, it uses the first subexpression, %2 with the second, etc. %0 is replaced % substitutions defined by the entire substring matching the regexp. See above and below for examples using % patterns. standard lighttpd configuration file syntax.
h3. url.redirect-code (Added in 1.5.0)
Defines the http code that is sent with the redirect URL
e.g.
<pre>
url.redirect-code = 302
</pre>
h2. Example
Some people love the www part in the url. A general solution to move all non www. hosts to its www equivalent: ::
<pre>
$HTTP["host"] =~ "^([^.]+\.[^.]+)$" {
url.redirect = (
".*" => "http://www.%1"
)
}
</pre>
Moving any subdomains except a few to www.example.org: (Note: The second match is required since a non-match doesn't set any groups) ::
<pre>
$HTTP["host"] !~ "^(www|mail|mysql)\.(example\.org)$" {
$HTTP["host"] =~ "^(.+\.)?(example\.org)$" {
url.redirect = (
"^/(.*)" => "http://www.%2/$1"
)
}
}
</pre>