Manuel utilisateur
Version 1.9 — Rev. 3

# Hôte virtuel - Général

### Racine des documents

#### Description

Indique la racine des documents de cet hôte virtuel. $VH_ROOT/html est recommandé. Dans les contextes, ce répertoire est référencé comme $DOC_ROOT.

#### Syntaxe

Un chemin pouvant être absolu, relatif à $SERVER_ROOT ou relatif à $VH_ROOT.

### E-mail de l'administrateur

#### Description

Indique les adresses e-mail des administrateurs de cet hôte virtuel.

#### Syntaxe

Liste d'adresses e-mail séparées par des virgules

### Activer la compression

#### Description

Indique s’il faut activer la compression GZIP pour cet hôte virtuel. Ce réglage ne prend effet que lorsque Activer la compression est défini sur Yes au niveau serveur.

#### Syntaxe

Sélectionner avec les boutons radio

#### Voir aussi

Activer la compression

### Activer la compression Brotli

#### Description

Indique s’il faut activer la compression Brotli pour cet hôte virtuel. Ce réglage ne prend effet que lorsque Niveau de compression Brotli (fichier statique) est défini sur une valeur non nulle au niveau serveur.

#### Syntaxe

Sélectionner avec les boutons radio

#### Voir aussi

Niveau de compression Brotli (fichier statique)

### Activer la recherche GeoLocation

#### Description

Indique s’il faut activer/desactiver la recherche IP Geolocation. Peut etre defini aux niveaux serveur, hote virtuel ou contexte. IP Geolocation est desactivee par defaut lorsque la valeur "Not Set" est utilisee.

#### Syntaxe

Sélectionner avec les boutons radio

#### Voir aussi

Utiliser l’IP client dans l’en-tete, Chemin du fichier DB,

### cgroups

#### Description

Fonction du noyau Linux qui limite, comptabilise et isole l’utilisation des ressources (CPU, mémoire, I/O disque, réseau, etc.) d’un ensemble de processus. Vous devez utiliser cgroups v2, ce qui est déterminé par l’existence du fichier /sys/fs/cgroup/cgroup.controllers.
Définir ceci sur Disabled au niveau serveur désactivera ce réglage pour tout le serveur. Dans tous les autres cas, le réglage de niveau serveur peut être remplacé au niveau virtual host.
Valeurs par défaut:
Niveau serveur: Off
Niveau VH: Hériter du réglage de niveau serveur

#### Syntaxe

Sélectionner dans la liste déroulante

### Utiliser le journal du serveur

#### Description

Spécifie si les messages de journal de cet hôte virtuel doivent être placés dans le fichier journal du serveur au lieu de créer son propre fichier journal.

#### Syntaxe

Sélectionner avec les boutons radio

### Nom du fichier

#### Description

Spécifie le chemin du fichier journal.

#### Syntaxe

Nom de fichier pouvant être un chemin absolu ou un chemin relatif à $SERVER_ROOT, $VH_ROOT.

#### Conseils

Performance Placez le fichier journal sur un disque séparé.

### Niveau de journalisation

#### Description

Spécifie le niveau de journalisation. Les niveaux disponibles (du plus élevé au plus bas) sont ERROR, WARNING, NOTICE, INFO et DEBUG. Seuls les messages dont le niveau est supérieur ou égal au paramètre actuel seront journalisés. Si vous voulez le définir sur DEBUG, vous devez également définir le niveau de journalisation du serveur sur DEBUG. Le niveau de débogage est contrôlé uniquement au niveau serveur par Niveau de débogage.

#### Syntaxe

Sélectionner dans la liste déroulante

#### Conseils

Performance Sauf si Niveau de débogage est défini sur un niveau autre que NONE, le niveau de journalisation DEBUG n'a pas d'impact sur les performances et est recommandé.

#### Voir aussi

Niveau de débogage

### Taille de rotation (octets)

#### Description

Spécifie quand le fichier journal actuel doit être renouvelé. Lorsque la taille du fichier dépasse la limite de rotation, le fichier journal actif est renommé en log_name.mm_dd_yyyy(.sequence) dans le même répertoire et un nouveau fichier journal actif est créé. La taille réelle du fichier journal rotatif peut être légèrement supérieure à cette limite. Définissez sur 0 pour désactiver la rotation des journaux.

#### Syntaxe

Nombre entier

#### Conseils

Information Ajoutez "K", "M" ou "G" au nombre pour indiquer kilo-, méga- et giga-octets.

### Jours de conservation

#### Description

Spécifie le nombre de jours pendant lesquels le fichier journal d'accès sera conservé sur le disque. Seuls les fichiers journaux rotatifs plus anciens que le nombre de jours spécifié seront supprimés. Le fichier journal actuel ne sera pas modifié, quel que soit le nombre de jours de données qu'il contient. Si vous ne voulez pas supprimer automatiquement les journaux obsolètes et très anciens, définissez cette valeur sur 0.

