Egna variabler custom-variables
Frågedelen av begäranden och vinjett::Modifierarsträngar kan innehålla användardefinierade variabler.
$ name = value
name
- Variabelnamn. Kan bestå av en kombination av alfa-, siffra- och säkra tecken, med undantag för $
.
value
- Värde som variabeln ska anges till (sträng).
Variabler definieras på liknande sätt som andra serverkommandon, med syntaxen ovan. Variabler måste definieras innan de kan refereras. Variabler som definieras i vignette::Modifier
kan refereras i URL-begäran, och omvänt.
value
måste vara URL-kodad med en omgång för säker HTTP-överföring. Dubbel kodning krävs om value
överförs på nytt via HTTP. Detta är fallet när value
ersätts med en kapslad extern begäran.Variabler refereras genom att du bäddar in variabelnamnet (omges av ett radavstånd och ett avslutande $
) var som helst i kommandovärden. Till exempel mellan =
efter kommandonamnet och efterföljande &
eller slutet av begäran. Servern ersätter varje sådan förekomst av $ name$
med string
. Inga ersättningar inträffar för någon förekomst av $ name$
i kommandonamn (före likhetstecknet för ett kommando) och i sökvägsdelen av begäran.
Anpassade variabler får inte kapslas. Förekomster av $ name$
i string
ersätts inte. Begärandefragmentet $var2=apple&$var1=my$var2$tree&text=$var1$
matchar till exempel text=my$var2$tree
.
$
är inte ett reserverat tecken. Det kan annars inträffa i begäran. src=my$texture$file.tif
är till exempel ett giltigt kommando (förutsatt att det finns en materialkatalogpost eller texturfil med namnet my$texture$file.tif
), medan wid=$number$
inte är det, eftersom wid=
kräver ett numeriskt argument.