Paramétrages du serveur Web

version 2004 (Modifiée)

Vous pouvez paramétrer le fonctionnement du serveur Web 4D à l'aide de paramètres définis dans le thème Web des Préférences de la base. Cette section décrit les paramètres des pages Configuration, Avancé et Options de ce thème ainsi que la section "Compatibilité Web" de la page Application/Compatibilité.

Indique si le serveur Web doit être démarré dès le lancement de l'application 4D. Cette option est détaillées dans la section Mise en route du serveur Web et gestion des connexions.

Par défaut, 4D publie une base Web sur le port TCP standard du Web, qui est le port 80. Si ce port est déjà utilisé par un autre service Web, vous devez changer le port TCP utilisé par 4D pour votre base. La modification du port TCP permet également de lancer le serveur Web 4D sous Mac OS X sans être l'utilisateur root de la machine (cf. section Mise en route du serveur Web et gestion des connexions).

Pour cela, dans la zone de saisie "Port TCP", indiquez le numéro de port TCP à utiliser pour cette base (c'est-à-dire un numéro de port TCP non utilisé par un autre service TCP/IP sur la machine).

Note : Si vous passez 0, 4D utilisera le numéro de port TCP par défaut, c'est-à-dire 80.

Au niveau du navigateur Web, vous devez inclure ce numéro de port TCP personnalisé dans la description de l'adresse utilisée pour vous connecter à la base Web. L'adresse doit être suivie du signe "deux-points" et du numéro de port. Si, par exemple, vous utilisez le port TCP numéro 8080, vous devrez spécifier dans le browser "123.45.67.89:8080".

ATTENTION : Lorsque vous utilisez des numéros de port TCP autres que les numéros par défaut (80 pour le mode standard et 443 pour le mode SSL), prenez garde à ne pas spécifier de numéros de port qui se trouvent être les numéros par défaut d'autres services que vous employez simultanément. Si, par exemple, vous envisagez d'exploiter le protocole FTP sur la machine serveur Web, n'utilisez pas les numéros de ports TCP 20 et 21 qui sont les ports par défaut de ce protocole. Pour connaître les attributions standard des numéros de port TCP, vous pouvez vous reporter à la section Annexe B, Numéros des ports TCP dans la documentation de 4D Internet Commands. Les numéros de port inférieurs à 256 sont réservés pour les services standard et les numéros 256 à 1024 sont réservés pour les services spécifiques issus des plates-formes UNIX. Pour une sécurité maximum, il vous suffit de spécifier un numéro de port situé au-delà de ces intervalles, par exemple dans les 2000 ou 3000.

Vous pouvez définir l'adresse IP sur laquelle le serveur Web doit recevoir les requêtes HTTP. Par défaut, le serveur répond sur toutes les adresses IP (option Toutes).

La liste déroulante "Adresse IP" liste automatiquement toutes les adresses IP présentes sur la machine. Lorsque vous sélectionnez une adresse particulière, le serveur ne répond qu'aux requêtes dirigées sur cette adresse.

Cette fonctionnalité est destinée aux serveurs Web 4D hébergés sur des machines ayant plusieurs adresses TCP/IP. C'est, par exemple, fréquemment le cas chez les fournisseurs d'hébergement Internet (MultiHoming). Vous pouvez donc placer plusieurs 4D ou 4D Server sur une même machine et de réserver une adresse IP spécifique à chaque base publiée en Internet/Intranet.

La mise en place de cette fonctionnalité nécessite une configuration adéquate de la machine accueillant les différents serveurs Web :

• Configuration MultiHoming sous Mac OS

Pour mettre en place un système utilisant le MultiHoming sous Mac OS :

1. Vous devez disposer d'Open Transport version 1.3 minimum (le MultiHoming est intégré à partir de cette version d'Open Transport).

2. Ouvrez le tableau de bord TCP/IP.

3. Sélectionnez manuel dans le pop up menu Configuration.

4. Créez un fichier texte nommé "Secondary IP Addresses" et placez-le dans le sous-dossier "Préférences" de votre dossier Système.

