mirror of
https://github.com/ninenines/cowboy.git
synced 2025-07-14 20:30:23 +00:00
34 lines
908 B
Markdown
34 lines
908 B
Markdown
Static handlers
|
|
===============
|
|
|
|
Purpose
|
|
-------
|
|
|
|
Static handlers are a built-in REST handler for serving files. They
|
|
are available as a convenience and provide fast file serving with
|
|
proper cache handling.
|
|
|
|
It is recommended to use a Content Distribution Network (CDN) or at
|
|
least a dedicated file server running on a dedicated cookie-less
|
|
hostname for serving your application's static files in production.
|
|
|
|
Usage
|
|
-----
|
|
|
|
Static handlers are pre-written REST handlers. They only need
|
|
to be specified in the routing information with the proper options.
|
|
|
|
The following example routing serves all files found in the
|
|
`priv_dir/static/` directory of the application. It uses a
|
|
mimetypes library to figure out the files' content types.
|
|
|
|
``` erlang
|
|
Dispatch = [
|
|
{'_', [
|
|
{"/[...]", cowboy_static, [
|
|
{directory, {priv_dir, static, []}},
|
|
{mimetypes, {fun mimetypes:path_to_mimes/2, default}}
|
|
]}
|
|
]}
|
|
].
|
|
```
|