<?xml version='1.0' encoding='UTF-8' ?>

<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">

<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>

<manualpage metafile="index.xml.meta">

<parentdocument href="../"/>

<title>Apache mod_rewrite</title>

<summary>

<blockquote>

<p>``The great thing about mod_rewrite is it gives you

all the configurability and flexibility of Sendmail.

The downside to mod_rewrite is that it gives you all

the configurability and flexibility of Sendmail.''</p>

<p class="cite">-- <cite>Brian Behlendorf</cite><br />

Apache Group</p>

</blockquote>

<blockquote>

<p>``Despite the tons of examples and docs,

mod_rewrite is voodoo. Damned cool voodoo, but still

voodoo.''</p>

<p class="cite">-- <cite>Brian Moore</cite><br />

bem@news.cmc.net</p>

</blockquote>

<p>Welcome to mod_rewrite, the Swiss Army Knife of URL

manipulation!</p>

<p>This module uses a rule-based rewriting engine (based on a

regular-expression parser) to rewrite requested URLs on the

fly. It supports an unlimited number of rules and an

unlimited number of attached rule conditions for each rule to

provide a really flexible and powerful URL manipulation

mechanism. The URL manipulations can depend on various tests,

for instance server variables, environment variables, HTTP

headers, time stamps and even external database lookups in

various formats can be used to achieve granular URL

matching.</p>

<p>This module operates on the full URLs (including the

path-info part) both in per-server context

(<code>httpd.conf</code>) and per-directory context

(<code>.htaccess</code> files and <code>&lt;Directory&gt;</code>

blocks) and can even generate query-string

parts on result. The rewritten result can lead to internal

sub-processing, external request redirection or even to an

internal proxy throughput.</p>

<p>But all this functionality and flexibility has its

drawback: complexity. So don't expect to understand this

entire module in just one day.</p>

</summary>

<seealso><a href="/urlmapping.html">Mapping URLs to the Filesystem</a></seealso>

<seealso><a href="http://wiki.apache.org/httpd/Rewrite">mod_rewrite

wiki</a></seealso>

<seealso><a href="/glossary.html">Glossary</a></seealso>

<section id="documentation"><title>Documentation</title>

<ul>

<li><a href="/mod/mod_rewrite.html">mod_rewrite reference

documentation</a></li>

<li><a href="rewrite_intro.html">Introduction</a></li>

<li><a href="rewrite_flags.html">Flags</a></li>

<li><a href="rewrite_tech.html">Technical details</a></li>

<li><a href="rewrite_guide.html">Rewrite Guide - useful examples</a></li>

<li><a href="rewrite_guide_advanced.html">Advanced Rewrite Guide - more

useful examples</a></li>

</ul>

</section>

</manualpage>