Commit 1553b849 authored by Joshua Slive's avatar Joshua Slive
Browse files

Backport: 

  Continue with addressing the FAQ: How to do url manipulation
  on the query string.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/APACHE_2_0_BRANCH@104637 13f79535-47bb-0310-9956-ffa450edef68
parent be308bc0

docs/manual/mod/mod_rewrite.html.en

+17 −14
Changes for docs/manual/mod/mod_rewrite.html.en: 17 added lines, 14 removed lines.
Original line number Diff line number Diff line
@@ -1325,16 +1325,21 @@ When using the NOT character 
      able to have more than one pattern to be applied before a

      substitution occurs.</p>



      <p>One more note: You can even create URLs in the

      substitution string containing a query string part. Just use

      a question mark inside the substitution string to indicate

      that the following stuff should be re-injected into the

      QUERY_STRING. When you want to erase an existing query

      string, end the substitution string with just the question

      mark.</p>

<div class="note"><h3>Query String</h3>

      <p>The <em>Pattern</em> will not match against the query string.

      Instead, you must use a <code class="directive"><a href="#rewritecond">RewriteCond</a></code> with the

      <code>%{QUERY_STRING}</code> variable.  You can, however, create

      URLs in the substitution string containing a query string

      part. Just use a question mark inside the substitution string to

      indicate that the following stuff should be re-injected into the

      query string. When you want to erase an existing query string,

      end the substitution string with just the question mark.  To

      combine a new query string with an old one, use the

      <code>[QSA]</code> flag (see below).</p>

</div>



<div class="note"><h3>Note</h3>

There is a special feature:

<div class="note"><h3>Substitution of Absolute URLs</h3>

          <p>There is a special feature:

          When you prefix a substitution field with

          <code>http://</code><em>thishost</em>[<em>:thisport</em>]

          then <strong>mod_rewrite</strong> automatically strips it
@@ -1342,15 +1347,13 @@ There is a special feature: 
          URLs is a useful and important feature when used in

          combination with a mapping-function which generates the

          hostname part. Have a look at the first example in the

          example section below to understand this.

</div>

          example section below to understand this.</p>



<div class="note"><h3>Remember</h3>

 An unconditional external

          <p><strong>Remember:</strong> An unconditional external

          redirect to your own server will not work with the prefix

          <code>http://thishost</code> because of this feature. To

          achieve such a self-redirect, you have to use the

          <strong>R</strong>-flag (see below).

          <strong>R</strong>-flag (see below).</p>

</div>



      <p>Additionally you can set special flags for

docs/manual/mod/mod_rewrite.xml

+19 −15
Changes for docs/manual/mod/mod_rewrite.xml: 19 added lines, 15 removed lines.
Original line number Diff line number Diff line 
<?xml version="1.0"?>

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

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

<!-- $Revision: 1.11.2.9 $ -->

<!-- $Revision: 1.11.2.10 $ -->



<!--

 Copyright 2002-2004 The Apache Software Foundation
@@ -1343,16 +1343,22 @@ When using the NOT character 
      able to have more than one pattern to be applied before a

      substitution occurs.</p>



      <p>One more note: You can even create URLs in the

      substitution string containing a query string part. Just use

      a question mark inside the substitution string to indicate

      that the following stuff should be re-injected into the

      QUERY_STRING. When you want to erase an existing query

      string, end the substitution string with just the question

      mark.</p>

<note><title>Query String</title>

      <p>The <em>Pattern</em> will not match against the query string.

      Instead, you must use a <directive

      module="mod_rewrite">RewriteCond</directive> with the

      <code>%{QUERY_STRING}</code> variable.  You can, however, create

      URLs in the substitution string containing a query string

      part. Just use a question mark inside the substitution string to

      indicate that the following stuff should be re-injected into the

      query string. When you want to erase an existing query string,

      end the substitution string with just the question mark.  To

      combine a new query string with an old one, use the

      <code>[QSA]</code> flag (see below).</p>

</note>



<note><title>Note</title>

There is a special feature:

<note><title>Substitution of Absolute URLs</title>

          <p>There is a special feature:

          When you prefix a substitution field with

          <code>http://</code><em>thishost</em>[<em>:thisport</em>]

          then <strong>mod_rewrite</strong> automatically strips it
@@ -1360,15 +1366,13 @@ There is a special feature: 
          URLs is a useful and important feature when used in

          combination with a mapping-function which generates the

          hostname part. Have a look at the first example in the

          example section below to understand this.

</note>

          example section below to understand this.</p>



<note><title>Remember</title>

 An unconditional external

          <p><strong>Remember:</strong> An unconditional external

          redirect to your own server will not work with the prefix

          <code>http://thishost</code> because of this feature. To

          achieve such a self-redirect, you have to use the

          <strong>R</strong>-flag (see below).

          <strong>R</strong>-flag (see below).</p>

</note>



      <p>Additionally you can set special flags for