Manuel utilisateur
Version 1.9 — Rev. 3

# Configuration des modules

La prise en charge des modules est disponible dans OpenLiteSpeed 1.3 et LSWS Enterprise 5.0 ou version superieure. Tous les modules requis doivent etre enregistres sous l'onglet Server Modules Configuration. Les fichiers de module doivent se trouver dans le dossier server root/modules pour pouvoir etre enregistres. Au demarrage, le serveur charge tous les modules enregistres. Le serveur doit etre redemarre apres l'enregistrement de nouveaux 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.

### 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.

#### Voir aussi

Emplacement