Commit fe19ee1a authored by Ruediger Pluem's avatar Ruediger Pluem
Browse files

* Add a note about trailing slashes for ProxyPass and fix the balancer example 

  accordingly.

PR: 39203


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@409455 13f79535-47bb-0310-9956-ffa450edef68
parent 2c6bfc47

docs/manual/mod/mod_proxy.html.en

+9 −1
Changes for docs/manual/mod/mod_proxy.html.en: 9 added lines, 1 removed line.
Original line number Diff line number Diff line
@@ -674,6 +674,14 @@ through</td></tr> 
    <code>http://example.com/mirror/foo/bar</code> to be internally converted

    into a proxy request to <code>http://backend.example.com/bar</code>.</p>



    <div class="warning">

    <p>If the first argument ends with a trailing <strong>/</strong>, the second

       argument should also end with a trailing <strong>/</strong> and vice

       versa. Otherwise the resulting requests to the backend may miss some

       needed slashes and do not deliver the expected results.

    </p>

    </div>



    <p>The <code>!</code> directive is useful in situations where you don't want

    to reverse-proxy a subdirectory, <em>e.g.</em></p>
@@ -858,7 +866,7 @@ through</td></tr> 
    </table>

    <div class="example"><p><code>

      ProxyPass /special-area http://special.example.com/ smax=5 max=10<br />

      ProxyPass / balancer://mycluster stickysession=jsessionid nofailover=On<br />

      ProxyPass / balancer://mycluster/ stickysession=jsessionid nofailover=On<br />

      &lt;Proxy balancer://mycluster&gt;<br />

      <span class="indent">

        BalancerMember http://1.2.3.4:8009<br />

docs/manual/mod/mod_proxy.xml

+9 −1
Changes for docs/manual/mod/mod_proxy.xml: 9 added lines, 1 removed line.
Original line number Diff line number Diff line
@@ -489,6 +489,14 @@ expressions</description> 
    <code>http://example.com/mirror/foo/bar</code> to be internally converted

    into a proxy request to <code>http://backend.example.com/bar</code>.</p>



    <note type="warning">

    <p>If the first argument ends with a trailing <strong>/</strong>, the second

       argument should also end with a trailing <strong>/</strong> and vice

       versa. Otherwise the resulting requests to the backend may miss some

       needed slashes and do not deliver the expected results.

    </p>

    </note>



    <p>The <code>!</code> directive is useful in situations where you don't want

    to reverse-proxy a subdirectory, <em>e.g.</em></p>
@@ -673,7 +681,7 @@ expressions</description> 
    </table>

    <example>

      ProxyPass /special-area http://special.example.com/ smax=5 max=10<br />

      ProxyPass / balancer://mycluster stickysession=jsessionid nofailover=On<br />

      ProxyPass / balancer://mycluster/ stickysession=jsessionid nofailover=On<br />

      &lt;Proxy balancer://mycluster&gt;<br />

      <indent>

        BalancerMember http://1.2.3.4:8009<br />