diff options
author | Rich Bowen <rbowen@apache.org> | 2013-04-17 03:51:22 +0200 |
---|---|---|
committer | Rich Bowen <rbowen@apache.org> | 2013-04-17 03:51:22 +0200 |
commit | 6ae3cff5b44a3d8c3404bcc9fc108af0ee737ee0 (patch) | |
tree | 99ac045ff3d1ad2832e056b8720c17aad13f08d3 /docs/manual/rewrite/rewritemap.xml | |
parent | mod_auth_basic: Allow AuthBasicFake to be switched off for an URL space. (diff) | |
download | apache2-6ae3cff5b44a3d8c3404bcc9fc108af0ee737ee0.tar.xz apache2-6ae3cff5b44a3d8c3404bcc9fc108af0ee737ee0.zip |
Rearranges the sections so that 'int' is first, where it makes more
sense, so that types progress in order of complexity, rather than some
other arbitrary order.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1468709 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/rewrite/rewritemap.xml')
-rw-r--r-- | docs/manual/rewrite/rewritemap.xml | 90 |
1 files changed, 45 insertions, 45 deletions
diff --git a/docs/manual/rewrite/rewritemap.xml b/docs/manual/rewrite/rewritemap.xml index 47e247f4d2..888da63eb9 100644 --- a/docs/manual/rewrite/rewritemap.xml +++ b/docs/manual/rewrite/rewritemap.xml @@ -109,6 +109,51 @@ once created, in your <code>RewriteRule</code> and may be used, and give examples of each.</p> </section> + <section id="int"> + <title>int: Internal Function</title> + + <p>When a MapType of <code>int</code> is used, the MapSource is one + of the available internal RewriteMap functions. Module authors can provide + additional internal functions by registering them with the + <code>ap_register_rewrite_mapfunc</code> API. + The functions that are provided by default are: + </p> + + <ul> + <li><strong>toupper</strong>:<br/> + Converts the key to all upper case.</li> + <li><strong>tolower</strong>:<br/> + Converts the key to all lower case.</li> + <li><strong>escape</strong>:<br/> + Translates special characters in the key to + hex-encodings.</li> + <li><strong>unescape</strong>:<br/> + Translates hex-encodings in the key back to + special characters.</li> + </ul> + + <p> + To use one of these functions, create a <code>RewriteMap</code> referencing + the int function, and then use that in your <code>RewriteRule</code>: + </p> + + <p> <strong>Redirect a URI to an all-lowercase version of itself</strong></p> + <highlight language="config"> + +RewriteMap lc int:tolower +RewriteRule (.*?[A-Z]+.*) ${lc:$1} [R] + </highlight> + + <note> + <p>Please note that the example offered here is for + illustration purposes only, and is not a recommendation. If you want + to make URLs case-insensitive, consider using + <module>mod_speling</module> instead. + </p> + </note> + + </section> + <section id="txt"> <title>txt: Plain text maps</title> @@ -284,51 +329,6 @@ by many requests. </section> - <section id="int"> - <title>int: Internal Function</title> - - <p>When a MapType of <code>int</code> is used, the MapSource is one - of the available internal RewriteMap functions. Module authors can provide - additional internal functions by registering them with the - <code>ap_register_rewrite_mapfunc</code> API. - The functions that are provided by default are: - </p> - - <ul> - <li><strong>toupper</strong>:<br/> - Converts the key to all upper case.</li> - <li><strong>tolower</strong>:<br/> - Converts the key to all lower case.</li> - <li><strong>escape</strong>:<br/> - Translates special characters in the key to - hex-encodings.</li> - <li><strong>unescape</strong>:<br/> - Translates hex-encodings in the key back to - special characters.</li> - </ul> - - <p> - To use one of these functions, create a <code>RewriteMap</code> referencing - the int function, and then use that in your <code>RewriteRule</code>: - </p> - - <p> <strong>Redirect a URI to an all-lowercase version of itself</strong></p> - <highlight language="config"> - -RewriteMap lc int:tolower -RewriteRule (.*?[A-Z]+.*) ${lc:$1} [R] - </highlight> - - <note> - <p>Please note that the example offered here is for - illustration purposes only, and is not a recommendation. If you want - to make URLs case-insensitive, consider using - <module>mod_speling</module> instead. - </p> - </note> - - </section> - <section id="prg"><title>prg: External Rewriting Program</title> <p>When a MapType of <code>prg</code> is used, the MapSource is a |