granicus.if.org Git - apache/blob - docs/manual/rewrite/index.html.en

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>Apache mod_rewrite - Apache HTTP Server</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body id="manual-page"><div id="page-header">
  14 <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>
  15 <p class="apache">Apache HTTP Server Version 2.3</p>
  16 <img alt="" src="../images/feather.gif" /></div>
  17 <div class="up"><a href="../"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  18 <div id="path">
  19 <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>
  20 <div class="toplang">
  21 <p><span>Available Languages: </span><a href="../en/rewrite/" title="English">&nbsp;en&nbsp;</a> |
  22 <a href="../fr/rewrite/" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  23 <a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  24 </div>
  25
  26
  27       <p>mod_rewrite uses a rule-based rewriting engine (based on a
  28       regular-expression parser) to rewrite requested URLs on the
  29       fly. It supports an unlimited number of rules and an
  30       unlimited number of attached rule conditions for each rule to
  31       provide a really flexible and powerful URL manipulation
  32       mechanism. The URL manipulations can depend on various tests:
  33       server variables, environment variables, HTTP
  34       headers, time stamps external database lookups, and various other
  35       external processes or handlers, can be used to achieve granular URL
  36       matching.</p>
  37
  38       <p>Rewrite rules can operate on the full URLs, including the path-info
  39       and query string portions, and may be used in per-server context
  40       (<code>httpd.conf</code>), per-virtualhost context (<code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> blocks), or
  41       per-directory context (<code>.htaccess</code> files and <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> blocks). The
  42       rewritten result can lead to further rules, internal
  43       sub-processing, external request redirection, or proxy
  44       passthrough.</p>
  45
  46       <p>Since mod_rewrite is so powerful, it can indeed be rather
  47       complex. This document supplements the <a href="../mod/mod_rewrite.html">reference documentation</a>, and
  48       attempts to allay some of that complexity, and provide highly
  49       annoted examples of common scenarios that you may handle with
  50       mod_rewrite. But we also attempt to show you when you should not
  51       use mod_rewrite, and use other standard Apache features instead,
  52       thus avoiding this unnecessary complexity.</p>
  53
  54
  55 <ul>
  56 <li><a href="../mod/mod_rewrite.html">mod_rewrite reference
  57 documentation</a></li>
  58 <li><a href="intro.html">Introduction to regular expressions and
  59 mod_rewrite</a></li>
  60 <li><a href="rewrite_guide.html">Rewrite Guide - useful examples</a></li>
  61 <li><a href="remapping.html">Using mod_rewrite for redirection and
  62 remapping of URLs</a></li>
  63 <li><a href="access.html">Using mod_rewrite to control access</a></li>
  64 <li><a href="advanced.html">Advanced techniques and tricks</a></li>
  65 <li><a href="flags.html">Flags</a></li>
  66 <li><a href="tech.html">Technical details</a></li>
  67 </ul>
  68 </div>
  69 <div id="quickview"><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">mod_rewrite reference
  70 documentation</a></li><li><a href="../urlmapping.html">Mapping URLs to the Filesystem</a></li><li><a href="http://wiki.apache.org/httpd/Rewrite">mod_rewrite
  71 wiki</a></li><li><a href="../glossary.html">Glossary</a></li></ul></div>
  72 </div>
  73 <div class="bottomlang">
  74 <p><span>Available Languages: </span><a href="../en/rewrite/" title="English">&nbsp;en&nbsp;</a> |
  75 <a href="../fr/rewrite/" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  76 <a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  77 </div><div id="footer">
  78 <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>
  79 <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>
  80 </body></html>