docs: Attempt to clarify how handle directives may be re-ordered

As discussed in <https://github.com/caddyserver/caddy/issues/5037>.
This commit is contained in:
Alex Bradbury 2022-09-14 04:55:46 +01:00
parent 3fe4d09713
commit 4af378049b

View file

@ -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