You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by yl...@apache.org on 2021/12/13 15:07:46 UTC
svn commit: r1895895 - /httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml
Author: ylavic
Date: Mon Dec 13 15:07:45 2021
New Revision: 1895895
URL: http://svn.apache.org/viewvc?rev=1895895&view=rev
Log:
Improve docs for ProxyPass mapping= parameter. [skip ci]
Modified:
httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml
Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml?rev=1895895&r1=1895894&r2=1895895&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml Mon Dec 13 15:07:45 2021
@@ -1285,9 +1285,20 @@ ProxyPass "/example" "http://backend.exa
</td></tr>
<tr><td>mapping</td>
<td>-</td>
- <td><p>Mapping to process the <var>url</var> before choosing a Worker/Balancer.
- 'servlet' maps like a servlet container (like jk_servlet_normalize), use with Apache Tomcat for example.
- 'encoded' maps it encoded.</p>
+ <td><p>Type of mapping between the <var>path</var> and the <var>url</var>.
+ This determines the normalization and/or (non-)decoding that <module>mod_proxy</module> will
+ apply to the request's <var>uri-path</var> to match the <var>path</var>. If/when the mapping
+ matches, the request <var>uri-path</var> is committed such that <code><Location</code>
+ and other directory contexts using a path will match according to the same mapping.</p>
+ <p>The <code>encoded</code> mapping avoids the %-decoding of the <var>uri-path</var> such that
+ one can match for instance <code>/some%2furi%2fpath%2fwith%2fslash</code> in a <code>ProxyPass</code>
+ or <code><Location</code> context.</p>
+ <p>The <code>servlet</code> mapping refers to the one defined by the Servlet specification, which
+ is for instance applied by Apache Tomcat for servlet containers (notably the path parameters are
+ ignored for the mapping). An <var>uri-path</var> like <code>/some;foo/path</code> is then mapped
+ as <code>/some/path</code> and thus matches <code><Location /some/path></code> or
+ <code>ProxyPass "/some/path" "https://tomcat.example.com"</code> regardless of the requested
+ path parameters.</p>
</td></tr>
</table>