Variables personnalisées custom-variables
La partie requête des requêtes et la vignette ::Chaînes de modificateur peuvent inclure des variables définies par l’utilisateur.
$ name = value
name - Nom de variable. Peut se composer de n’importe quelle combinaison de caractères alpha, de chiffres et de caractères sûrs, à l’exception de $.
value - Valeur à laquelle la variable doit être définie (chaîne).
Les variables sont définies de la même manière que les autres commandes du serveur, à l’aide de la syntaxe ci-dessus. Les variables doivent être définies avant de pouvoir être référencées. Les variables définies dans vignette::Modifier peuvent être référencées dans la requête d’URL, et inversement.
value doit être codé URL à un seul passage pour une transmission HTTP sécurisée. Un double encodage est requis si value est retransmis par HTTP. Cette situation se produit lorsque value est remplacé par une requête étrangère imbriquée.Les variables sont référencées en incorporant le nom de la variable (inclus par un $ de début et de fin) n’importe où dans les valeurs de commande. Par exemple, entre le = suivant le nom de la commande et le & suivant ou la fin de la requête. Le serveur remplace chaque occurrence de $ name$ par string. Aucune substitution ne se produit sur les occurrences de $ name$ dans les noms de commande (avant le signe égal d’une commande), et dans la partie chemin de la requête.
Les variables personnalisées peuvent ne pas être imbriquées. Les occurrences de $ name$ dans string ne sont pas remplacées. Par exemple, le fragment de requête $var2=apple&$var1=my$var2$tree&text=$var1$ correspond à text=my$var2$tree.
$ n’est pas un caractère réservé ; il peut se produire autrement dans la requête. Par exemple, src=my$texture$file.tif est une commande valide (en supposant qu’il existe une entrée de catalogue de matières ou un fichier de texture nommé my$texture$file.tif), contrairement à wid=$number$, car wid= nécessite un argument numérique.