カスタム変数 custom-variables
リクエストおよびビネット::修飾子文字列のクエリ部分には、ユーザー定義の変数が含まれる場合があります。
$ name = value
name – 変数名。 $を除く、アルファ、数字、および安全な文字の任意の組み合わせで構成できます。
value – 変数を設定する値(文字列)。
変数は、上記の構文を使用して、他のサーバーコマンドと同様に定義されます。 変数を参照する前に、変数を定義する必要があります。 vignette::Modifierで定義された変数は、URL リクエストで参照でき、逆に参照できます。
valueは、安全なHTTP送信のためにシングルパス URL エンコードする必要があります。 valueがHTTP経由で再送信される場合は、ダブルエンコーディングが必要です。 この状況は、valueがネストされた外部リクエストに置き換えられた場合に発生します。変数は、コマンド値の任意の場所に変数名(先頭と末尾の$で囲まれた)を埋め込むことで参照されます。 例えば、コマンド名に続く=と、その後の&またはリクエストの最後の間です。 サーバーは、そのような発生のそれぞれを$ name$にstringに置き換えます。 コマンド名(コマンドの等号の前)およびリクエストのパス部分で$ name$が発生しても、置換は行われません。
カスタム変数はネストできません。 string内の$ name$の出現箇所は置換されません。 例えば、リクエストフラグメント $var2=apple&$var1=my$var2$tree&text=$var1$はtext=my$var2$treeに解決されます。
$は予約済みの文字ではありません。リクエストで他の文字が発生する可能性があります。 例えば、src=my$texture$file.tifは有効なコマンドです(my$texture$file.tifという名前のマテリアルカタログエントリまたはテクスチャファイルが存在すると仮定します)。一方、wid=$number$はそうではありません。wid=には数値引数が必要です。