WEB GET HTTP HEADER
WEB GET HTTP HEADER ( entête | tabChamps {; tabValeurs} )
| Paramètre | Type | Description | |
|---|---|---|---|
| entête | tabChamps | Texte, Tableau texte | ← | En-tête HTTP de la requête ou Champs de l’en-tête HTTP |
| tabValeurs | Text array | ← | Contenu des champs de l’en-tête HTTP |
Description
La commande WEB GET HTTP HEADER retourne, soit sous forme de chaîne, soit sous forme de deux tableaux, l’en-tête HTTP de la requête en cours de traitement.
Cette commande peut être appelée depuis toute méthode (Méthode base Sur authentification Web, QR SET DESTINATION, méthode appelée par "/4DACTION"...) exécutée dans un process Web.
- Première syntaxe : WEB GET HTTP HEADER (entête)
Lorsque vous utilisez cette syntaxe, le résultat retourné dans la variable entête est du type suivant :
"GET /page.html HTTP\1.0"+Char(13)+Char(10)+"User-Agent: browser"+Char(13)+Char(10)+"Cookie: C=HELLO"
Chaque champ d’en-tête est séparé par une séquence CR+LF (Retour chariot+Retour à la ligne), sous Windows et Mac OS.
- Seconde syntaxe : WEB GET HTTP HEADER (tabChamps; tabValeurs) Lorsque vous utilisez cette syntaxe, les résultats retournés dans les tableaux tabChamps et tabValeurs sont du type suivant :
| tabChamps{1} = "X-METHOD" | tabValeurs{1} = "GET" * |
|---|---|
| tabChamps{2} = "X-URL" | tabValeurs{2} = "/page.html" * |
| tabChamps{3} = "X-VERSION" | tabValeurs{3} = "HTTP/1.0" * |
| tabChamps{4} = "User-Agent" | tabValeurs{4} = "browser" |
| tabChamps{5} = "Cookie" | tabValeurs{5} = "C=HELLO" |
* Ces trois premiers éléments ne correspondent pas à des champs HTTP. Ils constituent la première ligne de la requête.
Conformément à la norme HTTP, les noms des champs sont toujours libellés en anglais.
A titre indicatif, voici une liste non exhaustive des champs HTTP pouvant être présents dans une requête :
- Accept : ce que le navigateur est susceptible d’accepter comme contenu.
- Accept-Language : la ou les langue(s) acceptée(s) par le navigateur (pour information). Permet de choisir une page d’accueil en fonction de la langue préférée du navigateur.
- Cookie : liste des cookies.
- From : adresse e-mail de l’utilisateur du navigateur.
- Host : nom ou adresse du serveur (par exemple, dans le cas de l’URL http://monserveurweb/mapage.html, Host prend la valeur "monserveurweb"). Permet de gérer les cas où plusieurs noms pointent vers la même adresse IP (virtual hosting).
- Referer : provenance de la requête (par exemple http://monserveurweb/mapage1.html), c’est-à-dire la page que l’utilisateur affiche s’il clique sur le bouton Précédent de son navigateur.
- User-Agent : nom et version du navigateur ou du proxy.
Exemple
- Cette méthode permet de récupérer le contenu de tout champ d’en-tête de requête HTTP :
// Méthode projet GetHTTPField
// GetHTTPField ( Texte ) -> Texte
// GetHTTPField ( Nom en-tête HTTP ) -> Contenu en-tête HTTP
var $0;$1 : Text
var $vlElem : Integer
ARRAY TEXT($noms;0)
ARRAY TEXT($valeurs;0)
$0:=""
WEB GET HTTP HEADER($noms;$valeurs)
$vlElem:=Find in array($noms;$1)
If($vlElem>0)
$0:=$valeurs{$vlElem}
End if
- Une fois que cette méthode projet est écrite, vous pouvez l’appeler ainsi :
// Contenu de l’en-tête Cookie
$cookie:=GetHTTPField("Cookie")
- Vous pouvez également envoyer des pages différentes en fonction de la langue du navigateur (par exemple dans la QR SET DESTINATION) :
$langue:=GetHTTPField("Accept-Language")
Case of
:($langue="@fr@") //Français (cf. liste ISO 639)
WEB SEND FILE("index_fr.html")
:($langue="@es@") //Espagnol (cf. liste ISO 639)
WEB SEND FILE("index_es.html")
Else
WEB SEND FILE("index.html")
End case
Note : Les navigateurs Web permettent de définir plusieurs langues par défaut. Elles sont listées dans le champ “Accept-Language”, séparées par des ";". Leur priorité est définie par leur position au sein de la chaîne ; il peut donc être utile de tester la position des langues dans la chaîne.
- Exemple de gestion des hôtes virtuels (par exemple dans la QR SET DESTINATION). Les trois noms “home_site.com”, “home_site1.com” et “home_site2.com” pointent vers la même adresse IP, par exemple 192.1.2.3.
$host:=GetHTTPField("Host")
Case of
:($host="www.site1.com")
WEB SEND FILE("home_site1.com")
:($host="www.site2.com")
WEB SEND FILE("home_site2.com")
Else
WEB SEND FILE("home_site.com")
End case