Add documentation for empty query match (#473)

This commit is contained in:
OmarAhmadyar 2025-06-09 08:16:59 -07:00 committed by GitHub
parent 78c23bf7e2
commit 3bc9fdade8
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -776,12 +776,13 @@ With a [CEL expression](#expression):
```caddy-d
query <key>=<val>...
query ""
expression query({'<key>': '<val>'})
expression query({'<key>': ['<vals...>']})
```
By query string parameters. Should be a sequence of `key=value` pairs. Keys are matched exactly (case-sensitively) but also support `*` to match any value. Values can use placeholders.
By query string parameters. Should be a sequence of `key=value` pairs, or an empty string "". Keys are matched exactly (case-sensitively) but also support `*` to match any value. Values can use placeholders. Empty string matches http requests with no query parameters.
There can be multiple `query` matchers per named matcher, and pairs with the same keys will be OR'ed together. Different keys will be AND'ed together. So, all keys in the matcher must have at least one matching value.