================
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 whether ``HEAD`` requests are
automatically mapped to ``GET`` so that Apache output filters which need to
inspect the complete response body can still produce correct response
headers.

The directive accepts three values:

* ``Auto`` (the default): map ``HEAD`` to ``GET`` only when an output
  filter is registered that needs the full response body, such as
  ``mod_deflate`` or ``mod_cache``.
* ``On``: always map ``HEAD`` to ``GET``, even if no such output filter
  is registered.
* ``Off``: always preserve the original request method.

For example::

  WSGIMapHEADToGET On

The directive may be required where a WSGI application tries to optimise
and avoid doing work for a ``HEAD`` request by not actually generating a
response. By doing this the application can break Apache filters for
caching or compression, so the mapping of ``HEAD`` to ``GET`` can be
needed to avoid problems.