Chaque ligne du fichier "Secondary IP Addresses" doit contenir une adresse IP secondaire ainsi que, si nécessaire, un masque de sous-réseau et une adresse de routeur.

Pour plus d'informations sur cette configuration, reportez-vous à la documentation d'Open Transport, fournie par Apple, Inc.

• Configuration MultiHoming sous Windows

Pour mettre en place un système utilisant le MultiHoming sous Windows :

1. Sélectionnez successivement les commandes suivantes :

• Windows NT : Menu Démarrer > Paramètres > Panneau de configuration > icône Réseau > onglet Protocoles > Protocole TCP/IP > bouton Propriétés > bouton Avancé...

• Windows 2000 : Menu Démarrer > Paramètres > Connexions réseau et accès à distance > Connexion au réseau local > Bouton Propriétés > Protocole Internet (TCP/IP) > Bouton Propriétés > Bouton Avancé...

• Windows XP : Menu Démarrer > Panneau de configuration > Connexions réseau et Internet > Connexions réseau > Connexion au réseau local (Propriétés) > Protocole Internet (TCP/IP) > Bouton Propriétés > Bouton Avancé...

La boîte de dialogue de configuration "Paramètres TCP/IP avancés" s'affiche.

2. Cliquez sur le bouton Ajouter... dans la zone "Adresses IP" et ajoutez les adresses IP supplémentaires.

Vous pouvez définir jusqu'à 5 adresses IP différentes. Pour cette opération, il se peut que vous ayez besoin de l'assistance d'un administrateur réseau.

Indique si le serveur Web doit ou non accepter les connexions sécurisées. Cette option est décrite dans la section Utiliser le protocole SSL.

Permet de modifier le numéro du port TCP/IP utilisé par le serveur Web pour les connexions HTTP sécurisées via SSL (protocole HTTPS). Par défaut, le numéro du port HTTPS est 443 (valeur standard).

Vous pouvez souhaiter modifier ce numéro pour deux raisons principales :

• par souci de sécurité — en effet, les attaques des pirates contre les serveurs Web se concentrent généralement sur les ports TCP standard, c'est-à-dire 80 et 443.

• sous Mac OS X, pour permettre aux utilisateurs "standard" de lancer le serveur Web en mode sécurisé — en effet, sous Mac OS X, l'utilisation des ports TCP/IP réservés à la publication Web (0 à 1023) requiert des privilèges d'accès spécifiques : seul l'utilisateur "root" peut lancer une application utilisant ces ports. Pour que les utilisateurs autres que "root" puissent lancer le serveur Web, une solution consiste à modifier le numéro du port TCP/IP du serveur Web (cf. section Mise en route du serveur Web et gestion des connexions).

