Variables d'environnement CGI

Un article de Wikipédia, l'encyclopédie libre.

Les variables d'environnement CGI sont des variables transmises à un programme CGI, par le serveur Web l'invoquant, lors de son exécution.

Elles fournissent des informations sur la requête effectuée par le client, sur le serveur et également sur le client lui-même. Par exemple, lorsqu'on effectue une recherche sur un site qui fonctionne avec des CGI, le script récupérera les termes de la recherche avec la variable d'environnement « QUERY_STRING ».

Sommaire 1 Liste des variables CGI 1.1 Variables en rapport avec le serveur 1.2 Variables spécifiques à la requête 1.3 Variables provenant du client 2 Articles connexes

[modifier] Liste des variables CGI

[modifier] Variables en rapport avec le serveur

• SERVER_SOFTWARE

Le nom et la version du serveur HTTP répondant à la requête. (Format : nom/version)

• SERVER_NAME

Le nom d'hôte, alias DNS ou adresse IP du serveur.

• GATEWAY_INTERFACE

La révision de la spécification CGI que le serveur utilise. (Format : CGI/révision)

[modifier] Variables spécifiques à la requête

• SERVER_PROTOCOL

Le nom et la révision du protocole dans lequel la requête a été faite (Format : protocole/révision)

• SERVER_PORT

Le numéro de port sur lequel la requête a été envoyée.

• REQUEST_METHOD

La méthode utilisée pour faire la requête. Pour HTTP, elle contient généralement « GET » ou « POST ».

• PATH_INFO

Le chemin supplémentaire du script tel que donné par le client. Par exemple, si le serveur héberge le script « /cgi-bin/monscript.cgi » et que le client demande l'url « http://serveur.org/cgi-bin/monscript.cgi/marecherche », alors PATH_INFO contiendra « marecherche ».

• PATH_TRANSLATED

Contient le chemin demandé par le client après que les conversions virtuel → physique aient été faites par le serveur.

• SCRIPT_NAME

Le chemin virtuel vers le script étant exécuté. Exemple : « /cgi-bin/script.cgi »

• QUERY_STRING

Contient tout ce qui suit le « ? » dans l'URL envoyée par le client. Toutes les variables provenant d'un formulaire envoyé avec la méthode « GET » sera contenue dans le QUERY_STRING sous la forme « var1=val1&var2=val2&... ».

• REMOTE_HOST

Le nom d'hôte du client. Si le serveur ne possède pas cette information (par exemple, lorsque la résolution DNS inverse est désactivée), REMOTE_HOST sera vide.

• REMOTE_ADDR

L'adresse IP du client.

• AUTH_TYPE

Le type d'identification utilisé pour protéger le script (s’il est protégé et si le serveur supporte l'identification).

• REMOTE_USER

Le nom d'utilisateur du client, si le script est protégé et si le serveur supporte l'identification.

• REMOTE_IDENT

Nom d'utilisateur (distant) du client faisant la requête. Le serveur doit supporter l'identification RFC 931. Cette variable devraient être utilisée à des fins de journaux seulement.

• CONTENT_TYPE

Le type de contenu attaché à la requête, si des données sont attachées (comme lorsqu'un formulaire est envoyé avec la méthode « POST »).

• CONTENT_LENGTH

La longueur du contenu envoyé par le client.

[modifier] Variables provenant du client

Toutes les variables qui sont envoyées par le client sont aussi passées au script CGI, après que le serveur ait rajouté le préfixe « HTTP_ ». Voici quelques exemples de variables possibles :

• HTTP_ACCEPT

Les types de données MIME que le client accepte de recevoir.

Exemple : text/*, image/jpeg, image/png, image/*, */*

• HTTP_ACCEPT_LANGUAGE

Les langages dans lequel le client accepte de recevoir la réponse.

Exemple : fr_CA, fr

• HTTP_USER_AGENT

Le navigateur utilisé par le client.

Exemple : Mozilla/5.0 (compatible; Konqueror/3; Linux)

[modifier] Articles connexes

• variable d'environnement