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

   1 <?xml version='1.0' encoding='UTF-8' ?>
   2 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
   4 <!-- $LastChangedRevision$ -->
   5
   6 <!--
   7  Copyright 2002-2005 The Apache Software Foundation or its licensors, as
   8  applicable.
   9
  10  Licensed under the Apache License, Version 2.0 (the "License");
  11  you may not use this file except in compliance with the License.
  12  You may obtain a copy of the License at
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  16  Unless required by applicable law or agreed to in writing, software
  17  distributed under the License is distributed on an "AS IS" BASIS,
  18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19  See the License for the specific language governing permissions and
  20  limitations under the License.
  21 -->
  22
  23 <manualpage metafile="index.xml.meta">
  24 <parentdocument href="../"/>
  25
  26   <title>Apache mod_rewrite</title>
  27
  28 <summary>
  29       <blockquote>
  30             <p>``The great thing about mod_rewrite is it gives you
  31             all the configurability and flexibility of Sendmail.
  32             The downside to mod_rewrite is that it gives you all
  33             the configurability and flexibility of Sendmail.''</p>
  34
  35             <p class="cite">-- <cite>Brian Behlendorf</cite><br />
  36             Apache Group</p>
  37
  38       </blockquote>
  39
  40       <blockquote>
  41             <p>`` Despite the tons of examples and docs,
  42             mod_rewrite is voodoo. Damned cool voodoo, but still
  43             voodoo. ''</p>
  44
  45             <p class="cite">-- <cite>Brian Moore</cite><br />
  46             bem@news.cmc.net</p>
  47
  48       </blockquote>
  49
  50       <p>Welcome to mod_rewrite, the Swiss Army Knife of URL
  51       manipulation!</p>
  52
  53       <p>This module uses a rule-based rewriting engine (based on a
  54       regular-expression parser) to rewrite requested URLs on the
  55       fly. It supports an unlimited number of rules and an
  56       unlimited number of attached rule conditions for each rule to
  57       provide a really flexible and powerful URL manipulation
  58       mechanism. The URL manipulations can depend on various tests,
  59       for instance server variables, environment variables, HTTP
  60       headers, time stamps and even external database lookups in
  61       various formats can be used to achieve granular URL
  62       matching.</p>
  63
  64       <p>This module operates on the full URLs (including the
  65       path-info part) both in per-server context
  66       (<code>httpd.conf</code>) and per-directory context
  67       (<code>.htaccess</code>) and can even generate query-string
  68       parts on result. The rewritten result can lead to internal
  69       sub-processing, external request redirection or even to an
  70       internal proxy throughput.</p>
  71
  72       <p>But all this functionality and flexibility has its
  73       drawback: complexity. So don't expect to understand this
  74       entire module in just one day.</p>
  75
  76 </summary>
  77
  78 <section id="documentation"><title>Documentation</title>
  79 <ul>
  80 <li><a href="../mod/mod_rewrite.html">mod_rewrite reference
  81 documentation</a></li>
  82 <li><a href="rewrite_intro.html">Introduction</a></li>
  83 <li><a href="rewrite_tech.html">Technical details</a></li>
  84 <li><a href="rewrite_guide.html">Practical solutions to common
  85 problems</a></li>
  86 <li><a href="../glossary.html">Glossary</a></li>
  87 </ul>
  88 </section>
  89
  90 </manualpage>
  91
  92