mirror of
https://github.com/ninenines/cowboy.git
synced 2025-07-15 12:40:25 +00:00
6672ea0415
Changes include:
* Much simplified route configuration.
* Etag generation is now enabled by default.
* Web mimetypes are now detected by default. A bigger list of
mimetypes can be detected without any additional library.
* Mimetypes can no longer be specified as a list. Copying this
list for new connections is too costy. You can easily convert
it into a function and pass that function to the handler instead.
* You can however specify a single hardcoded mimetype. Mostly
useful when serving a single file, like an index.html file,
to avoid extra operations.
* Specifying a path as a list of tokens is not possible anymore.
Use either a binary or a string.
* Using a private directory will not work if the application
was not started properly. Cowboy will not attempt to find
the location of this directory if the VM doesn't know it,
as this caused issues in some setups.
* Overall the code has been much simplified and clarified,
and of course has now been documented.
34 lines
1.1 KiB
Markdown
34 lines
1.1 KiB
Markdown
cowboy_static
|
|
=============
|
|
|
|
The `cowboy_static` module implements file serving capabilities
|
|
by using the REST semantics provided by `cowboy_rest`.
|
|
|
|
Types
|
|
-----
|
|
|
|
### opts() = {priv_file, atom(), string() | binary()}
|
|
| {priv_file, atom(), string() | binary(), extra()}
|
|
| {file, string() | binary()}
|
|
| {file, string() | binary(), extra()}
|
|
| {priv_dir, atom(), string() | binary()}
|
|
| {priv_dir, atom(), string() | binary(), extra()}
|
|
| {dir, atom(), string() | binary()}
|
|
| {dir, atom(), string() | binary(), extra()}
|
|
|
|
> Configuration for the static handler.
|
|
>
|
|
> The handler can be configured for sending either one file or
|
|
> a directory (including its subdirectories).
|
|
>
|
|
> Extra options allow you to define how the etag should be calculated
|
|
> and how the mimetype of files should be detected. They are defined
|
|
> as follow, but do note that these types are not exported, only the
|
|
> `opts/0` type is public.
|
|
|
|
### extra() = [extra_etag() | extra_mimetypes()]
|
|
|
|
### extra_etag() = {etag, module(), function()} | {etag, false}
|
|
|
|
### extra_mimetypes() = {mimetypes, module(), function()}
|
|
| {mimetypes, binary() | {binary(), binary(), [{binary(), binary()}]}}
|