index.html.en revision bd2feb86ee6d8c91ecd992138ceb96a7069a5578
6ae232055d4d8a97267517c5e50074c2c819941and<?xml version="1.0" encoding="ISO-8859-1"?>
6ae232055d4d8a97267517c5e50074c2c819941and<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
6ae232055d4d8a97267517c5e50074c2c819941and<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
6ae232055d4d8a97267517c5e50074c2c819941and XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
6ae232055d4d8a97267517c5e50074c2c819941and This file is generated from xml source: DO NOT EDIT
6ae232055d4d8a97267517c5e50074c2c819941and XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
6ae232055d4d8a97267517c5e50074c2c819941and -->
6ae232055d4d8a97267517c5e50074c2c819941and<title>Apache mod_rewrite - Apache HTTP Server</title>
6ae232055d4d8a97267517c5e50074c2c819941and<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
6ae232055d4d8a97267517c5e50074c2c819941and<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<link href="/images/favicon.ico" rel="shortcut icon" /></head>
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<body id="manual-page"><div id="page-header">
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<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>
6ae232055d4d8a97267517c5e50074c2c819941and<p class="apache">Apache HTTP Server Version 2.3</p>
6ae232055d4d8a97267517c5e50074c2c819941and<img alt="" src="/images/feather.gif" /></div>
6ae232055d4d8a97267517c5e50074c2c819941and<div class="up"><a href="../"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<div id="path">
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<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>
6ae232055d4d8a97267517c5e50074c2c819941and<div class="toplang">
6ae232055d4d8a97267517c5e50074c2c819941and<p><span>Available Languages: </span><a href="/en/rewrite/" title="English">&nbsp;en&nbsp;</a> |
6ae232055d4d8a97267517c5e50074c2c819941and<a href="/fr/rewrite/" hreflang="fr" rel="alternate" title="Fran�ais">&nbsp;fr&nbsp;</a> |
b43f840409794ed298e8634f6284741f193b6c4ftakashi<a href="/tr/rewrite/" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
6ae232055d4d8a97267517c5e50074c2c819941and</div>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <blockquote>
b43f840409794ed298e8634f6284741f193b6c4ftakashi <p>``The great thing about mod_rewrite is it gives you
6ae232055d4d8a97267517c5e50074c2c819941and all the configurability and flexibility of Sendmail.
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung The downside to mod_rewrite is that it gives you all
6ae232055d4d8a97267517c5e50074c2c819941and the configurability and flexibility of Sendmail.''</p>
b43f840409794ed298e8634f6284741f193b6c4ftakashi
b43f840409794ed298e8634f6284741f193b6c4ftakashi <p class="cite">-- <cite>Brian Behlendorf</cite><br />
b43f840409794ed298e8634f6284741f193b6c4ftakashi Apache Group</p>
b43f840409794ed298e8634f6284741f193b6c4ftakashi
6ae232055d4d8a97267517c5e50074c2c819941and </blockquote>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <blockquote>
6ae232055d4d8a97267517c5e50074c2c819941and <p>``Despite the tons of examples and docs,
6ae232055d4d8a97267517c5e50074c2c819941and mod_rewrite is voodoo. Damned cool voodoo, but still
6ae232055d4d8a97267517c5e50074c2c819941and voodoo.''</p>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <p class="cite">-- <cite>Brian Moore</cite><br />
6ae232055d4d8a97267517c5e50074c2c819941and bem@news.cmc.net</p>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and </blockquote>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <p>Welcome to mod_rewrite, the Swiss Army Knife of URL
6ae232055d4d8a97267517c5e50074c2c819941and manipulation!</p>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <p>This module uses a rule-based rewriting engine (based on a
6ae232055d4d8a97267517c5e50074c2c819941and regular-expression parser) to rewrite requested URLs on the
6ae232055d4d8a97267517c5e50074c2c819941and fly. It supports an unlimited number of rules and an
6ae232055d4d8a97267517c5e50074c2c819941and unlimited number of attached rule conditions for each rule to
6ae232055d4d8a97267517c5e50074c2c819941and provide a really flexible and powerful URL manipulation
6ae232055d4d8a97267517c5e50074c2c819941and mechanism. The URL manipulations can depend on various tests,
6ae232055d4d8a97267517c5e50074c2c819941and for instance server variables, environment variables, HTTP
6ae232055d4d8a97267517c5e50074c2c819941and headers, time stamps and even external database lookups in
6ae232055d4d8a97267517c5e50074c2c819941and various formats can be used to achieve granular URL
6ae232055d4d8a97267517c5e50074c2c819941and matching.</p>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <p>This module operates on the full URLs (including the
6ae232055d4d8a97267517c5e50074c2c819941and path-info part) both in per-server context
6ae232055d4d8a97267517c5e50074c2c819941and (<code>httpd.conf</code>) and per-directory context
6ae232055d4d8a97267517c5e50074c2c819941and (<code>.htaccess</code> files and <code>&lt;Directory&gt;</code>
6ae232055d4d8a97267517c5e50074c2c819941and blocks) and can even generate query-string
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh parts on result. The rewritten result can lead to internal
6ae232055d4d8a97267517c5e50074c2c819941and sub-processing, external request redirection or even to an
6ae232055d4d8a97267517c5e50074c2c819941and internal proxy throughput.</p>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and <p>But all this functionality and flexibility has its
6ae232055d4d8a97267517c5e50074c2c819941and drawback: complexity. So don't expect to understand this
6ae232055d4d8a97267517c5e50074c2c819941and entire module in just one day.</p>
6ae232055d4d8a97267517c5e50074c2c819941and
6ae232055d4d8a97267517c5e50074c2c819941and</div>
6ae232055d4d8a97267517c5e50074c2c819941and<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
6ae232055d4d8a97267517c5e50074c2c819941andwiki</a></li><li><a href="/glossary.html">Glossary</a></li></ul></div>
6ae232055d4d8a97267517c5e50074c2c819941and<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
6ae232055d4d8a97267517c5e50074c2c819941and<div class="section">
6ae232055d4d8a97267517c5e50074c2c819941and<h2><a name="documentation" id="documentation">Documentation</a></h2>
6ae232055d4d8a97267517c5e50074c2c819941and<ul>
6ae232055d4d8a97267517c5e50074c2c819941and<li><a href="/mod/mod_rewrite.html">mod_rewrite reference
6ae232055d4d8a97267517c5e50074c2c819941anddocumentation</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><a href="rewrite_intro.html">Introduction</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><a href="rewrite_flags.html">Flags</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><a href="rewrite_tech.html">Technical details</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><a href="rewrite_guide.html">Rewrite Guide - useful examples</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and<li><a href="rewrite_guide_advanced.html">Advanced Rewrite Guide - more
6ae232055d4d8a97267517c5e50074c2c819941anduseful examples</a></li>
6ae232055d4d8a97267517c5e50074c2c819941and</ul>
6ae232055d4d8a97267517c5e50074c2c819941and</div></div>
6ae232055d4d8a97267517c5e50074c2c819941and<div class="bottomlang">
6ae232055d4d8a97267517c5e50074c2c819941and<p><span>Available Languages: </span><a href="/en/rewrite/" title="English">&nbsp;en&nbsp;</a> |
6ae232055d4d8a97267517c5e50074c2c819941and<a href="/fr/rewrite/" hreflang="fr" rel="alternate" title="Fran�ais">&nbsp;fr&nbsp;</a> |
6ae232055d4d8a97267517c5e50074c2c819941and<a href="/tr/rewrite/" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
6ae232055d4d8a97267517c5e50074c2c819941and</div><div id="footer">
6ae232055d4d8a97267517c5e50074c2c819941and<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>
6ae232055d4d8a97267517c5e50074c2c819941and<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>
6ae232055d4d8a97267517c5e50074c2c819941and</body></html>