Bug 64042 - Extend documentation of FallbackResource to give an example of usage
Summary: Extend documentation of FallbackResource to give an example of usage
Status: RESOLVED FIXED
Alias: None
Product: Apache httpd-2
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 2.5-HEAD
Hardware: PC All
: P2 normal (vote)
Target Milestone: ---
Assignee: HTTP Server Documentation List
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2019-12-30 12:38 UTC by David Spector
Modified: 2020-01-02 18:03 UTC (History)
1 user (show)



Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description David Spector 2019-12-30 12:38:54 UTC
https://httpd.apache.org/docs/trunk/en/mod/mod_dir.html includes documentation for FallbackResource. In this documentation it gives the use case of a 'front controller,' implying that redirecting to a single file using FallbackResource allows that file to access the original URL specified by the user's request.

But the description does not explain how to obtain the original URL.

I suggest that the documentation would be more helpful if it explained how to do this in various server languages, or at least in one.

For example, in PHP, the domain is available in $_SERVER['HTTP_HOST'] and the original URL (except for any anchor portion) is available in $_SERVER['REQUEST_URI'].

On my computer, I cannot contribute to the Comments section at the bottom of the page to contribute this suggestion. That section is readonly, with no explanation that I can find. So I am submitting this ticket.

I am submitting this for 2.5, but of course it applies to 2.4 versions as well. I am hoping the documentation could be extended to help other developers.
Comment 1 Rich Bowen 2020-01-02 18:03:57 UTC
r1872257 adds this to the trunk (ie, 2.5) docs.

r1872258 adds it to the 2.4 docs.