自定义变量 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