自訂變數 custom-variables

請求和暈映::修飾元字串的查詢部分可能包含使用者定義的變數。

$ name = value

name — 變數名稱。 可由任何字母、數字和安全字元的組合組成,不包括$

value — 要設定變數的值(字串)。

變數的定義與其他伺服器命令類似,使用上述語法。 必須先定義變數,才能加以參照。 在vignette::Modifier中定義的變數可以在URL要求中參照,反之亦然。

NOTE
value必須為單次URL編碼,才能安全HTTP傳輸。 若透過HTTP重新傳輸value,則需要雙重編碼。 此情況是將value替代成巢狀外部要求的情況。

將變數名稱(以前置字元和尾端$括住)內嵌在命令值中的任何位置來參考變數。 例如,在命令名稱后面的=和後續的&或要求的結尾之間。 伺服器會以string取代每個出現的$ name$。 命令名稱(在命令的等號之前)和要求的路徑部分中$ 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=需要數值引數。

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49