-
Notifications
You must be signed in to change notification settings - Fork 271
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Loading status checks…
Add docs for WSGIMapHEADToGET directive.
1 parent
3d7a321
commit d49ed1b
Showing
2 changed files
with
24 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
================== | ||
WSGIMapHEADToGET | ||
================== | ||
|
||
:Description: Enable/disable mapping of HEAD request to GET. | ||
:Syntax: ``WSGIMapHEADToGET On|Off|Auto`` | ||
:Default: ``WSGIMapHEADToGET Auto`` | ||
:Context: server config, virtual host, directory, .htaccess | ||
|
||
The ``WSGIMapHEADToGET`` directive controls the behaviour of automatically | ||
mapping any ``HEAD`` request to a ``GET`` request when an Apache output filter | ||
is registered that may want to see the complete response in order to generate | ||
correct response headers. | ||
|
||
The directive can be set to be either ``Auto`` (the default), ``On`` which | ||
will always map a ``HEAD`` to ``GET`` even if no output filters detected and | ||
``Off`` to always preserve the original request method type. | ||
|
||
The directive may be required where a WSGI application tries to optimize and | ||
avoid doing work for a ``HEAD`` request by not actually generating a response | ||
so that complete response headers can still be generated. By doing this the | ||
WSGI application can break Apache filters for caching, so the mapping of | ||
``HEAD`` to ``GET`` can be required to avoid problems. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters