docs: Add missing docs for import directive

This commit is contained in:
Matthew Holt 2020-05-15 10:50:57 -06:00
parent 00c3d67077
commit 5f1bd6374f
3 changed files with 31 additions and 0 deletions

View file

@ -15,6 +15,7 @@ Directive | Description
**[handle](/docs/caddyfile/directives/handle)** | A mutually-exclusive group of directives
**[handle_errors](/docs/caddyfile/directives/handle_errors)** | Defines routes for handling errors
**[header](/docs/caddyfile/directives/header)** | Sets or removes response headers
**[import](/docs/caddyfile/directives/import)** | Include snippets or files
**[log](/docs/caddyfile/directives/log)** | Enables access/request logging
**[php_fastcgi](/docs/caddyfile/directives/php_fastcgi)** | Serve PHP sites over FastCGI
**[redir](/docs/caddyfile/directives/redir)** | Issues an HTTP redirect to the client

View file

@ -0,0 +1,26 @@
---
title: import (Caddyfile directive)
---
# import
Includes a [snippet](/docs/caddyfile/concepts#snippets) or file, replacing this directive with the contents of the snippet or file.
This directive is a special case: it is evaluated before the structure is parsed, and it can appear anywhere in the Caddyfile.
## Syntax
```
import <pattern>
```
- **&lt;pattern&gt;** is the filename, glob pattern, or name of [snippet](/docs/caddyfile/concepts#snippets) to include. Its contents will replace this line as if that file's contents appeared here to begin with. It is an error if a specific file cannot be found, but an empty glob pattern is not an error.
## Examples
Import all files in an adjacent sites-enabled folder:
```
import sites-enabled/*
```

View file

@ -21,6 +21,9 @@ Using `wget`:
<pre><code class="cmd"><span class="bash">wget "https://github.com/caddyserver/caddy/releases/latest/download/ASSET"</span></code></pre>
Replace `ASSET` with the filename for your platform.
## Docker
<pre><code class="cmd bash">docker pull caddy</code></pre>
@ -59,6 +62,7 @@ RHEL/CentOS 7:
[**Deploy a Caddy droplet on DigitalOcean**](https://marketplace.digitalocean.com/apps/caddy)
## macOS
<pre><code class="cmd bash">brew install caddy</code></pre>