From c1cd192ee760cf4ad4e6ca6021ceb86f03576e1e Mon Sep 17 00:00:00 2001 From: Scott Mebberson Date: Fri, 20 Aug 2021 14:14:28 +0930 Subject: caddyhttp: Updated the documentation for MatchQuery (#4295) --- modules/caddyhttp/matchers.go | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) (limited to 'modules/caddyhttp/matchers.go') diff --git a/modules/caddyhttp/matchers.go b/modules/caddyhttp/matchers.go index 1a49b3c..b452d48 100644 --- a/modules/caddyhttp/matchers.go +++ b/modules/caddyhttp/matchers.go @@ -82,7 +82,19 @@ type ( // MatchMethod matches requests by the method. MatchMethod []string - // MatchQuery matches requests by URI's query string. + // MatchQuery matches requests by the URI's query string. It takes a JSON object + // keyed by the query keys, with an array of string values to match for that key. + // Query key matches are exact, but wildcards may be used for value matches. Both + // keys and values may be placeholders. + // An example of the structure to match `?key=value&topic=api&query=something` is: + // + // ```json + // { + // "key": ["value"], + // "topic": ["api"], + // "query": ["*"] + // } + // ``` MatchQuery url.Values // MatchHeader matches requests by header fields. It performs fast, -- cgit v1.2.3