#### Syntaxe

Nombre entier

### Compresser l'archive

#### Description

Spécifie s'il faut compresser les fichiers journaux rotatifs afin d'économiser de l'espace disque.

#### Syntaxe

Sélectionner avec les boutons radio

#### Conseils

Information Les fichiers journaux se compressent très bien; cette option est recommandée pour réduire l'utilisation du disque par les anciens journaux.

### Contrôle du journal

#### Description

Emplacement où le journal d'accès doit être écrit. Trois options sont disponibles:

1. Écrire dans le journal d'accès du serveur
2. Créer un journal d'accès pour cet hôte virtuel
3. Désactiver la journalisation d'accès

#### Syntaxe

Sélectionner dans la liste déroulante

### Nom du fichier

#### Description

Nom du fichier journal d'accès.

#### Syntaxe

Nom de fichier pouvant être un chemin absolu ou un chemin relatif à $SERVER_ROOT, $VH_ROOT.

#### Conseils

Performance Placez le fichier journal d'accès sur un disque séparé.

### Journaliseur par tube

#### Description

Spécifie l'application externe qui recevra les données du journal d'accès envoyées par LiteSpeed via un tube sur son flux STDIN (le descripteur de fichier est 0). Lorsque ce champ est spécifié, le journal d'accès est envoyé uniquement à l'application de journalisation et non au fichier journal d'accès spécifié dans l'entrée précédente.
L'application de journalisation doit d'abord être définie dans la section Applications externes. La journalisation d'accès au niveau serveur ne peut utiliser qu'une application de journalisation externe définie au niveau serveur. La journalisation d'accès au niveau hôte virtuel ne peut utiliser qu'une application de journalisation définie au niveau hôte virtuel.
Le processus de journalisation est lancé de la même manière que les autres processus externes (CGI/FastCGI/LSAPI). Cela signifie qu'il s'exécutera avec l'ID utilisateur spécifié dans les paramètres Mode Set UID de l’app externe de l'hôte virtuel et ne s'exécutera jamais au nom d'un utilisateur privilégié.
LiteSpeed web server effectue un équilibrage de charge simple entre plusieurs applications de journalisation si plusieurs instances sont configurées. Le serveur LiteSpeed essaie toujours de garder le nombre d'applications de journalisation aussi bas que possible. Ce n'est que lorsqu'une application de journalisation ne traite pas les entrées du journal d'accès à temps que le serveur essaie de lancer une autre instance.
Si un journaliseur plante, le serveur web démarre une autre instance, mais les données de journal dans le tampon de flux seront perdues. Des données de journal peuvent être perdues si les journaliseurs externes ne suivent pas la vitesse et le volume du flux de journal.

#### Syntaxe

Sélectionner dans la liste déroulante

### Format du journal

#### Description

Spécifie le format du journal d'accès. Lorsque le format du journal est défini, il remplace le paramètre En-têtes de journal.

#### Syntaxe

Chaîne. La syntaxe du format de journal est compatible avec le format de journal personnalisé d'Apache 2.0.

#### Exemple

Common Log Format (CLF)
"%h %l %u %t \"%r\" %>s %b"
Common Log Format with Virtual Host
"%v %h %l %u %t \"%r\" %>s %b"
NCSA extended/combined log format
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"
Log cookie value of Foobar
"%{Foobar}C"

#### Voir aussi

En-têtes de journal

### En-têtes de journal

#### Description

Spécifie s'il faut journaliser les en-têtes de requête HTTP: Referer, UserAgent et Host.

#### Syntaxe

Sélectionner avec des cases à cocher

#### Conseils

Performance Désactivez cette option si vous n'avez pas besoin de ces en-têtes dans le journal d'accès.

#### Voir aussi

Format du journal

### Journal des octets

#### Description

Spécifie le chemin du fichier journal des octets de bande passante. Lorsque ce champ est spécifié, un journal de bande passante compatible cPanel est créé. Il journalise le total des octets transférés pour une requête, y compris les corps de requête et de réponse.

#### Syntaxe

Nom de fichier pouvant être un chemin absolu ou un chemin relatif à $SERVER_ROOT.

#### Conseils

Performance Placez le fichier journal sur un disque séparé.

### Utiliser les fichiers d'index du serveur

#### Description

Indique s’il faut utiliser les paramètres de fichiers d’index du serveur. Si la valeur est Yes, seuls les paramètres du serveur seront utilisés. Si la valeur est No, les paramètres du serveur ne seront pas utilisés. Si la valeur est Addition, des fichiers d’index supplémentaires peuvent être ajoutés à la liste de fichiers d’index du serveur pour cet hôte virtuel. Si vous voulez désactiver les fichiers d’index pour cet hôte virtuel, vous pouvez définir la valeur sur No et laisser le champ des fichiers d’index vide.

