Variables personnalisées

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 alphanumériques, 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.

REMARQUE

value doit être codé URL à un seul passage pour une transmission HTTP sécurisée. Un double encodage est requis si value est retransmis via HTTP. C’est le cas 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 $ au début et un $ à la 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 chacune de ces occurrences de $ name$ par string. Aucune substitution ne se produira 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.

Sur cette page