サンプル

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