diff options
Diffstat (limited to 'docs/manual/mod/mod_substitute.html.en')
| -rw-r--r-- | docs/manual/mod/mod_substitute.html.en | 18 |
1 files changed, 10 insertions, 8 deletions
diff --git a/docs/manual/mod/mod_substitute.html.en b/docs/manual/mod/mod_substitute.html.en index 93854e10..b51f2f76 100644 --- a/docs/manual/mod/mod_substitute.html.en +++ b/docs/manual/mod/mod_substitute.html.en @@ -46,7 +46,9 @@ <li><img alt="" src="../images/down.gif" /> <a href="#substituteinheritbefore">SubstituteInheritBefore</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#substitutemaxlinelength">SubstituteMaxLineLength</a></li> </ul> -<ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_substitute">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_substitute">Report a bug</a></li></ul><h3>See also</h3> +<ul class="seealso"> +<li><a href="#comments_section">Comments</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="Substitute" id="Substitute">Substitute</a> <a name="substitute" id="substitute">Directive</a></h2> @@ -72,11 +74,11 @@ Using the <code>n</code> flag forces the pattern to be treated as a fixed string.</dd> <dt><code>f</code></dt> - <dd>The <code>f</code> flag causes mod_substitute to flatten the + <dd>The <code>f</code> flag causes <code>mod_substitute</code> to flatten the result of a substitution allowing for later substitutions to take place on the boundary of this one. This is the default.</dd> <dt><code>q</code></dt> - <dd>The <code>q</code> flag causes mod_substitute to not + <dd>The <code>q</code> flag causes <code>mod_substitute</code> to not flatten the buckets after each substitution. This can result in much faster response and a decrease in memory utilization, but should only be used if there is no possibility @@ -103,7 +105,7 @@ when regular expressions are used, as illustrated in the following example: </p> <div class="example"><h3>Example of using backreferences and captures</h3><pre class="prettyprint lang-config"><Location "/"> AddOutputFilterByType SUBSTITUTE text/html - # "foo=k,bar=k" -> "foo/bar=k" + # "foo=k,bar=k" -> "foo/bar=k" Substitute "s|foo=(\w+),bar=\1|foo/bar=$1" </Location></pre> </div> @@ -114,10 +116,10 @@ to the back-end server. These URLs don't work for the end-user, since the back-end server is unreachable.</p> - <p>In this case, <code>mod_substutite</code> can be used to rewrite + <p>In this case, <code>mod_substitute</code> can be used to rewrite those URLs into something that will work from the front end:</p> - <div class="example"><h3>Rewriting URLs embedded in proxied content</h3><pre class="prettyprint lang-config">ProxyPass "/blog/" "http://internal.blog.example.com" + <div class="example"><h3>Rewriting URLs embedded in proxied content</h3><pre class="prettyprint lang-config">ProxyPass "/blog/" "http://internal.blog.example.com" ProxyPassReverse "/blog/" "http://internal.blog.example.com/" Substitute "s|http://internal.blog.example.com/|http://www.example.com/blog/|i"</pre> @@ -126,7 +128,7 @@ Substitute "s|http://internal.blog.example.com/|http://www.example.com/blog/|i"< <p><code class="directive"><a href="../mod/mod_proxy.html#proxypassreverse">ProxyPassReverse</a></code> modifies any <code>Location</code> (redirect) headers that are sent by the back-end server, and, in this example, - <code>Substitute</code> takes care of the rest of the problem by + <code class="directive">Substitute</code> takes care of the rest of the problem by fixing up the HTML response as well.</p> @@ -143,7 +145,7 @@ Substitute "s|http://internal.blog.example.com/|http://www.example.com/blog/|i"< <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_substitute</td></tr> <tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in httpd 2.4.17 and later</td></tr> </table> - <p>Whether to apply the inherited <code class="directive">Substitute</code> + <p>Whether to apply the inherited <code class="directive"><a href="#substitute">Substitute</a></code> patterns first (<code>on</code>), or after the ones of the current context (<code>off</code>). <code class="directive">SubstituteInheritBefore</code> is itself inherited, |