caddyhttp: Document missing placeholders for escaped URI and prefixed query (#7659)

Steffen Busch committed Apr 17, 2026 at 22:13 UTC 24bebd0a07cef434ec9c807bdb3a5a2d5f5ae9c1

1 file changed +5

modules/caddyhttp/app.go

@@ -69,6 +69,7 @@ func init() {

69 // `{http.request.orig_uri.path.dir}` | The request's original directory

70 // `{http.request.orig_uri.path.file}` | The request's original filename

71 // `{http.request.orig_uri.query}` | The request's original query string (without `?`)

72 +// `{http.request.orig_uri.prefixed_query}` | The request's original query string with a `?` prefix, if non-empty

73 // `{http.request.port}` | The port part of the request's Host header

74 // `{http.request.proto}` | The protocol of the request

75 // `{http.request.local.host}` | The host (IP) part of the local address the connection arrived on

@@ -98,11 +99,15 @@ func init() {

99 // `{http.request.tls.client.san.ips.*}` | SAN IP addresses (index optional)

100 // `{http.request.tls.client.san.uris.*}` | SAN URIs (index optional)

101 // `{http.request.uri}` | The full request URI

102 +// `{http.request.uri_escaped}` | The full request URI with query-style URL encoding applied (using url.QueryEscape)

103 // `{http.request.uri.path}` | The path component of the request URI

104 +// `{http.request.uri.path_escaped}` | The path component of the request URI with query-style URL encoding applied (using url.QueryEscape)

105 // `{http.request.uri.path.*}` | Parts of the path, split by `/` (0-based from left)

106 // `{http.request.uri.path.dir}` | The directory, excluding leaf filename

107 // `{http.request.uri.path.file}` | The filename of the path, excluding directory

108 // `{http.request.uri.query}` | The query string (without `?`)

109 +// `{http.request.uri.query_escaped}` | The query string with query-style URL encoding applied (using url.QueryEscape)

110 +// `{http.request.uri.prefixed_query}` | The query string with a `?` prefix, if non-empty

111 // `{http.request.uri.query.*}` | Individual query string value

112 // `{http.response.header.*}` | Specific response header field

113 // `{http.vars.*}` | Custom variables in the HTTP handler chain