Nom de variable |
Explication |
CONTENT_LENGTH |
contient le nombre de signes transmis à l'appel du script CGI par la méthode POST . Si par exemple le script CGI a été appelé lors de l'envoi d'un formulaire HTML et que POST y est mentionné comme méthode de transmission, se trouve dans cette variable d'environnement combien de signes le script doit lire de l' entrée standard pour lire complètement les données du formulaire transmises. |
CONTENT_TYPE |
contient le type Mime des données transmises à l'appel du script CGI par la méthode POST. Si par exemple le script CGI a été appelé lors de l'envoi d'un formulaire HTML et que POST y est mentionné comme méthode de transmission, se trouve dans cette variable d'environnement le type Mime typique pour des formulaires HTML application/x-www-form-urlencoded (Sur ce type Mime voir aussi Flux de données lors de la transmission de données de formulaire). |
DOCUMENT_ROOT |
Contient le chemin physique du répertoire racine pour le rangement des fichiers qui peuvent être appelés sur le serveur Web. Un script CGI peut calculer à partir de cette mention des noms de chemin absolus pour l'ouverture de fichiers. |
GATEWAY_INTERFACE |
contient la version de l'interface CGI, soutenue par le serveur installé - par exemple CGI/1.1, si la version actuellement habituelle de définition de l'interface CGI est soutenue. |
HTTP_ACCEPT |
contient la liste des types Mime acceptés par le navigateur WWW appelant. La mention */* signifie que le navigateur Web accepte tout. |
HTTP_ACCEPT_CHARSET |
contient la liste des jeux de caractères acceptés par le navigateur Web appelant, par exemple iso-8859-1,*,utf-8 . |
HTTP_ACCEPT_ENCODING |
contient une liste des méthodes de codage acceptées par le navigateur Web appelant. Certains navigateurs acceptent aussi par exemple le type de codage gzip, ce qui signifie que le navigateur peut également recevoir des fichiers qui lui sont transmis comprimés d'après l'algorithme GNU-Zip. |
HTTP_ACCEPT_LANGUAGE |
contient la langue utilisée par le navigateur appelant pour son interface utilisateur. Des valeurs fréquentes sont par exemple fr (pour des navigateurs en langue française) ou bien de (pour des navigateurs en langue allemande). Un script CGI peut décider par exemple, au vu de cette mention, s'il envoie une réponse en français ou en allemand au navigateur. |
HTTP_CONNECTION |
Contient des informations sur l'état de la connexion HTTP entre le serveur et le navigateur appelant. La valeur Keep-Alive signifie que le navigateur attend une réponse. |
HTTP_COOKIE |
Contient le nom et la valeur de témoins de connexion (cookies) dans la mesure où ils sont envoyés par l'ordinateur appelant. Avec l'instruction Perl:
my @cookies = split(/[;,]\s*/,$ENV{'HTTP_COOKIE'});
vous pouvez rechercher tous les cookies posés. Chaque élément du tableau nommé @cookies contient alors chacun un cookie, composé d'un nom et d'une valeur, qui sont séparés par le signe égal = . La valeur du témoin de connexion est sauvegardée dans le format du type Mime application/x-www-form-urlencoded (sur ce type Mime, se reporter à Flux de données lors de la transmission de données de formulaire). |
HTTP_HOST |
Contient le nom de domaine ou l'adresse IP de la ligne d'adresse du navigateur appelant. Pour un script CGI, cette mention peut être importante au cas où il doit servir plusieurs serveurs. |
HTTP_REFERER |
contient l'adresse URI de la page Web à partir de laquelle le script CGI a été appelé. La valeur n'est cependant pas transmise correctement par tous les navigateurs Web et n'est donc pas disponible dans tous les cas .
Remarque: Si votre anglais est courant, vous remarquerez que HTTP_REFERER devrait s'appeler normalement HTTP_REFERRER . Cette erreur a échappé aux auteurs de la première spécification HTTP qui perdure aujourd'hui pour des raisons historiques et de compatibilité vers l'amont. |
HTTP_USER_AGENT |
contient les informations de produit et de version du navigateur WWW appelant. Un script CGI peut rechercher de cette façon quel est le navigateur dont se sert l'utilisateur. |
PATH_INFO |
Si une chaîne de caractères avec des données est transmise au script CGI, alors PATH_INFO contient la partie de la chaîne de caractères après le nom du script jusqu'au premier ?. Si par exemple le script a pour adresse http://ma.page.net/cgi-bin/test.pl, mais est appelé avec http://ma.page.net/cgi-bin/test.pl/querys/mamusique.sql?cat=Mozart , alors cette variable d'environnement contient la partie /querys/musicbase.sql . Elle est conçue pour permettre la transmission comme paramètres pour des scripts des noms de fichier avec la mention de leur chemin. |
PATH_TRANSLATED |
Contient comme PATH_INFO la partie de l'URI après le nom du script jusqu'au premier ?, avec cette différence cependant, que ce n'est pas la partie proprement dite de L'URI qui est renvoyée mais le chemin aux données de cette partie traduit par le serveur . Supposons que le script a pour adresse http://ma.page.net/cgi-bin/test.pl, mais qu'il a été appelé avec http://ma.page.net/cgi-bin/test.pl/querys/mamusique.sql. Ensuite cette partie d'adresse supplémentaire /querys/musicbase.sql pourrait, du point de vue du serveur être résolue en un nom de chemin physique comme /usr/web/page/querys/musicbase.sql. C'est ce nom de chemin que renverrait PATH_TRANSLATED . |
QUERY_STRING |
contient une chaîne de caractères avec des données qui ont été transmises au script dans l'URI après le premier ?. Supposons que le script a l'adresse http://ma.page.net/cgi-bin/test.pl, mais a été appelé avec l'adresse http://ma.page.net/cgi-bin/test.pl?User=Serge. Alors QUERY_STRING contiendrait la valeur User=Serge . Si un utilisateur a rempli un formulaire HTML et qu'il appelle le script CGI avec la méthode GET , alors cette variable d'environnement contiendrait les données saisies du formulaire. Les données sont codées d'après les règles du type Mime application/x-www-form-urlencoded . |
REMOTE_ADDR |
contient l'adresse IP de l'ordinateur serveur par lequel le script CGI a été appelé. Il ne doit pas s'agir absolument ici de l'adresse IP de l'ordinateur client qui appelle - la valeur peut également provenir d'un serveur Proxy. |
REMOTE_HOST |
contient l'adresse domaine de l'ordinateur serveur par lequel le script CGI a été appelé. Cette valeur n'est cependant fixée que si le Serveur Web est configuré en fonction et qu'il est en mesure d'attribuer le nom d'hôte correspondant à l'adresse IP. Il ne doit pas s'agir absolument ici de l'adresse IP de l'ordinateur client qui appelle - la valeur peut également provenir d'un serveur Proxy. |
REMOTE_IDENT |
contient des informations de protocole si, sur le serveur, tourne le protocole ident pour les accès protégés. |
REMOTE_PORT |
recherche par quel port de l'ordinateur client le script CGI a été appelé. Ce nombre est habituellement dans une plage supérieure à 1024 et est choisi de façon aléatoire par le navigateur Web appelant. |
REMOTE_USER |
contient le nom avec lequel l'utilisateur qui a appelé le script CGI, s'est annoncé. Si le script par exemple est protégé htaccess, L'utilisateur qui appelle doit s'annoncer avec un nom d'utilisateur et un mot de passe. Le nom d'utilisateur entré à ce moment peut être recherché avec cette variable. |
REQUEST_METHOD |
contient la commande HTTP avec laquelle le programme CGI a été appelé: soit GET soit POST . Un script CGI peut par exemple lire cette variable et décider ensuite comment il peut lire les données du formulaire: soit de l'entrée standard (pour la méthode POST) ou bien de la variable d'environnement QUERY_STRING (pour la méthode GET). |
REQUEST_URI |
Contient le chemin HTTP du script les données transmises dans l'appel. Supposons que le script a l'adresse http://ma.page.net/cgi-bin/test.pl et qu'il a été appelé avec http://ma.page.net/cgi-bin/test.pl?User=Serge. Alors la variable REQUEST_URI livre la valeur /cgi-bin/test.pl?User=Serge . |
SCRIPT_NAME |
contient le chemin HTTP du script CGI appelé. Supposons que le script a l'adresse http://ma.page.net/cgi-bin/test.pl . Alors la variable SCRIPT_NAME livre la valeur /cgi-bin/test.pl . |
SCRIPT_FILE_NAME |
Contient le chemin physique du script sur l'ordinateur serveur, donc par exemple /usr/web/data/cgi-bin/test.pl . |
SERVER_ADDR |
Contient l'adresse IP de l'ordinateur serveur. |
SERVER_ADMIN |
Contient le nom/ l'adresse électronique de l'administrateur serveur enregistré dans la configuration du serveur Web. |
SERVER_NAME |
Contient le nom de l'ordinateur serveur sur lequel tourne le script CGI. Normalement c'est le nom d'hôte enregistré de l'ordinateur. |
SERVER_PORT |
contient le numéro de port qui a été installé pour le serveur Web. Pour les serveurs Web, celui-ci est normalement 80. |
SERVER_PROTOCOL |
Contient la version du protocole HTTP que soutient le serveur Web installé, par exemple HTTP/1.1 , su la version 1.1 habituelle aujourd'hui est soutenue. |
SERVER_SIGNATURE |
Contient un renseignement avancé sur le serveur par exemple Apache/1.3.14 Server at localhost Port 80 . |
SERVER_SOFTWARE |
Contient le nom et le numéro de version du logiciel sur l'ordinateur serveur Web. |