When placed into an .htaccess file or a <Directory> or <Location> section, this directive forces all matching files to be parsed through the handler given by handler-name. For example, if you had a directory you wanted to be parsed entirely as imagemap rule files, regardless of extension, you might put the following into an .htaccess file in that directory:

SetHandler imap-file

Another example: if you wanted to have the server display a status report whenever a URL of http://servername/status was called, you might put the following into apache2.conf :

<Location "/status">
 SetHandler server-status
</Location>

You could also use this directive to configure a particular handler for files with a particular file extension. For example:

<FilesMatch "\.php$">
 SetHandler application/x-httpd-php
</FilesMatch>

String-valued expressions can be used to reference per-request variables, including backreferences to named regular expressions:

<LocationMatch ^/app/(?<sub>[^/]+)/>
 SetHandler "proxy:unix:/var/run/app_%{env:MATCH_sub}.sock|fcgi://localhost:8080"
</LocationMatch>

You can override an earlier defined SetHandler directive by using the value None .

See also

• AddHandler