utility. (<a href="../rewrite/rewritemap.html#dbm">Details ...</a>)</dd>
<dt>int</dt>
- <dd>One of the four available internal functions provided by
- <code>RewriteMap</code>: toupper, tolower, escape or
- unescape. (<a href="../rewrite/rewritemap.html#int">Details ...</a>)</dd>
+ <dd>One of the five available internal functions provided by
+ <code>RewriteMap</code>: toupper, tolower, escape, unescape, or sleep.
+ (<a href="../rewrite/rewritemap.html#int">Details ...</a>)</dd>
<dt>prg</dt>
<dd>Calls an external program or script to process the
<dd>A dash indicates that no substitution should be performed
(the existing path is passed through untouched). This is used
when a flag (see below) needs to be applied without changing
- the path.</dd>
+ the path. In Apache HTTP Server 2.5.0 and later, a substitution
+ that ultimately expands to this single character is also treated as
+ "no substitution".</dd>
</dl>
<li><strong>unescape</strong>:<br />
Translates hex-encodings in the key back to
special characters.</li>
+ <li><strong>sleep</strong>:<br />
+ Causes the request to sleep for the amount of time specified in
+ the key, in milliseconds. Keys are accepted in the form of
+ "2000", "2000ms", or "2s". This map always returns an empty value.
+ <p> Available since Apache HTTP Server 2.5.0</p> </li>
</ul>
<p>
RewriteMap lc int:tolower<br />
RewriteRule (.*?[A-Z]+.*) ${lc:$1} [R]
</code></p></div>
+
+ <div class="example"><h3>Delay a request by one half of a second</h3><p><code>
+ RewriteMap sleep int:sleep<br />
+ RewriteRule ^/foo/bar.html -${sleep:"500ms"}
+ </code></p></div>
+
<div class="note">
<p>Please note that the example offered here is for