4D Doc Center : WEB FIXER OPTION

4D v14.3

WEB FIXER OPTION


WEB FIXER 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 FIXER OPTION permet de modifier la valeur courante de diverses options de fonctionnement du serveur Web de 4D.

Passez dans le paramètre sélecteur une des constantes du thème Serveur Web et dans valeur la nouvelle valeur de l’option :

Constante	Type	Valeur	Commentaire
Web adresse IP d’écoute	Entier long	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 (valeur = 0). Ce paramètre est défini dans les Propriétés de la base. Le sélecteur Web Adresse IP d’écoute 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). Le paramètre valeur contient l’adresse IP sous forme hexadécimale. Ainsi, pour désigner une adresse du type “a.b.c.d”, le code sera de la forme : `C_ENTIER LONG($addr) $addr:=($a<<24)\|($b<<16)\|($c<<8)\|$d WEB FIXER OPTION(Web Adresse IP découte;$addr)`
Web chemin du cookie de session	Entier long	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 conserver les sessions	Entier long	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 domaine du cookie de session	Entier long	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 enreg requêtes	Entier long	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 jeu de caractères	Entier long	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 niveau de compression HTTP	Entier long	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 nom du cookie de session	Entier long	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 nombre de sessions max	Entier long	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 session 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 Process Web simultanés maxi, 100 par défaut) Valeur par défaut : 100 (passez 0 pour rétablir la valeur par défaut)
Web numéro de port HTTPS	Entier long	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 SSL (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 numéro du port	Entier long	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 process Web simultanés maxi	Entier long	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 seuil de compression HTTP	Entier long	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 taille max requêtes	Entier long	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 timeout process	Entier long	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 session 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 timeout session	Entier long	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)