Vous pouvez passer toute valeur valide (pour éviter les restrictions d'accès sous Mac OS X, il est nécessaire de passer une valeur supérieure à 1023). Pour plus d'informations sur les numéros de port TCP, reportez-vous ci-dessus au paragraphe "Port TCP".

Permet de définir l'emplacement par défaut des fichiers du site Web et indique le niveau hiérarchique sur le disque au-dessus duquel aucune requête ne pourra accéder. Cette option est décrite dans la section Sécurité des connexions.

Cette option permet de désigner la page d'accueil (page "Home") par défaut pour tous les navigateurs se connectant à la base, quel que soit le mode (avec ou sans contexte) défini pour le démarrage des sessions Web. Cette page peut être statique ou semi-dynamique.

Par défaut, lors du premier démarrage du serveur Web, 4D crée une page d'accueil nommée "index.html" et la place dans le dossier racine HTML. Si vous ne modifiez pas ce paramétrage, tout navigateur se connectant au serveur Web obtient la page suivante :

Pour modifier la page d'accueil par défaut, vous pouvez simplement la remplacer par votre propre page "index.html" dans le dossier racine de la base ou saisir dans la zone le chemin d'accès relatif de la page que vous souhaitez définir. Le chemin d'accès doit être établi relativement au dossier racine HTML par défaut. Afin d'assurer la compatibilité multi-plate-forme de vos bases, le serveur Web 4D utilise, pour décrire les chemins d'accès, des conventions d'écriture particulières. Les règles de syntaxe sont les suivantes ;

• les dossiers sont séparés par le caractère /

• le chemin ne doit pas se terminer par /

• pour "remonter" d'un niveau dans la hiérarchie des dossiers, saisissez ".." (point point) devant le nom du dossier

• le chemin ne doit pas commencer par /.

Par exemple, si vous souhaitez que la page d'accueil par défaut soit la page "MyHome.htm", placée dans le dossier "Web" (lui-même situé dans le dossier racine HTML par défaut de la base), saisissez Web/MyHome.htm

Note : Vous pouvez également définir une page d'accueil par défaut pour chaque process Web à l'aide de la routine FIXER PAGE ACCUEIL.

Si vous ne spécifiez pas de page d'accueil par défaut, le fonctionnement du serveur Web diffère suivant le mode de démarrage :

• Si le serveur Web démarre en mode sans contexte (mode standard), la Méthode base Sur connexion Web est appelée. Il vous revient alors de traiter la requête par programmation.

• Si le serveur Web démarre en mode contextuel, la barre de menus courante — par défaut, la barre de menus n° 1 — est envoyée en tant que page d'accueil.

Permet de définir le mode dans lequel le serveur Web doit démarrer. Cette option est décrite dans la section Utiliser le mode contextuel.

Réutilisation des contextes temporaires (visible uniquement avec 4D Client)

Permet d'optimiser le fonctionnement du serveur Web de 4D Client en recyclant les process Web créés pour le traitement de requêtes Web précédentes.

En effet, le serveur Web de 4D Client a besoin d'un process Web spécifique pour le traitement de chaque requête Web ; lorsque cela s'avère nécessaire, ce process se connecte au poste 4D Server afin d'accéder aux données et au moteur de base de données. Il génère alors un contexte temporaire utilisant ses propres variables, sélections, etc. Une fois la requête traitée, le process est tué. Lorsque l'option Réutilisation des contextes temporaires est cochée, 4D maintient les process Web spécifiques créés sur 4D Client et les réutilise pour les requêtes suivantes. L'étape de création du process étant supprimée, les performances du serveur Web sont alors améliorées.

En contrepartie, vous devez veiller dans ce cas à initialiser systématiquement les variables utilisées dans les méthodes 4D afin de ne pas risquer d'obtenir des résultats faussés. De même, il est nécessaire d'effacer les sélections ou enregistrements courants éventuellement définis au cours de la requête précédente.

Le serveur Web 4D dispose d'un cache permettant de charger en mémoire les pages statiques, les images GIF, les images JPEG (<100 ko) et les feuilles de styles (fichiers .css), au fur et à mesure qu'elles sont demandées.

L'utilisation d'un cache permet d'augmenter de manière significative les performances du serveur Web en ce qui concerne l'envoi de pages statiques. Le cache est commun à tous les process Web.

Par défaut, le cache des pages statiques n'est pas activé. Pour l'activer, il suffit de cocher l'option Utiliser le cache Web de 4D.

Vous pouvez éventuellement modifier la taille du cache dans la zone Taille du cache des pages. La valeur à fixer dépend du nombre et de la taille des pages statiques de votre site Web, ainsi que des ressources dont dispose la machine hôte.

Note : Au cours de l'utilisation de votre base Web, vous pourrez contrôler les performances du cache à l'aide de la routine STATISTIQUES DU CACHE WEB. Si par exemple vous constatez que le taux d'utilisation du cache est proche de 100%, vous pouvez envisager d'augmenter la taille qui lui est allouée.

Les URL particuliers /4DSTATS et /4DHTMLSTATS vous permettent également d'obtenir des informations sur l'état du cache. Reportez-vous à la section Informations sur le site Web.

Une fois le cache activé, lorsqu'une page est demandée par un navigateur, le serveur Web 4D la cherche d'abord dans le cache. Si elle s'y trouve, elle est immédiatement envoyée, sinon le programme charge la page depuis le disque et la place dans le cache. Lorsque le cache est plein et que de la place supplémentaire est requise, 4D "décharge" les pages les moins utilisées, par ordre d'ancienneté.

• Vider le cache

Vous pouvez à tout moment vider le cache des pages et des images qu'il contient (par exemple si vous avez effectué des modifications sur une page statique et souhaitez qu'elle soit rechargée dans le cache). Pour cela, il vous suffit de cliquer sur le bouton Vider cache. Le cache est alors immédiatement vidé.

