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.