Bug 64042

Summary: Extend documentation of FallbackResource to give an example of usage
Product: Apache httpd-2 Reporter: David Spector <apache>
Component: DocumentationAssignee: HTTP Server Documentation List <docs>
Status: RESOLVED FIXED    
Severity: normal CC: apache
Priority: P2    
Version: 2.5-HEAD   
Target Milestone: ---   
Hardware: PC   
OS: All   

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.