index.html.en revision f3f7fbd152943fb15146b438ec8a4c39c404a2fb
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>
f3f7fbd152943fb15146b438ec8a4c39c404a2fbrbowen<body id="manual-page" class="no-sidebar"><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>
f3f7fbd152943fb15146b438ec8a4c39c404a2fbrbowen<p class="apache">Apache HTTP Server Version 2.1</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">
f3f7fbd152943fb15146b438ec8a4c39c404a2fbrbowen<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-project/">Documentation</a> &gt; <a href="../">Version 2.1</a></div><div id="page-content"><div id="preamble"><h1>Apache mod_rewrite</h1>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<div class="toplang">
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<p><span>Available Languages: </span><a href="/en/rewrite/" title="English">&nbsp;en&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>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen <p>`` Despite the tons of examples and docs,
22a41ae508535e87c3c2270202ae78de6ac4672crbowen mod_rewrite is voodoo. Damned cool voodoo, but still
22a41ae508535e87c3c2270202ae78de6ac4672crbowen 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
22a41ae508535e87c3c2270202ae78de6ac4672crbowen (<code>.htaccess</code>) 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>
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>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<li><a href="rewrite_tech.html">Technical details</a></li>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<li><a href="rewrite_guide.html">Practical solutions to common
22a41ae508535e87c3c2270202ae78de6ac4672crbowenproblems</a></li>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<li><a href="/glossary.html">Glossary</a></li>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen</ul>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen</div></div>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<div class="bottomlang">
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<p><span>Available Languages: </span><a href="/en/rewrite/" title="English">&nbsp;en&nbsp;</a></p>
22a41ae508535e87c3c2270202ae78de6ac4672crbowen</div><div id="footer">
22a41ae508535e87c3c2270202ae78de6ac4672crbowen<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>
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>