https://issues.apache.org/bugzilla/show_bug.cgi?id=54158
Bug ID: 54158
Summary: Suggestion regarding 2.0 to 2.2 Upgrade Documentation
and mod_proxy documentation
Product: Apache httpd-2
Version: 2.5-HEAD
Hardware: PC
OS: Linux
Status: NEW
Severity: normal
Priority: P2
Component: Documentation
Assignee: docs@httpd.apache.org
Reporter: henry.szabli...@budget.ny.gov
Classification: Unclassified
Hello docs-project,
I have a suggestion regarding the 2.0 to 2.2 upgrade documentation, and the
mod_proxy documentation. After upgrading we noticed a behavior change of
ProxyPass, specifically in how it works when used alongside RewriteRules. In
2.0.64 we were able to mix them, and they appeared to be processed
sequentially. However, in 2.2.23 it seems that RewriteRules are processed
first, and then the ProxyPass lines. We came to this conclusion when we saw
our “catchall” rewrite rule at the bottom of our configuration getting
triggered before any ProxyPass requests. We solved this by simply using
RewriteRules for everything.
I found enough in the documentation to indicate that this is an intended
behavior. I found it by going to the documentation for mod_rewrite, then the
“more detailed mod_rewrite documentation”, and then finally “when not to use
mod_rewrite” which is here http://httpd.apache.org/docs/2.2/rewrite/avoid.html.
In the section on “Simple Proxying” after explaining ProxyPass, it has a note:
"You may need to use RewriteRule instead when there are other RewriteRules in
effect in the same scope, as a RewriteRule will usually take effect before a
ProxyPass, and so may preempt what you're trying to accomplish."
I could not find mention of this at all in the mod_proxy documentation at
http://httpd.apache.org/docs/2.2/mod/mod_proxy.html (which was my first stop in
trying to figure this out)... having the only mention of this need to use
mod_rewrite in a section titled "when *not* to use mod_rewrite" seems a bit
awkward.
So my suggestion would be to include mention of this behavior change in the
upgrade documentation at http://httpd.apache.org/docs/2.2/upgrading.html
(provided that this is an intended behavior change), and possibly include the
same note quoted above in the mod_proxy documentation.
Thank you for your time,
-Henry S.
--
You are receiving this mail because:
You are the assignee for the bug.
---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscr...@httpd.apache.org
For additional commands, e-mail: docs-h...@httpd.apache.org
