CGIVariable()

Syntaxe

Resultat$ = CGIVariable(Nom$)
Description
Renvoie le contenu de la variable d'environnement CGI spécifiée.

Arguments

Nom$ Le nom de la variable à obtenir.
Peut être une valeur personnalisée ou l'une des constantes prédéfinies suivantes: 
  #PB_CGI_AuthType          : le procédé d'authentification utilisé par le navigateur Web 
                              si un quelconque procédé d'authentification a été utilisé.
                              Il n'est pas défini, sauf si le script est protégé.
                     
  #PB_CGI_ContentLength     : utilisé pour les scripts qui reçoivent des données de 
                              formulaire utilisant la méthode POST. Cette variable 
                              indique la longueur en octets du flux de données d'entrée 
                              de CGI. Cela est nécessaire pour lire les données à partir 
                              de l'entrée standard avec la méthode POST.
                         
  #PB_CGI_HeaderContentType : indique le type de support de données en cours de réception 
                              de l'utilisateur.
                              il est utilisé pour les scripts appelés en utilisant la méthode POST.
  #PB_CGI_DocumentRoot      : le chemin de la racine de la page d'accueil HTML pour le serveur.
  #PB_CGI_GatewayInterface  : la version de CGI utilisé pour échanger les données entre le client et le serveur. 
                              Généralement c'est CGI/1.1 pour le niveau de révision actuel.
  #PB_CGI_PathInfo          : informations de chemin supplémentaire ajouté à la fin de l'URL qui a accédé au programme de script côté serveur.
  #PB_CGI_PathTranslated    : une version traduite de la variable PATH_INFO par le serveur Web du virtuel vers le chemin physique.
  #PB_CGI_QueryString       : cette chaîne contient des informations à la fin du chemin de script côté serveur 
                              qui a suivi un point d'interrogation. 
                              Utilisé pour renvoyer les données si la méthode GET a été utilisé par un formulaire. 
                              Il y a des restrictions de longueur à la QUERY_STRING. 
  #PB_CGI_RemoteAddr        : l'adresse IP de l'ordinateur client.
  #PB_CGI_RemoteHost        : le nom de domaine complet de la machine du client faisant la requête HTTP. 
                              Il peut ne pas être possible de déterminer ce nom puisque les noms de nombreux ordinateurs clients 
                              ne sont pas enregistrées dans le système DNS.
  #PB_CGI_RemoteIdent       : la possibilité d'utiliser cette variable est limitée aux serveurs qui prennent 
                              en charge la RFC 931. Cette variable peut contenir le nom d'utilisateur de la machine 
                              cliente, mais il est destiné à être utilisé à des fins d'exploitation du fichier log, 
                              quand il est disponible.
  #PB_CGI_RemotePort        : le port utilisé par les clients. 
  #PB_CGI_RemoteUser        : si le script CGI a été protégé et l'utilisateur a été connecté pour accéder au script, 
                              cette valeur contient le journal de l'utilisateur.
  #PB_CGI_RequestURI        : le chemin vers le fichier demandé par le client.
  #PB_CGI_RequestMethod     : décrit la méthode de requête utilisée par le navigateur qui est habituellement GET, POST, ou HEAD.
  #PB_CGI_ScriptName        : le chemin virtuel du script CGI en cours d'exécution.
  #PB_CGI_ScriptFilename    : le nom de fichier local du script en cours d'exécution.
  #PB_CGI_ServerAdmin       : l'adresse e-mail de l'administrateur du serveur. 
  #PB_CGI_ServerName        : le nom du serveur, l'adresse IP ou le nom alias DNS présentée comme une URL d'auto-référencement. 
                              Cela ne comprend pas l'identificateur de protocole tel que "HTTP", le nom de la machine, ou le numéro de port.
  #PB_CGI_ServerPort        : le numéro de port sur lequel les requêtes et les réponses HTTP sont envoyées.
  #PB_CGI_ServerProtocol    : cette valeur est généralement HTTP qui décrit le protocole utilisé entre les ordinateurs client et serveur.
  #PB_CGI_ServerSignature   : information sur le serveur en spécifiant le nom et la version du serveur Web et le port.
  #PB_CGI_ServerSoftware    : le nom et la version du serveur web.
  #PB_CGI_HttpAccept        : les types de supports de données que le navigateur client peut accepter. 
                              Ces types de données sont séparées par des virgules.
  #PB_CGI_HttpAcceptEncoding: le type d'encodage que le navigateur client accepte.
  #PB_CGI_HttpAcceptLanguage: la langue que le navigateur client accepte.
  #PB_CGI_HttpCookie        : utilisé comme une variable d'environnement qui contient les cookies associés au domaine du serveur depuis le navigateur.
  #PB_CGI_HttpForwarded     : l'URL de la page transmise juste avant.
  #PB_CGI_HttpHost          : nom de l'hôte d'où viennent les requêtes HTTP.
  #PB_CGI_HttpPragma        : pragmas HTTP 
  #PB_CGI_HttpReferer       : l'adresse de la page d'où la requête HTTP est originaire. 
  #PB_CGI_HttpUserAgent     : le nom du navigateur Web du client qui a envoyé la requête.

