Commit 749581da authored by Richard Bowen's avatar Richard Bowen
Browse files

This is *not* complete, but I wanted people to see what I'm thinking and 

working on. Please hack on it, comment, etc. Some content will be
removed from the module reference document when this is complete, but
for now this is not linked anywhere from the rest of the site.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.0.x@124537 13f79535-47bb-0310-9956-ffa450edef68
parent df3b24dd

docs/manual/rewrite/index.html

0 → 100644
+3 −0
Changes for docs/manual/rewrite/index.html: 3 added lines, 0 removed lines.
Original line number Diff line number Diff line 
URI: index.html.en

Content-Language: en

Content-type: text/html; charset=ISO-8859-1

docs/manual/rewrite/index.html.en

0 → 100644
+97 −0
Changes for docs/manual/rewrite/index.html.en: 97 added lines, 0 removed lines.
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--

        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              This file is generated from xml source: DO NOT EDIT

        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

      -->

<title>Apache mod_rewrite - Apache HTTP Server</title>

<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />

<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />

<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />

<link href="../images/favicon.ico" rel="shortcut icon" /></head>

<body id="manual-page"><div id="page-header">

<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>

<p class="apache">Apache HTTP Server Version 2.0</p>

<img alt="" src="../images/feather.gif" /></div>

<div class="up"><a href="../"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>

<div id="path">

<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.0</a></div><div id="page-content"><div id="preamble"><h1>Apache mod_rewrite</h1>

<div class="toplang">

<p><span>Available Languages: </span><a href="../en/rewrite/" title="English">&nbsp;en&nbsp;</a></p>

</div>



      <blockquote>

            <p>``The great thing about mod_rewrite is it gives you

            all the configurability and flexibility of Sendmail.

            The downside to mod_rewrite is that it gives you all

            the configurability and flexibility of Sendmail.''</p>



            <p class="cite">-- <cite>Brian Behlendorf</cite><br />

            Apache Group</p>



      </blockquote>



      <blockquote>

            <p>`` Despite the tons of examples and docs,

            mod_rewrite is voodoo. Damned cool voodoo, but still

            voodoo. ''</p>



            <p class="cite">-- <cite>Brian Moore</cite><br />

            bem@news.cmc.net</p>



      </blockquote>



      <p>Welcome to mod_rewrite, the Swiss Army Knife of URL

      manipulation!</p>



      <p>This module uses a rule-based rewriting engine (based on a

      regular-expression parser) to rewrite requested URLs on the

      fly. It supports an unlimited number of rules and an

      unlimited number of attached rule conditions for each rule to

      provide a really flexible and powerful URL manipulation

      mechanism. The URL manipulations can depend on various tests,

      for instance server variables, environment variables, HTTP

      headers, time stamps and even external database lookups in

      various formats can be used to achieve granular URL

      matching.</p>



      <p>This module operates on the full URLs (including the

      path-info part) both in per-server context

      (<code>httpd.conf</code>) and per-directory context

      (<code>.htaccess</code>) and can even generate query-string

      parts on result. The rewritten result can lead to internal

      sub-processing, external request redirection or even to an

      internal proxy throughput.</p>



      <p>But all this functionality and flexibility has its

      drawback: complexity. So don't expect to understand this

      entire module in just one day.</p>



</div>

<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#documentation">Documentation</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#mod-rewrite">mod_rewrite</a></li>

</ul></div>

<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="section">

<h2><a name="documentation" id="documentation">Documentation</a></h2>

<ul>

<li><a href="rewrite_intro.html">Introduction</a></li>

<li><a href="rewrite_tech.html">Technical details</a></li>

<li><a href="rewrite_guide.html">Practical solutions to common

problems</a></li>

<li><a href="../glossary.html">Glossary</a></li>

</ul>

</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="section">

<h2><a name="mod-rewrite" id="mod-rewrite">mod_rewrite</a></h2>

<p>Extensive documentation on the directives 

provided by this module is provided in the <a href="../mod/mod_rewrite.html">mod_rewrite reference documentation</a>.

</p>

</div></div>

<div class="bottomlang">

