From 4af378049b330755405521d0fb7bf9282d46e897 Mon Sep 17 00:00:00 2001 From: Alex Bradbury Date: Wed, 14 Sep 2022 04:55:46 +0100 Subject: [PATCH] docs: Attempt to clarify how handle directives may be re-ordered As discussed in . --- src/docs/markdown/caddyfile/directives/handle.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/docs/markdown/caddyfile/directives/handle.md b/src/docs/markdown/caddyfile/directives/handle.md index 8c31e633..97f11b3e 100644 --- a/src/docs/markdown/caddyfile/directives/handle.md +++ b/src/docs/markdown/caddyfile/directives/handle.md @@ -6,7 +6,7 @@ title: handle (Caddyfile directive) Evaluates a group of directives mutually exclusively from other `handle` blocks at the same level of nesting. -The `handle` directive is kind of similar to the `location` directive from nginx config: the first matching `handle` block will be evaluated. Handle blocks can be nested if needed. Only HTTP handler directives can be used inside handle blocks. +The `handle` directive is kind of similar to the `location` directive from nginx config: the first matching `handle` block will be evaluated. `handle` directives at the same level of nesting will be tried in the order they're written in the `Caddyfile`, except if there is a single path matcher, which orders them by longest (most specific) path pattern first. Handle blocks can be nested if needed. Only HTTP handler directives can be used inside handle blocks. ## Syntax