#### Syntaxe

Sélectionner dans la liste déroulante

### Fichiers index

#### Description

Indique les noms des fichiers index qui seront recherches sequentiellement lorsqu’une URL est mappee vers un repertoire. Vous pouvez le personnaliser aux niveaux serveur, hote virtuel et contexte.

#### Syntaxe

Liste de noms de fichiers index separes par des virgules.

#### Conseils

Performance Ne definissez que les fichiers index dont vous avez besoin.

### Index automatique

#### Description

Indique s’il faut générer à la volée un index de répertoire lorsque les fichiers d’index listés dans Fichiers index ne sont pas disponibles dans un répertoire. Cette option est personnalisable au niveau hôte virtuel et contexte, et elle est héritée le long de l’arborescence de répertoires jusqu’à être explicitement remplacée. Vous pouvez personnaliser la page d’index générée. Consultez les How-tos du wiki en ligne.

#### Syntaxe

Sélectionner avec les boutons radio

#### Conseils

Security Il est recommandé de désactiver Index automatique partout où c’est possible afin d’éviter de révéler des données confidentielles.

#### Voir aussi

Fichiers index, URI d'index automatique

### URI d'index automatique

#### Description

Indique l’URI qui sera utilisée pour générer la page d’index lorsque les fichiers d’index listés dans Fichiers index ne sont pas disponibles dans un répertoire. LiteSpeed web server utilise un script externe pour générer la page d’index, ce qui offre une flexibilité de personnalisation maximale. Le script par défaut produit une page d’index ayant la même apparence que celle d’Apache. Pour personnaliser la page d’index générée, consultez les How-tos du wiki en ligne. Le répertoire à indexer est transmis au script via une variable d’environnement "LS_AI_PATH".

#### Syntaxe

URI

#### Voir aussi

Fichiers index, Index automatique

### Pages d'erreur personnalisees

#### Description

Chaque fois que le serveur rencontre un probleme lors du traitement d'une requete, il renvoie un code d'erreur et une page html comme message d'erreur au client web. Les codes d'erreur sont definis dans le protocole HTTP (voir RFC 2616). Le serveur web LiteSpeed dispose d'une page d'erreur par defaut integree pour chaque code d'erreur, mais une page personnalisee peut aussi etre configuree pour chaque code d'erreur. Ces pages d'erreur peuvent etre personnalisees davantage pour etre uniques a chaque virtual host.

### Code d’erreur

#### Description

Indique le code d’état HTTP de la page d’erreur. Seul le code d’état HTTP sélectionné aura cette page d’erreur personnalisée.

#### Syntaxe

Sélectionner dans la liste déroulante

### URL

#### Description

Indique l’URL de la page d’erreur personnalisée. Le serveur transférera la requête vers cette URL lorsque le code d’état HTTP correspondant sera retourné. Si cette URL fait référence à une ressource inexistante, la page d’erreur intégrée sera utilisée. L’URL peut être un fichier statique, une page générée dynamiquement ou une page sur un autre site web (une URL commençant par "http(s)://"). Lorsqu’elle fait référence à une page sur un autre site web, le client reçoit un code d’état de redirection au lieu du code d’état d’origine.

#### Syntaxe

URL

### Activer Expires

#### Description

Indique s’il faut generer un en-tete Expires pour les fichiers statiques. Si active, un en-tete Expires sera genere selon Expires par defaut et Expires par type.
Cela peut etre defini aux niveaux serveur, hote virtuel et contexte. Les parametres de niveau inferieur remplaceront ceux de niveau superieur, c’est-a-dire que les parametres de contexte remplaceront ceux de l’hote virtuel et les parametres de l’hote virtuel remplaceront ceux du serveur.

#### Syntaxe

Sélectionner avec les boutons radio

### Expires par defaut

#### Description

Indique les parametres par defaut pour la generation de l’en-tete Expires. Ce parametre prend effet lorsque Activer Expires est defini sur "Yes". Il peut etre remplace par Expires par type. Ne definissez pas ce defaut au niveau serveur ou hote virtuel sauf si necessaire, car il generera des en-tetes Expires pour toutes les pages. La plupart du temps, cela doit etre defini au niveau contexte pour certains repertoires qui ne changent pas souvent. S’il n’y a pas de parametre par defaut, aucun en-tete Expires ne sera genere pour les types non indiques dans Expires par type.

#### Syntaxe

A|Mseconds
Le fichier expirera apres le temps de base (A|M) plus les secondes indiquees. Le temps de base "A" definit la valeur sur le temps d’acces du client et "M" sur le temps de derniere modification du fichier.

### Expires par type

#### Description