<p><span>Available Languages: </span><a href="../en/rewrite/" title="English">&nbsp;en&nbsp;</a></p>

</div><div id="footer">

<p class="apache">Copyright 1999-2004 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>

<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>

</body></html>
 
 No newline at end of file

docs/manual/rewrite/index.xml

0 → 100644
+96 −0
Changes for docs/manual/rewrite/index.xml: 96 added lines, 0 removed lines.
Original line number Diff line number Diff line 
<?xml version='1.0' encoding='UTF-8' ?>

<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>

<!-- $LastChangedRevision$ -->



<!--

 Copyright 2002-2004 The Apache Software Foundation



 Licensed under the Apache License, Version 2.0 (the "License");

 you may not use this file except in compliance with the License.

 You may obtain a copy of the License at



     http://www.apache.org/licenses/LICENSE-2.0



 Unless required by applicable law or agreed to in writing, software

 distributed under the License is distributed on an "AS IS" BASIS,

 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 See the License for the specific language governing permissions and

 limitations under the License.

-->



<manualpage metafile="index.xml.meta">

<parentdocument href="../"/>



  <title>Apache mod_rewrite</title>



<summary>

      <blockquote>

            <p>``The great thing about mod_rewrite is it gives you

            all the configurability and flexibility of Sendmail.

            The downside to mod_rewrite is that it gives you all

            the configurability and flexibility of Sendmail.''</p>



            <p class="cite">-- <cite>Brian Behlendorf</cite><br />

            Apache Group</p>



      </blockquote>



      <blockquote>

            <p>`` Despite the tons of examples and docs,

            mod_rewrite is voodoo. Damned cool voodoo, but still

            voodoo. ''</p>



            <p class="cite">-- <cite>Brian Moore</cite><br />

            bem@news.cmc.net</p>



      </blockquote>



      <p>Welcome to mod_rewrite, the Swiss Army Knife of URL

      manipulation!</p>



      <p>This module uses a rule-based rewriting engine (based on a

      regular-expression parser) to rewrite requested URLs on the

      fly. It supports an unlimited number of rules and an

      unlimited number of attached rule conditions for each rule to

      provide a really flexible and powerful URL manipulation

      mechanism. The URL manipulations can depend on various tests,

      for instance server variables, environment variables, HTTP

      headers, time stamps and even external database lookups in

      various formats can be used to achieve granular URL

      matching.</p>



      <p>This module operates on the full URLs (including the

      path-info part) both in per-server context

      (<code>httpd.conf</code>) and per-directory context

      (<code>.htaccess</code>) and can even generate query-string

      parts on result. The rewritten result can lead to internal

      sub-processing, external request redirection or even to an

      internal proxy throughput.</p>



      <p>But all this functionality and flexibility has its

      drawback: complexity. So don't expect to understand this

      entire module in just one day.</p>



</summary>



<section id="documentation"><title>Documentation</title>

<ul>

<li><a href="rewrite_intro.html">Introduction</a></li>

<li><a href="rewrite_tech.html">Technical details</a></li>

<li><a href="rewrite_guide.html">Practical solutions to common

problems</a></li>

<li><a href="../glossary.html">Glossary</a></li>

</ul>

</section>



<section id="mod-rewrite"><title>mod_rewrite</title>

<p>Extensive documentation on the directives 

provided by this module is provided in the <a

href="../mod/mod_rewrite.html">mod_rewrite reference documentation</a>.

</p>

</section>



</manualpage>

docs/manual/rewrite/index.xml.meta

0 → 100644
+11 −0
Changes for docs/manual/rewrite/index.xml.meta: 11 added lines, 0 removed lines.
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8" ?>



<metafile>

  <basename>index</basename>

  <path>/rewrite/</path>

  <relpath>..</relpath>



  <variants>

    <variant>en</variant>

  </variants>

</metafile>

docs/manual/rewrite/rewrite_guide.html

0 → 100644
+3 −0
Changes for docs/manual/rewrite/rewrite_guide.html: 3 added lines, 0 removed lines.
Original line number Diff line number Diff line 
URI: rewrite_guide.html.en

Content-Language: en

Content-type: text/html; charset=ISO-8859-1