DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Système
  • Recherche
  • Équivalence
  • Variables d'environnement dans un site WEBDEV
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
SysEnvironnement (Fonction)
En anglais : SysEnvironment
Renvoie les variables d'environnement du système d'exploitation du poste en cours.
Remarque : Pour visualiser et/ou modifier les variables d'environnement du poste en cours, ouvrez le panneau de configuration et cliquez sur l'icône "Système".
Exemple
// Connaître toutes les variables d'environnement du système d'exploitation
ResEnvironnement = SysEnvironnement()
// Connaître les variables d'environnement du système d'exploitation
Trace(SysEnvironnement("homepath"))
// renvoie par exemple : 
// homepath=\Users\doc
Syntaxe
<Résultat> = SysEnvironnement([<Variable d'environnement>])
<Résultat> : Chaîne de caractères
  • Environnement complet du poste en cours (ou du poste serveur) si aucune <Variable d'environnement> n'est spécifiée. Les lignes de l'environnement sont séparées par des RC.
  • Ligne de l'environnement dont le premier mot correspond au paramètre <Variable d'environnement>.
  • Une chaîne vide ("") en cas de problème.
<Variable d'environnement> : Chaîne de caractères optionnelle
Variable à rechercher dans l'environnement du poste en cours (par exemple, "PATH" ou "USERNAME").
Remarques

Recherche

  • La recherche selon le paramètre <Variable d'environnement> est générique. Ainsi, SysEnvironnement("PR") retourne la ligne concernant le prompt (si elle existe dans l'environnement).
  • Si plusieurs lignes peuvent répondre à la recherche, seule la première est retournée.

Équivalence

La fonction SysEnvironnement retourne le même résultat que la commande SET de la ligne de commande (DOS).
WEBDEV - Code Serveur

Variables d'environnement dans un site WEBDEV

Les variables d'environnement retournées correspondent aux variables d'environnement du système d'exploitation du poste serveur.
Le protocole CGI définit un ensemble de variables par défaut :
Nom de la variableContenu
DOCUMENT_ROOTLe répertoire racine des documents du serveur Web.
HTTP_COOKIELa valeur des cookies enregistrés par le serveur.
Remarque : Pour manipuler les cookies, il est préférable d'utiliser les fonctions CookieLit et CookieEcrit.
HTTP_HOSTLe nom du serveur.
HTTP_REFERERL'URL de la page ayant amené à la page en cours.
HTTP_USER_AGENTLa description du navigateur utilisé.
HTTPSCette variable prend la valeur "on" si le protocole HTTPS a été utilisé. Elle n'est pas définie sinon.
QUERY_STRINGL'URI demandée par le poste client avant interprétation par le serveur. Il s'agit de la requête "brute".
REMOTE_ADDRL'adresse IP du navigateur. Il est préférable d'utiliser la fonction NavigateurAdresseIP.
REMOTE_HOSTLe nom du poste client (ou son adresse IP si le nom n'a pas pu être résolu ou si la fonctionnalité de résolution est désactivée dans le serveur Web).
REMOTE_PORTLe port utilisé par le poste client pour se connecter au serveur Web.
REMOTE_USERLe nom d'utilisateur fourni par le poste client (utilisé pour les pages protégées par un mécanisme d'authentification HTTP).
REQUEST_METHODLa méthode utilisée pour faire la requête HTTP : "GET" ou "POST".
REQUEST_URIL'URI demandée par le poste client après interprétation par le serveur.
SCRIPT_FILENAMELe chemin complet du programme en cours d'exécution sur le serveur Web.
SCRIPT_NAMELa portion de la variable SCRIPT_FILENAME relative à la variable DOCUMENT_ROOT.
SERVER_ADMINLes informations de contact de l'administrateur du serveur (généralement son adresse email).
SERVER_NAMELe nom d'entête d'hôte du serveur.
SERVER_PORTLe port sur lequel le serveur Web a été contacté.
SERVER_SOFTWARELa chaîne d'information du serveur Web (si elle est fournie).
Composante : wd290std.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Exemple d'utilisation WinDev
// Pour récupérer le nom de la session Windows de l'utilisateur
vNomSession est un chaîne = SysEnvironnement("USERNAME")
// Renvoie par exemple :
// USERNAME=LeNomDeLaSession

// Pour avoir seulement le nom de la session sans USERNAME= j'ai rajouté :
ChaîneSupprime(vNomUtilisateur, "USERNAME=")
Simonline
02 aoû. 2022
Manque un exemple
C'est dommage, il manque juste un exemple. la liste des variables d'environnement figure pour WEBDEV mais pas pour WINDEV .
MARC CHERNET
17 aoû. 2017

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale