https://bz.apache.org/bugzilla/show_bug.cgi?id=69640
Bug ID: 69640
Summary: FallbackResource documentation does not play well with
SetHandler / AddHandler
Product: Apache httpd-2
Version: 2.5-HEAD
Hardware: PC
OS: Mac OS X 10.1
Status: NEW
Severity: normal
Priority: P2
Component: Documentation
Assignee: docs@httpd.apache.org
Reporter: and...@nicols.co.uk
Target Milestone: ---
I've recently discovered that the FallbackResource directive does not play
nicely with SetHandler and AddHandler.
This was previously raised in
https://bz.apache.org/bugzilla/show_bug.cgi?id=52403 but rejected as an
expected behaviour, however it is not documented.
It is not clear from the documentation that the FallbackResource directive is
actually applying a Fallback _Handler_, which only applies if another Handler
is not set. In fact the description of this directive is:
> Define a default URL for requests that don't map to a file
It is also not clear from the SetHandler and AddHandler directives that their
use impacts the FallbackResource directive, though they do note that they have
an impact on other default handlers:
> Because SetHandler overrides default handlers, normal behavior such as
> handling of URLs ending in a slash (/) as directories or index files is
> suppressed.
I would suggest that the documentation for the FallbackResource be updated to:
1. be clearer that the directive sets a fallback _Handler_ when one is not set
2. update the description to mention handlersl too -- for example, something
like "Define a deafult URL for requests that don't map to a file or handler"
I would also suggest that the documentation for SetHandler and AddHandler also
mention that they have an impact on the FallbackResource.
For what it's worth, the approach I'm currently looking at is to make the
SetHandler call conditional on the file existing.
Found with the PHP Apache Docker images. Bug reported there:
https://github.com/docker-library/php/issues/1576
--
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
