Manuel utilisateur OpenLiteSpeed
Configuration des modules
Les modules peuvent etre configures globalement sous l'onglet Server Module configuration. Les donnees de configuration sont ensuite disponibles pour les configurations de modules Listener et Virtual Host, qui peuvent les heriter ou les modifier.
Table des matières
Modules serveur
- Module
- Module interne
- Paramètres du module
- Activer le module
- Priorité Hook::L4_BEGINSESSION
- Priorité Hook::L4_ENDSESSION
- Priorité Hook::L4_RECVING
- Priorité Hook::L4_SENDING
- Priorité Hook::HTTP_BEGIN
- Priorité Hook::RECV_REQ_HEADER
- Priorité Hook::URI_MAP
- Priorité Hook::HTTP_AUTH
- Priorité Hook::RECV_REQ_BODY
- Priorité Hook::RCVD_REQ_BODY
- Priorité Hook::RECV_RESP_HEADER
- Priorité Hook::RECV_RESP_BODY
- Priorité Hook::RCVD_RESP_BODY
- Priorité Hook::HANDLER_RESTART
- Priorité Hook::SEND_RESP_HEADER
- Priorité Hook::SEND_RESP_BODY
- Priorité Hook::HTTP_END
- Priorité Hook::MAIN_INITED
- Priorité Hook::MAIN_PREFORK
- Priorité Hook::MAIN_POSTFORK
- Priorité Hook::WORKER_POSTFORK
- Priorité Hook::WORKER_ATEXIT
- Priorité Hook::MAIN_ATEXIT
Modules de listener
Modules d'hôte virtuel
Filtres URL de module
Modules serveur
Description
La configuration des modules du serveur definit globalement les donnees de configuration des modules. Une fois definis, les listeners et les hotes virtuels ont acces aux modules et a leurs configurations.
Tous les modules a traiter doivent etre enregistres dans la configuration du serveur. La configuration du serveur definit egalement les valeurs par defaut des donnees de parametres de module. Ces valeurs peuvent etre heritees ou remplacees par les donnees de configuration du listener et de l'hote virtuel.
La priorite d'un module est definie uniquement au niveau serveur et heritee par les configurations de listener et d'hote virtuel.
Module
Description
Nom d'un module externe ou interne à charger au démarrage du serveur.
Externe
La valeur utilisée pour les modules externes doit correspondre au nom du fichier ".so" du module sous $SERVER_ROOT/modules/modulename.so afin que l'application serveur puisse le charger. Le serveur doit être redémarré après l'enregistrement d'un nouveau module.
Interne
La valeur utilisée pour les modules internes doit correspondre au nom de module utilisé lors de la compilation du module. Par exemple, elle doit être définie sur "cache" pour le module de cache interne inclus avec le serveur.
Syntaxe
chaîne
Module interne
Description
Indique si le module est un module interne, lié statiquement, plutôt qu'une bibliothèque externe .so.
Syntaxe
Sélectionner avec les boutons radio
Paramètres du module
Description
Définissez les paramètres du module. Les paramètres du module sont définis par le développeur du module.
La valeur définie au niveau serveur sera assignée globalement comme valeur par défaut. L'utilisateur peut remplacer ce réglage aux niveaux listener, hôte virtuel ou contexte. S'il n'est défini à aucun de ces niveaux, la valeur est héritée du niveau supérieur suivant.
Syntaxe
Spécifiée par l'interface du module.
Activer le module
Description
Active les hooks du module globalement. Ce réglage peut être remplacé aux niveaux listener et hôte virtuel.
Valeur par défaut: Yes
Syntaxe
Sélectionner avec les boutons radio
Priorité Hook::L4_BEGINSESSION
Description
Définit la priorité de ce callback de module dans le hook L4 Begin Session.
Le hook L4 Begin Session est déclenché lorsque la connexion TCP/IP commence.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::L4_ENDSESSION
Description
Définit la priorité de ce callback de module dans le hook L4 End Session.
Le hook L4 End Session est déclenché lorsque la connexion TCP/IP se termine.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::L4_RECVING
Description
Définit la priorité de ce callback de module dans le hook L4 Receiving.
Le hook L4 Receiving est déclenché lorsque la connexion TCP/IP reçoit des données.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::L4_SENDING
Description
Définit la priorité de ce callback de module dans le hook L4 Sending.
Le hook L4 Sending est déclenché lorsque la connexion TCP/IP envoie des données.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::HTTP_BEGIN
Description
Définit la priorité de ce callback de module dans le hook HTTP Begin.
Le hook HTTP Begin est déclenché lorsque la connexion TCP/IP commence une session HTTP.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::RECV_REQ_HEADER
Description
Définit la priorité de ce callback de module dans le hook HTTP Receive Request Header.
Le hook HTTP Receive Request Header est déclenché lorsque le serveur web reçoit un en-tête de requête.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::URI_MAP
Description
Définit la priorité de ce callback de module dans le hook HTTP URI Map.
Le hook HTTP URI Map est déclenché lorsque le serveur web associe une requête URI à un contexte.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::HTTP_AUTH
Description
Définit la priorité de ce callback de module dans le hook HTTP Authentication.
Le hook HTTP Authentication est déclenché après le mappage des ressources et avant le traitement par le gestionnaire. Il intervient après l'authentification HTTP intégrée et peut servir à effectuer des contrôles d'authentification supplémentaires.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::RECV_REQ_BODY
Description
Définit la priorité de ce callback de module dans le hook HTTP Receive Request Body.
Le hook HTTP Receive Request Body est déclenché lorsque le serveur web reçoit les données du corps de la requête.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::RCVD_REQ_BODY
Description
Définit la priorité de ce callback de module dans le hook HTTP Received Request Body.
Le hook HTTP Received Request Body est déclenché lorsque le serveur web a fini de recevoir les données du corps de la requête.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::RECV_RESP_HEADER
Description
Définit la priorité de ce callback de module dans le hook HTTP Receive Response Header.
Le hook HTTP Receive Response Header est déclenché lorsque le serveur web crée l'en-tête de réponse.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::RECV_RESP_BODY
Description
Définit la priorité de ce callback de module dans le hook HTTP Receive Response Body.
Le hook HTTP Receive Response Body est déclenché lorsque le backend du serveur web reçoit le corps de la réponse.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::RCVD_RESP_BODY
Description
Définit la priorité de ce callback de module dans le hook HTTP Received Response Body.
Le hook HTTP Received Response Body est déclenché lorsque le backend du serveur web a fini de recevoir le corps de la réponse.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::HANDLER_RESTART
Description
Définit la priorité de ce callback de module dans le hook HTTP Handler Restart.
Le hook HTTP Handler Restart est déclenché lorsque le serveur web doit abandonner la réponse actuelle et reprendre le traitement depuis le début, par exemple lorsqu'une redirection interne a été demandée.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::SEND_RESP_HEADER
Description
Définit la priorité de ce callback de module dans le hook HTTP Send Response Header.
Le hook HTTP Send Response Header est déclenché lorsque le serveur web est prêt à envoyer l'en-tête de réponse.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::SEND_RESP_BODY
Description
Définit la priorité de ce callback de module dans le hook HTTP Send Response Body.
Le hook HTTP Send Response Body est déclenché lorsque le serveur web va envoyer le corps de la réponse.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::HTTP_END
Description
Définit la priorité de ce callback de module dans le hook HTTP Session End.
Le hook HTTP Session End est déclenché lorsque la connexion HTTP est terminée.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::MAIN_INITED
Description
Définit la priorité de ce callback de module dans le hook Main Initialized.
Le hook Main Initialized est déclenché une seule fois au démarrage, après que la configuration et l'initialisation du serveur par le processus principal (contrôleur) sont terminées et avant le traitement des requêtes.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::MAIN_PREFORK
Description
Définit la priorité de ce callback de module dans le hook Main Prefork.
Le hook Main Prefork est déclenché par le processus principal (contrôleur) juste avant le démarrage (fork) d'un nouveau processus worker. Il est appelé pour chaque worker et peut se produire au démarrage du système ou si un worker a été redémarré.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::MAIN_POSTFORK
Description
Définit la priorité de ce callback de module dans le hook Main Postfork.
Le hook Main Postfork est déclenché par le processus principal (contrôleur) juste après le démarrage (fork) d'un nouveau processus worker. Il est appelé pour chaque worker et peut se produire au démarrage du système ou si un worker a été redémarré.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::WORKER_POSTFORK
Description
Définit la priorité de ce callback de module dans le hook Worker Postfork.
Le hook Worker Postfork est déclenché par un processus worker après sa création par le processus principal (contrôleur). Notez qu'un hook Main Postfork correspondant peut être appelé par le processus principal avant ou après ce callback.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::WORKER_ATEXIT
Description
Définit la priorité de ce callback de module dans le hook Worker At Exit.
Le hook Worker At Exit est déclenché par un processus worker juste avant sa sortie. C’est le dernier point de hook appelé par un worker.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Priorité Hook::MAIN_ATEXIT
Description
Définit la priorité de ce callback de module dans le hook Main At Exit.
Le hook Main At Exit est déclenché par le processus principal (contrôleur) juste avant sa sortie. C’est le dernier point de hook appelé par le processus principal.
Ce réglage ne prend effet que si le module possède un point de hook ici. S'il n'est pas défini, la priorité correspond à la valeur par défaut définie dans le module.
Syntaxe
Valeur entière de -6000 à 6000. Une valeur plus basse signifie une priorité plus élevée.
Modules de listener
Description
Les donnees de configuration des modules du listener sont, par defaut, heritees de la configuration des modules du serveur. Les modules du listener sont limites aux hooks TCP/IP de couche 4.
Activer le module
Description
Active les hooks du module au niveau listener. Ce réglage ne prend effet que si le module possède des hooks de niveau TCP/IP (L4_BEGSESSION, L4_ENDSESSION, L4_RECVING, L4_SENDING).
Valeur par défaut: hériter du réglage de niveau serveur
Syntaxe
Sélectionner avec les boutons radio
Modules d'hôte virtuel
Description
Les donnees de configuration des modules de l'hote virtuel sont, par defaut, heritees de la configuration des modules du serveur. Les modules de l'hote virtuel sont limites aux hooks de niveau HTTP.
Activer le module
Description
Active les hooks du module au niveau hôte virtuel. Ce réglage ne prend effet que si le module possède des hooks de niveau HTTP.
Valeur par défaut: hériter du réglage de niveau serveur
Syntaxe
Sélectionner avec les boutons radio
Filtres URL de module
Description
C'est un emplacement centralise permettant de personnaliser les parametres des modules pour les contextes d'hote virtuel. Les parametres d'une URI de contexte remplacent les parametres de niveau hote virtuel ou serveur.
URI
Description
Indique l’URI de ce contexte.
Syntaxe
L’URI peut etre une URI simple (commencant par "/") ou une URI d’expression reguliere compatible Perl (commencant par "exp:"). Si une URI simple se termine par "/", ce contexte inclura toutes les sous-URI sous cette URI. Si le contexte est mappe vers un repertoire du systeme de fichiers, un "/" final doit etre ajoute.