Indique les parametres d’en-tete Expires pour des types MIME individuels.

#### Syntaxe

Liste separee par des virgules de "MIME-type=A|Mseconds". Le fichier expirera apres le temps de base (A|M) plus les secondes indiquees.
Le temps de base "A" definit la valeur sur le temps d’acces du client et "M" sur le temps de derniere modification du fichier. MIME-type accepte le caractere generique "*", comme image/*.

### Televersement de fichiers

#### Description

Fournit des fonctions de securite supplementaires lors du televersement de fichiers en utilisant un Request Body Parser pour analyser les fichiers vers un repertoire local du serveur, ou des modules tiers peuvent les analyser facilement a la recherche d'une intention malveillante. Request Body Parser est utilise lorsque Passer les donnees d’upload par chemin de fichier est active ou lorsqu'un module appelle set_parse_req_body de LSIAPI au niveau LSI_HKPT_HTTP_BEGIN. Des exemples d'API sont fournis dans le paquet source.

#### Voir aussi

Priorité Hook::HTTP_BEGIN

### Chemin des fichiers temporaires

#### Description

Répertoire temporaire où les fichiers envoyés au serveur seront stockés pendant que l’analyseur du corps de requête fonctionne. La valeur par défaut est /tmp/lshttpd/.

#### Syntaxe

Chemin absolu ou chemin commençant par $SERVER_ROOT (pour les niveaux serveur et VHost) ou $VH_ROOT (pour les niveaux VHost).

### Permission de fichier temporaire

#### Description

Détermine les permissions de fichier utilisées pour les fichiers stockés dans le répertoire temporaire. Le réglage au niveau serveur est global et peut être remplacé au niveau VHost.

#### Syntaxe

Nombre octal à 3 chiffres. La valeur par défaut est 666.

### Passer les donnees d’upload par chemin de fichier

#### Description

Indique s’il faut ou non transmettre les donnees du fichier upload par chemin. Si active, le chemin du fichier avec d’autres informations est envoye au backend handler au lieu du fichier lui-meme lors de l’upload. Cela economise des ressources CPU et du temps de transfert, mais demande des mises a jour cote backend pour l’implementation. Si desactive, le contenu du fichier sera transfere au backend handler; le corps de requete reste parse en fichiers.

#### Syntaxe

Sélectionner avec les boutons radio

#### Conseils

Performance Activez ceci pour accelerer le traitement des uploads de fichiers si la compatibilite ascendante n’est pas un probleme.

### Suffixes

#### Description

Spécifie les suffixes des fichiers de script qui seront gérés par ce gestionnaire de scripts. Les suffixes doivent être uniques.

#### Syntaxe

Liste séparée par des virgules; le caractère point "." est interdit.

#### Conseils

Information Le serveur ajoute automatiquement un type MIME spécial ("application/x-httpd-[suffix]") pour le premier suffixe de la liste. Par exemple, le type MIME "application/x-httpd-php53" sera ajouté pour le suffixe "php53". Les suffixes suivants doivent être configurés dans les paramètres Parametres MIME.
Même si ce champ liste des suffixes, les gestionnaires de scripts utilisent les types MIME, et non les suffixes, pour décider quels scripts gérer.
Performance Security Spécifiez uniquement les suffixes dont vous avez réellement besoin.

### Type de gestionnaire

#### Description

Spécifie le type d'application externe qui traite ces fichiers de script. Les types disponibles sont: LSAPI app, Web Server (Proxy), Fast CGI, SCGI, CGI, Load balancer, Servlet Engine, uWSGI ou Module Handler. Sauf pour les types de gestionnaire CGI et Module Handler, Nom du gestionnaire doit également être défini sur une application externe précédemment définie dans la section Applications externes.

#### Syntaxe

Sélectionner dans la liste déroulante

### Nom du gestionnaire

#### Description

Spécifie le nom de l'application externe qui traite les fichiers de script lorsque le type de gestionnaire est LSAPI app, Web Server (Proxy), Fast CGI, SCGI, Load balancer, Servlet Engine ou uWSGI.

#### Syntaxe

Sélectionner dans la liste déroulante

### Remplacement de php.ini

#### Description

Utilisé pour remplacer les paramètres php.ini dans le contexte actuel (niveau hôte virtuel ou niveau contexte).
Les directives prises en charge sont:
php_value
php_flag
php_admin_value
php_admin_flag
Toutes les autres lignes/directives seront ignorées.

#### Syntaxe

La syntaxe de remplacement est similaire à celle d’Apache: une liste de directives et de leurs valeurs séparées par des retours à la ligne, chaque directive étant précédée de php_value, php_flag, php_admin_value ou php_admin_flag selon le cas.

#### Exemple

php_value include_path ".:/usr/local/lib/php"
php_admin_flag engine on
php_admin_value open_basedir "/home"