PDF (adobe.com)

Définition de variables de serveur



Vous définissez des variables de serveur comme sources de contenu dynamique pouvant être utilisées dans une application Web. Les variables de serveur varient d'un type de document à l'autre et comprennent notamment les variables de formulaire, les variables d'URL, les variables de session et les variables d'application.

Les variables de serveur sont accessibles à tous les clients qui accèdent au serveur et à toutes les applications exécutées sur le serveur. Les variables de serveur sont conservées jusqu'à l'arrêt du serveur.

Définition de variables de serveur ColdFusion

  1. Ouvrez le panneau Liaisons (Fenêtre > Liaisons). Dans la boîte de dialogue Variable de serveur, tapez le nom de la variable de serveur et cliquez sur OK.
  2. Cliquez sur le bouton Plus (+) et choisissez la variable de serveur dans le menu déroulant.
  3. Saisissez le nom de l’objet et cliquez sur OK. La variable de serveur ColdFusion s'affiche dans le panneau Liaisons.

Le tableau ci-dessous répertorie les variables de serveur de ColdFusion intégrées :

Variable

Description

Server.ColdFusion.ProductName

Nom de produit de ColdFusion.

Server.ColdFusion.ProductVersion

Numéro de version de ColdFusion.

Server.ColdFusion.ProductLevel

Edition de ColdFusion (édition entreprise ou professionnelle).

Server.ColdFusion.SerialNumber

Numéro de série de la version de ColdFusion installée.

Server.OS.Name

Nom du système d'exploitation exécuté sur le serveur (Windows XP, Windows 2000, Linux)

Server.OS.AdditionalInformation

Informations supplémentaires sur le système d'exploitation installé (Service Packs, mises à jour).

Server.OS.Version

Version du système d'exploitation installé.

Server.OS.BuildNumber

Numéro de compilation du système d'exploitation installé.

Définition d'une variable locale ColdFusion

Les variables locales sont créées au moyen de la balise CFSET ou CFPARAM dans une page ColdFusion. La variable locale définie s'affiche dans le panneau Liaisons.

 Dans la boîte de dialogue Variable locale, tapez le nom de la variable locale et cliquez sur OK.

Définition de variables de serveur ASP

Vous pouvez définir les variables de serveur ASP suivantes comme sources de contenu dynamique : Request.Cookie, Request.QueryString, Request.Form, Request.ServerVariables et Request.ClientCertificates.

  1. Ouvrez le panneau Liaisons (Fenêtre > Liaisons).
  2. Cliquez sur le bouton Plus (+) et choisissez Variable d'application dans le menu déroulant.
  3. Dans la boîte de dialogue Variable de demande, sélectionnez l'un des ensembles de demandes dans le menu déroulant Type.
    L'ensemble QueryString
    Récupère des informations annexées à l'URL de la page émettrice, par exemple lorsque la page comprend un formulaire HTML utilisant la méthode GET. La chaîne de requête est composée d'une ou de plusieurs paires nom/valeur (par exemple, last=Smith, first=Winston) annexées à l'URL avec un point d'interrogation (?). Si la chaîne de requête compte plusieurs paires nom/valeur, elles sont combinées avec des esperluettes (&).

    L'ensemble Form
    Récupère les informations de formulaire incluses dans le corps de la demande HTTP par un formulaire HTML utilisant la méthode POST.

    L'ensemble ServerVariables
    Récupère les valeurs de variables d'environnement prédéfinies. Cet ensemble contient une longue liste de variables, notamment CONTENT_LENGTH (longueur du contenu envoyé dans la demande HTTP, qui permet de savoir si un formulaire est vierge) et HTTP_USER_AGENT (fournit des informations sur le navigateur de l'utilisateur).

    Par exemple, Request.ServerVariables("HTTP_USER_AGENT") contient des informations sur le navigateur expéditeur, comme Mozilla/4.07 [en] (WinNT; I), qui indique un navigateur Netscape Navigator 4.07.

    La liste complète des variables d'environnement de serveur ASP figure dans la documentation en ligne fournie avec Microsoft Personal Web Server (PWS) ou Internet Information Server (IIS).

    L'ensemble Cookies
    Récupère les valeurs des cookies envoyés dans une demande HTTP. Par exemple, supposez que la page lise un cookie appelé « readMe » sur l’ordinateur de l'utilisateur. Sur le serveur, les valeurs du cookie sont enregistrées dans la variable Request.Cookies("readMe").

    L'ensemble ClientCertificate
    Récupère les zones de certification de la demande HTTP envoyée par le navigateur. Les zones de certification sont spécifiées dans la norme X.509.

  4. Indiquez à quelle variable de l'ensemble vous souhaitez accéder, et cliquez sur OK.

    Par exemple, si vous souhaitez accéder aux données contenues dans la Request.ServerVariables("HTTP_USER_AGENT"), tapez l'argument HTTP_USER_AGENT. Si vous souhaitez accéder aux informations de la variable Request.Form("lastname"), tapez l'argument lastname.

    La variable de demande s'affiche dans le panneau Liaisons.

Définition de variables de serveur PHP

Définissez des variables de serveur comme source de contenu dynamique pour les types de document PHP. Les variables de serveur PHP s'affichent dans le panneau Liaisons.

  1. Ouvrez le panneau Liaisons (Fenêtre > Liaisons).
  2. Cliquez sur le bouton Plus (+) et choisissez la variable de serveur dans le menu déroulant.
  3. Dans la boîte de dialogue Variable de demande, tapez le nom de la variable (par exemple REQUEST_METHOD), puis cliquez sur OK.

    Pour plus d'informations, recherchez le mot clé $_SERVER dans la documentation de PHP.

