granicus.if.org Git - apache/blob - docs/manual/rewrite/rewritemap.html.en

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
   4 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>Using RewriteMap - Apache HTTP Server Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body id="manual-page"><div id="page-header">
  19 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
  20 <p class="apache">Apache HTTP Server Version 2.5</p>
  21 <img alt="" src="../images/feather.png" /></div>
  22 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  23 <div id="path">
  24 <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/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Using RewriteMap</h1>
  25 <div class="toplang">
  26 <p><span>Available Languages: </span><a href="../en/rewrite/rewritemap.html" title="English">&nbsp;en&nbsp;</a> |
  27 <a href="../fr/rewrite/rewritemap.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a></p>
  28 </div>
  29
  30
  31     <p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
  32 <a href="../mod/mod_rewrite.html">reference documentation</a>. It describes
  33 the use of the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive,
  34 and provides examples of each of the various <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> types.</p>
  35
  36     <div class="warning">Note that many of these examples won't work unchanged in your
  37 particular server configuration, so it's important that you understand
  38 them, rather than merely cutting and pasting the examples into your
  39 configuration.</div>
  40
  41   </div>
  42 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
  43 <li><img alt="" src="../images/down.gif" /> <a href="#int">int: Internal Function</a></li>
  44 <li><img alt="" src="../images/down.gif" /> <a href="#txt">txt: Plain text maps</a></li>
  45 <li><img alt="" src="../images/down.gif" /> <a href="#rnd">rnd: Randomized Plain Text</a></li>
  46 <li><img alt="" src="../images/down.gif" /> <a href="#dbm">dbm: DBM Hash File</a></li>
  47 <li><img alt="" src="../images/down.gif" /> <a href="#prg">prg: External Rewriting Program</a></li>
  48 <li><img alt="" src="../images/down.gif" /> <a href="#dbd">dbd or fastdbd: SQL Query</a></li>
  49 <li><img alt="" src="../images/down.gif" /> <a href="#summary">Summary</a></li>
  50 </ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</a></li></ul></div>
  51 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  52 <div class="section">
  53 <h2><a name="introduction" id="introduction">Introduction</a> <a title="Permanent link" href="#introduction" class="permalink">&para;</a></h2>
  54
  55
  56    <p>
  57    The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive
  58    defines an external function which can be called in the context of
  59    <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> or
  60    <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> directives to
  61    perform rewriting that is too complicated, or too specialized to be
  62    performed just by regular expressions. The source of this lookup can
  63    be any of the types listed in the sections below, and enumerated in
  64    the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> reference
  65    documentation.</p>
  66
  67    <p>The syntax of the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
  68    directive is as follows:</p>
  69
  70 <pre class="prettyprint lang-config">RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em>
  71 </pre>
  72
  73
  74     <p>The <a id="mapfunc" name="mapfunc"><em>MapName</em></a> is an
  75     arbitray name that you assign to the map, and which you will use in
  76     directives later on. Arguments are passed to the map via the
  77     following syntax:</p>
  78
  79     <p class="indent">
  80       <strong>
  81         <code>${</code> <em>MapName</em> <code>:</code> <em>LookupKey</em>
  82         <code>}</code> <br /> <code>${</code> <em>MapName</em> <code>:</code>
  83         <em>LookupKey</em> <code>|</code> <em>DefaultValue</em> <code>}</code>
  84       </strong>
  85     </p>
  86
  87     <p>When such a construct occurs, the map <em>MapName</em> is
  88       consulted and the key <em>LookupKey</em> is looked-up. If the
  89       key is found, the map-function construct is substituted by
  90       <em>SubstValue</em>. If the key is not found then it is
  91       substituted by <em>DefaultValue</em> or by the empty string
  92       if no <em>DefaultValue</em> was specified.</p>
  93
  94     <p>For example, you can define a
  95       <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> as:</p>
  96     <pre class="prettyprint lang-config">RewriteMap examplemap "txt:/path/to/file/map.txt"</pre>
  97
  98     <p>You would then be able to use this map in a
  99       <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> as follows:</p>
 100       <pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1}"</pre>
 101
 102
 103 <p>A default value can be specified in the event that nothing is found
 104 in the map:</p>
 105
 106 <pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1|/not_found.html}"</pre>
 107
 108
 109 <div class="note"><h3>Per-directory and .htaccess context</h3>
 110 <p>
 111 The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive may not be
 112 used in <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> sections or
 113 <code>.htaccess</code> files. You must
 114 declare the map in server or virtualhost context. You may use the map,
 115 once created, in your <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> and
 116 <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> directives in those
 117 scopes. You just can't <strong>declare</strong> it in those scopes.</p>
 118 </div>
 119
 120 <p>The sections that follow describe the various <em>MapType</em>s that
 121 may be used, and give examples of each.</p>
 122   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 123 <div class="section">
 124 <h2><a name="int" id="int">int: Internal Function</a> <a title="Permanent link" href="#int" class="permalink">&para;</a></h2>
 125
 126
 127     <p>When a MapType of <code>int</code> is used, the MapSource is one
 128     of the available internal <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
 129     functions.  Module authors can provide
 130     additional internal functions by registering them with the
 131     <code>ap_register_rewrite_mapfunc</code> API.
 132     The functions that are provided by default are:
 133     </p>
 134
 135     <ul>
 136       <li><strong>toupper</strong>:<br />
 137              Converts the key to all upper case.</li>
 138       <li><strong>tolower</strong>:<br />
 139              Converts the key to all lower case.</li>
 140       <li><strong>escape</strong>:<br />
 141              Translates special characters in the key to
 142             hex-encodings.</li>
 143       <li><strong>unescape</strong>:<br />
 144              Translates hex-encodings in the key back to
 145             special characters.</li>
 146     </ul>
 147
 148     <p>
 149     To use one of these functions, create a <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> referencing
 150     the int function, and then use that in your <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>:
 151     </p>
 152
 153    <p> <strong>Redirect a URI to an all-lowercase version of itself</strong></p>
 154     <pre class="prettyprint lang-config">RewriteMap lc int:tolower
 155 RewriteRule "(.*)" "${lc:$1}" [R]</pre>
 156
 157
 158     <div class="note">
 159     <p>Please note that the example offered here is for
 160     illustration purposes only, and is not a recommendation. If you want
 161     to make URLs case-insensitive, consider using
 162     <code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code> instead.
 163     </p>
 164     </div>
 165
 166   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 167 <div class="section">
 168 <h2><a name="txt" id="txt">txt: Plain text maps</a> <a title="Permanent link" href="#txt" class="permalink">&para;</a></h2>
 169
 170
 171     <p>When a MapType of <code>txt</code> is used, the MapSource is a filesystem path to a
 172     plain-text mapping file, containing one space-separated key/value pair
 173     per line. Optionally, a line may contain a comment, starting with
 174     a '#' character.</p>
 175
 176     <p>A valid text rewrite map file will have the following syntax:</p>
 177
 178     <div class="example"><p><code>
 179       # Comment line<br />
 180       <strong><em>MatchingKey</em> <em>SubstValue</em></strong><br />
 181       <strong><em>MatchingKey</em> <em>SubstValue</em></strong> # comment<br />
 182     </code></p></div>
 183
 184     <p>When the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> is invoked
 185     the argument is looked for in the
 186     first argument of a line, and, if found, the substitution value is
 187     returned.</p>
 188
 189     <p>For example, we can use a mapfile to translate product names to
 190     product IDs for easier-to-remember URLs, using the following
 191     recipe:</p>
 192 <p><strong>Product to ID configuration</strong></p>
 193     <pre class="prettyprint lang-config">RewriteMap product2id "txt:/etc/apache2/productmap.txt"
 194 RewriteRule "^/product/(.*)" "/prods.php?id=${product2id:$1|NOTFOUND}" [PT]</pre>
 195
 196
 197     <p>We assume here that the <code>prods.php</code> script knows what
 198     to do when it received an argument of <code>id=NOTFOUND</code> when
 199     a product is not found in the lookup map.</p>
 200
 201     <p>The file <code>/etc/apache2/productmap.txt</code> then contains
 202     the following:</p>
 203
 204     <div class="example"><h3>Product to ID map</h3><p><code>
 205 ##<br />
 206 ##  productmap.txt - Product to ID map file<br />
 207 ##<br />
 208 <br />
 209 television 993<br />
 210 stereo     198<br />
 211 fishingrod 043<br />
 212 basketball 418<br />
 213 telephone  328
 214     </code></p></div>
 215
 216     <p>Thus, when <code>http://example.com/product/television</code> is
 217     requested, the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> is
 218     applied, and the request
 219     is internally mapped to <code>/prods.php?id=993</code>.</p>
 220
 221     <div class="note"><h3>Note: .htaccess files</h3>
 222     The example given is crafted to be used in server or virtualhost
 223     scope. If you're planning to use this in a <code>.htaccess</code>
 224     file, you'll need to remove the leading slash from the rewrite
 225     pattern in order for it to match anything:
 226     <pre class="prettyprint lang-config">RewriteRule "^product/(.*)" "/prods.php?id=${product2id:$1|NOTFOUND}" [PT]</pre>
 227
 228     </div>
 229
 230     <div class="note"><h3>Cached lookups</h3>
 231     <p>
 232     The looked-up keys are cached by httpd until the <code>mtime</code>
 233     (modified time) of the mapfile changes, or the httpd server is
 234     restarted. This ensures better performance on maps that are called
 235     by many requests.
 236     </p>
 237     </div>
 238
 239   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 240 <div class="section">
 241 <h2><a name="rnd" id="rnd">rnd: Randomized Plain Text</a> <a title="Permanent link" href="#rnd" class="permalink">&para;</a></h2>
 242
 243
 244     <p>When a MapType of <code>rnd</code> is used, the MapSource is a
 245     filesystem path to a plain-text mapping file, each line of which
 246     contains a key, and one or more values separated by <code>|</code>.
 247     One of these values will be chosen at random if the key is
 248     matched.</p>
 249
 250     <p>For example, you can use the following map
 251     file and directives to provide a random load balancing between
 252     several back-end servers, via a reverse-proxy. Images are sent
 253     to one of the servers in the 'static' pool, while everything
 254     else is sent to one of the 'dynamic' pool.</p>
 255
 256     <div class="example"><h3>Rewrite map file</h3><p><code>
 257 ##<br />
 258 ##  map.txt -- rewriting map<br />
 259 ##<br />
 260 <br />
 261 static   www1|www2|www3|www4<br />
 262 dynamic  www5|www6
 263     </code></p></div>
 264 <p><strong>Configuration directives</strong></p>
 265     <pre class="prettyprint lang-config">RewriteMap servers "rnd:/path/to/file/map.txt"
 266
 267 RewriteRule "^/(.*\.(png|gif|jpg))" "http://${servers:static}/$1"  [NC,P,L]
 268 RewriteRule "^/(.*)"                "http://${servers:dynamic}/$1" [P,L]</pre>
 269
 270
 271     <p>So, when an image is requested and the first of these rules is
 272     matched, <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> looks up the string
 273     <code>static</code> in the map file, which returns one of the
 274     specified hostnames at random, which is then used in the
 275     <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> target.</p>
 276
 277     <p>If you wanted to have one of the servers more likely to be chosen
 278     (for example, if one of the server has more memory than the others,
 279     and so can handle more requests) simply list it more times in the
 280     map file.</p>
 281
 282     <div class="example"><p><code>
 283 static   www1|www1|www2|www3|www4
 284     </code></p></div>
 285
 286   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 287 <div class="section">
 288 <h2><a name="dbm" id="dbm">dbm: DBM Hash File</a> <a title="Permanent link" href="#dbm" class="permalink">&para;</a></h2>
 289
 290
 291     <p>When a MapType of <code>dbm</code> is used, the MapSource is a
 292     filesystem path to a DBM database file containing key/value pairs to
 293     be used in the mapping. This works exactly the same way as the
 294     <code>txt</code> map, but is much faster, because a DBM is indexed,
 295     whereas a text file is not. This allows more rapid access to the
 296     desired key.</p>
 297
 298     <p>You may optionally specify a particular dbm type:</p>
 299
 300  <pre class="prettyprint lang-config">RewriteMap examplemap "dbm=sdbm:/etc/apache/mapfile.dbm"</pre>
 301
 302
 303     <p>The type can be <code>sdbm</code>, <code>gdbm</code>, <code>ndbm</code>
 304     or <code>db</code>.
 305     However, it is recommended that you just use the <a href="../programs/httxt2dbm.html">httxt2dbm</a> utility that is
 306     provided with Apache HTTP Server, as it will use the correct DBM library,
 307     matching the one that was used when httpd itself was built.</p>
 308
 309     <p>To create a dbm file, first create a text map file as described
 310     in the <a href="#txt">txt</a> section. Then run
 311     <code>httxt2dbm</code>:</p>
 312
 313 <div class="example"><p><code>
 314 $ httxt2dbm -i mapfile.txt -o mapfile.map
 315 </code></p></div>
 316
 317 <p>You can then reference the resulting file in your
 318 <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive:</p>
 319
 320 <pre class="prettyprint lang-config">RewriteMap mapname "dbm:/etc/apache/mapfile.map"</pre>
 321
 322
 323 <div class="note">
 324 <p>Note that with some dbm types, more than one file is generated, with
 325 a common base name. For example, you may have two files named
 326 <code>mapfile.map.dir</code> and <code>mapfiile.map.pag</code>. This is
 327 normal, and you need only use the base name <code>mapfile.map</code> in
 328 your <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive.</p>
 329 </div>
 330
 331 <div class="note"><h3>Cached lookups</h3>
 332 <p>
 333 The looked-up keys are cached by httpd until the <code>mtime</code>
 334 (modified time) of the mapfile changes, or the httpd server is
 335 restarted. This ensures better performance on maps that are called
 336 by many requests.
 337 </p>
 338 </div>
 339
 340   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 341 <div class="section">
 342 <h2><a name="prg" id="prg">prg: External Rewriting Program</a> <a title="Permanent link" href="#prg" class="permalink">&para;</a></h2>
 343
 344     <p>When a MapType of <code>prg</code> is used, the MapSource is a
 345     filesystem path to an executable program which will providing the
 346     mapping behavior. This can be a compiled binary file, or a program
 347     in an interpreted language such as Perl or Python.</p>
 348
 349     <p>This program is started once, when the Apache HTTP Server is
 350     started, and then communicates with the rewriting engine via
 351     <code>STDIN</code> and <code>STDOUT</code>. That is, for each map
 352     function lookup, it expects one argument via <code>STDIN</code>, and
 353     should return one new-line terminated response string on
 354     <code>STDOUT</code>. If there is no corresponding lookup value, the
 355     map program should return the four-character string
 356     "<code>NULL</code>" to indicate this.</p>
 357
 358     <p>External rewriting programs are not started if they're defined in
 359     a context that does not have <code class="directive"><a href="../mod/mod_rewrite.html#rewriteengine">RewriteEngine</a></code> set to
 360     <code>on</code>.</p>
 361
 362     <p>By default, external rewriting programs are run as the
 363     user:group who started httpd. This can be changed on UNIX systems
 364     by passing user name and group name as third argument to
 365     <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> in the
 366     <code>username:groupname</code> format.</p>
 367
 368     <p>This feature utilizes the <code>rewrite-map</code> mutex,
 369     which is required for reliable communication with the program.
 370     The mutex mechanism and lock file can be configured with the
 371     <code class="directive"><a href="../mod/core.html#mutex">Mutex</a></code> directive.</p>
 372
 373     <p>A simple example is shown here which will replace all dashes with
 374     underscores in a request URI.</p>
 375
 376     <p><strong>Rewrite configuration</strong></p>
 377     <pre class="prettyprint lang-config">RewriteMap d2u "prg:/www/bin/dash2under.programlisting" apache:apache
 378 RewriteRule "-" "${d2u:%{REQUEST_URI}}"</pre>
 379
 380
 381     <p><strong>dash2under.pl</strong></p>
 382     <pre class="prettyprint lang-perl">#!/usr/bin/perl
 383 $| = 1; # Turn off I/O buffering
 384 while (&lt;STDIN&gt;) {
 385     s/-/_/g; # Replace dashes with underscores
 386     print $_;
 387 }</pre>
 388
 389
 390 <div class="note"><h3>Caution!</h3>
 391 <ul>
 392 <li>Keep your rewrite map program as simple as possible. If the program
 393 hangs, it will cause httpd to wait indefinitely for a response from the
 394 map, which will, in turn, cause httpd to stop responding to
 395 requests.</li>
 396 <li>Be sure to turn off buffering in your program. In Perl this is done
 397 by the second line in the example script: <code>$| = 1;</code> This will
 398 of course vary in other languages. Buffered I/O will cause httpd to wait
 399 for the output, and so it will hang.</li>
 400 <li>Remember that there is only one copy of the program, started at
 401 server startup. All requests will need to go through this one bottleneck.
 402 This can cause significant slowdowns if many requests must go through
 403 this process, or if the script itself is very slow.</li>
 404 </ul>
 405 </div>
 406
 407 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 408 <div class="section">
 409 <h2><a name="dbd" id="dbd">dbd or fastdbd: SQL Query</a> <a title="Permanent link" href="#dbd" class="permalink">&para;</a></h2>
 410
 411
 412     <p>When a MapType of <code>dbd</code> or <code>fastdbd</code> is
 413     used, the MapSource is a SQL SELECT statement that takes a single
 414     argument and returns a single value.</p>
 415
 416     <p><code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> will need to be configured to point at
 417     the right database for this statement to be executed.</p>
 418
 419     <p>There are two forms of this MapType.
 420     Using a MapType of <code>dbd</code> causes the query to be
 421     executed with each map request, while using <code>fastdbd</code>
 422     caches the database lookups internally. So, while
 423     <code>fastdbd</code> is more efficient, and therefore faster, it
 424     won't pick up on changes to the database until the server is
 425     restarted.</p>
 426
 427     <p>If a query returns more than one row, a random row from
 428     the result set is used.</p>
 429
 430     <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">RewriteMap myquery "fastdbd:SELECT destination FROM rewrite WHERE source = %s"</pre>
 431 </div>
 432
 433     <div class="note"><h3>Note</h3>
 434     <p>The query name is passed to the database driver as a label for
 435     an SQL prepared statement, and will therefore need to follow any rules
 436     (such as case-sensitivity) required for your database.</p></div>
 437
 438   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 439 <div class="section">
 440 <h2><a name="summary" id="summary">Summary</a> <a title="Permanent link" href="#summary" class="permalink">&para;</a></h2>
 441
 442
 443     <p>The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive can
 444     occur more than once. For each mapping-function use one
 445     <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive to declare
 446     its rewriting mapfile.</p>
 447
 448     <p>While you cannot <strong>declare</strong> a map in
 449     per-directory context (<code>.htaccess</code> files or
 450     <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> blocks) it is
 451     possible to <strong>use</strong> this map in per-directory context.</p>
 452
 453   </div></div>
 454 <div class="bottomlang">
 455 <p><span>Available Languages: </span><a href="../en/rewrite/rewritemap.html" title="English">&nbsp;en&nbsp;</a> |
 456 <a href="../fr/rewrite/rewritemap.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a></p>
 457 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
 458 <script type="text/javascript"><!--//--><![CDATA[//><!--
 459 var comments_shortname = 'httpd';
 460 var comments_identifier = 'http://httpd.apache.org/docs/trunk/rewrite/rewritemap.html';
 461 (function(w, d) {
 462     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 463         d.write('<div id="comments_thread"><\/div>');
 464         var s = d.createElement('script');
 465         s.type = 'text/javascript';
 466         s.async = true;
 467         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 468         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 469     }
 470     else {
 471         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 472     }
 473 })(window, document);
 474 //--><!]]></script></div><div id="footer">
 475 <p class="apache">Copyright 2019 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>
 476 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 477 if (typeof(prettyPrint) !== 'undefined') {
 478     prettyPrint();
 479 }
 480 //--><!]]></script>
 481 </body></html>