Valeur de retour

Renvoie la valeur de la variable d'environnement CGI spécifiée.

Remarques

Lorsque le CGI est chargé, de nombreuses informations sont envoyées du serveur Web vers l'application CGI à travers les variables d'environnement.

Exemple

  If Not InitCGI() Or Not ReadCGI()
    End
  EndIf
  
  WriteCGIHeader(#PB_CGI_HeaderContentType, "text/html", #PB_CGI_LastHeader) ; Ecrit les en-têtes pour informer le navigateur du format du contenu
  
  WriteCGIString("<html><title>PureBasic - variables</title><body>")  
  
  Procedure WriteCGIConstant(Constant$)
    WriteCGIString(Constant$ + ": " + CGIVariable(Constant$)+"<br>")
  EndProcedure
  
  WriteCGIConstant(#PB_CGI_AuthType)
  WriteCGIConstant(#PB_CGI_ContentLength)
  WriteCGIConstant(#PB_CGI_HeaderContentType)
  WriteCGIConstant(#PB_CGI_DocumentRoot)
  WriteCGIConstant(#PB_CGI_GatewayInterface)
  WriteCGIConstant(#PB_CGI_PathInfo)
  WriteCGIConstant(#PB_CGI_PathTranslated)
  WriteCGIConstant(#PB_CGI_QueryString)
  WriteCGIConstant(#PB_CGI_RemoteAddr)
  WriteCGIConstant(#PB_CGI_RemoteHost)
  WriteCGIConstant(#PB_CGI_RemoteIdent)
  WriteCGIConstant(#PB_CGI_RemotePort)
  WriteCGIConstant(#PB_CGI_RemoteUser)
  WriteCGIConstant(#PB_CGI_RequestURI)
  WriteCGIConstant(#PB_CGI_RequestMethod)
  WriteCGIConstant(#PB_CGI_ScriptName)
  WriteCGIConstant(#PB_CGI_ScriptFilename)
  WriteCGIConstant(#PB_CGI_ServerAdmin)
  WriteCGIConstant(#PB_CGI_ServerName)
  WriteCGIConstant(#PB_CGI_ServerPort)
  WriteCGIConstant(#PB_CGI_ServerProtocol)
  WriteCGIConstant(#PB_CGI_ServerSignature)
  WriteCGIConstant(#PB_CGI_ServerSoftware)
  WriteCGIConstant(#PB_CGI_HttpAccept)
  WriteCGIConstant(#PB_CGI_HttpAcceptEncoding)
  WriteCGIConstant(#PB_CGI_HttpAcceptLanguage)
  WriteCGIConstant(#PB_CGI_HttpCookie)
  WriteCGIConstant(#PB_CGI_HttpForwarded)
  WriteCGIConstant(#PB_CGI_HttpHost)
  WriteCGIConstant(#PB_CGI_HttpPragma)
  WriteCGIConstant(#PB_CGI_HttpReferer)
  WriteCGIConstant(#PB_CGI_HttpUserAgent)
  
  WriteCGIString("</body></html>")

Voir aussi

ReadCGI()

OS Supportés

Tous

<- CGIParameterValue() - CGI Index - CountCGICookies() ->