WEB GET OPTION

4D v16.3

WEB GET OPTION


WEB GET OPTION ( sélecteur ; valeur )

Paramètre	Type	Description
sélecteur	Entier long	Code de l’option à modifier
valeur	Entier long, Texte	Valeur de l’option

Description

La commande WEB GET OPTION permet de lire la valeur courante d’une option de fonctionnement du serveur Web de 4D.

Le paramètre sélecteur contient l’option Web à lire. Passez dans ce paramètre une constante du thème "Serveur Web" :

Constante	Valeur	Comment
Web character set	17	Portée : 4D local, 4D Server Conservé entre deux sessions : Oui Description : Jeu de caractères que le serveur Web 4D (avec 4D en mode local et 4D Server) utilise pour communiquer avec les navigateurs Web qui se connectent à la base. La valeur par défaut dépend de la langue du système d’exploitation. Ce paramètre est défini dans les Propriétés de la base. Valeurs : Les valeurs possibles dépendent du mode d'exécution de la base relatif au jeu de caractères. Mode Unicode : Lorsque l’application est exécutée en mode Unicode, les valeurs à passer pour ce paramètre sont des identifiants de jeux de caractères (entier long MIBEnum ou chaîne Name, identifiants définis par l’IANA, cf. http://www.iana.org/assignments/character-sets). Voici la liste des identifiants correspondant aux jeux de caractères pris en charge par le serveur Web de 4D : 4=ISO-8859-1 12=ISO-8859-9 13=ISO-8859-10 17=Shift-JIS 2024=Windows-31J 2026=Big5 38=euc-kr 106=UTF-8 2250=Windows-1250 2251=Windows-1251 2253=Windows-1253 2255=Windows-1255 2256=Windows-1256 Mode compatibilité ASCII : 0 : Occidental 1 : Japonais 2 : Chinois 3 : Coréen 4 : Défini par l’utilisateur 5 : Réservé 6 : Europe Centrale 7 : Cyrillique 8 : Arabe 9 : Grec 10 : Hébreu 11 : Turc 12 : Nordique
Web Client IP address to listen	23	Portée : Tous postes 4D distants Conservé entre deux sessions : Oui Valeurs possibles : voir sélecteur 16 Description : Permet de spécifier ce paramétrage pour toutes les machines 4D distantes utilisées comme serveurs Web. La valeur définie à l'aide de ce sélecteur est appliquée à tous les postes serveur Web distants. Si vous souhaitez définir des valeurs séparément pour certaines machines distantes, utilisez la boîte de dialogue des Propriétés de la base de 4D en mode distant.
Web debug log	84	Portée : serveur Web local Conservé entre deux sessions : Non, mais reste valide même si le serveur HTTP est redémarré (un nouveau fichier est utilisé) Description : Permet de lire ou de définir le statut du fichier de debug de requêtes HTTP du serveur Web 4D. Lorsqu'il est activé, ce fichier, nommé "HTTPDebugLog_nn.txt", est stocké dans le dossier "Logs" de l'application (nn est le numéro de fichier). L'historique des requêtes HTTP est particulièrement utile dans le contexte du débogage du serveur Web. Il stocke en texte brut chaque requête et chaque réponse. La totalité des requêtes, en-têtes compris, est enregistrée ; en option, il est possible d'enregistrer également le corps (body) des requêtes. Pour plus d'informations sur les fichiers HTTPDebugLog, veuillez vous reporter à la section Annexe E : Description des fichiers d'historique dans le manuel Mode Développement. Valeurs : Une des constantes préfixées "wdl" (reportez-vous ci-dessous à la description de ces constantes). Valeur par défaut : 0 (non activé)
Web HTTP compression level	50	Portée : Serveur Web local Conservé entre deux sessions : Non Description : Niveau de compression pour tous les échanges HTTP compressés effectués pour le serveur HTTP de 4D (requêtes client ou réponses serveur, Web et Web Service). Ce sélecteur permet d’optimiser les échanges en privilégiant la rapidité d’exécution (compression moindre) ou la quantité de compression (vitesse moindre). Le choix d’une valeur dépend de la taille et de la nature des données échangées. Passez de 1 à 9 dans le paramètre valeur, 1 étant la compression la plus rapide et 9 la plus élevée. Vous pouvez également passer -1 pour obtenir un compromis entre vitesse et taux de compression. Par défaut le niveau de compression est 1 (compression rapide). Valeurs : 1 à 9 (1 = plus rapide, 9 = plus compressé) ou -1 = meilleur compromis.
Web HTTP compression threshold	51	Portée : Serveur HTTP local Conservé entre deux sessions : Non Description : Dans le cadre d’échanges HTTP optimisés, seuil de taille de requête au-dessous de laquelle les échanges ne doivent pas être compressés. Ce paramétrage est utile pour éviter de perdre du temps machine à compresser les trop petits échanges. Valeurs possibles : Toute valeur de type Entier long. Le paramètre valeur contient une taille exprimée en octets. Par défaut, le seul de compression est fixé à 1024 octets.
Web HTTP TRACE	85	Portée : serveur Web local Conservé entre deux sessions : Non Description : Permet de désactiver ou d'activer la méthode HTTP TRACE dans le serveur Web de 4D. Pour des raisons de sécurité, à compter de 4D v15 R2, par défaut le serveur Web de 4D Web rejette les requêtes HTTP TRACE avec l'erreur 405 (see Désactivation de HTTP TRACE). Si nécessaire, vous pouvez rétablir la prise en charge de la méthode HTTP TRACE pour la session en passant cette constante avec la valeur 1. Lorsque l'option est activée, le serveur Web de 4D répond aux requêtes HTTP TRACE en retournant la ligne de requête, l'en-tête et le corps. Valeurs possibles : 0 (désactivé) ou 1 (activé) Valeur par défaut : 0 (désactivé)
Web HTTPS port ID	39	Portée : 4D local, 4D Server Conservé entre deux sessions : Oui Description : Numéro du port TCP utilisé par le serveur Web de 4D en mode local et de 4D Server pour les connexions sécurisées via TLS (protocole HTTPS). Le numéro de port HTTPS est défini dans la page “Web/Configuration” de la boîte de dialogue des Propriétés de la base. Par défaut, la valeur est 443 (valeur standard). Vous pouvez utiliser les constantes du thème Numéros de port TCP pour le paramètre valeur. Valeurs possibles : 0 à 65535
Web inactive process timeout	78	Portée : serveur Web local Conservé entre deux sessions : Non, mais reste valide même si le serveur HTTP est redémarré. Description : Permet de modifier la durée de vie des process inactifs associés aux sessions. A l’issue du timeout, le process est tué sur le serveur, la Méthode base Sur fermeture process Web est appelée puis le contexte de la session est détruit. Valeurs : Entier long (minutes) Valeur par défaut : 480 minutes (passez 0 pour rétablir la valeur par défaut)
Web inactive session timeout	72	Portée : serveur Web local Conservé entre deux sessions : Non, mais reste valide même si le serveur HTTP est redémarré. Description : Permet de modifier la durée de vie des sessions inactives (durée définie dans le cookie). A l’issue de cette durée, le cookie de session expire et n’est plus envoyé par le client HTTP. Valeurs : Entier long (minutes) Valeur par défaut : 480 minutes (passez 0 pour rétablir la valeur par défaut)
Web IP address to listen	16	Portée : 4D local, 4D Server Conservé entre deux sessions : Oui Description : Adresse IP sur laquelle le serveur Web doit recevoir les requêtes HTTP avec 4D en mode local et 4D Server. Par défaut, aucune adresse particulière n’est spécifiée. Ce paramètre est défini dans les Propriétés de la base. Ce sélecteur est utile dans le cas de serveurs Web 4D compilés et fusionnés avec 4D Desktop (pas d’accès au mode Développement). Valeurs possibles : Adresse IP sous forme de chaîne. Les formats chaîne IPv6 (ex : "2001:0db8:0000:0000:0000:ff00:0042:8329") et chaîne IPv4 (ex : "123.45.67.89") sont pris en charge. Note : Par compatibilité, les adresses IPv4 exprimées sous forme hexadécimale (obsolète) sont toujours prises en charge.
Web keep session	70	Portée : serveur Web local Conservé entre deux sessions : Non, mais reste valide même si le serveur HTTP est redémarré. Description : Permet d’activer ou d’inactiver la gestion automatique des sessions (décrit dans la section Gestion des sessions Web). Valeurs : 1 (activer mode) ou 0 (inactiver mode) Valeur par défaut : 1 pour les bases créées depuis la v13, 0 pour les bases converties. A noter que ce mode active également le mécanisme de réutilisation des contextes temporaires en mode distant. Pour plus d’informations sur ce mécanisme, reportez-vous à la description de cette option dans la section Paramétrages du serveur Web.
Web log recording	29	Portée : 4D local, 4D Server Conservé entre deux sessions : Oui Description : Démarrage ou arrêt de l’enregistrement des requêtes Web reçues par le serveur Web de 4D en mode local ou de 4D Server. Par défaut, la valeur est 0 (pas d’enregistrement des requêtes). L’historique des requêtes Web est stocké sous la forme d’un fichier texte nommé “logweb.txt” automatiquement placé dans le dossier Logs de la base, à côté du fichier de structure. Le format de ce fichier est déterminé par la valeur que vous passez. Pour plus d'informations sur les différents formats d'historique des requêtes, reportez-vous à la section Informations sur le site Web. L’activation de ce fichier peut également être définie dans la page “Web/Journal” des Propriétés de la base. Valeurs possibles : 0 = Ne pas enregistrer (défaut), 1 = Enregistrer au format CLF, 2 = Enregistrer au format DLF, 3 = Enregistrer au format ELF, 4 = Enregistrer au format WLF. Attention : Les formats 3 et 4 sont des formats personnalisés, dont le contenu doit être défini au préalable dans les Propriétés de la base. Si vous utilisez l’un de ces formats sans que ses champs n’aient été sélectionnés, le fichier des requêtes n’est pas généré.
Web max concurrent processes	18	Portée : 4D local, 4D Server Conservé entre deux sessions : Oui Description : Limite strictement supérieure du nombre de process Web de tout type acceptés par le serveur Web avec 4D en mode local et 4D Server. Lorsque ce nombre limite (moins un) est atteint, 4D ne crée plus de nouveau process et retourne le message “Serveur non disponible” (statut HTTP 503 - Service Unavailable) à toute nouvelle requête. Ce paramètre permet de prévenir la saturation du serveur Web 4D pouvant se produire lors d’un envoi massif de requêtes ou d’une demande excessive de création de contextes. Il peut également être défini dans la boîte de dialogue des Propriétés de la base. En théorie, le nombre maximum de process Web est le résultat de la division Mémoire disponible / Taille de la pile d’un process Web. Une autre solution consiste à visualiser les informations sur les process Web affichées dans l’Exporateur d’exécution : le nombre courant de process Web et le nombre maximum atteint depuis le démarrage du serveur Web sont indiqués. Valeurs : Toute valeur incluse entre 10 et 32 000. La valeur par défaut est 100.
Web max sessions	71	Portée : serveur Web local Conservé entre deux sessions : Non, mais reste valide même si le serveur HTTP est redémarré. Description : Permet de limiter le nombre de sessions simultanées. Lorsque le nombre défini est atteint, la session la plus ancienne est détruite (et la Méthode base Sur fermeture process Web est appelée) si le serveur Web a besoin d’en créer une nouvelle. Valeurs : Entier long. Le nombre de sessions simultanées ne peut pas dépasser le nombre total de process Web (option Web max concurrent processes, 100 par défaut) Valeur par défaut : 100 (passez 0 pour rétablir la valeur par défaut)
Web maximum requests size	27	Portée : 4D local, 4D Server Conservé entre deux sessions : Oui Description : Taille maximale (en octets) des requêtes HTTP entrantes (POST) que le serveur Web est autorisé à traiter. Par défaut, la valeur est 2 000 000, c’est-à-dire un peu moins de 2 Mo. La valeur maximale (2 147 483 648) signifie en pratique qu’aucune limite n’est fixée. Ce paramétrage permet d’empêcher la saturation du serveur Web à cause de requêtes entrantes de trop grande taille. Lorsqu’une requête atteint la limite, le serveur Web de 4D la refuse. Valeurs possibles : 500 000 à 2 147 483 648.
Web port ID	15	Portée : 4D en mode local et 4D Server. Conservé entre deux sessions : Non Description : Permet de fixer ou de lire le numéro du port TCP utilisé par le serveur Web 4D avec 4D en mode local et 4D Server. Le numéro de port TCP est défini dans la page “Web/Configuration” de la boîte de dialogue des Propriétés de la base. Vous pouvez utiliser les constantes du thème Numéros de port TCP pour le paramètre valeur. Ce sélecteur est utile dans le cadre de serveurs Web 4D compilés et fusionnés avec 4D Desktop (pas d’accès au mode Développement). Valeurs : Pour plus d’informations sur le numéro de port TCP, reportez-vous à la section Paramétrages du serveur Web. Valeur par défaut : 80
Web session cookie domain	81	Portée : serveur Web local Conservé entre deux sessions : Non, mais reste valide même si le serveur HTTP est redémarré. Description : Permet de fixer ou de lire la valeur du champ "domain" du cookie de session. Ce sélecteur (ainsi que le sélecteur 82) est utile pour contrôler la portée des cookies de session : si vous définissez par exemple la valeur "/.4d.fr" pour ce sélecteur, le client n'enverra un cookie que lorsque la requête s'adresse au domaine ".4d.fr", ce qui exclut les serveurs hébergeant des données statiques externes. Valeurs :* Texte
Web session cookie name	73	Portée : serveur Web local Conservé entre deux sessions : Non, mais reste valide même si le serveur HTTP est redémarré. Description : Permet de définir le nom du cookie utilisé pour stocker l’ID de session. Valeurs : Texte. Valeur par défaut : "4DSID" (passez une chaîne vide pour rétablir la valeur par défaut)
Web session cookie path	82	Portée : serveur Web local Conservé entre deux sessions : Non, mais reste valide même si le serveur HTTP est redémarré. Description : Permet de fixer ou de lire la valeur du champ "path" du cookie de session. Ce sélecteur (ainsi que le sélecteur 81) est utile pour contrôler la portée des cookies de session : si vous définissez par exemple la valeur "/4DACTION" pour ce sélecteur, le client n'enverra un cookie que pour les requêtes dynamiques débutant par 4DACTION et pas pour les images, pages statiques, etc. Valeurs : Texte
Web session enable IP address validation	83	Portée : serveur Web local Conservé entre deux sessions : Non Description : Permet de désactiver ou d'activer la validation des adresses IP pour les cookies de session. Pour des raisons de sécurité, par défaut le serveur Web de 4D vérifie l'adresse IP de chaque requête contenant un cookie de session et rejette la requête si cette adresse ne correspond pas à l'adresse IP utilisée pour créer le cookie. Dans certaines applications spécifiques, vous pouvez souhaiter désactiver cette validation et accepter les cookies de session même si les adresses IP ne correspondent pas. Par exemple, lorsque les appareils mobiles basculent du réseau Wifi au réseau 3G/4G, leur adresse IP change. Dans ce cas, vous pouvez passer 0 dans cette option afin de permettre aux clients de pouvoir continuer à utiliser leur session Web même après changement d'adresse IP. Notez que ce paramétrage abaisse le niveau de sécurité de votre application. Lorsqu'il est modifié, ce paramétrage est effectif immédiatement (il n'est pas nécessaire de redémarrer le serveur HTTP). Valeurs possibles : 0 (désactivé) ou 1 (activé) Valeur par défaut : 1 (les adresses IP sont vérifiées)

Lorsque vous utilisez le sélecteur Web debug log, vous pouvez récupérer une des constantes suivantes dans le paramètre valeur :

Constante	Type	Valeur	Comment
wdl disable	Entier long	0	Le fichier de debug de requêtes HTTP Web est désactivé
wdl enable with all body parts	Entier long	7	Le fichier de debug de requêtes HTTP Web est activé avec les body de la requête et de la réponse
wdl enable with request body	Entier long	5	Le fichier de debug de requêtes HTTP Web est activé avec le body de la requête uniquement
wdl enable with response body	Entier long	3	Le fichier de debug de requêtes HTTP Web est activé avec le body de la réponse uniquement
wdl enable without body	Entier long	1	Le fichier de debug de requêtes HTTP Web est activé sans les body (la taille des body est fournie dans ce cas)

Voir aussi

WEB SET OPTION