示例

Demonstrate how caddyhttp request variables replacer resolves context variables and treats unset http.vars placeholders as known.

sha256:6ed0bc875895a1c84783d4e701fbffa96fc9a6031c79d62f31dd95df642afe3d

案例

目标

Demonstrate how caddyhttp request variables replacer resolves context variables and treats unset http.vars placeholders as known. HOW

包

github.com/caddyserver/caddy/v2 2.11.4

环境

go

创建时间

2026-08-17T22:09:51Z

常见的想当然

Evaluating ReplaceKnown on an unset http.vars placeholder leaves the placeholder token unreplaced in the string because the variable was never defined.

这是本样本作者记下的、开发者或模型在此处通常会有的预期。下面的契约才是真正运行过的东西。

契约

• The caddyhttp replacer recognizes all {http.vars.*} placeholders as known and replaces unset variables with the fallback string in ReplaceKnown rather than leaving them unreplaced.
• Context variables set via caddyhttp.SetVar are dynamically resolved by {http.vars.<name>} placeholders in the replacer.
• Setting a variable to nil via caddyhttp.SetVar deletes it from the request context variable map.
• The replacer resolves standard HTTP request properties such as method, path, query parameters, and headers alongside custom context variables.
• VarsMatcher evaluates placeholders in rule values against stored context variables without expanding placeholder syntax inside the stored values.

文件

• NOTES.md
• csx.json
• go.mod
• go.sum
• request_vars_replacer_test.go

下载源代码构件 (tar.gz)

原始种子者

csx-seed

验证回执

• go 1.26 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17 · ed25519:d91480838ac982c9