index.html.en revision cc8190433d13f5e9de618c5d7f10c824c0c1919c
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<?xml version="1.0" encoding="ISO-8859-1"?>
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 -->
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>
4eb5e97c7a147352e1017b0114d2719d5f67cea9rbowen<body id="manual-page"><div id="page-header">
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>
52fff662005b1866a3ff09bb6c902800c5cc6dedjerenkrantz<p class="apache">Apache HTTP Server Version 2.3</p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<img alt="" src="/images/feather.gif" /></div>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<div class="up"><a href="../"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<div id="path">
4b5981e276e93df97c34e4da05ca5cf8bbd937dand<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Apache mod_rewrite</h1>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<div class="toplang">
f3ec420152ca921e4c1ce77782f51b53f659018dnd<p><span>Available Languages: </span><a href="/en/rewrite/" title="English">&nbsp;en&nbsp;</a> |
bd2feb86ee6d8c91ecd992138ceb96a7069a5578gryzor<a href="/fr/rewrite/" hreflang="fr" rel="alternate" title="Fran�ais">&nbsp;fr&nbsp;</a> |
f3ec420152ca921e4c1ce77782f51b53f659018dnd<a href="/tr/rewrite/" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen</div>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen
22a41ae508535e87c3c2270202ae78de6ac4672crbowen <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
22a41ae508535e87c3c2270202ae78de6ac4672crbowen the configurability and flexibility of Sendmail.''</p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen
22a41ae508535e87c3c2270202ae78de6ac4672crbowen <p class="cite">-- <cite>Brian Behlendorf</cite><br />
22a41ae508535e87c3c2270202ae78de6ac4672crbowen Apache Group</p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen
22a41ae508535e87c3c2270202ae78de6ac4672crbowen </blockquote>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen
22a41ae508535e87c3c2270202ae78de6ac4672crbowen <blockquote>
ec7f95732d562ee4f5586faea04d12df7fb20180rbowen <p>``Despite the tons of examples and docs,
22a41ae508535e87c3c2270202ae78de6ac4672crbowen mod_rewrite is voodoo. Damned cool voodoo, but still
cb31536ca972d939ea2833f27b99f8b0bdde049crbowen voodoo.''</p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen
22a41ae508535e87c3c2270202ae78de6ac4672crbowen <p class="cite">-- <cite>Brian Moore</cite><br />
22a41ae508535e87c3c2270202ae78de6ac4672crbowen bem@news.cmc.net</p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen
22a41ae508535e87c3c2270202ae78de6ac4672crbowen </blockquote>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen
22a41ae508535e87c3c2270202ae78de6ac4672crbowen <p>Welcome to mod_rewrite, the Swiss Army Knife of URL
22a41ae508535e87c3c2270202ae78de6ac4672crbowen manipulation!</p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen
22a41ae508535e87c3c2270202ae78de6ac4672crbowen <p>This module uses a rule-based rewriting engine (based on a
22a41ae508535e87c3c2270202ae78de6ac4672crbowen regular-expression parser) to rewrite requested URLs on the
22a41ae508535e87c3c2270202ae78de6ac4672crbowen fly. It supports an unlimited number of rules and an
22a41ae508535e87c3c2270202ae78de6ac4672crbowen unlimited number of attached rule conditions for each rule to
22a41ae508535e87c3c2270202ae78de6ac4672crbowen provide a really flexible and powerful URL manipulation
22a41ae508535e87c3c2270202ae78de6ac4672crbowen mechanism. The URL manipulations can depend on various tests,
22a41ae508535e87c3c2270202ae78de6ac4672crbowen for instance server variables, environment variables, HTTP
22a41ae508535e87c3c2270202ae78de6ac4672crbowen headers, time stamps and even external database lookups in
22a41ae508535e87c3c2270202ae78de6ac4672crbowen various formats can be used to achieve granular URL
22a41ae508535e87c3c2270202ae78de6ac4672crbowen matching.</p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen
22a41ae508535e87c3c2270202ae78de6ac4672crbowen <p>This module operates on the full URLs (including the
22a41ae508535e87c3c2270202ae78de6ac4672crbowen path-info part) both in per-server context
22a41ae508535e87c3c2270202ae78de6ac4672crbowen (<code>httpd.conf</code>) and per-directory context
1db37411af96e1c17b78ed2b35461187791250cbrbowen (<code>.htaccess</code> files and <code>&lt;Directory&gt;</code>
1db37411af96e1c17b78ed2b35461187791250cbrbowen blocks) and can even generate query-string
22a41ae508535e87c3c2270202ae78de6ac4672crbowen parts on result. The rewritten result can lead to internal
22a41ae508535e87c3c2270202ae78de6ac4672crbowen sub-processing, external request redirection or even to an
22a41ae508535e87c3c2270202ae78de6ac4672crbowen internal proxy throughput.</p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen
22a41ae508535e87c3c2270202ae78de6ac4672crbowen <p>But all this functionality and flexibility has its
22a41ae508535e87c3c2270202ae78de6ac4672crbowen drawback: complexity. So don't expect to understand this
22a41ae508535e87c3c2270202ae78de6ac4672crbowen entire module in just one day.</p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen
22a41ae508535e87c3c2270202ae78de6ac4672crbowen</div>
f5cfdad942d8d69e7991d58f0910688e7821ed9cslive<div id="quickview"><h3>See also</h3><ul class="seealso"><li><a href="/urlmapping.html">Mapping URLs to the Filesystem</a></li><li><a href="http://wiki.apache.org/httpd/Rewrite">mod_rewrite
f5cfdad942d8d69e7991d58f0910688e7821ed9cslivewiki</a></li><li><a href="/glossary.html">Glossary</a></li></ul></div>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<div class="section">
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<h2><a name="documentation" id="documentation">Documentation</a></h2>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<ul>
f3f7fbd152943fb15146b438ec8a4c39c404a2fbrbowen<li><a href="/mod/mod_rewrite.html">mod_rewrite reference
f3f7fbd152943fb15146b438ec8a4c39c404a2fbrbowendocumentation</a></li>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<li><a href="rewrite_intro.html">Introduction</a></li>
f5cfdad942d8d69e7991d58f0910688e7821ed9cslive<li><a href="rewrite_flags.html">Flags</a></li>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<li><a href="rewrite_tech.html">Technical details</a></li>
ec7f95732d562ee4f5586faea04d12df7fb20180rbowen<li><a href="rewrite_guide.html">Rewrite Guide - useful examples</a></li>
ec7f95732d562ee4f5586faea04d12df7fb20180rbowen<li><a href="rewrite_guide_advanced.html">Advanced Rewrite Guide - more
ec7f95732d562ee4f5586faea04d12df7fb20180rbowenuseful examples</a></li>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen</ul>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen</div></div>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<div class="bottomlang">
f3ec420152ca921e4c1ce77782f51b53f659018dnd<p><span>Available Languages: </span><a href="/en/rewrite/" title="English">&nbsp;en&nbsp;</a> |
bd2feb86ee6d8c91ecd992138ceb96a7069a5578gryzor<a href="/fr/rewrite/" hreflang="fr" rel="alternate" title="Fran�ais">&nbsp;fr&nbsp;</a> |
f3ec420152ca921e4c1ce77782f51b53f659018dnd<a href="/tr/rewrite/" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen</div><div id="footer">
b036ef2952fb6924b308f954b39786443460ddc6rpluem<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
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></div>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen</body></html>