Permet de définir le délai avant fermeture (timeout) des process de connexion Web (mode contextuel uniquement). Cette option est décrite dans la section Utiliser le mode contextuel.

Cette option indique la limite strictement supérieure du nombre de process Web de tout type (contextuels, non contextuels ou appartenant à la "réserve" de process) pouvant être simultanément ouverts sur le serveur. 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.

Par défaut, le nombre est de 32 000 (autrement dit, jusqu'à 31 999 process Web peuvent être créés simultanément). Vous pouvez passer toute valeur incluse entre 10 et 32 000.

Lorsque ce nombre maximum (moins un) de process Web concurrents 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.

Note : Le nombre maximum de process Web peut également être défini à l'aide de la commande FIXER PARAMETRE BASE.

• Comment déterminer la valeur à passer ?

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'Explorateur d'exécution : le nombre courant de process Web et le nombre maximum atteint depuis le démarrage du serveur Web sont indiqués.

• A propos de la réserve de process Web

La "réserve" de process Web permet d'augmenter la réactivité du serveur Web en mode sans contexte. Cette réserve est dimensionnée par un minimum (0 par défaut) et un maximum (10 par défaut) de process à recycler. Ces valeurs peuvent être modifiées à l'aide de la commande FIXER PARAMETRE BASE. Lors du changement du nombre maximum de process Web, si celui-ci est inférieur à la limite supérieure de la "réserve", cette limite est alors abaissée au nombre maximum de process Web.

Lorsque cette option est cochée, en mode contextuel une partie des contrôles de saisie peut être effectuée sur les navigateurs via des scripts Java automatiques.

Sur le navigateur, les contrôles de saisie et les types de données (champs ou variables) auxquels ils peuvent s'appliquer sont les suivants :

• valeur minimale (numériques) ;

• valeur maximale (numériques) ;

• valeur obligatoire (numériques et alphas).

Les scripts Java générés, de petite taille, ont pour but d'afficher les boîtes de dialogue d'alerte adéquates sans réellement empêcher la validation (celle-ci reste du ressort de 4D).

En effet, si une zone de saisie contient une valeur incorrecte, un message d'alerte est affiché sur le navigateur lorsque l'utilisateur clique sur un bouton (de validation, d'annulation, etc.). Une fois la boîte de dialogue d'alerte validée, si l'utilisateur clique une seconde fois sur le bouton, l'action de celui-ci sera prise en compte. Le contrôle complet de la saisie est effectué par le serveur Web de 4D.

Cette option vous permet de générer sous forme de fichier texte au format CLF un historique des requêtes adressées au serveur Web. Cette option est décrite dans la section Informations sur le site Web.

Paramétrage du système de protection des accès au site Web via des mots de passe. Cette option est décrite dans la section Sécurité des connexions.

Par défaut, le serveur Web 4D convertit les caractères étendus présents dans les pages Web (dynamiques et statiques) au normes HTML avant de les envoyer. Ils sont ensuite interprétés par les navigateurs.

Vous pouvez paramétrer le serveur Web de manière à ce que les caractères étendus soient envoyés "tel quels", sans conversion en entités HTML. Cette option permet un gain de vitesse important sur des systèmes étrangers (principalement japonais).

Pour cela, il suffit de cocher l'option Envoyer directement les caractères étendus.

La liste déroulante Jeu standard vous permet de définir le jeu de caractères utilisé par le serveur Web 4D. Par défaut, le jeu de caractères est UTF-8.

Le serveur Web de 4D peut utiliser des connexions persistantes (keep-alive). L'option keep-alive permet de maintenir ouverte une seule connexion TCP pour l'ensemble des échanges effectués par un navigateur et le serveur afin d'économiser les ressources et d'optimiser les échanges.

L'option Utiliser les connexions persistantes permet d'activer ou d'inactiver les connexions TCP persistantes pour le serveur Web. Cette option est cochée par défaut. Dans la plupart des cas, il est conseillé de conserver cette option cochée car elle permet d'accélérer les échanges. Si le navigateur Web ne prend pas en charge les connexions keep-alive, le serveur Web 4D bascule automatiquement en HTTP/1.0.

La fonction keep-alive du serveur Web de 4D concerne toutes les connexions TCP/IP (HTTP, HTTPS), en mode contextuel et en mode sans contexte. A noter toutefois que les connexions persistantes ne sont pas systématiquement utilisées pour tous les process Web 4D. Dans certains cas, d'autres mécanismes d'optimisation du serveur Web sont mis en oeuvre. Les connexions persistantes sont principalement efficaces lors de l'envoi de pages statiques.

Deux options permettent de régler le mécanisme des connexions persistantes :

• Nombre de requêtes par connexion : permet de définir le nombre maximum de requêtes pouvant transiter dans une même connexion persistante. Limiter le nombre de requêtes par connexion permet d'éviter les risques de saturation du serveur via l'envoi massif de requêtes (technique utilisée par les pirates).

La valeur par défaut (100) peut être réduite ou augmentée en fonction des ressources de la machine hébergeant le serveur Web 4D.

• Délai avant déconnexion (timeout) : cette valeur définit le délai maximal (en secondes) pendant lequel le serveur Web maintient ouverte une connexion TCP tant qu'aucune nouvelle requête n'est reçue de la part du navigateur. A l'issue de ce délai, le serveur referme la connexion.

Si le navigateur envoie une requête après la fermeture de la connexion, une nouvelle connexion TCP est automatiquement créée. Ce fonctionnement est transparent pour l'utilisateur.

La page Compatibilité du thème Application des Préférences comporte des options permettant de régler le fonctionnement du serveur Web :

Utiliser les commentaires 4DVAR au lieu des crochets

Cette option vous permet de définir la notation à utiliser pour l'insertion de variables 4D dans les pages statiques.

• Lorsque l'option est cochée (valeur par défaut), la syntaxe à employer est la notation HTML standard :

<!––#4DVAR MAVAR––> (l'espace entre 4DVAR et le nom de la variable est impératif).

• Lorsque l'option n'est pas cochée, la syntaxe à employer est la notation avec des crochets ([MAVAR]) — solution propriétaire utilisée dans les anciennes versions du serveur Web 4D.

Lorsque cette option est cochée (valeur par défaut), en mode contextuel le serveur Web place le numéro de contexte courant dans l'URL de base des documents envoyés aux navigateurs.

Avec le système précédent (option désélectionnée), le serveur Web 4D envoie au navigateur le numéro du contexte pour chaque élément d'une page, ce qui ralentit les traitements.

Cette option peut être désélectionnée pour des raisons de compatibilité. Notez qu'après l'avoir modifiée, vous devez redémarrer la base afin que le nouveau fonctionnement soit effectif.

Dans les versions précédentes de 4D, les URLs inconnus (URLs ne correspondant à aucune page ni URLs spécial) étaient retournés dans les méthodes bases Sur authentification Web et Sur connexion Web ($1) sans débuter par le caractère "/". Cette particularité a été supprimée à compter de 4e Dimension 2004.

Toutefois, si vous avez mis en place des mécanismes basés sur cette particularité et souhaitez conserver le fonctionnement précédent, vous pouvez cocher l'option Supprimer "/" sur les URLs inconnus. Par défaut, cette option est cochée pour les bases de données converties et non cochée pour les nouvelles bases.

FIXER PAGE ACCUEIL, FIXER PARAMETRE BASE, Sécurité des connexions, Utiliser le mode contextuel.