Skip to content

Commit 1985f70

Browse files
committed
docs: clarify Caddyfile placeholder timing
Signed-off-by: Zen Dodd <mail@steadytao.com>
1 parent 378d6d0 commit 1985f70

1 file changed

Lines changed: 2 additions & 0 deletions

File tree

src/docs/markdown/caddyfile/concepts.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -662,6 +662,8 @@ You can use any placeholders in the Caddyfile, but for convenience you can also
662662

663663
Not all config fields support placeholders, but most do where you would expect it. Support for placeholders needs to have been explicitly added to those fields. Plugin authors can [read this article](/docs/extending-caddy/placeholders) to learn how to add support for placeholders in their own modules.
664664

665+
Placeholders are usually evaluated at runtime by the module that supports them. This means they are not the same as Caddyfile parse-time features such as the [`import`](#snippets) directive or [Caddyfile environment variables](#environment-variables) (`{$ENV}`). Fields that are compiled or validated while the config is loaded, such as regular expression matcher patterns, may not support runtime placeholders as their input values. Use [`import`](#snippets) or [`{$ENV}`](#environment-variables) when you need to provide config text before the Caddyfile is adapted.
666+
665667

666668

667669

0 commit comments

Comments
 (0)