Commit 57345dde authored by Richard Bowen's avatar Richard Bowen
Browse files

Add more detail to the RewriteMap rnd: example, as well as rewriting 

some of the text that makes this feature seem less useful than it
actually is.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@201923 13f79535-47bb-0310-9956-ffa450edef68
parent 3145512b

docs/manual/mod/mod_rewrite.html.en

+14 −8
Changes for docs/manual/mod/mod_rewrite.html.en: 14 added lines, 8 removed lines.
Original line number Diff line number Diff line
@@ -848,12 +848,14 @@ RewriteMap real-to-user txt:/path/to/file/map.txt 
          ``<code>|</code>'' characters which have the meaning of

          ``or''. In other words they indicate a set of

          alternatives from which the actual returned value is

          chosen randomly. Although this sounds crazy and useless,

          it was actually designed for load balancing in a reverse

          proxy situation where the looked up values are server

          names. Example:</p>



<div class="example"><pre>

          chosen randomly. For example, you might use the following map

          file and directives to provide a random load balancing between

          several back-end server, via a reverse-proxy. Images are sent

          to one of the servers in the 'static' pool, while everything

          else is sent to one of the 'dynamic' pool.</p>

          <p>Example:</p>



<div class="example"><h3>Rewrite map file</h3><pre>

##

##  map.txt -- rewriting map

##
@@ -862,8 +864,12 @@ static www1|www2|www3|www4 
dynamic  www5|www6

</pre></div>



<div class="example"><p><code>

RewriteMap servers rnd:/path/to/file/map.txt

<div class="example"><h3>Configuration directives</h3><p><code>

RewriteMap servers rnd:/path/to/file/map.txt<br />

<br />

RewriteRule ^/(.*\.(png|gif|jpg)) http://${servers:static}/$1

[NC,P,L]<br />

RewriteRule ^/(.*) http://${servers:dynamic}/$1 [P,L]

</code></p></div>

        </li>

docs/manual/mod/mod_rewrite.xml

+14 −8
Changes for docs/manual/mod/mod_rewrite.xml: 14 added lines, 8 removed lines.
Original line number Diff line number Diff line
@@ -356,12 +356,14 @@ RewriteMap real-to-user txt:/path/to/file/map.txt 
          ``<code>|</code>'' characters which have the meaning of

          ``or''. In other words they indicate a set of

          alternatives from which the actual returned value is

          chosen randomly. Although this sounds crazy and useless,

          it was actually designed for load balancing in a reverse

          proxy situation where the looked up values are server

          names. Example:</p>



<example>

          chosen randomly. For example, you might use the following map

          file and directives to provide a random load balancing between

          several back-end server, via a reverse-proxy. Images are sent

          to one of the servers in the 'static' pool, while everything

          else is sent to one of the 'dynamic' pool.</p>

          <p>Example:</p>



<example><title>Rewrite map file</title>

<pre>

##

##  map.txt -- rewriting map
@@ -372,8 +374,12 @@ dynamic www5|www6 
</pre>

</example>



<example>

RewriteMap servers rnd:/path/to/file/map.txt

<example><title>Configuration directives</title>

RewriteMap servers rnd:/path/to/file/map.txt<br />

<br />

RewriteRule ^/(.*\.(png|gif|jpg)) http://${servers:static}/$1

[NC,P,L]<br />

RewriteRule ^/(.*) http://${servers:dynamic}/$1 [P,L]

</example>

        </li>