自定义变量 custom-variables

请求和晕影::修饰符字符串的查询部分可能包含用户定义的变量。

$ name = value

name — 变量名称。 可由字母、数字和安全字符的任意组合组成,不包括$

value — 要设置变量的值(字符串)。

使用上述语法定义的变量与其他服务器命令类似。 必须先定义变量,然后才能引用它们。 在vignette::Modifier中定义的变量可以在URL请求中引用,反之亦然。

NOTE
value必须为单通道URL编码,以便安全HTTP传输。 如果通过HTTP重新传输value,则需要双重编码。 将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=需要数值参数。

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