diff options
author | Eric Covener <covener@apache.org> | 2023-03-11 22:41:08 +0000 |
---|---|---|
committer | Eric Covener <covener@apache.org> | 2023-03-11 22:41:08 +0000 |
commit | 114adea813e5b2f5f18b4c19e0e9e6390507e9a7 (patch) | |
tree | 74aa375625453d949ec13e7f4614c14382091a6e | |
parent | 4783569c0c1ef162d78a40ff60eb403fcecf4226 (diff) | |
download | httpd-114adea813e5b2f5f18b4c19e0e9e6390507e9a7.tar.gz |
Merge r1908302 from trunk:
move B=xx example to the bottom
show example with quoted flags and a space
[skip ci]
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1908303 13f79535-47bb-0310-9956-ffa450edef68
-rw-r--r-- | docs/manual/rewrite/flags.html.en | 16 | ||||
-rw-r--r-- | docs/manual/rewrite/flags.xml | 17 |
2 files changed, 25 insertions, 8 deletions
diff --git a/docs/manual/rewrite/flags.html.en b/docs/manual/rewrite/flags.html.en index 5ffd1b2eb0..caa4883f45 100644 --- a/docs/manual/rewrite/flags.html.en +++ b/docs/manual/rewrite/flags.html.en @@ -85,10 +85,6 @@ of how you might use them.</p> <h2><a name="flag_b" id="flag_b">B (escape backreferences)</a></h2> <p>The [B] flag instructs <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to escape non-alphanumeric characters before applying the transformation.</p> -<p>In 2.4.26 and later, you can limit the escaping to specific characters -in backreferences by listing them: <code>[B=#?;]</code>. Note: The space -character can be used in the list of characters to escape, but it cannot be -the last character in the list.</p> <p><code>mod_rewrite</code> has to unescape URLs before mapping them, so backreferences are unescaped at the time they are applied. @@ -120,6 +116,18 @@ when the backend may break if presented with an unescaped URL.</p> <p>An alternative to this flag is using a <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> to capture against %{THE_REQUEST} which will capture strings in the encoded form.</p> + +<p>In 2.4.26 and later, you can limit the escaping to specific characters +in backreferences by listing them: <code>[B=#?;]</code>. Note: The space +character can be used in the list of characters to escape, but you must quote +the entire third argument of <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> +and the space must not be the last character in the list.</p> + +<pre class="prettyprint lang-config"># Escape spaces and question marks. +RewriteRule "^search/(.*)$" "/search.php?term=$1" "[B= ?]"</pre> + + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="flag_bnp" id="flag_bnp">BNP|backrefnoplus (don't escape space to +)</a></h2> diff --git a/docs/manual/rewrite/flags.xml b/docs/manual/rewrite/flags.xml index 41dfcac57c..d6855db0b9 100644 --- a/docs/manual/rewrite/flags.xml +++ b/docs/manual/rewrite/flags.xml @@ -70,10 +70,6 @@ of how you might use them.</p> <p>The [B] flag instructs <directive module="mod_rewrite">RewriteRule</directive> to escape non-alphanumeric characters before applying the transformation.</p> -<p>In 2.4.26 and later, you can limit the escaping to specific characters -in backreferences by listing them: <code>[B=#?;]</code>. Note: The space -character can be used in the list of characters to escape, but it cannot be -the last character in the list.</p> <p><code>mod_rewrite</code> has to unescape URLs before mapping them, so backreferences are unescaped at the time they are applied. @@ -109,6 +105,19 @@ when the backend may break if presented with an unescaped URL.</p> <p>An alternative to this flag is using a <directive module="mod_rewrite" >RewriteCond</directive> to capture against %{THE_REQUEST} which will capture strings in the encoded form.</p> + +<p>In 2.4.26 and later, you can limit the escaping to specific characters +in backreferences by listing them: <code>[B=#?;]</code>. Note: The space +character can be used in the list of characters to escape, but you must quote +the entire third argument of <directive module="mod_rewrite">RewriteRule</directive> +and the space must not be the last character in the list.</p> + +<highlight language="config"> +# Escape spaces and question marks. +RewriteRule "^search/(.*)$" "/search.php?term=$1" "[B= ?]" +</highlight> + + </section> <section id="flag_bnp"><title>BNP|backrefnoplus (don't escape space to +)</title> |