Configure > File Directives
This document describes the configuration directives of the file handler.
"file.dir"
- Description:
-
The directive specifies the directory under which should be served for the corresponding path.
Example. Serving files under different pathspaths: "/": file.dir: /path/to/doc-root "/icons": file.dir: /path/to/icons-dir
- Level:
- path
"file.dirlisting"
- Description:
-
A boolean flag (
OFF
, orON
) specifying whether or not to send the directory listing in case none of the index files exist. - Level:
- global, host, path
- Default:
file.dirlisting: OFF
"file.etag"
- Description:
-
A boolean flag (
OFF
, orON
) specifying whether or not to send etags. - Level:
- global, host, path
- Default:
file.etag: ON
"file.index"
- Description:
-
Specifies the names of the files that should be served when the client sends a request against the directory.
The sequence of filenames afer search from left to right, and the first file that existed is sent to the client.
- Level:
- global, host, path
- Default:
file.index: [ 'index.html', 'index.htm', 'index.txt' ]
"file.mime.addtypes"
- Description:
-
The directive modifies the MIME mappings by adding the specified MIME type mappings.
Example. Adding MIME mappingsfile.mime.addtypes: "application/javascript": ".js" "image/jpeg": [ ".jpg", ".jpeg" ]
The default mappings is hard-coded in lib/handler/mimemap/defaults.c.h.
- Level:
- global, host, path
"file.mime.removetypes"
- Description:
-
Removes the MIME mappings for specified extensions supplied as a sequence of extensions.
Example. Removing MIME mappingsfile.mime.removetypes: [ ".jpg", ".jpeg" ]
- Level:
- global, host, path
"file.mime.setdefaulttype"
- Description:
-
Sets the default MIME-type that is used when an extension does not exist in the MIME mappings
- Level:
- global, host, path
- Default:
file.mime.setdefaulttype: "application/octet-stream"
"file.mime.settypes"
- Description:
-
Resets the MIME mappings to given mapping.
Example. Resetting the MIME mappings to minimumfile.mime.settypes: "text/html": [ ".html", ".htm" ] "text/plain": ".txt"
- Level:
- global, host, path
"file.send-gzip"
- Description:
-
A boolean flag (
ON
orOFF
) indicating whether or not so send.gz
variants if possible.If set to
ON
, the handler looks for a file with.gz
appended and sends the file (i.e. sends the contents ofindex.html.gz
in place ofindex.html
) if the client is capable of transparently decoding a gzipped response. - Level:
- global, host, path
- Default:
file.send-gzip: OFF