index.html.en revision 22a41ae508535e87c3c2270202ae78de6ac4672c
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
22a41ae508535e87c3c2270202ae78de6ac4672crbowen XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
22a41ae508535e87c3c2270202ae78de6ac4672crbowen This file is generated from xml source: DO NOT EDIT
22a41ae508535e87c3c2270202ae78de6ac4672crbowen XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<title>Apache mod_rewrite - Apache HTTP Server</title>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<link href="/images/favicon.ico" rel="shortcut icon" /></head>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<div class="up"><a href="../"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.0</a></div><div id="page-content"><div id="preamble"><h1>Apache mod_rewrite</h1>
f3ec420152ca921e4c1ce77782f51b53f659018dnd<p><span>Available Languages: </span><a href="/en/rewrite/" title="English"> en </a></p>
d474d8ef01ec5c2a09341cd148851ed383c3287crbowen <blockquote>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen <p>``The great thing about mod_rewrite is it gives you
22a41ae508535e87c3c2270202ae78de6ac4672crbowen all the configurability and flexibility of Sendmail.
22a41ae508535e87c3c2270202ae78de6ac4672crbowen The downside to mod_rewrite is that it gives you all
ef96a16f2c3ed821e516840775560b4895b26d3drbowen the configurability and flexibility of Sendmail.''</p>
ef96a16f2c3ed821e516840775560b4895b26d3drbowen <p class="cite">-- <cite>Brian Behlendorf</cite><br />
ef96a16f2c3ed821e516840775560b4895b26d3drbowen Apache Group</p>
ef96a16f2c3ed821e516840775560b4895b26d3drbowen </blockquote>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen <blockquote>
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen <p>`` Despite the tons of examples and docs,
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen mod_rewrite is voodoo. Damned cool voodoo, but still
ef96a16f2c3ed821e516840775560b4895b26d3drbowen voodoo. ''</p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen bem@news.cmc.net</p>
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen </blockquote>
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen <p>Welcome to mod_rewrite, the Swiss Army Knife of URL
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen manipulation!</p>
ef96a16f2c3ed821e516840775560b4895b26d3drbowen <p>This module uses a rule-based rewriting engine (based on a
ef96a16f2c3ed821e516840775560b4895b26d3drbowen regular-expression parser) to rewrite requested URLs on the
22a41ae508535e87c3c2270202ae78de6ac4672crbowen fly. It supports an unlimited number of rules and an
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen unlimited number of attached rule conditions for each rule to
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen provide a really flexible and powerful URL manipulation
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen mechanism. The URL manipulations can depend on various tests,
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen for instance server variables, environment variables, HTTP
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen headers, time stamps and even external database lookups in
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen various formats can be used to achieve granular URL
0b1f1f5b70f1d4df3b6a6eb4c92f6869719dc711rbowen matching.</p>
1093a264c81aa1041581ab059905fb8f7cdfc5e2rbowen <p>This module operates on the full URLs (including the
22a41ae508535e87c3c2270202ae78de6ac4672crbowen path-info part) both in per-server context
f3f7fbd152943fb15146b438ec8a4c39c404a2fbrbowen (<code>.htaccess</code>) and can even generate query-string
5f8a7d39ae7cbbdd9738d1d8ae7ee0cb35671932rbowen parts on result. The rewritten result can lead to internal
5f8a7d39ae7cbbdd9738d1d8ae7ee0cb35671932rbowen sub-processing, external request redirection or even to an
06ed4d71350dacf8c4bedec7ac850eeb9a84637arbowen internal proxy throughput.</p>
5f8a7d39ae7cbbdd9738d1d8ae7ee0cb35671932rbowen <p>But all this functionality and flexibility has its
3723c5ef4beec0403b4daa6c64fc0a8f53541018rbowen drawback: complexity. So don't expect to understand this
53abc235688d883cfa15cdfec354ba03128f357arbowen entire module in just one day.</p>
6ac307024b9ac1219869549636eb03ef6b95a930rbowen<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#documentation">Documentation</a></li>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<li><img alt="" src="/images/down.gif" /> <a href="#mod-rewrite">mod_rewrite</a></li>
1093a264c81aa1041581ab059905fb8f7cdfc5e2rbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1093a264c81aa1041581ab059905fb8f7cdfc5e2rbowen<h2><a name="documentation" id="documentation">Documentation</a></h2>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<li><a href="rewrite_intro.html">Introduction</a></li>
f3ec420152ca921e4c1ce77782f51b53f659018dnd<li><a href="rewrite_tech.html">Technical details</a></li>
bd2feb86ee6d8c91ecd992138ceb96a7069a5578gryzor<li><a href="rewrite_guide.html">Practical solutions to common
9c1260efa52c82c2a58e5b5f20cd6902563d95f5rbowen</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<h2><a name="mod-rewrite" id="mod-rewrite">mod_rewrite</a></h2>
provided by this module is provided in the <a href="/mod/mod_rewrite.html">mod_rewrite reference documentation</a>.
<p class="apache">Copyright 1995-2005 The Apache Software Foundation or its licensors, as applicable.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div>