Définition d'une variable client ColdFusion

Définissez une variable client ColdFusion comme source de contenu dynamique pour une page. Les variables de client ColdFusion que vous venez de définir s'affichent dans le panneau Liaisons.

 Dans la boîte de dialogue Variable client, tapez le nom de la variable client et cliquez sur OK.

Par exemple, pour accéder aux données contenues dans la Client.LastVisit, tapez LastVisit.

Les variables client sont des variables ajoutées au code pour associer des données à un client spécifique. Elles conservent l'état de l'application pendant que l'utilisateur passe d'une page à l'autre et d'une session à l'autre dans l'application.

Il existe deux types de variables serveur : les variables intégrées et les variables définies par l'utilisateur. Le tableau ci-dessous répertorie les variables client ColdFusion intégrées :

Variable

Description

Client.CFID

Identifiant incrémentiel attribué à chacun des clients se connectant au serveur.

Client.CFTOKEN

Numéro généré aléatoirement et permettant d'identifier un client spécifique de façon univoque.

Client.URLToken

Combinaison de CFID et CFTOKEN devant être transmise de modèle en modèle lorsque les cookies ne sont pas utilisés.

Client.LastVisit

Enregistre la date de la dernière visite effectuée par un client.

Client.HitCount

Nombre de demandes de pages liées à un même client (obtenu à l'aide de CFID et CFTOKEN).

Client.TimeCreated

Enregistre l'heure de la première création de CFID et CFTOKEN pour un client spécifique.

Définition d'une variable cookie ColdFusion

Les variables cookie sont créées au niveau du code et permettent d'accéder aux informations contenues dans les cookies transmis au serveur par un navigateur. La variable cookie définie s'affiche dans le panneau Liaisons.

 Dans la boîte de dialogue Variable cookie, tapez le nom de la variable client et cliquez sur OK.

Définition d'une variable CGI ColdFusion

La variable CGI définie s'affiche dans le panneau Liaisons.

 Dans la boîte de dialogue Variable CGI, tapez le nom de la variable et cliquez sur OK.

Par exemple, si vous souhaitez accéder aux données contenues dans la CGI.HTTP_REFERER , saisissez HTTP_REFERER.

Le tableau ci-dessous répertorie les variables CGI de ColdFusion les plus fréquemment créées sur le serveur :

Variable

Description

SERVER_SOFTWARE

Nom et version du logiciel du serveur d'informations répondant à la demande (et exécutant la passerelle). Format : nom/version.

SERVER_NAME

Nom d'hôte, alias DNS ou adresse IP du serveur tel qu'il/elle se présente dans les URL d'appel.

GATEWAY_INTERFACE

Révision de la spécification CGI appliquée par le serveur. Format : CGI/révision.

SERVER_PROTOCOL

Nom et révision du protocole d'informations par lequel la demande a été transmise. Format : protocole/révision.

SERVER_PORT

Numéro du port auquel la demande a été envoyée.

REQUEST_METHOD

Méthode utilisée pour l'exécution de la demande. Dans le cas de HTTP, il s'agit de Get, Head, Post, etc.

PATH_INFO

Informations de chemin complémentaires, telles qu'elles sont fournies par le client. On accède aux scripts en utilisant leur nom de chemin virtuel suivi des informations complémentaires. Celles-ci sont envoyées en tant que PATH_INFO.

PATH_TRANSLATED

Le serveur fournit une version traduite de PATH_INFO, résultat de la conversion du chemin virtuel en chemin physique.

SCRIPT_NAME

Chemin virtuel vers le script en cours d'exécution. Variable utilisée pour les URL d'appel.

QUERY_STRING

Informations de requête qui suivent le point d'interrogation (?) dans l'URL référençant le script.

REMOTE_HOST

Nom de l'hôte à l'origine de la demande. Si le serveur ne dispose pas de cette information, il définit REMOTE_ADDR mais pas REMOTE_HOST.

REMOTE_ADDR

Adresse IP de l'hôte distant à l'origine de la demande.

AUTH_TYPE

Si le serveur prend en charge l'authentification de l'utilisateur et que le script est protégé, cette variable correspond à la méthode d'authentification spécifique au protocole utilisée pour vérifier l'identité de l'utilisateur.

REMOTE_USER AUTH_USER

Si le serveur prend en charge l'authentification de l'utilisateur et que le script est protégé, cette variable correspond au nom saisi par l'utilisateur lors de l'authentification (disponible également sous la forme AUTH_USER).

REMOTE_IDENT

Si le serveur HTTP prend en charge l'identification RFC 931, cette variable reçoit comme valeur le nom de l'utilisateur distant récupéré du serveur. Utilisez cette variable uniquement pour la connexion.

CONTENT_TYPE

Dans le cas de requêtes assorties d'informations, telles que HTTP POST et PUT, cette variable correspond au type de contenu des données.

CONTENT_LENGTH

Longueur du contenu, tel qu'il a été fourni par le client.

Le tableau ci-dessous répertorie les variables CGI les plus fréquemment créées par le navigateur et transmises au serveur :

Variable

Description

HTTP_REFERER

Document de référence. Il s'agit du document associé aux données de formulaire ou qui les envoie.

HTTP_USER_AGENT

Navigateur utilisé par le client pour envoyer la demande. Format : logiciel/version bibliothèque/version.

HTTP_IF_MODIFIED_SINCE

Date de la dernière modification de la page. Cette variable est envoyée suivant la configuration du navigateur, généralement en réponse au serveur ayant envoyé l'en-tête LAST_MODIFIED HTTP. Peut être utilisée pour tirer parti des possibilités de mise en mémoire cache au niveau du navigateur.