La documentation de cette directive + n'a pas encore t traduite. Veuillez vous reporter la version + en langue anglaise.

Description:	Fonctionnalités de base du serveur HTTP Apache toujours disponibles
Statut:	Core

Description:	Serveur mandataire/passerelle multi-protocole
Statut:	Extension
Identificateur de Module:	proxy_module

Description:	Module fournissant le support de FastCGI à `mod_proxy`
Statut:	Extension

Description:	Allow variables sent to FastCGI servers to be fixed up
Syntaxe:	`ProxyFCGISetEnvIf conditional-expression + environment-variable-name + value-expression`
Contexte:	configuration du serveur, serveur virtuel, répertoire, .htaccess
Statut:	Extension
Module:	mod_proxy_fcgi
Compatibilité:	Available in version 2.5 and later

Directive SSLOCSPNoverify

La documentation de cette directive + n'a pas encore t traduite. Veuillez vous reporter la version + en langue anglaise.

Description:	Chiffrement de haut niveau basé sur les protocoles Secure Sockets Layer (SSL) et Transport Layer Security (TLS)
Statut:	Extension

Description:	skip the OCSP responder certificates verification
Syntaxe:	`SSLOCSPNoverify On/Off`
Défaut:	`SSLOCSPNoverify Off`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Extension
Module:	mod_ssl
Compatibilité:	Available in httpd 2.5 and later, if using OpenSSL 0.9.7 or later

Directive SSLOCSPOverrideResponder

Description:

Force l'utilisation de l'URI du répondeur par défaut pour @@ -1290,6 +1307,18 @@ utilis

Directive SSLOCSPResponderCertificateFile

+ + + + + + + +

Description:	Set of trusted PEM encoded OCSP responder certificates
Syntaxe:	`SSLOCSPResponderCertificateFile file`
Contexte:	configuration du serveur, serveur virtuel
Statut:	Extension
Module:	mod_ssl
Compatibilité:	Available in httpd 2.5 and later, if using OpenSSL 0.9.7 or later

La documentation de cette directive + n'a pas encore t traduite. Veuillez vous reporter la version + en langue anglaise.

Directive SSLOCSPResponderTimeout

diff --git a/docs/manual/mod/mpm_common.html b/docs/manual/mod/mpm_common.html index 059c2662c78..234685936ad 100644 --- a/docs/manual/mod/mpm_common.html +++ b/docs/manual/mod/mpm_common.html @@ -8,6 +8,10 @@ URI: mpm_common.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mpm_common.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mpm_common.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mpm_common.html.fr b/docs/manual/mod/mpm_common.html.fr new file mode 100644 index 00000000000..3ea706d91d9 --- /dev/null +++ b/docs/manual/mod/mpm_common.html.fr @@ -0,0 +1,936 @@ + + + + + +mpm_common - Serveur Apache HTTP Version 2.5 + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.5 > Modules

Apache MPM : Directives Communes

Langues Disponibles: de | + en | + fr | + ja | + tr

Description:	Délai d'attente pour les requêtes OCSP

Description:	Une série de directives implémentées par plusieurs +modules multi-processus (MPM)
Statut:	MPM

Directives

+ +

Traitement des bugs

Voir aussi

Commentaires

+ +

Directive CoreDumpDirectory

+ + + + + + + +

Description:	Le répertoire dans lequel le serveur HTTP Apache va tenter de se +positionner avant d'effectuer un vidage mémoire
Syntaxe:	`CoreDumpDirectory répertoire`
Défaut:	`Voir ci-dessous pour le répertoire par défaut`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`

Cette directive permet de définir le répertoire dans lequel + Apache httpd va tenter de se positionner avant d'effectuer un vidage + mémoire sur disque. + Si votre système d'exploitation est configuré pour créer des + fichiers de vidage mémoire dans le répertoire de travail des + processus qui se sont crashés, + CoreDumpDirectory est nécessaire pour + définir un répertoire de travail autre que le répertoire par défaut + ServerRoot, ce répertoire de + travail ne devant pas être accessible en écriture par l'utilisateur sous + lequel le serveur s'exécute.

+ +

Si vous avez besoin d'un vidage mémoire pour le débogage, vous + pouvez utiliser cette directive pour le placer à un endroit + différent. Cette directive n'a aucun effet si votre système + d'exploitation n'est pas configuré pour créer des + fichiers de vidage mémoire dans le répertoire de travail des + processus qui se sont crashés.

+ +

Vidages mémoire sous Linux

Si Apache httpd est démarré sous l'utilisateur root puis bascule vers + un autre utilisateur, le noyau Linux désactive les + vidages mémoire, même si le répertoire est accessible en écriture au + processus. Apache httpd (versions 2.0.46 et supérieures) réactive les + vidages mémoire sous Linux 2.4 et au delà, mais seulement si vous + définissez une directive CoreDumpDirectory.

+ +

Vidages mémoire sous BSD

Pour activer le vidage mémoire des exécutables suid sur les + systèmes de style BSD (comme FreeBSD), définissez + kern.sugid_coredump à 1. +

+ +

Signaux spécifiques

CoreDumpDirectory n'est traité qu'à la + reception d'un certain nombre de signaux , SIGFPE, SIGILL, SIGABORT, + SIGSEGV, et SIGBUS.

+ Sur certains systèmes d'exploitation, SIGQUIT provoque aussi un + vidage mémoire, mais n'est pas traité par les directives + CoreDumpDirectory ou + EnableExceptionHook, si bien que la + définition du répertoire d'enregistrement du vidage mémoire est + entièrement dévolue au système d'exploitation.

+ +

Directive EnableExceptionHook

+ + + + + + + +

Description:	Active un hook ("point d'accrochage logiciel") qui exécute des +gestionnaires d'exception après un crash
Syntaxe:	`EnableExceptionHook On\|Off`
Défaut:	`EnableExceptionHook Off`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`

Pour des raisons de sécurité, cette directive n'est disponible + que si la compilation du serveur a été configurée avec l'option + --enable-exception-hook. Elle permet d'activer un hook + ("point d'accrochage logiciel") + qui autorise certains modules externes à effectuer un branchement et + accomplir telle ou telle action après le crash d'un processus + enfant.

+ +

Deux modules, mod_whatkilledus et + mod_backtrace utilisent ce hook. Veuillez vous + référer à la page EnableExceptionHook de Jeff Trawick pour plus + d'informations à leur sujet.

+ +

Directive GracefulShutdownTimeout

+ + + + + + + +

Description:	Spécifie le délai maximum après lequel le serveur va +s'arrêter dans le cas d'un arrêt "en douceur"
Syntaxe:	`GracefulShutdownTimeout seconds`
Défaut:	`GracefulShutdownTimeout 0`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`

La directive GracefulShutdownTimeout + permet de spécifier le temps, en secondes, pendant lequel le serveur + va continuer à fonctionner après avoir reçu un signal + "graceful-stop" ("Arrêt en douceur"), afin de terminer le traitement + des connexions en cours.

+ +

Définir cette valeur à zéro signifie au serveur d'attendre + jusqu'à ce que toutes les requêtes en cours aient été traitées.

+ +

Directive Listen

+ + + + + + +

Description:	Les adresses IP et ports sur lesquels le serveur écoute
Syntaxe:	`Listen [adresse IP:]numéro port +[protocole]`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`, `mpm_winnt`, `mpm_netware`, `mpmt_os2`

La directive Listen permet de signifier à + Apache httpd de ne se mettre à l'écoute que sur les adresses IP et ports spécifiés ; par + défaut, le serveur répond aux requêtes en provenance de toutes les + interfaces réseau. La directive Listen est + dorénavant requise, et si elle est absente du fichier de + configuration, le serveur refusera de démarrer. Ceci constitue un + changement par rapport aux versions précédentes d'Apache httpd.

+ +

La directive Listen signifie au serveur de + n'accepter les requêtes entrantes que vers le port ou le couple + adresse-port spécifié. Si seulement un port est spécifié, le serveur + se met à l'écoute sur ce port sur toutes les interfaces réseau. Si une adresse IP + et un port sont spécifiés, le serveur va se mettre à l'écoute sur ce port sur + l'interface réseau correspondant à l'adresse IP.

+ +

On peut utiliser autant de directives + Listen que nécessaire pour spécifier + plusieurs adresses et/ou ports à écouter. Le serveur répondra aux + requêtes vers tous les adresses et ports spécifiés.

+ +

Par exemple, pour que le serveur accepte les connexions sur les + ports 80 et 8000, utilisez :

+ +

Listen 80
+Listen 8000

+ + +

Pour que le serveur accepte les connexions sur deux interfaces et + ports particuliers, spécifiez :

+ +

Listen 192.170.2.1:80
+Listen 192.170.2.5:8000

+ + +

Les adressee IPv6 doivent être entourées de crochets, comme dans + l'exemple suivant :

+ +

Listen [2001:db8::a00:20ff:fea7:ccea]:80

+ + +

L'argument optionnel protocole n'est pas nécessaire + dans la plupart des configurations. S'il est absent, + https est la valeur par défaut pour le port 443 et + http l'est pour tous les autres ports. L'argument + protocole sert à déterminer quel module doit traiter une requête, et + à appliquer des optimisations spécifiques à certains protocoles à + l'aide de la directive AcceptFilter.

+ +

La spécification d'un protocole n'est nécessaire que si vous + utilisez des ports non standards. Par exemple, pour configurer un + site en https sur le port 8443 :

+ +

Listen 192.170.2.1:8443 https

+ + +

Condition d'erreur

+ Plusieurs directives Listen pour les mêmes + adresse IP/port vont provoquer l'envoi d'un message d'erreur + Address already in use. +

+ + +

Voir aussi

Directive ListenBackLog

+ + + + + + + +

Description:	Longueur maximale de la liste d'attente des +connexions
Syntaxe:	`ListenBacklog backlog`
Défaut:	`ListenBacklog 511`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`, `mpm_winnt`, `mpm_netware`, `mpmt_os2`

La longueur maximale de la liste d'attente des connexions. En + général, aucune modification n'est nécessaire, ni même souhaitable ; + cependant, sur certains systèmes, il peut être nécessaire + d'en augmenter la valeur en cas d'attaque TCP SYN flood (envoi en + masse de requêtes SYN pour saturer le serveur). Voir le paramètre + backlog de l'appel système listen(2).

+ +

En fait, l'argument backlog sera souvent limité à une valeur + inférieure en fonction du système d'exploitation. Notez aussi que de + nombreux systèmes d'exploitation ne tiennent pas vraiment compte de + la valeur spécifiée pour l'argument backlog, mais s'en inspirent + seulement (et choisissent en général une valeur supérieure).

+ +

Directive ListenCoresBucketsRatio

+ + + + + + + + +

Description:	Rapport entre le nombre de coeurs de processeur activés et +le nombre de segments d'écoute
Syntaxe:	`ListenCoresBucketsRatio ratio`
Défaut:	`ListenCoresBucketsRatio 0 (disabled)`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`
Compatibilité:	Disponible à partir de la version 2.4.13 du serveur HTTP +Apache, avec un noyau supportant l'option de socket +`SO_REUSEPORT`, et distribuant uniformément les nouvelles +connexions aux sockets d'écoute des processus (ou threads) qui +l'utilisent (par exemple Linux versions 3.9 et ultérieures, mais pas +l'implémentation courante de `SO_REUSEPORT` par les +plateformes de type BSD.

Vous pouvez utiliser la directive + ListenCoresBucketsRatio pour spécifier un + ratio entre le nombre de coeurs de CPU activés et le + nombre de segments d'écoute (listeners' buckets) souhaités ; le + serveur HTTP Apache va alors créernum_cpu_cores / ratio + segments d'écoute, chacun contenant son propre socket d'écoute + Listen sur le ou les mêmes ports ; chaque + processus enfant sera associé à un seul segment d'écoute (avec une + distribution de type round-robin des segments à la création des + processus enfants).

+ +

Définition du terme coeur de CPU activé ("online")

Sous Linux et BSD, un coeur de CPU peut être activé ou désactivé si Hotplug + a été configuré ; la directive + ListenCoresBucketsRatio doit donc tenir compte de ce + paramètre pour calculer le nombre de segments d'écoute à créer.

+ +

La directive ListenCoresBucketsRatio peut + améliorer le support de la montée en charge lorsque l'arrivée de + nouvelles connexions est/devient un goulot d'étranglement. Le test + de cette fonctionnalité avec des machines possédant un nombre de + coeurs de CPU important a permit de constater une amélioration des + performances significative et des temps de réponse plus courts.

+ +

Pour que cette fonctionnalité soit activée, le nombre de coeurs + de CPU doit être égal au moins au double du ratio + spécifié. Si vous spécifiez la valeur recommandée pour + ratio, à savoir 8, le nombre minimum de + coeurs de processeurs disponibles sera alors de 16. La valeur + optimale de ratio permettant d'obtenir des performances maximales + doit être calculée pour chaque système cible, en testant plusieurs valeurs + et en observant les résultats.

+ +

Cette directive influence le calcul des valeurs limites inférieures de + MinSpareThreads et MaxSpareThreads. En effet, pour accepter les + connexions de manière optimale, le nombre de processus enfants doit être un + multiple du nombre de segments d'écoute.

+ +

Directive MaxConnectionsPerChild

+ + + + + + + + +

Description:	Limite le nombre de connexions qu'un processus enfant va +traiter au cours de son fonctionnement
Syntaxe:	`MaxConnectionsPerChild number`
Défaut:	`MaxConnectionsPerChild 0`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`, `mpm_winnt`, `mpm_netware`, `mpmt_os2`
Compatibilité:	Disponible depuis la version 2.3.9 du serveur HTTP +Apache. L'ancien nom `MaxRequestsPerChild` est encore +supporté.

La directive MaxConnectionsPerChild permet de + définir le nombre maximum de connexions qu'un processus enfant va + pouvoir traiter au cours de son fonctionnement. Lorsqu'il a traité + MaxConnectionsPerChild connexions, le processus + enfant est arrêté. Si MaxConnectionsPerChild est + définie à 0, il n'y a plus aucune limite sur le nombre + de connexions que le processus pourra traiter.

+ +

Définir MaxConnectionsPerChild à une valeur + non nulle limite la quantité de mémoire qu'un processus peut + consommer à cause de fuites (accidentelles) de mémoire.

+ + +

Directive MaxMemFree

+ + + + + + + +

Description:	Quantité maximale de mémoire que l'allocateur principal est +autorisé à conserver sans appeler `free()`
Syntaxe:	`MaxMemFree KOctets`
Défaut:	`MaxMemFree 2048`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`, `mpm_winnt`, `mpm_netware`

La directive MaxMemFree permet de définir + le nombre maximum de KOctets libres que tout allocateur est + autorisé à conserver sans appeler free(). Dans les MPMs + threadés, chaque thread possède son propre allocateur. Si elle est + définie à 0, la quantité de mémoire libre que peut conserver un + allocateur est illimitée.

+ +

Directive MaxRequestWorkers

+ + + + + + + +

Description:	Nombre maximum de connexions pouvant être traitées +simultanément
Syntaxe:	`MaxRequestWorkers nombre`
Défaut:	`Voir ci-dessous pour plus de détails`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`

La directive MaxRequestWorkers permet de fixer le + nombre maximum de requêtes pouvant être traitées simultanément. + Si la limite MaxRequestWorkers est atteinte, toute + tentative de connexion sera normalement mise dans une file + d'attente, et ceci jusqu'à un certain nombre dépendant de la + directive ListenBacklog. + Lorsqu'un processus enfant se libèrera suite à la fin du traitement + d'une requête, la connexion en attente pourra être traitée à son + tour.

+ +

Pour les serveurs non threadés (c'est à dire utilisant + prefork), la directive + MaxRequestWorkers définit alors le nombre maximum de + processus enfants qui pourront être lancés simultanément pour + traiter les requêtes. La valeur par défaut est 256 ; si + vous l'augmentez, vous devez aussi augmenter la valeur de la + directive ServerLimit.

+ +

Pour les serveur threadés et hybrides (utilisant par + exemple event ou worker), + MaxRequestWorkers définit alors le nombre total de + threads qui seront disponibles pour servir les clients. Dans le + cas des MPMs hybrides, la valeur par défaut est 16 + (directive ServerLimit) multiplié par la valeur + 25 (directive ThreadsPerChild). Par conséquent, pour affecter à la + directive MaxRequestWorkers une valeur qui requiert + plus de 16 processus, vous devez aussi augmenter la valeur de la + directive ServerLimit.

+ +

Le nom de la directive MaxRequestWorkers + était MaxClients avant la version 2.3.13. Cet + ancien nom est encore supporté.

+ +

Directive MaxSpareThreads

+ + + + + + + +

Description:	Nombre maximum de threads inactifs
Syntaxe:	`MaxSpareThreads nombre`
Défaut:	`Voir ci-dessous pour plus de détails`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `mpm_netware`, `mpmt_os2`

C'est le nombre maximum de threads inactifs. Les MPMs utilisent + cette directive de différentes manières.

+ +

Pour worker et event, la définition par défaut est + MaxSpareThreads 250. Ce MPM gère les threads inactifs + au niveau du serveur. Si le serveur possède trop de threads + inactifs, des processus enfants seront arrêtés jusqu'à ce que le + nombre de threads inactifs repasse en dessous de cette limite. Des + processus/threads supplémentaires sont susceptibles d'être créés si + ListenCoresBucketsRatio est + activée.

+ +

Pour mpm_netware, la définition par défaut est + MaxSpareThreads 100. Comme ce MPM n'exécute qu'un seul + processus, le nombre de processus inactifs est surveillé au + niveau du serveur.

+ +

mpmt_os2 fonctionne de manière similaire à + mpm_netware. Pour mpmt_os2, la + valeur par défaut est 10.

+ +

Contraintes

La gamme de valeurs pour MaxSpareThreads + est limitée. Apache httpd corrigera automatiquement cette valeur selon + les règles suivantes :

Avec mpm_netware, MaxSpareThreads doit être supérieure à MinSpareThreads.
Avec + worker et event, MaxSpareThreads + doit être supérieure ou égale à la somme de MinSpareThreads et ThreadsPerChild.

+ +

Voir aussi

MinSpareThreads
StartServers
MaxSpareServers

Directive MinSpareThreads

+ + + + + + + +

Description:	Nombre minimum de threads inactifs qui seront disponibles +pour pouvoir traiter les pics de requêtes
Syntaxe:	`MinSpareThreads nombre`
Défaut:	`Voir ci-dessous pour plus de détails`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `mpm_netware`, `mpmt_os2`

C'est le nombre minimum de threads inactifs pour être en mesure + de traiter les pics de requêtes. Les MPMs utilisent cette directive + de différentes manières.

+ +

Avec worker et event, la définition par défaut est + MinSpareThreads 75, et le nombre de threads inactifs + est surveillé au niveau du serveur. Si le serveur ne possède pas + assez de threads inactifs, des processus enfants sont créés jusqu'à + ce que le nombre de threads inactifs repasse au dessus de + nombre. Des processus/threads supplémentaires peuvent + être créés si ListenCoresBucketsRatio est activée.

+ +

Avec mpm_netware, la définition par défaut est + MinSpareThreads 10 et, comme ce MPM n'exécute qu'un + seul processus, le nombre de threads est surveillé au niveau du + serveur.

+ +

mpmt_os2 fonctionne de manière similaire à + mpm_netware. Pour mpmt_os2, la + valeur par défaut est 5.

+ + +

Voir aussi

MaxSpareThreads
StartServers
MinSpareServers

Directive PidFile

+ + + + + + + +

Description:	Ficher dans lequel le serveur enregistre l'identificateur +de processus du démon
Syntaxe:	`PidFile nom fichier`
Défaut:	`PidFile httpd.pid`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`, `mpm_winnt`, `mpmt_os2`

La directive PidFile permet de définir le + ficher dans lequel le serveur + enregistre l'identificateur de processus du démon. Si le chemin du + fichier n'est pas absolu, il est considéré comme relatif au chemin + défini par la directive DefaultRuntimeDir.

+ +

Exemple

PidFile /var/run/apache.pid

+ +

Il est souvent utile de pouvoir envoyer un signal au + serveur afin qu'il ferme et ouvre à nouveau ses journaux + d'erreur et de transfert, et recharge son + fichier de configuration. Pour ce faire, on envoie un signal SIGHUP + (kill -1) à l'identificateur de processus enregistré dans le fichier + défini par la directive PidFile.

+ +

La directive PidFile fait l'objet des + mêmes avertissements que ceux concernant le chemin d'enregistrement + des fichiers journaux et la sécurité.

+ +

Note

Depuis la version 2 du serveur HTTP Apache, nous recommandons de n'utiliser + que le script apachectl, ou le script de + démarrage fourni avec votre système d'exploitation pour (re)démarrer ou + arrêter le serveur.

+ +

Directive ReceiveBufferSize

+ + + + + + + +

Description:	Taille du tampon TCP en entrée
Syntaxe:	`ReceiveBufferSize octets`
Défaut:	`ReceiveBufferSize 0`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`, `mpm_winnt`, `mpm_netware`, `mpmt_os2`

Le serveur va fixer la taille du tampon TCP en entrée au + nombre d'octets spécifié.

+ +

Si la directive est définie à 0, le serveur va + utiliser la valeur par défaut adoptée par le système + d'exploitation.

+ +

Directive ScoreBoardFile

+ + + + + + + +

Description:	Chemin du fichier où sont stockées les données concernant +la coordination des processus enfants
Syntaxe:	`ScoreBoardFile file-path`
Défaut:	`ScoreBoardFile apache_runtime_status`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`, `mpm_winnt`

Le serveur HTTP Apache utilise un tableau de bord pour la + communication entre le processus parent et les processus enfants. + Pour faciliter cette communication, certaines architectures + nécessitent un fichier. En l'absence de cette directive, donc si + aucun nom de fichier n'est spécifié, Apache httpd tentera tout + d'abord de créer un tableau uniquement en mémoire (en utilisant la + mémoire partagée anonyme) ; et si il n'y parvient pas, il tentera de + créer un fichier sur disque (en utilisant la mémoire partagée à base + de fichier). Si cette directive est utilisée, Apache httpd créera + systématiquement un fichier sur disque.

+ +

Si file-path n'est pas un chemin absolu, il sera relatif à la + valeur spécifiée par la directive DefaultRuntimeDir. +

+ +

Exemple

ScoreBoardFile /var/run/apache_runtime_status

+ +

Une mémoire partagée sous forme de fichier est utile pour les + applications tierces qui nécessitent un accès direct au tableau de + bord des processus.

+ +

Si vous utilisez un ScoreBoardFile, vous + pourrez constater une amélioration des performances en le plaçant + sur un disque virtuel en RAM. Assurez-vous cependant de tenir compte + des mêmes avertissements que ceux concernant le chemin du fichier + journal et la sécurité.

+ +

Voir aussi

Arrêter et redémarrer +le serveur HTTP Apache

Directive SendBufferSize

+ + + + + + + +

Description:	Taille du tampon TCP en sortie
Syntaxe:	`SendBufferSize octets`
Défaut:	`SendBufferSize 0`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`, `mpm_winnt`, `mpm_netware`, `mpmt_os2`

Définit la taille du tampon TCP en sortie avec le nombre + d'octets spécifié. Ceci s'avère souvent très utile pour augmenter les + valeurs par défaut standards du passé des systèmes d'exploitation + pour les transmissions à grande vitesse et haute densité (c'est + à dire de l'ordre de 100ms comme sur les liaisons rapides + transcontinentales).

+ +

Si la directive est définie à 0, le serveur va + utiliser la valeur par défaut adoptée par le système + d'exploitation.

+ +

L'amélioration des performances des connexions à grande vitesse + et à temps de latence élevé, peut nécessiter + une intervention au niveau de la configuration de votre système + d'exploitation.

+ +

Sous certains systèmes d'exploitation, la modification du + comportement TCP via une augmentation de la valeur de + SendBufferSize risque de ne pas être + perceptible, si la directive EnableSendfile n'est pas définie à OFF. + Cette interaction ne s'applique qu'aux fichiers statiques.

+ +

Directive ServerLimit

+ + + + + + + +

Description:	Limite supérieure de la définition du nombre de +processus
Syntaxe:	`ServerLimit nombre`
Défaut:	`Voir ci-dessous pour plus de détails`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`

Avec le MPM prefork, cette directive définit le + nombre maximum que l'on peut affecter à la directive MaxRequestWorkers, et ceci pour la + durée de vie du processus Apache httpd. Avec les + MPMs worker et event, cette directive, en combinaison avec + ThreadLimit, définit le + nombre maximum que l'on peut affecter à MaxRequestWorkers, et ceci pour la durée de + vie du processus Apache httpd. Avec le MPM event, cette + directive permet aussi de définir combien de processus anciens peuvent + continuer à s'exécuter pour terminer le traitement des connexions ouvertes. + Au cours d'un redémarrage, vous pouvez + modifier la valeur de la directive MaxRequestWorkers, alors que toute + tentative de modification de la valeur de la directive ServerLimit sera ignorée.

+ +

Cette directive doit être utilisée avec précaution. Si + ServerLimit est définie à une valeur beaucoup + plus grande que nécessaire, de la mémoire partagée supplémentaire + sera inutilement allouée. Si à la fois + ServerLimit et MaxRequestWorkers possèdent des valeurs + supérieures à ce que le système peut supporter, ce dernier peut + devenir instable ou Apache httpd peut tout simplement refuser de démarrer.

+ +

Avec les MPMs prefork et event, n'utilisez cette directive + que si vous devez définir MaxRequestWorkers à une valeur supérieure à + 256 (valeur par défaut). N'affectez pas à la directive ServerLimit une valeur supérieure à + celle que vous avez prévu d'affecter à la directive MaxRequestWorkers.

+ +

Avec worker, n'utilisez cette directive que si + la définition de vos directives MaxRequestWorkers et ThreadsPerChild nécessitent plus de + 16 processus serveurs (valeur par défaut). N'affectez pas à la + directive ServerLimit une + valeur supérieure au nombre de processus requis pour la définition + des directives MaxRequestWorkers + et ThreadsPerChild.

+ +

Avec le MPM event, augmentez la valeur de cette + directive si le nombre de processus défini par les directives MaxRequestWorkers et ThreadsPerChild augmenté du nombre de processus + en procédure d'arrêt "graceful" est supérieur à 16 (valeur par défaut).

+ +

Note

Il existe une limite de ServerLimit 20000 codée en + dur dans le serveur (200000 pour le MPM prefork). + Ceci est censé éviter les effets désastreux que pourrait provoquer + une faute de frappe. Pour dépasser cette limite, vous devez + modifier la valeur de MAX_SERVER_LIMIT dans le fichier source du + mpm et recompiler le serveur.

+ +

Voir aussi

Arrêter et redémarrer +le serveur HTTP Apache

Directive StartServers

+ + + + + + + +

Description:	Nombre de processus enfants du serveur créés au +démarrage
Syntaxe:	`StartServers nombre`
Défaut:	`Voir ci-dessous pour plus de détails`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `prefork`, `mpmt_os2`

La directive StartServers permet de + définir le nombre de processus enfants du serveur créés au + démarrage. Comme le nombre de processus est contrôlé dynamiquement + en fonction de la charge (voir MinSpareThreads, MaxSpareThreads, MinSpareServers, MaxSpareServers), il n'est en général + pas nécessaire d'ajuster ce paramètre.

+ +

La valeur par défaut diffère d'un MPM à l'autre. Pour + worker et event, la définition par défaut est + StartServers 3 ; la valeur par défaut est + 5 pour prefork et 2 + pour mpmt_os2.

+ +

Directive StartThreads

+ + + + + + + +

Description:	Nombre de threads créés au démarrage
Syntaxe:	`StartThreads nombre`
Défaut:	`Voir ci-dessous pour plus de détails`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`mpm_netware`

C'est le nombre de threads créés au démarrage du serveur. Comme + le nombre de threads est contrôlé dynamiquement + en fonction de la charge (voir MinSpareThreads, MaxSpareThreads, MinSpareServers, MaxSpareServers), il n'est en général + pas nécessaire d'ajuster ce paramètre.

+ +

Pour mpm_netware, la définition par défaut est + StartThreads 50 et, comme il n'y a qu'un processus, il + s'agit du nombre total de threads créés au démarrage pour servir les + requêtes.

+ +

Directive ThreadLimit

+ + + + + + + +

Description:	Le nombre de threads maximum que l'on peut définir par +processus enfant
Syntaxe:	`ThreadLimit nombre`
Défaut:	`Voir ci-dessous pour plus de détails`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `mpm_winnt`

Cette directive permet de définir le nombre maximum que l'on peut + affecter à la directive ThreadsPerChild pour la durée de vie + du processus Apache httpd. La directive ThreadsPerChild peut être modifiée + au cours d'un redémarrage jusqu'à la valeur de la directive ThreadLimit, mais toute tentative + de modification de la directive ThreadLimit au cours d'un + redémarrage sera ignorée.

+ +

L'utilisation de cette directive doit faire l'objet de + précautions particulières. Si ThreadLimit est + définie à une valeur très supérieure à la directive ThreadsPerChild, de la mémoire + partagée supplémentaire sera inutilement allouée. Si les directives + ThreadLimit et ThreadsPerChild sont définies à des + valeurs supérieures à ce que le système peut supporter, ce dernier + peut devenir instable, ou Apache httpd peut tout simplement refuser de + démarrer. Ne définissez pas cette directive à une valeur supérieure + à la valeur maximale que vous pensez affecter à la directive ThreadsPerChild pour le processus + Apache httpd en cours d'exécution.

+ +

La valeur par défaut de la directive + ThreadLimit est 1920 avec + mpm_winnt, et 64 avec les autres + MPMs.

+ +

Note

Il existe une limite de ThreadLimit 20000 (ou + ThreadLimit 100000 avec event, + ThreadLimit 15000 avec mpm_winnt) + codée en dur dans le serveur. Ceci est censé éviter les effets + désastreux que pourrait provoquer une faute de frappe. Pour + dépasser cette limite, vous devez modifier la valeur de + MAX_THREAD_LIMIT dans le fichier source du mpm et recompiler le + serveur.

+ +

Directive ThreadsPerChild

+ + + + + + + +

Description:	Nombre de threads créés par chaque processus +enfant
Syntaxe:	`ThreadsPerChild nombre`
Défaut:	`Voir ci-dessous pour plus de détails`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `mpm_winnt`

Cette directive permet de définir le nombre de threads que va + créer chaque processus enfant. Un processus enfant crée ces threads + au démarrage et n'en crée plus d'autres par la suite. Si l'on + utilise un MPM comme mpm_winnt qui ne lance qu'un + processus enfant, ce nombre doit être suffisamment grand pour + supporter la charge du serveur. Avec un MPM comme + worker qui lance plusieurs processus enfants, c'est + le nombre total de threads qui doit être suffisamment grand + pour supporter la charge du serveur.

+ +

La valeur par défaut de la directive + ThreadsPerChild est 64 avec + mpm_winnt, et 25 avec les autres + MPMs.

+ +

Directive ThreadStackSize

+ + + + + + + +

Description:	La taille en octets de la pile qu'utilisent les threads qui +traitent les connexions clients
Syntaxe:	`ThreadStackSize taille`
Défaut:	`65536 sous NetWare; varie en fonction des autres systèmes +d'exploitation`
Contexte:	configuration du serveur
Statut:	MPM
Module:	`event`, `worker`, `mpm_winnt`, `mpm_netware`, `mpmt_os2`

La directive ThreadStackSize permet de + définir la taille de la pile (pour les données propres) qu'utilisent + les threads qui traitent les connexions clients en faisant appel à + des modules. Dans la plupart des cas, la valeur par défaut de la + taille de la pile du système d'exploitation convient, mais il existe + certaines situations où il peut s'avérer nécessaire de l'ajuster + :

+ +

Sur les plates-formes qui possèdent une valeur par défaut de + taille de la pile relativement petite (par exemple HP-UX), Apache + httpd peut se crasher si l'on utilise certains modules tiers qui + possèdent un quantité de données propres stockées relativement + importante. Il se peut que ces mêmes modules fonctionnent + correctement sur d'autres plate-formes où la valeur par défaut de + la taille de la pile est supérieure. Ce type de crash peut être + evité en définissant ThreadStackSize à une + valeur supérieure à la valeur par défaut du système + d'exploitation. Ce type d'ajustement n'est nécessaire que si le + fournisseur du module tiers en fait mention, ou si le diagnostic + d'un crash d'Apache httpd indique que la taille de la pile était trop + petite.
Sur les plates-formes où la taille par défaut de la pile des + threads est sensiblement supérieure à la taille nécessaire pour la + configuration du serveur web, il est possible de disposer d'un + plus grand nombre de threads par processus enfant si la directive + ThreadStackSize est définie à une valeur + inférieure à la valeur par défaut du système d'exploitation. + Cependant, ce + type d'ajustement ne doit être effectué que dans un environnement + de test permettant de qualifier le serveur web au maximum de ses + possibilités, car il peut arriver, dans de rares cas, que des + requêtes nécessitent une taille de pile supérieure pour pouvoir + être traitées. La taille minimale requise pour la pile dépend + fortement des modules utilisés, mais toute modification dans la + configuration du serveur web peut invalider la définition courante + de la directive ThreadStackSize.
Sous Linux, cette directive ne peut être utilisée que pour + augmenter la valeur par defaut de la taille de la pile, car + l'appel système sous-jacent utilise cette valeur comme taille de pile + minimale. C'est la limite logicielle (souvent élevée) + pour ulimit -s (8Mo si aucune limite) qui est + utilisée comme taille de pile par défaut.

+ +

Il est recommandé de ne pas réduire + ThreadStackSize, à moins qu'un grand nombre + de threads par processus enfant ne soit nécessaire. Sur certaines + plates-formes (y compris Linux), une valeur de 128000 est déjà trop + basse et provoque des crashes avec certains modules courants.

+ +

Langues Disponibles: de | + en | + fr | + ja | + tr

Commentaires

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.

+ \ No newline at end of file diff --git a/docs/manual/mod/mpm_common.xml.fr b/docs/manual/mod/mpm_common.xml.fr new file mode 100644 index 00000000000..a0db6744423 --- /dev/null +++ b/docs/manual/mod/mpm_common.xml.fr @@ -0,0 +1,960 @@ + + + + + + + + + + + +mpm_common +Une sÃ©rie de directives implÃ©mentÃ©es par plusieurs +modules multi-processus (MPM) +MPM + + +CoreDumpDirectory +Le rÃ©pertoire dans lequel le serveur HTTP Apache va tenter de se +positionner avant d'effectuer un vidage mÃ©moire +CoreDumpDirectory rÃ©pertoire +Voir ci-dessous pour le rÃ©pertoire par dÃ©faut +server config +eventworker +prefork + + +

Cette directive permet de dÃ©finir le rÃ©pertoire dans lequel + Apache httpd va tenter de se positionner avant d'effectuer un vidage + mÃ©moire sur disque. + Si votre systÃ¨me d'exploitation est configurÃ© pour crÃ©er des + fichiers de vidage mÃ©moire dans le rÃ©pertoire de travail des + processus qui se sont crashÃ©s, + CoreDumpDirectory est nÃ©cessaire pour + dÃ©finir un rÃ©pertoire de travail autre que le rÃ©pertoire par dÃ©faut + ServerRoot, ce rÃ©pertoire de + travail ne devant pas Ãªtre accessible en Ã©criture par l'utilisateur sous + lequel le serveur s'exÃ©cute.

+ +

Si vous avez besoin d'un vidage mÃ©moire pour le dÃ©bogage, vous + pouvez utiliser cette directive pour le placer Ã un endroit + diffÃ©rent. Cette directive n'a aucun effet si votre systÃ¨me + d'exploitation n'est pas configurÃ© pour crÃ©er des + fichiers de vidage mÃ©moire dans le rÃ©pertoire de travail des + processus qui se sont crashÃ©s.

+ + Vidages mÃ©moire sous Linux +

Si Apache httpd est dÃ©marrÃ© sous l'utilisateur root puis bascule vers + un autre utilisateur, le noyau Linux dÃ©sactive les + vidages mÃ©moire, mÃªme si le rÃ©pertoire est accessible en Ã©criture au + processus. Apache httpd (versions 2.0.46 et supÃ©rieures) rÃ©active les + vidages mÃ©moire sous Linux 2.4 et au delÃ , mais seulement si vous + dÃ©finissez une directive CoreDumpDirectory.

+ + + + Vidages mÃ©moire sous BSD +

Pour activer le vidage mÃ©moire des exÃ©cutables suid sur les + systÃ¨mes de style BSD (comme FreeBSD), dÃ©finissez + kern.sugid_coredump Ã 1. +

+ + + Signaux spÃ©cifiques +

CoreDumpDirectory n'est traitÃ© qu'Ã la + reception d'un certain nombre de signaux , SIGFPE, SIGILL, SIGABORT, + SIGSEGV, et SIGBUS.

+ Sur certains systÃ¨mes d'exploitation, SIGQUIT provoque aussi un + vidage mÃ©moire, mais n'est pas traitÃ© par les directives + CoreDumpDirectory ou + EnableExceptionHook, si bien que la + dÃ©finition du rÃ©pertoire d'enregistrement du vidage mÃ©moire est + entiÃ¨rement dÃ©volue au systÃ¨me d'exploitation.

+ + + + + +EnableExceptionHook +Active un hook ("point d'accrochage logiciel") qui exÃ©cute des +gestionnaires d'exception aprÃ¨s un crash +EnableExceptionHook On|Off +EnableExceptionHook Off +server config + +eventworker +prefork + + +

Pour des raisons de sÃ©curitÃ©, cette directive n'est disponible + que si la compilation du serveur a Ã©tÃ© configurÃ©e avec l'option + --enable-exception-hook. Elle permet d'activer un hook + ("point d'accrochage logiciel") + qui autorise certains modules externes Ã effectuer un branchement et + accomplir telle ou telle action aprÃ¨s le crash d'un processus + enfant.

+ +

Deux modules, mod_whatkilledus et + mod_backtrace utilisent ce hook. Veuillez vous + rÃ©fÃ©rer Ã la page EnableExceptionHook de Jeff Trawick pour plus + d'informations Ã leur sujet.

+ + + + +GracefulShutdownTimeout +SpÃ©cifie le dÃ©lai maximum aprÃ¨s lequel le serveur va +s'arrÃªter dans le cas d'un arrÃªt "en douceur" +GracefulShutdownTimeout seconds +GracefulShutdownTimeout 0 +server config +eventworker +prefork + + +

La directive GracefulShutdownTimeout + permet de spÃ©cifier le temps, en secondes, pendant lequel le serveur + va continuer Ã fonctionner aprÃ¨s avoir reÃ§u un signal + "graceful-stop" ("ArrÃªt en douceur"), afin de terminer le traitement + des connexions en cours.

+ +

DÃ©finir cette valeur Ã zÃ©ro signifie au serveur d'attendre + jusqu'Ã ce que toutes les requÃªtes en cours aient Ã©tÃ© traitÃ©es.

+ + + + +PidFile +Ficher dans lequel le serveur enregistre l'identificateur +de processus du dÃ©mon +PidFile nom fichier +PidFile httpd.pid +server config +eventworker +preforkmpm_winnt +mpmt_os2 + + + +

La directive PidFile permet de dÃ©finir le + ficher dans lequel le serveur + enregistre l'identificateur de processus du dÃ©mon. Si le chemin du + fichier n'est pas absolu, il est considÃ©rÃ© comme relatif au chemin + dÃ©fini par la directive DefaultRuntimeDir.

+ + Exemple + + PidFile /var/run/apache.pid + + + +

Il est souvent utile de pouvoir envoyer un signal au + serveur afin qu'il ferme et ouvre Ã nouveau ses journaux + d'erreur et de transfert, et recharge son + fichier de configuration. Pour ce faire, on envoie un signal SIGHUP + (kill -1) Ã l'identificateur de processus enregistrÃ© dans le fichier + dÃ©fini par la directive PidFile.

+ +

La directive PidFile fait l'objet des + mÃªmes avertissements que ceux concernant le chemin d'enregistrement + des fichiers journaux et la sÃ©curitÃ©.

+ + Note +

Depuis la version 2 du serveur HTTP Apache, nous recommandons de n'utiliser + que le script apachectl, ou le script de + dÃ©marrage fourni avec votre systÃ¨me d'exploitation pour (re)dÃ©marrer ou + arrÃªter le serveur.

+ + + + + +Listen +Les adresses IP et ports sur lesquels le serveur Ã©coute +Listen [adresse IP:]numÃ©ro port +[protocole] +server config +eventworker +preforkmpm_winnt +mpm_netwarempmt_os2 + + + +

La directive Listen permet de signifier Ã + Apache httpd de ne se mettre Ã l'Ã©coute que sur les adresses IP et ports spÃ©cifiÃ©s ; par + dÃ©faut, le serveur rÃ©pond aux requÃªtes en provenance de toutes les + interfaces rÃ©seau. La directive Listen est + dorÃ©navant requise, et si elle est absente du fichier de + configuration, le serveur refusera de dÃ©marrer. Ceci constitue un + changement par rapport aux versions prÃ©cÃ©dentes d'Apache httpd.

+ +

La directive Listen signifie au serveur de + n'accepter les requÃªtes entrantes que vers le port ou le couple + adresse-port spÃ©cifiÃ©. Si seulement un port est spÃ©cifiÃ©, le serveur + se met Ã l'Ã©coute sur ce port sur toutes les interfaces rÃ©seau. Si une adresse IP + et un port sont spÃ©cifiÃ©s, le serveur va se mettre Ã l'Ã©coute sur ce port sur + l'interface rÃ©seau correspondant Ã l'adresse IP.

+ +

On peut utiliser autant de directives + Listen que nÃ©cessaire pour spÃ©cifier + plusieurs adresses et/ou ports Ã Ã©couter. Le serveur rÃ©pondra aux + requÃªtes vers tous les adresses et ports spÃ©cifiÃ©s.

+ +

Par exemple, pour que le serveur accepte les connexions sur les + ports 80 et 8000, utilisez :

+ + +Listen 80 +Listen 8000 + + +

Pour que le serveur accepte les connexions sur deux interfaces et + ports particuliers, spÃ©cifiez :

+ + +Listen 192.170.2.1:80 +Listen 192.170.2.5:8000 + + +

Les adressee IPv6 doivent Ãªtre entourÃ©es de crochets, comme dans + l'exemple suivant :

+ + + Listen [2001:db8::a00:20ff:fea7:ccea]:80 + + +

L'argument optionnel protocole n'est pas nÃ©cessaire + dans la plupart des configurations. S'il est absent, + https est la valeur par dÃ©faut pour le port 443 et + http l'est pour tous les autres ports. L'argument + protocole sert Ã dÃ©terminer quel module doit traiter une requÃªte, et + Ã appliquer des optimisations spÃ©cifiques Ã certains protocoles Ã + l'aide de la directive AcceptFilter.

+ +

La spÃ©cification d'un protocole n'est nÃ©cessaire que si vous + utilisez des ports non standards. Par exemple, pour configurer un + site en https sur le port 8443 :

+ + + Listen 192.170.2.1:8443 https + + + Condition d'erreur + Plusieurs directives Listen pour les mÃªmes + adresse IP/port vont provoquer l'envoi d'un message d'erreur + Address already in use. + + + +ProblÃ¨mes avec DNS +DÃ©finition des adresses et ports +qu'utilise le serveur HTTP Apache +Autre +discussion Ã propos du message d'erreur

Address already in
+use

, citant d'autres causes possibles. + + + +ListenCoresBucketsRatio +Rapport entre le nombre de coeurs de processeur activÃ©s et +le nombre de segments d'Ã©coute +ListenCoresBucketsRatio ratio +ListenCoresBucketsRatio 0 (disabled) +server config +eventworker +prefork + +Disponible Ã partir de la version 2.4.13 du serveur HTTP +Apache, avec un noyau supportant l'option de socket +SO_REUSEPORT, et distribuant uniformÃ©ment les nouvelles +connexions aux sockets d'Ã©coute des processus (ou threads) qui +l'utilisent (par exemple Linux versions 3.9 et ultÃ©rieures, mais pas +l'implÃ©mentation courante de SO_REUSEPORT par les +plateformes de type BSD. + + +

Vous pouvez utiliser la directive + ListenCoresBucketsRatio pour spÃ©cifier un + ratio entre le nombre de coeurs de CPU activÃ©s et le + nombre de segments d'Ã©coute (listeners' buckets) souhaitÃ©s ; le + serveur HTTP Apache va alors crÃ©ernum_cpu_cores / ratio + segments d'Ã©coute, chacun contenant son propre socket d'Ã©coute + Listen sur le ou les mÃªmes ports ; chaque + processus enfant sera associÃ© Ã un seul segment d'Ã©coute (avec une + distribution de type round-robin des segments Ã la crÃ©ation des + processus enfants).

+ + DÃ©finition du terme coeur de CPU activÃ© ("online") +

Sous Linux et BSD, un coeur de CPU peut Ãªtre activÃ© ou dÃ©sactivÃ© si Hotplug + a Ã©tÃ© configurÃ© ; la directive + ListenCoresBucketsRatio doit donc tenir compte de ce + paramÃ¨tre pour calculer le nombre de segments d'Ã©coute Ã crÃ©er.

+ + +

La directive ListenCoresBucketsRatio peut + amÃ©liorer le support de la montÃ©e en charge lorsque l'arrivÃ©e de + nouvelles connexions est/devient un goulot d'Ã©tranglement. Le test + de cette fonctionnalitÃ© avec des machines possÃ©dant un nombre de + coeurs de CPU important a permit de constater une amÃ©lioration des + performances significative et des temps de rÃ©ponse plus courts.

+ +

Pour que cette fonctionnalitÃ© soit activÃ©e, le nombre de coeurs + de CPU doit Ãªtre Ã©gal au moins au double du ratio + spÃ©cifiÃ©. Si vous spÃ©cifiez la valeur recommandÃ©e pour + ratio, Ã savoir 8, le nombre minimum de + coeurs de processeurs disponibles sera alors de 16. La valeur + optimale de ratio permettant d'obtenir des performances maximales + doit Ãªtre calculÃ©e pour chaque systÃ¨me cible, en testant plusieurs valeurs + et en observant les rÃ©sultats.

+ +

Cette directive influence le calcul des valeurs limites infÃ©rieures de + MinSpareThreads et MaxSpareThreads. En effet, pour accepter les + connexions de maniÃ¨re optimale, le nombre de processus enfants doit Ãªtre un + multiple du nombre de segments d'Ã©coute.

+ + + + +ListenBackLog +Longueur maximale de la liste d'attente des +connexions +ListenBacklog backlog +ListenBacklog 511 +server config +eventworker +preforkmpm_winnt +mpm_netwarempmt_os2 + + + +

La longueur maximale de la liste d'attente des connexions. En + gÃ©nÃ©ral, aucune modification n'est nÃ©cessaire, ni mÃªme souhaitable ; + cependant, sur certains systÃ¨mes, il peut Ãªtre nÃ©cessaire + d'en augmenter la valeur en cas d'attaque TCP SYN flood (envoi en + masse de requÃªtes SYN pour saturer le serveur). Voir le paramÃ¨tre + backlog de l'appel systÃ¨me listen(2).

+ +

En fait, l'argument backlog sera souvent limitÃ© Ã une valeur + infÃ©rieure en fonction du systÃ¨me d'exploitation. Notez aussi que de + nombreux systÃ¨mes d'exploitation ne tiennent pas vraiment compte de + la valeur spÃ©cifiÃ©e pour l'argument backlog, mais s'en inspirent + seulement (et choisissent en gÃ©nÃ©ral une valeur supÃ©rieure).

+ + + + +MaxRequestWorkers +Nombre maximum de connexions pouvant Ãªtre traitÃ©es +simultanÃ©ment +MaxRequestWorkers nombre +Voir ci-dessous pour plus de dÃ©tails +server config +eventworker +prefork + + + +

La directive MaxRequestWorkers permet de fixer le + nombre maximum de requÃªtes pouvant Ãªtre traitÃ©es simultanÃ©ment. + Si la limite MaxRequestWorkers est atteinte, toute + tentative de connexion sera normalement mise dans une file + d'attente, et ceci jusqu'Ã un certain nombre dÃ©pendant de la + directive ListenBacklog. + Lorsqu'un processus enfant se libÃ¨rera suite Ã la fin du traitement + d'une requÃªte, la connexion en attente pourra Ãªtre traitÃ©e Ã son + tour.

+ +

Pour les serveurs non threadÃ©s (c'est Ã dire utilisant + prefork), la directive + MaxRequestWorkers dÃ©finit alors le nombre maximum de + processus enfants qui pourront Ãªtre lancÃ©s simultanÃ©ment pour + traiter les requÃªtes. La valeur par dÃ©faut est 256 ; si + vous l'augmentez, vous devez aussi augmenter la valeur de la + directive ServerLimit.

+ +

Pour les serveur threadÃ©s et hybrides (utilisant par + exemple event ou worker), + MaxRequestWorkers dÃ©finit alors le nombre total de + threads qui seront disponibles pour servir les clients. Dans le + cas des MPMs hybrides, la valeur par dÃ©faut est 16 + (directive ServerLimit) multipliÃ© par la valeur + 25 (directive ThreadsPerChild). Par consÃ©quent, pour affecter Ã la + directive MaxRequestWorkers une valeur qui requiert + plus de 16 processus, vous devez aussi augmenter la valeur de la + directive ServerLimit.

+ +

Le nom de la directive MaxRequestWorkers + Ã©tait MaxClients avant la version 2.3.13. Cet + ancien nom est encore supportÃ©.

+ + + + +MaxMemFree +QuantitÃ© maximale de mÃ©moire que l'allocateur principal est +autorisÃ© Ã conserver sans appeler free() +MaxMemFree KOctets +MaxMemFree 2048 +server config +eventworker +preforkmpm_winnt +mpm_netware + + + +

La directive MaxMemFree permet de dÃ©finir + le nombre maximum de KOctets libres que tout allocateur est + autorisÃ© Ã conserver sans appeler free(). Dans les MPMs + threadÃ©s, chaque thread possÃ¨de son propre allocateur. Si elle est + dÃ©finie Ã 0, la quantitÃ© de mÃ©moire libre que peut conserver un + allocateur est illimitÃ©e.

+ + + + +MaxConnectionsPerChild +Limite le nombre de connexions qu'un processus enfant va +traiter au cours de son fonctionnement +MaxConnectionsPerChild number +MaxConnectionsPerChild 0 +server config +eventworker +preforkmpm_winnt +mpm_netwarempmt_os2 + +Disponible depuis la version 2.3.9 du serveur HTTP +Apache. L'ancien nom MaxRequestsPerChild est encore +supportÃ©. + + +

La directive MaxConnectionsPerChild permet de + dÃ©finir le nombre maximum de connexions qu'un processus enfant va + pouvoir traiter au cours de son fonctionnement. Lorsqu'il a traitÃ© + MaxConnectionsPerChild connexions, le processus + enfant est arrÃªtÃ©. Si MaxConnectionsPerChild est + dÃ©finie Ã 0, il n'y a plus aucune limite sur le nombre + de connexions que le processus pourra traiter.

+ +

DÃ©finir MaxConnectionsPerChild Ã une valeur + non nulle limite la quantitÃ© de mÃ©moire qu'un processus peut + consommer Ã cause de fuites (accidentelles) de mÃ©moire.

+ + + + + +MaxSpareThreads +Nombre maximum de threads inactifs +MaxSpareThreads nombre +Voir ci-dessous pour plus de dÃ©tails +server config +eventworker +mpm_netwarempmt_os2 + + + +

C'est le nombre maximum de threads inactifs. Les MPMs utilisent + cette directive de diffÃ©rentes maniÃ¨res.

+ +

Pour worker et event, la dÃ©finition par dÃ©faut est + MaxSpareThreads 250. Ce MPM gÃ¨re les threads inactifs + au niveau du serveur. Si le serveur possÃ¨de trop de threads + inactifs, des processus enfants seront arrÃªtÃ©s jusqu'Ã ce que le + nombre de threads inactifs repasse en dessous de cette limite. Des + processus/threads supplÃ©mentaires sont susceptibles d'Ãªtre crÃ©Ã©s si + ListenCoresBucketsRatio est + activÃ©e.

+ +

Pour mpm_netware, la dÃ©finition par dÃ©faut est + MaxSpareThreads 100. Comme ce MPM n'exÃ©cute qu'un seul + processus, le nombre de processus inactifs est surveillÃ© au + niveau du serveur.

+ +

mpmt_os2 fonctionne de maniÃ¨re similaire Ã + mpm_netware. Pour mpmt_os2, la + valeur par dÃ©faut est 10.

+ + Contraintes +

La gamme de valeurs pour MaxSpareThreads + est limitÃ©e. Apache httpd corrigera automatiquement cette valeur selon + les rÃ¨gles suivantes :

Avec mpm_netware, MaxSpareThreads doit Ãªtre supÃ©rieure Ã MinSpareThreads.
Avec + worker et event, MaxSpareThreads + doit Ãªtre supÃ©rieure ou Ã©gale Ã la somme de MinSpareThreads et ThreadsPerChild.

+ + +MinSpareThreads +StartServers +MaxSpareServers + + + +MinSpareThreads +Nombre minimum de threads inactifs qui seront disponibles +pour pouvoir traiter les pics de requÃªtes +MinSpareThreads nombre +Voir ci-dessous pour plus de dÃ©tails +server config +eventworker +mpm_netwarempmt_os2 + + + +

C'est le nombre minimum de threads inactifs pour Ãªtre en mesure + de traiter les pics de requÃªtes. Les MPMs utilisent cette directive + de diffÃ©rentes maniÃ¨res.

+ +

Avec worker et event, la dÃ©finition par dÃ©faut est + MinSpareThreads 75, et le nombre de threads inactifs + est surveillÃ© au niveau du serveur. Si le serveur ne possÃ¨de pas + assez de threads inactifs, des processus enfants sont crÃ©Ã©s jusqu'Ã + ce que le nombre de threads inactifs repasse au dessus de + nombre. Des processus/threads supplÃ©mentaires peuvent + Ãªtre crÃ©Ã©s si ListenCoresBucketsRatio est activÃ©e.

+ +

Avec mpm_netware, la dÃ©finition par dÃ©faut est + MinSpareThreads 10 et, comme ce MPM n'exÃ©cute qu'un + seul processus, le nombre de threads est surveillÃ© au niveau du + serveur.

+ +

mpmt_os2 fonctionne de maniÃ¨re similaire Ã + mpm_netware. Pour mpmt_os2, la + valeur par dÃ©faut est 5.

+ + +MaxSpareThreads +StartServers +MinSpareServers + + + +ScoreBoardFile +Chemin du fichier oÃ¹ sont stockÃ©es les donnÃ©es concernant +la coordination des processus enfants +ScoreBoardFile file-path +ScoreBoardFile apache_runtime_status +server config +eventworker +preforkmpm_winnt + + + +

Le serveur HTTP Apache utilise un tableau de bord pour la + communication entre le processus parent et les processus enfants. + Pour faciliter cette communication, certaines architectures + nÃ©cessitent un fichier. En l'absence de cette directive, donc si + aucun nom de fichier n'est spÃ©cifiÃ©, Apache httpd tentera tout + d'abord de crÃ©er un tableau uniquement en mÃ©moire (en utilisant la + mÃ©moire partagÃ©e anonyme) ; et si il n'y parvient pas, il tentera de + crÃ©er un fichier sur disque (en utilisant la mÃ©moire partagÃ©e Ã base + de fichier). Si cette directive est utilisÃ©e, Apache httpd crÃ©era + systÃ©matiquement un fichier sur disque.

+ +

Si file-path n'est pas un chemin absolu, il sera relatif Ã la + valeur spÃ©cifiÃ©e par la directive DefaultRuntimeDir. +

+ + Exemple + + ScoreBoardFile /var/run/apache_runtime_status + + + +

Une mÃ©moire partagÃ©e sous forme de fichier est utile pour les + applications tierces qui nÃ©cessitent un accÃ¨s direct au tableau de + bord des processus.

+ +

Si vous utilisez un ScoreBoardFile, vous + pourrez constater une amÃ©lioration des performances en le plaÃ§ant + sur un disque virtuel en RAM. Assurez-vous cependant de tenir compte + des mÃªmes avertissements que ceux concernant le chemin du fichier + journal et la sÃ©curitÃ©.

+ +ArrÃªter et redÃ©marrer +le serveur HTTP Apache + + + +ReceiveBufferSize +Taille du tampon TCP en entrÃ©e +ReceiveBufferSize octets +ReceiveBufferSize 0 +server config +eventworker +preforkmpm_winnt +mpm_netwarempmt_os2 + + + +

Le serveur va fixer la taille du tampon TCP en entrÃ©e au + nombre d'octets spÃ©cifiÃ©.

+ +

Si la directive est dÃ©finie Ã 0, le serveur va + utiliser la valeur par dÃ©faut adoptÃ©e par le systÃ¨me + d'exploitation.

+ + + + +SendBufferSize +Taille du tampon TCP en sortie +SendBufferSize octets +SendBufferSize 0 +server config +eventworker +preforkmpm_winnt +mpm_netwarempmt_os2 + + + +

DÃ©finit la taille du tampon TCP en sortie avec le nombre + d'octets spÃ©cifiÃ©. Ceci s'avÃ¨re souvent trÃ¨s utile pour augmenter les + valeurs par dÃ©faut standards du passÃ© des systÃ¨mes d'exploitation + pour les transmissions Ã grande vitesse et haute densitÃ© (c'est + Ã dire de l'ordre de 100ms comme sur les liaisons rapides + transcontinentales).

+ +

Si la directive est dÃ©finie Ã 0, le serveur va + utiliser la valeur par dÃ©faut adoptÃ©e par le systÃ¨me + d'exploitation.

+ +

L'amÃ©lioration des performances des connexions Ã grande vitesse + et Ã temps de latence Ã©levÃ©, peut nÃ©cessiter + une intervention au niveau de la configuration de votre systÃ¨me + d'exploitation.

+ +

Sous certains systÃ¨mes d'exploitation, la modification du + comportement TCP via une augmentation de la valeur de + SendBufferSize risque de ne pas Ãªtre + perceptible, si la directive EnableSendfile n'est pas dÃ©finie Ã OFF. + Cette interaction ne s'applique qu'aux fichiers statiques.

+ + + + +ServerLimit +Limite supÃ©rieure de la dÃ©finition du nombre de +processus +ServerLimit nombre +Voir ci-dessous pour plus de dÃ©tails +server config +eventworker +prefork + + + +

Avec le MPM prefork, cette directive dÃ©finit le + nombre maximum que l'on peut affecter Ã la directive MaxRequestWorkers, et ceci pour la + durÃ©e de vie du processus Apache httpd. Avec les + MPMs worker et event, cette directive, en combinaison avec + ThreadLimit, dÃ©finit le + nombre maximum que l'on peut affecter Ã MaxRequestWorkers, et ceci pour la durÃ©e de + vie du processus Apache httpd. Avec le MPM event, cette + directive permet aussi de dÃ©finir combien de processus anciens peuvent + continuer Ã s'exÃ©cuter pour terminer le traitement des connexions ouvertes. + Au cours d'un redÃ©marrage, vous pouvez + modifier la valeur de la directive MaxRequestWorkers, alors que toute + tentative de modification de la valeur de la directive ServerLimit sera ignorÃ©e.

+ +

Cette directive doit Ãªtre utilisÃ©e avec prÃ©caution. Si + ServerLimit est dÃ©finie Ã une valeur beaucoup + plus grande que nÃ©cessaire, de la mÃ©moire partagÃ©e supplÃ©mentaire + sera inutilement allouÃ©e. Si Ã la fois + ServerLimit et MaxRequestWorkers possÃ¨dent des valeurs + supÃ©rieures Ã ce que le systÃ¨me peut supporter, ce dernier peut + devenir instable ou Apache httpd peut tout simplement refuser de dÃ©marrer.

+ +

Avec les MPMs prefork et event, n'utilisez cette directive + que si vous devez dÃ©finir MaxRequestWorkers Ã une valeur supÃ©rieure Ã + 256 (valeur par dÃ©faut). N'affectez pas Ã la directive ServerLimit une valeur supÃ©rieure Ã + celle que vous avez prÃ©vu d'affecter Ã la directive MaxRequestWorkers.

+ +

Avec worker, n'utilisez cette directive que si + la dÃ©finition de vos directives MaxRequestWorkers et ThreadsPerChild nÃ©cessitent plus de + 16 processus serveurs (valeur par dÃ©faut). N'affectez pas Ã la + directive ServerLimit une + valeur supÃ©rieure au nombre de processus requis pour la dÃ©finition + des directives MaxRequestWorkers + et ThreadsPerChild.

+ +

Avec le MPM event, augmentez la valeur de cette + directive si le nombre de processus dÃ©fini par les directives MaxRequestWorkers et ThreadsPerChild augmentÃ© du nombre de processus + en procÃ©dure d'arrÃªt "graceful" est supÃ©rieur Ã 16 (valeur par dÃ©faut).

+ + Note +

Il existe une limite de ServerLimit 20000 codÃ©e en + dur dans le serveur (200000 pour le MPM prefork). + Ceci est censÃ© Ã©viter les effets dÃ©sastreux que pourrait provoquer + une faute de frappe. Pour dÃ©passer cette limite, vous devez + modifier la valeur de MAX_SERVER_LIMIT dans le fichier source du + mpm et recompiler le serveur.

+ + +ArrÃªter et redÃ©marrer +le serveur HTTP Apache + + + +StartServers +Nombre de processus enfants du serveur crÃ©Ã©s au +dÃ©marrage +StartServers nombre +Voir ci-dessous pour plus de dÃ©tails +server config +eventworker +preforkmpmt_os2 + + + +

La directive StartServers permet de + dÃ©finir le nombre de processus enfants du serveur crÃ©Ã©s au + dÃ©marrage. Comme le nombre de processus est contrÃ´lÃ© dynamiquement + en fonction de la charge (voir MinSpareThreads, MaxSpareThreads, MinSpareServers, MaxSpareServers), il n'est en gÃ©nÃ©ral + pas nÃ©cessaire d'ajuster ce paramÃ¨tre.

+ +

La valeur par dÃ©faut diffÃ¨re d'un MPM Ã l'autre. Pour + worker et event, la dÃ©finition par dÃ©faut est + StartServers 3 ; la valeur par dÃ©faut est + 5 pour prefork et 2 + pour mpmt_os2.

+ + + + +StartThreads +Nombre de threads crÃ©Ã©s au dÃ©marrage +StartThreads nombre +Voir ci-dessous pour plus de dÃ©tails +server config +mpm_netware + + +

C'est le nombre de threads crÃ©Ã©s au dÃ©marrage du serveur. Comme + le nombre de threads est contrÃ´lÃ© dynamiquement + en fonction de la charge (voir MinSpareThreads, MaxSpareThreads, MinSpareServers, MaxSpareServers), il n'est en gÃ©nÃ©ral + pas nÃ©cessaire d'ajuster ce paramÃ¨tre.

+ +

Pour mpm_netware, la dÃ©finition par dÃ©faut est + StartThreads 50 et, comme il n'y a qu'un processus, il + s'agit du nombre total de threads crÃ©Ã©s au dÃ©marrage pour servir les + requÃªtes.

+ + + + +ThreadLimit +Le nombre de threads maximum que l'on peut dÃ©finir par +processus enfant +ThreadLimit nombre +Voir ci-dessous pour plus de dÃ©tails +server config +eventworker +mpm_winnt + + + +

Cette directive permet de dÃ©finir le nombre maximum que l'on peut + affecter Ã la directive ThreadsPerChild pour la durÃ©e de vie + du processus Apache httpd. La directive ThreadsPerChild peut Ãªtre modifiÃ©e + au cours d'un redÃ©marrage jusqu'Ã la valeur de la directive ThreadLimit, mais toute tentative + de modification de la directive ThreadLimit au cours d'un + redÃ©marrage sera ignorÃ©e.

+ +

L'utilisation de cette directive doit faire l'objet de + prÃ©cautions particuliÃ¨res. Si ThreadLimit est + dÃ©finie Ã une valeur trÃ¨s supÃ©rieure Ã la directive ThreadsPerChild, de la mÃ©moire + partagÃ©e supplÃ©mentaire sera inutilement allouÃ©e. Si les directives + ThreadLimit et ThreadsPerChild sont dÃ©finies Ã des + valeurs supÃ©rieures Ã ce que le systÃ¨me peut supporter, ce dernier + peut devenir instable, ou Apache httpd peut tout simplement refuser de + dÃ©marrer. Ne dÃ©finissez pas cette directive Ã une valeur supÃ©rieure + Ã la valeur maximale que vous pensez affecter Ã la directive ThreadsPerChild pour le processus + Apache httpd en cours d'exÃ©cution.

+ +

La valeur par dÃ©faut de la directive + ThreadLimit est 1920 avec + mpm_winnt, et 64 avec les autres + MPMs.

+ + Note +

Il existe une limite de ThreadLimit 20000 (ou + ThreadLimit 100000 avec event, + ThreadLimit 15000 avec mpm_winnt) + codÃ©e en dur dans le serveur. Ceci est censÃ© Ã©viter les effets + dÃ©sastreux que pourrait provoquer une faute de frappe. Pour + dÃ©passer cette limite, vous devez modifier la valeur de + MAX_THREAD_LIMIT dans le fichier source du mpm et recompiler le + serveur.

+ + + + + +ThreadsPerChild +Nombre de threads crÃ©Ã©s par chaque processus +enfant +ThreadsPerChild nombre +Voir ci-dessous pour plus de dÃ©tails +server config +eventworker +mpm_winnt + + + +

Cette directive permet de dÃ©finir le nombre de threads que va + crÃ©er chaque processus enfant. Un processus enfant crÃ©e ces threads + au dÃ©marrage et n'en crÃ©e plus d'autres par la suite. Si l'on + utilise un MPM comme mpm_winnt qui ne lance qu'un + processus enfant, ce nombre doit Ãªtre suffisamment grand pour + supporter la charge du serveur. Avec un MPM comme + worker qui lance plusieurs processus enfants, c'est + le nombre total de threads qui doit Ãªtre suffisamment grand + pour supporter la charge du serveur.

+ +

La valeur par dÃ©faut de la directive + ThreadsPerChild est 64 avec + mpm_winnt, et 25 avec les autres + MPMs.

+ + + + +ThreadStackSize +La taille en octets de la pile qu'utilisent les threads qui +traitent les connexions clients +ThreadStackSize taille +65536 sous NetWare; varie en fonction des autres systÃ¨mes +d'exploitation +server config +eventworker +mpm_winntmpm_netware +mpmt_os2 + + + +

La directive ThreadStackSize permet de + dÃ©finir la taille de la pile (pour les donnÃ©es propres) qu'utilisent + les threads qui traitent les connexions clients en faisant appel Ã + des modules. Dans la plupart des cas, la valeur par dÃ©faut de la + taille de la pile du systÃ¨me d'exploitation convient, mais il existe + certaines situations oÃ¹ il peut s'avÃ©rer nÃ©cessaire de l'ajuster + :

+ +

Sur les plates-formes qui possÃ¨dent une valeur par dÃ©faut de + taille de la pile relativement petite (par exemple HP-UX), Apache + httpd peut se crasher si l'on utilise certains modules tiers qui + possÃ¨dent un quantitÃ© de donnÃ©es propres stockÃ©es relativement + importante. Il se peut que ces mÃªmes modules fonctionnent + correctement sur d'autres plate-formes oÃ¹ la valeur par dÃ©faut de + la taille de la pile est supÃ©rieure. Ce type de crash peut Ãªtre + evitÃ© en dÃ©finissant ThreadStackSize Ã une + valeur supÃ©rieure Ã la valeur par dÃ©faut du systÃ¨me + d'exploitation. Ce type d'ajustement n'est nÃ©cessaire que si le + fournisseur du module tiers en fait mention, ou si le diagnostic + d'un crash d'Apache httpd indique que la taille de la pile Ã©tait trop + petite.
Sur les plates-formes oÃ¹ la taille par dÃ©faut de la pile des + threads est sensiblement supÃ©rieure Ã la taille nÃ©cessaire pour la + configuration du serveur web, il est possible de disposer d'un + plus grand nombre de threads par processus enfant si la directive + ThreadStackSize est dÃ©finie Ã une valeur + infÃ©rieure Ã la valeur par dÃ©faut du systÃ¨me d'exploitation. + Cependant, ce + type d'ajustement ne doit Ãªtre effectuÃ© que dans un environnement + de test permettant de qualifier le serveur web au maximum de ses + possibilitÃ©s, car il peut arriver, dans de rares cas, que des + requÃªtes nÃ©cessitent une taille de pile supÃ©rieure pour pouvoir + Ãªtre traitÃ©es. La taille minimale requise pour la pile dÃ©pend + fortement des modules utilisÃ©s, mais toute modification dans la + configuration du serveur web peut invalider la dÃ©finition courante + de la directive ThreadStackSize.
Sous Linux, cette directive ne peut Ãªtre utilisÃ©e que pour + augmenter la valeur par defaut de la taille de la pile, car + l'appel systÃ¨me sous-jacent utilise cette valeur comme taille de pile + minimale. C'est la limite logicielle (souvent Ã©levÃ©e) + pour ulimit -s (8Mo si aucune limite) qui est + utilisÃ©e comme taille de pile par dÃ©faut.

+ + Il est recommandÃ© de ne pas rÃ©duire + ThreadStackSize, Ã moins qu'un grand nombre + de threads par processus enfant ne soit nÃ©cessaire. Sur certaines + plates-formes (y compris Linux), une valeur de 128000 est dÃ©jÃ trop + basse et provoque des crashes avec certains modules courants. + + + + diff --git a/docs/manual/mod/mpm_common.xml.meta b/docs/manual/mod/mpm_common.xml.meta index 5544f9df314..612da57c7ed 100644 --- a/docs/manual/mod/mpm_common.xml.meta +++ b/docs/manual/mod/mpm_common.xml.meta @@ -9,6 +9,7 @@ de en + fr ja tr diff --git a/docs/manual/mod/mpm_netware.html b/docs/manual/mod/mpm_netware.html index 4b973d1614c..b818fb32f82 100644 --- a/docs/manual/mod/mpm_netware.html +++ b/docs/manual/mod/mpm_netware.html @@ -3,3 +3,7 @@ URI: mpm_netware.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mpm_netware.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mpm_netware.html.fr b/docs/manual/mod/mpm_netware.html.fr new file mode 100644 index 00000000000..45846191a00 --- /dev/null +++ b/docs/manual/mod/mpm_netware.html.fr @@ -0,0 +1,140 @@ + + + + + +mpm_netware - Serveur Apache HTTP Version 2.5 + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.5 > Modules

Apache MPM netware

Langues Disponibles: en | + fr

+ + + +

Description:	Module multi-processus implémentant un serveur web basé +exclusivement sur les threads et optimisé pour Novell +NetWare
Statut:	MPM
Identificateur de Module:	mpm_netware_module
Fichier Source:	mpm_netware.c

Sommaire

+ +

Ce module multi-processus (MPM) implémente un serveur web basé + exclusivement sur les threads et optimisé pour Novell NetWare.

+ +

Le thread maître est chargé du lancement de threads esclaves qui + attendent les connexions et les traitent au fur et à mesure de leur + arrivée. Le serveur HTTP Apache essaie toujours de maintenir + plusieurs threads + esclaves en spare (en réserve) ou inactifs. De cette + façon, les clients n'ont pas besoin d'attendre le lancement d'un + nouveau thread enfant pour que leurs requêtes soient traitées.

+ +

Les directives StartThreads, MinSpareThreads, MaxSpareThreads, et MaxThreads contrôlent + la manière dont le thread maître crée les threads esclaves afin de + traiter les requêtes. En général, Apache httpd s'auto-régule correctement, + et la plupart des sites ne nécessitent aucune modification des + valeurs par défaut de ces directives. Pour les sites dont le serveur + est limité en mémoire, il peut s'avérer nécessaire de diminuer la + valeur de la directive MaxThreads afin d'éviter une + hyper-activité du serveur (arrêts de threads inactifs et lancement incessant + de nouveau threads). Vous trouverez plus d'informations à + propos du contrôle de la création de processus dans le document conseils en matière de + performances.

+ +

La directive MaxRequestsPerChild + contrôle la fréquence à laquelle le serveur recycle ses processus + en arrêtant les anciens et en en lançant de nouveaux. Sous le + système d'exploitation NetWare, il est vivement recommandé de + laisser cette directive à 0, ce qui permet aux threads esclaves de + continuer à traiter les requêtes indéfiniment.

Directives

Traitement des bugs

Voir aussi

+ +

Directive MaxThreads

+ + + + + + + +

Description:	Définit le nombre maximum de threads esclaves
Syntaxe:	`MaxThreads nombre`
Défaut:	`MaxThreads 2048`
Contexte:	configuration du serveur
Statut:	MPM
Module:	mpm_netware

La directive MaxThreads définit + le nombre maximum de threads esclaves que l'on désire autoriser. La + valeur par défaut correspondant à la valeur codée en dur à la + compilation, la valeur de cette directive ne peut donc qu'être + diminuée, comme dans l'exemple suivant :

+ +

+ MaxThreads 512 +

+ +

Langues Disponibles: en | + fr

Commentaires

+ \ No newline at end of file diff --git a/docs/manual/mod/mpm_netware.xml.fr b/docs/manual/mod/mpm_netware.xml.fr new file mode 100644 index 00000000000..6394fe58b68 --- /dev/null +++ b/docs/manual/mod/mpm_netware.xml.fr @@ -0,0 +1,117 @@ + + + + + + + + + + +mpm_netware +Module multi-processus implÃ©mentant un serveur web basÃ© +exclusivement sur les threads et optimisÃ© pour Novell +NetWare +MPM +mpm_netware.c +mpm_netware_module + +

Ce module multi-processus (MPM) implÃ©mente un serveur web basÃ© + exclusivement sur les threads et optimisÃ© pour Novell NetWare.

+ +

Le thread maÃ®tre est chargÃ© du lancement de threads esclaves qui + attendent les connexions et les traitent au fur et Ã mesure de leur + arrivÃ©e. Le serveur HTTP Apache essaie toujours de maintenir + plusieurs threads + esclaves en spare (en rÃ©serve) ou inactifs. De cette + faÃ§on, les clients n'ont pas besoin d'attendre le lancement d'un + nouveau thread enfant pour que leurs requÃªtes soient traitÃ©es.

+ +

Les directives StartThreads, MinSpareThreads, MaxSpareThreads, et MaxThreads contrÃ´lent + la maniÃ¨re dont le thread maÃ®tre crÃ©e les threads esclaves afin de + traiter les requÃªtes. En gÃ©nÃ©ral, Apache httpd s'auto-rÃ©gule correctement, + et la plupart des sites ne nÃ©cessitent aucune modification des + valeurs par dÃ©faut de ces directives. Pour les sites dont le serveur + est limitÃ© en mÃ©moire, il peut s'avÃ©rer nÃ©cessaire de diminuer la + valeur de la directive MaxThreads afin d'Ã©viter une + hyper-activitÃ© du serveur (arrÃªts de threads inactifs et lancement incessant + de nouveau threads). Vous trouverez plus d'informations Ã + propos du contrÃ´le de la crÃ©ation de processus dans le document conseils en matiÃ¨re de + performances.

+ +

La directive MaxRequestsPerChild + contrÃ´le la frÃ©quence Ã laquelle le serveur recycle ses processus + en arrÃªtant les anciens et en en lanÃ§ant de nouveaux. Sous le + systÃ¨me d'exploitation NetWare, il est vivement recommandÃ© de + laisser cette directive Ã 0, ce qui permet aux threads esclaves de + continuer Ã traiter les requÃªtes indÃ©finiment.

+DÃ©finition des adresses et ports +qu'utilise Apache httpd + + +Listen + +ListenBacklog + +MaxMemFree + +MaxRequestsPerChild + +ReceiveBufferSize + +SendBufferSize + +MaxSpareThreads + +MinSpareThreads + +StartThreads + +ThreadStackSize + + + +MaxThreads +DÃ©finit le nombre maximum de threads esclaves +MaxThreads nombre +MaxThreads 2048 +server config + + +

La directive MaxThreads dÃ©finit + le nombre maximum de threads esclaves que l'on dÃ©sire autoriser. La + valeur par dÃ©faut correspondant Ã la valeur codÃ©e en dur Ã la + compilation, la valeur de cette directive ne peut donc qu'Ãªtre + diminuÃ©e, comme dans l'exemple suivant :

+ + + MaxThreads 512 + + + + + diff --git a/docs/manual/mod/mpm_netware.xml.meta b/docs/manual/mod/mpm_netware.xml.meta index 2fea66827c3..9b8f967461a 100644 --- a/docs/manual/mod/mpm_netware.xml.meta +++ b/docs/manual/mod/mpm_netware.xml.meta @@ -8,5 +8,6 @@ en + fr diff --git a/docs/manual/mod/mpm_winnt.html b/docs/manual/mod/mpm_winnt.html index 2c0ccc92f71..7370f15f878 100644 --- a/docs/manual/mod/mpm_winnt.html +++ b/docs/manual/mod/mpm_winnt.html @@ -8,6 +8,10 @@ URI: mpm_winnt.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mpm_winnt.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mpm_winnt.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mpm_winnt.html.fr b/docs/manual/mod/mpm_winnt.html.fr new file mode 100644 index 00000000000..f1e08e997f4 --- /dev/null +++ b/docs/manual/mod/mpm_winnt.html.fr @@ -0,0 +1,163 @@ + + + + + +mpm_winnt - Serveur Apache HTTP Version 2.5 + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.5 > Modules

Apache MPM winnt

Langues Disponibles: de | + en | + fr | + ja

+ + + +

Description:	Module multi-processus optimisé pour Windows +NT.
Statut:	MPM
Identificateur de Module:	mpm_winnt_module
Fichier Source:	mpm_winnt.c

Sommaire

+ +

Ce module multi-processus (MPM) est le module par défaut pour les + systèmes d'exploitation de style Windows NT. Il consiste en un + processus de contrôle unique qui lance un processus enfant unique, + ce dernier créant à son tour des threads pour traiter les + requêtes.

+ +

La directive ThreadsPerChild définit le + nombre maximal de connexions clientes simultanées.

+ +

Ce MPM utilise par défaut les APIs Windows avancées pour accepter + les nouvelles connexions des clients. Avec certaines configurations, + des produits tiers peuvent interférer avec cette implémentation, et + provoquer l'enregistrement des messages suivants dans les journaux + du serveur :

+ +

+ Child: Encountered too many AcceptEx faults accepting client connections. + winnt_mpm: falling back to 'AcceptFilter none'. +

+ +

Le MPM se rabat sur une implémentation plus sûre, mais certaines + requêtes n'ont pas été traitées correctement. Pour éviter cette + erreur, définissez la directive AcceptFilter à none.

+ +

AcceptFilter http none
+AcceptFilter https none

+ + +

Avec les versions 2.0 et 2.2 d'Apache httpd, c'est la directive + Win32DisableAcceptEx qui était utilisée à cet + effet.

+ +

Le MPM WinNT diffère des autres MPMs Unix comme worker et event + à bien des égards :

+ +

Lorsqu'un processus enfant s'arrête suite à un arrêt ou + redémarrage du serveur, ou lorsque que la limite MaxConnectionsPerChild est + atteinte, les requêtes en cours de traitement par ce processus en + cours d'arrêt n'ont que TimeOut secondes pour s'exécuter avant + l'arrêt du processus. Les autres types de redémarrage ou arrêt ne + sont pas implémentés.
Les nouveau processus enfants relisent les fichiers de + configuration au lieu d'en hériter du parent. Ce comportement ne + pose pas de problème si le processus enfant est créé au démarrage + ou redémarrage, mais dans le cas où un processus enfant est créé + parce qu'un autre processus enfant s'est arrêté ou a atteint la + limite MaxConnectionsPerChild, tout + changement survenu entre temps dans la configuration sera alors + pris en compte dans le processus enfant, et parent et enfant + utiliseront une configuration différente. Si des modifications + planifiées de la configuration ont été partiellement effectuées, + et si la configuration courante n'est pas interprétable, le + processus enfant de remplacement ne pourra pas démarrer, et le + serveur s'arrêtera. En conséquence, toute modification des + fichiers de configuration doit être accompagnée d'un redémarrage + du serveur.
Les hooks monitor et fatal_exception + ne sont pas encore implémentés.
La directive AcceptFilter est + implémentée par le MPM et fournit un type de contrôle différent + sur le traitement des nouvelles connexions (Voir la documentation + de la directive AcceptFilter + pour plus de détails).

+ +

Directives

Traitement des bugs

Voir aussi

+ +

Langues Disponibles: de | + en | + fr | + ja

Commentaires

+ \ No newline at end of file diff --git a/docs/manual/mod/mpm_winnt.xml.fr b/docs/manual/mod/mpm_winnt.xml.fr new file mode 100644 index 00000000000..bbc564b085e --- /dev/null +++ b/docs/manual/mod/mpm_winnt.xml.fr @@ -0,0 +1,143 @@ + + + + + + + + + + + +mpm_winnt +Module multi-processus optimisÃ© pour Windows +NT. +MPM +mpm_winnt.c +mpm_winnt_module + +

Ce module multi-processus (MPM) est le module par dÃ©faut pour les + systÃ¨mes d'exploitation de style Windows NT. Il consiste en un + processus de contrÃ´le unique qui lance un processus enfant unique, + ce dernier crÃ©ant Ã son tour des threads pour traiter les + requÃªtes.

+ +

Ce MPM utilise par dÃ©faut les APIs Windows avancÃ©es pour accepter + les nouvelles connexions des clients. Avec certaines configurations, + des produits tiers peuvent interfÃ©rer avec cette implÃ©mentation, et + provoquer l'enregistrement des messages suivants dans les journaux + du serveur :

+ + + Child: Encountered too many AcceptEx faults accepting client connections.
+ winnt_mpm: falling back to 'AcceptFilter none'. + + +

Le MPM se rabat sur une implÃ©mentation plus sÃ»re, mais certaines + requÃªtes n'ont pas Ã©tÃ© traitÃ©es correctement. Pour Ã©viter cette + erreur, dÃ©finissez la directive AcceptFilter Ã none.

+ + +AcceptFilter http none +AcceptFilter https none + + +

Avec les versions 2.0 et 2.2 d'Apache httpd, c'est la directive + Win32DisableAcceptEx qui Ã©tait utilisÃ©e Ã cet + effet.

+ +

Lorsqu'un processus enfant s'arrÃªte suite Ã un arrÃªt ou + redÃ©marrage du serveur, ou lorsque que la limite MaxConnectionsPerChild est + atteinte, les requÃªtes en cours de traitement par ce processus en + cours d'arrÃªt n'ont que TimeOut secondes pour s'exÃ©cuter avant + l'arrÃªt du processus. Les autres types de redÃ©marrage ou arrÃªt ne + sont pas implÃ©mentÃ©s.
Les nouveau processus enfants relisent les fichiers de + configuration au lieu d'en hÃ©riter du parent. Ce comportement ne + pose pas de problÃ¨me si le processus enfant est crÃ©Ã© au dÃ©marrage + ou redÃ©marrage, mais dans le cas oÃ¹ un processus enfant est crÃ©Ã© + parce qu'un autre processus enfant s'est arrÃªtÃ© ou a atteint la + limite MaxConnectionsPerChild, tout + changement survenu entre temps dans la configuration sera alors + pris en compte dans le processus enfant, et parent et enfant + utiliseront une configuration diffÃ©rente. Si des modifications + planifiÃ©es de la configuration ont Ã©tÃ© partiellement effectuÃ©es, + et si la configuration courante n'est pas interprÃ©table, le + processus enfant de remplacement ne pourra pas dÃ©marrer, et le + serveur s'arrÃªtera. En consÃ©quence, toute modification des + fichiers de configuration doit Ãªtre accompagnÃ©e d'un redÃ©marrage + du serveur.
La directive AcceptFilter est + implÃ©mentÃ©e par le MPM et fournit un type de contrÃ´le diffÃ©rent + sur le traitement des nouvelles connexions (Voir la documentation + de la directive AcceptFilter + pour plus de dÃ©tails).

+ +

+ +Utiliser le serveur HTTP +Apache sous Microsoft Windows + +AcceptFilter + + +CoreDumpDirectory + +PidFile + +Listen + +ListenBacklog + +MaxConnectionsPerChild + +MaxMemFree + +ScoreBoardFile + +ReceiveBufferSize + +SendBufferSize + +ThreadLimit + +ThreadsPerChild + +ThreadStackSize + + + diff --git a/docs/manual/mod/mpm_winnt.xml.meta b/docs/manual/mod/mpm_winnt.xml.meta index 6816f05c39a..5394adc8989 100644 --- a/docs/manual/mod/mpm_winnt.xml.meta +++ b/docs/manual/mod/mpm_winnt.xml.meta @@ -9,6 +9,7 @@ de en + fr ja diff --git a/docs/manual/mod/mpmt_os2.html b/docs/manual/mod/mpmt_os2.html index eb0b883e857..032c4b4f83d 100644 --- a/docs/manual/mod/mpmt_os2.html +++ b/docs/manual/mod/mpmt_os2.html @@ -3,3 +3,7 @@ URI: mpmt_os2.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mpmt_os2.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mpmt_os2.html.fr b/docs/manual/mod/mpmt_os2.html.fr new file mode 100644 index 00000000000..3be61e3efe2 --- /dev/null +++ b/docs/manual/mod/mpmt_os2.html.fr @@ -0,0 +1,102 @@ + + + + + +mpmt_os2 - Serveur Apache HTTP Version 2.5 + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.5 > Modules

Apache MPM os2

Langues Disponibles: en | + fr

+ + + +

Description:	MPM hybride multi-processus, multi-thread pour +OS/2
Statut:	MPM
Identificateur de Module:	mpm_mpmt_os2_module
Fichier Source:	mpmt_os2.c

Sommaire

+ +

Le serveur se compose d'un processus principal parent, et d'un + petit nombre fixe de processus enfants.

+ +

La tâche du processus parent consiste à gérer les processus + enfants, c'est à dire lancer ces processus de manière à ce + qu'il y en ait toujours un nombre égal à la valeur de la directive + StartServers pour traiter + les connexions.

+ +

Chaque processus enfant comporte un jeu de threads esclaves et un + thread maître qui accepte les connexions et les distribue aux + esclaves via une file de travail. Le jeu de threads esclaves est + dynamique et géré par un thread de maintenance de façon à ce que le + nombre de threads inactifs soit maintenu entre MinSpareThreads et MaxSpareThreads.

Directives

Traitement des bugs

Voir aussi

+ +

Langues Disponibles: en | + fr

Commentaires

+ \ No newline at end of file diff --git a/docs/manual/mod/mpmt_os2.xml.fr b/docs/manual/mod/mpmt_os2.xml.fr new file mode 100644 index 00000000000..28682e7690c --- /dev/null +++ b/docs/manual/mod/mpmt_os2.xml.fr @@ -0,0 +1,78 @@ + + + + + + + + + + + +mpmt_os2 +MPM hybride multi-processus, multi-thread pour +OS/2 +MPM +mpmt_os2.c +mpm_mpmt_os2_module + +

Le serveur se compose d'un processus principal parent, et d'un + petit nombre fixe de processus enfants.

+ +

La tÃ¢che du processus parent consiste Ã gÃ©rer les processus + enfants, c'est Ã dire lancer ces processus de maniÃ¨re Ã ce + qu'il y en ait toujours un nombre Ã©gal Ã la valeur de la directive + StartServers pour traiter + les connexions.

+ +

Chaque processus enfant comporte un jeu de threads esclaves et un + thread maÃ®tre qui accepte les connexions et les distribue aux + esclaves via une file de travail. Le jeu de threads esclaves est + dynamique et gÃ©rÃ© par un thread de maintenance de faÃ§on Ã ce que le + nombre de threads inactifs soit maintenu entre MinSpareThreads et MaxSpareThreads.

+DÃ©finition des adresses et ports +qu'utilise Apache + +User + +Group + +Listen + +ListenBacklog + +ReceiveBufferSize + +SendBufferSize + +MaxConnectionsPerChild + +MaxSpareThreads + +MinSpareThreads + +PidFile + +StartServers + + + diff --git a/docs/manual/mod/mpmt_os2.xml.meta b/docs/manual/mod/mpmt_os2.xml.meta index dfe34172d98..f380b827f62 100644 --- a/docs/manual/mod/mpmt_os2.xml.meta +++ b/docs/manual/mod/mpmt_os2.xml.meta @@ -8,5 +8,6 @@ en + fr diff --git a/docs/manual/mod/prefork.html b/docs/manual/mod/prefork.html index c21f42f3d8b..a0bc723a13a 100644 --- a/docs/manual/mod/prefork.html +++ b/docs/manual/mod/prefork.html @@ -8,6 +8,10 @@ URI: prefork.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: prefork.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: prefork.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/prefork.html.fr b/docs/manual/mod/prefork.html.fr new file mode 100644 index 00000000000..fa7eb6aeafc --- /dev/null +++ b/docs/manual/mod/prefork.html.fr @@ -0,0 +1,233 @@ + + + + + +prefork - Serveur Apache HTTP Version 2.5 + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.5 > Modules

Apache MPM prefork

Langues Disponibles: de | + en | + fr | + ja | + tr

+ + + +

Description:	Implémente un serveur web avec démarrage anticipé de +processus, sans thread
Statut:	MPM
Identificateur de Module:	mpm_prefork_module
Fichier Source:	prefork.c

Sommaire

+ +

Ce module multi-processus (MPM) implémente un serveur web avec + démarrage anticipé de processus. Chaque processus du serveur peut + répondre aux requêtes entrantes, et un processus parent contrôle la + taille du jeu de processus enfants. Il est particulièrement indiqué pour les + sites qui ne doivent pas utiliser les threads afin de maintenir une + compatibilité avec certaines bibliothèques non sûres du point de vue + des threads. C'est également le MPM le plus approprié si l'on veut + isoler les requêtes les unes des autres, de façon à ce qu'un + problème concernant une requête n'affecte pas les autres.

+ +

Ce MPM s'auto-contrôle de manière efficace, de sorte qu'il est + rarement nécessaire d'ajuster ses directives de configuration. Le + plus important est la définition de la directive MaxRequestWorkers ; sa valeur doit être + assez grande pour pouvoir traiter autant de requêtes simultanées que + vous pensez recevoir, mais assez petite pour conserver suffisamment + de mémoire RAM pour tous les processus.

Sujets

Comment ça marche

Directives

Traitement des bugs

Voir aussi

Comment ça marche

Un processus de contrôle unique a pour tâche de lancer les + processus enfants qui attendent les connexions et les traitent au + fur et à mesure qu'elles arrivent. Apache httpd essaie toujours de + maintenir plusieurs processus serveurs inactifs ou en + réserve, afin de pouvoir traiter les requêtes entrantes. De + cette façon, les clients n'ont pas besoin d'attendre le démarrage + d'un nouveau processus enfant pour que leurs requêtes puissent être + traitées.

+ +

Les directives StartServers, MinSpareServers, MaxSpareServers et MaxRequestWorkers permettent de contrôler + la manière dont le processus parent crée les processus enfants pour + traiter les requêtes. En général, Apache httpd s'auto-contrôle de manière + efficace, de sorte que la plupart des sites peuvent conserver les + valeurs par défaut des directives. Les sites qui doivent traiter + plus de 256 requêtes simultanées doivent augmenter la valeur de + MaxRequestWorkers, alors que les + sites dont la ressource mémoire est limitée doivent la diminuer afin + d'éviter une hyperactivité du serveur (utilisation excessive de la + mémoire virtuelle sur disque). Vous trouverez plus d'informations à + propos du contrôle de la création de processus dans le document conseils en matière de + performances

+ +

Alors que le processus parent est en général démarré en tant que + root sous Unix afin de pouvoir se mettre à l'écoute sur le port 80, les + processus enfants sont lancés par Apache httpd sous un utilisateur avec + privilèges restreints. On peut contrôler les privilèges accordés aux + processus enfants d'Apache httpd à l'aide des directives User et Group. Les processus enfants doivent + être en mesure de lire tous les contenus destinés à être servis, + mais leurs privilèges doivent être aussi bas que possible.

+ +

La directive MaxConnectionsPerChild permet de + contrôler la fréquence à laquelle le serveur recycle ses processus + en arrêtant les plus anciens et en en lançant de nouveaux.

+ +

Ce module MPM utilise le mutex mpm-accept pour + sérialiser l'accès aux connexions entrantes lorsque peut se + présenter un problème d'afflux de requêtes (en général quand il y a + plusieurs sockets en écoute). Les aspects de l'implémentation de ce + mutex peuvent être configurés via la directive Mutex. Vous trouverez des informations + supplémentaires à propos de ce mutex dans la documentation à propos + des conseils en matière de + performances

Directive MaxSpareServers

+ + + + + + + +

Description:	Nombre maximum de processus serveurs enfants +inactifs
Syntaxe:	`MaxSpareServers nombre`
Défaut:	`MaxSpareServers 10`
Contexte:	configuration du serveur
Statut:	MPM
Module:	prefork

La directive MaxSpareServers permet de + définir le nombre maximum souhaité de processus serveurs enfants + inactifs. Un processus inactif est un processus qui ne + traite pas de requête. S'il y a plus de + MaxSpareServers processus inactifs, le + processus parent arrêtera les processus excédentaires.

+ +

La modification de ce paramètre n'est nécessaire que + dans le cas de sites très sollicités. Définir ce paramètre à une + valeur très grande est cependant dans la plupart des cas une + mauvaise idée. Si vous essayez d'affecter à ce paramètre une valeur + égale ou inférieure à la valeur de MinSpareServers, le serveur HTTP Apache + l'ajustera automatiquement à la valeur de + MinSpareServers + 1.

+ +

Voir aussi

Directive MinSpareServers

+ + + + + + + +

Description:	Nombre minimum de processus serveurs enfants +inactifs
Syntaxe:	`MinSpareServers nombre`
Défaut:	`MinSpareServers 5`
Contexte:	configuration du serveur
Statut:	MPM
Module:	prefork

La directive MinSpareServers permet de + définir le nombre minimum désiré de processus serveurs enfants + inactifs. Un processus inactif est un processus qui ne + traite pas de requête. S'il y a moins de + MinSpareServers processus inactifs, le + processus parent va créer de nouveaux enfants de la manière suivante + : il en crée un, attend une seconde, il en crée deux, attend une + seconde, il en crée quatre, puis continue ainsi exponentiellement + jusu'à ce que son taux de création de processus enfants soit de 32 + par seconde. Il ne s'arrête que lorsque le nombre de processus + enfants correspond à la définition de la directive + MinSpareServers.

+ +

La modification de ce paramètre n'est nécessaire que + dans le cas de sites très sollicités. Définir ce paramètre à une + valeur très grande est dans la plupart des cas une mauvaise + idée.

+ +

Voir aussi

Langues Disponibles: de | + en | + fr | + ja | + tr

Commentaires

+ \ No newline at end of file diff --git a/docs/manual/mod/prefork.xml.fr b/docs/manual/mod/prefork.xml.fr new file mode 100644 index 00000000000..5397a120b2c --- /dev/null +++ b/docs/manual/mod/prefork.xml.fr @@ -0,0 +1,204 @@ + + + + + + + + + + + +prefork +ImplÃ©mente un serveur web avec dÃ©marrage anticipÃ© de +processus, sans thread +MPM +prefork.c +mpm_prefork_module + +

Ce module multi-processus (MPM) implÃ©mente un serveur web avec + dÃ©marrage anticipÃ© de processus. Chaque processus du serveur peut + rÃ©pondre aux requÃªtes entrantes, et un processus parent contrÃ´le la + taille du jeu de processus enfants. Il est particuliÃ¨rement indiquÃ© pour les + sites qui ne doivent pas utiliser les threads afin de maintenir une + compatibilitÃ© avec certaines bibliothÃ¨ques non sÃ»res du point de vue + des threads. C'est Ã©galement le MPM le plus appropriÃ© si l'on veut + isoler les requÃªtes les unes des autres, de faÃ§on Ã ce qu'un + problÃ¨me concernant une requÃªte n'affecte pas les autres.

+ +

Ce MPM s'auto-contrÃ´le de maniÃ¨re efficace, de sorte qu'il est + rarement nÃ©cessaire d'ajuster ses directives de configuration. Le + plus important est la dÃ©finition de la directive MaxRequestWorkers ; sa valeur doit Ãªtre + assez grande pour pouvoir traiter autant de requÃªtes simultanÃ©es que + vous pensez recevoir, mais assez petite pour conserver suffisamment + de mÃ©moire RAM pour tous les processus.

Comment Ã§a marche +

Un processus de contrÃ´le unique a pour tÃ¢che de lancer les + processus enfants qui attendent les connexions et les traitent au + fur et Ã mesure qu'elles arrivent. Apache httpd essaie toujours de + maintenir plusieurs processus serveurs inactifs ou en + rÃ©serve, afin de pouvoir traiter les requÃªtes entrantes. De + cette faÃ§on, les clients n'ont pas besoin d'attendre le dÃ©marrage + d'un nouveau processus enfant pour que leurs requÃªtes puissent Ãªtre + traitÃ©es.

+ +

Les directives StartServers, MinSpareServers, MaxSpareServers et MaxRequestWorkers permettent de contrÃ´ler + la maniÃ¨re dont le processus parent crÃ©e les processus enfants pour + traiter les requÃªtes. En gÃ©nÃ©ral, Apache httpd s'auto-contrÃ´le de maniÃ¨re + efficace, de sorte que la plupart des sites peuvent conserver les + valeurs par dÃ©faut des directives. Les sites qui doivent traiter + plus de 256 requÃªtes simultanÃ©es doivent augmenter la valeur de + MaxRequestWorkers, alors que les + sites dont la ressource mÃ©moire est limitÃ©e doivent la diminuer afin + d'Ã©viter une hyperactivitÃ© du serveur (utilisation excessive de la + mÃ©moire virtuelle sur disque). Vous trouverez plus d'informations Ã + propos du contrÃ´le de la crÃ©ation de processus dans le document conseils en matiÃ¨re de + performances

+ +

Alors que le processus parent est en gÃ©nÃ©ral dÃ©marrÃ© en tant que + root sous Unix afin de pouvoir se mettre Ã l'Ã©coute sur le port 80, les + processus enfants sont lancÃ©s par Apache httpd sous un utilisateur avec + privilÃ¨ges restreints. On peut contrÃ´ler les privilÃ¨ges accordÃ©s aux + processus enfants d'Apache httpd Ã l'aide des directives User et Group. Les processus enfants doivent + Ãªtre en mesure de lire tous les contenus destinÃ©s Ã Ãªtre servis, + mais leurs privilÃ¨ges doivent Ãªtre aussi bas que possible.

+ +

La directive MaxConnectionsPerChild permet de + contrÃ´ler la frÃ©quence Ã laquelle le serveur recycle ses processus + en arrÃªtant les plus anciens et en en lanÃ§ant de nouveaux.

+ +

Ce module MPM utilise le mutex mpm-accept pour + sÃ©rialiser l'accÃ¨s aux connexions entrantes lorsque peut se + prÃ©senter un problÃ¨me d'afflux de requÃªtes (en gÃ©nÃ©ral quand il y a + plusieurs sockets en Ã©coute). Les aspects de l'implÃ©mentation de ce + mutex peuvent Ãªtre configurÃ©s via la directive Mutex. Vous trouverez des informations + supplÃ©mentaires Ã propos de ce mutex dans la documentation Ã propos + des conseils en matiÃ¨re de + performances

+ +CoreDumpDirectory + +EnableExceptionHook + +PidFile + +Listen + +ListenBacklog + +MaxRequestWorkers + +MaxMemFree + +MaxConnectionsPerChild + +ScoreBoardFile + +ReceiveBufferSize + +SendBufferSize + +ServerLimit + +StartServers + +User + +Group + + + +MaxSpareServers +Nombre maximum de processus serveurs enfants +inactifs +MaxSpareServers nombre +MaxSpareServers 10 +server config + + +

La directive MaxSpareServers permet de + dÃ©finir le nombre maximum souhaitÃ© de processus serveurs enfants + inactifs. Un processus inactif est un processus qui ne + traite pas de requÃªte. S'il y a plus de + MaxSpareServers processus inactifs, le + processus parent arrÃªtera les processus excÃ©dentaires.

+ +

La modification de ce paramÃ¨tre n'est nÃ©cessaire que + dans le cas de sites trÃ¨s sollicitÃ©s. DÃ©finir ce paramÃ¨tre Ã une + valeur trÃ¨s grande est cependant dans la plupart des cas une + mauvaise idÃ©e. Si vous essayez d'affecter Ã ce paramÃ¨tre une valeur + Ã©gale ou infÃ©rieure Ã la valeur de MinSpareServers, le serveur HTTP Apache + l'ajustera automatiquement Ã la valeur de + MinSpareServers + 1.

+ +MinSpareServers +StartServers +MaxSpareThreads + + + +MinSpareServers +Nombre minimum de processus serveurs enfants +inactifs +MinSpareServers nombre +MinSpareServers 5 +server config + + +

La directive MinSpareServers permet de + dÃ©finir le nombre minimum dÃ©sirÃ© de processus serveurs enfants + inactifs. Un processus inactif est un processus qui ne + traite pas de requÃªte. S'il y a moins de + MinSpareServers processus inactifs, le + processus parent va crÃ©er de nouveaux enfants de la maniÃ¨re suivante + : il en crÃ©e un, attend une seconde, il en crÃ©e deux, attend une + seconde, il en crÃ©e quatre, puis continue ainsi exponentiellement + jusu'Ã ce que son taux de crÃ©ation de processus enfants soit de 32 + par seconde. Il ne s'arrÃªte que lorsque le nombre de processus + enfants correspond Ã la dÃ©finition de la directive + MinSpareServers.

+ +

La modification de ce paramÃ¨tre n'est nÃ©cessaire que + dans le cas de sites trÃ¨s sollicitÃ©s. DÃ©finir ce paramÃ¨tre Ã une + valeur trÃ¨s grande est dans la plupart des cas une mauvaise + idÃ©e.

+ +MaxSpareServers +StartServers +MinSpareThreads + + + + diff --git a/docs/manual/mod/prefork.xml.meta b/docs/manual/mod/prefork.xml.meta index 9c143c19e2a..abaac63b165 100644 --- a/docs/manual/mod/prefork.xml.meta +++ b/docs/manual/mod/prefork.xml.meta @@ -9,6 +9,7 @@ de en + fr ja tr diff --git a/docs/manual/mod/quickreference.html b/docs/manual/mod/quickreference.html index 67c29e95a08..aab06765caa 100644 --- a/docs/manual/mod/quickreference.html +++ b/docs/manual/mod/quickreference.html @@ -12,6 +12,10 @@ URI: quickreference.html.es Content-Language: es Content-type: text/html; charset=ISO-8859-1 +URI: quickreference.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: quickreference.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/quickreference.html.fr b/docs/manual/mod/quickreference.html.fr new file mode 100644 index 00000000000..de9f1b82be7 --- /dev/null +++ b/docs/manual/mod/quickreference.html.fr @@ -0,0 +1,1529 @@ + + + + + +Document de référence rapide des directives - Serveur Apache HTTP Version 2.5 + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.5 > Modules

Document de référence rapide des directives

Langues Disponibles: de | + en | + es | + fr | + ja | + ko | + tr | + zh-cn

+ +

Le document de référence rapide des directives montre l'usage, + les valeurs par défaut, le statut, + et le contexte de chaque directive de configuration d'Apache. Pour plus + d'informations sur chacun de ces termes, voir le Dictionnaire des directives.

+ +

La première colonne donne le nom de la directive et son usage. + Si la directive possède une valeur par défaut, elle est indiquée dans la + deuxième colonne. + Si la valeur par défaut est trop grande pour pouvoir être affichée, + elle sera tronquée et suivie d'un "+".

+ +

La troisième colonne énumère les contextes dans + lesquels la directive est applicable, et la quatrième indique son statut en accord avec le + tableau des légendes ci-dessous.

+ + + +

A | B | C | D | E | F | G | H | I | K | L | M | N | O | P | Q | R | S | T | U | V | W | X

+ + + + +

s	configuration du serveur
v	serveur virtuel
d	répertoire
h	.htaccess

+ + + + + +

C	Core
M	MPM
B	Base
E	Extension
X	Expérimental
T	Externe

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

AcceptFilter `protocole` `filtre +d'acceptation`		s	C
Permet d'optimiser la configuration d'une socket pour +l'écoute d'un protocole
AcceptPathInfo On\|Off\|Default	Default	svdh	C
Les ressources acceptent des informations sous forme d'un +nom de chemin en fin de requête.
AccessFileName `nom-du-fichier` +[`nom-du-fichier`] ...	.htaccess	sv	C
Nom du fichier de configuration distribué
Action `type d'action` `script cgi` +[virtual]		svdh	B
Active un script CGI pour un gestionnaire ou un type de +contenu particulier
AddAlt `texte` `fichier` [`fichier`] ...		svdh	B
Texte optionnel à afficher à la place d'un icône pour un +fichier en fonction de son nom
AddAltByEncoding `texte` `codage MIME` +[`codage MIME`] ...		svdh	B
Texte optionnel à afficher à la place d'un icône pour un +fichier en fonction de son codage MIME
AddAltByType `texte` `type MIME` +[`type MIME`] ...		svdh	B
Texte optionnel à afficher à la place d'un icône pour un +fichier en fonction de son type MIME
AddCharset `jeu-car` `extension` +[`extension`] ...		svdh	B
Associe les extensions de noms de fichiers spécifiées au +jeu de caractères spécifié
AddDefaultCharset On\|Off\|`jeu de caractères`	Off	svdh	C
Paramètre jeu de caractères par défaut à ajouter quand le +type de contenu d'une réponse est `text/plain` ou +`text/html`
AddDescription `texte` [`fichier`] ...		svdh	B
Afficher la description d'un fichier
AddEncoding `codage` `extension` +[`extension`] ...		svdh	B
Associe les extensions de noms de fichiers données au type +de codage spécifié
AddHandler `nom-gestionnaire` `extension` +[`extension`] ...		svdh	B
Associe les extensions de noms de fichiers données au +gestionnaire spécifié
AddIcon `icône` `nom` [`nom`] +...		svdh	B
Icône à afficher pour un fichier en fonction de son +nom
AddIconByEncoding `icône` `codage MIME` +[`codage MIME`] ...		svdh	B
Icône à afficher à côté d'un fichier en fonction de son +codage MIME
AddIconByType `icône` `type MIME` +[`type MIME`] ...		svdh	B
Icône à afficher à côté d'un fichier en fonction de son +type MIME
AddInputFilter `filtre`[;`filtre`...] +`extension` [`extension`] ...		svdh	B
Associe les extensions de noms de fichiers aux +filtres spécifiés qui traiteront les requêtes clients
AddLanguage `symbole-langage` `extension` +[`extension`] ...		svdh	B
Associe l'extension de nom de fichier donnée au langage +spécifié
AddModuleInfo `nom-module` `chaîne`		sv	E
Ajoute des données supplémentaires aux informations de +module affichées par le gestionnaire server-info
AddOutputFilter `filtre`[;`filtre`...] +`extension` [`extension`] ...		svdh	B
Associe les extensions de noms de fichiers aux +filtres spécifiés qui traiteront les réponses en provenance du +serveur
AddOutputFilterByType `filtre`[;`filtre`...] +`type_de_média` [`type_de_média`] ...		svdh	B
assigne un filtre en sortie pour un type de média +particulier
AddType `type-médium` `extension` +[`extension`] ...		svdh	B
Associe les extensions de noms de fichiers au type de +contenu spécifié
Alias [`chemin URL`] +`chemin fichier`\|`chemin répertoire`		sv	B
Met en correspondance des URLs avec des chemins du système +de fichiers
AliasMatch `regex` +`chemin fichier`\|`chemin répertoire`		sv	B
Met en correspondance des URLs avec le système de fichiers +en faisant intervenir les expressions rationnelles
Allow from all\|`hôte`\|env=[!]`variable +d'environnement` +[`hôte`\|env=[!]`variable d'environnement`] ...		dh	E
Spécifie quels hôtes peuvent accéder à une certaine zone du +serveur
AllowCONNECT `port`[-`port`] +[`port`[-`port`]] ...	443 563	sv	E
Ports autorisés à se `CONNECT`er à travers le +mandataire
AllowEncodedSlashes On\|Off\|NoDecode	Off	sv	C
Détermine si les séparateurs de chemin encodés sont +autorisés à transiter dans les URLs tels quels
AllowHandlers [not] none\|handler-name +[none\|handler-name]...	all	d	X
Restrict access to the listed handlers
AllowMethods reset\|HTTP-method +[HTTP-method]...	reset	d	X
Restreint l'accès aux méthodes HTTP spécifiées
AllowOverride All\|None\|`type directive` +[`type directive`] ...	None à partir de la +	d	C
Types de directives autorisées dans les fichiers +`.htaccess`
AllowOverrideList None\|`directive` +[`directive-type`] ...	None	d	C
Directives autorisées dans les fichiers `.htaccess`
Anonymous `utilisateur` [`utilisateur`] +...		dh	E
Définit la liste des identifiants utilisateur autorisés à +accéder sans vérification du mot de passe
Anonymous_LogEmail On\|Off	On	dh	E
Détermine si le mot de passe fourni sera enregistré dans le +journal des erreurs
Anonymous_MustGiveEmail On\|Off	On	dh	E
Détermine si l'abscence de mot de passe est +autorisée
Anonymous_NoUserID On\|Off	Off	dh	E
Détermine si le champ identifiant peut être +vide
Anonymous_VerifyEmail On\|Off	Off	dh	E
Détermine s'il faut vérifier que le format de l'adresse +email fournie comme mot de passe est correct
AsyncFilter request\|connection\|network	request	sv	C
Définit le type de filtrage minimal disponible pour le + traitement asynchrone
AsyncRequestWorkerFactor `facteur`		s	M
Limite le nombre de connexions simultanées par thread
AuthBasicAuthoritative On\|Off	On	dh	B
Définit si les processus d'autorisation et +d'authentification peuvent être confiés à des modules de plus bas +niveau
AuthBasicFake off\|nom-utilisateur [mot-de-passe]		dh	B
Authentification de base simulée à l'aide des nom +d'utilisateur et mot de passe fournis
AuthBasicProvider `nom fournisseur` +[`nom fournisseur`] ...	file	dh	B
Définit le(les) fournisseur(s) d'authentification pour +cette zone du site web
AuthBasicUseDigestAlgorithm MD5\|Off	Off	dh	B
Vérifie les mots de passe auprès des fournisseurs +d'authentification à la manière de l'authentification de type Digest. +
AuthDBDUserPWQuery `requête`		d	E
Requête SQL servant à vérifier le mot de passe d'un +utilisateur
AuthDBDUserRealmQuery `requête`		d	E
Requête SQL servant à vérifier une empreinte de mot de +passe pour un utilisateur et un identifiant d'authentification. +
AuthDBMGroupFile `chemin-fichier`		dh	E
Définit le nom du fichier de base de données qui liste +les groupes d'utilisateurs.
AuthDBMType default\|SDBM\|GDBM\|NDBM\|DB	default	dh	E
Définit le type de fichier de base de données utilisé pour +stocker les mots de passe
AuthDBMUserFile `chemin-fichier`		dh	E
Définit le nom d'un fichier de base de données pour +l'authentification contenant la liste +des utilisateurs et de leurs mots de passe
AuthDigestAlgorithm MD5\|MD5-sess	MD5	dh	E
Sélectionne l'algorithme utilisé pour calculer les +condensés du défit et de sa réponse
AuthDigestDomain `URI` [`URI`] ...		dh	E
Les URIs qui se trouvent dans le même espace de protection +concernant l'authentification à base de condensés
AuthDigestNcCheck On\|Off	Off	s	E
Active ou désactive la vérification du nombre d'envois du +nombre à valeur unique (nonce) par le serveur
AuthDigestNonceFormat `format`		dh	E
Détermine la manière dont le nombre à valeur unique du +serveur (nonce) est généré
AuthDigestNonceLifetime `secondes`	300	dh	E
Durée de validité du nombre à valeur unique du +serveur (nonce)
AuthDigestProvider `nom fournisseur` +[`nom fournisseur`] ...	file	dh	E
Définit le(s) fournisseurs(s) d'authentification pour la +zone du site web concernée
AuthDigestQop none\|auth\|auth-int [auth\|auth-int]	auth	dh	E
Détermine le niveau de protection fourni par +l'authentification à base de condensé
AuthDigestShmemSize `taille`	1000	s	E
La quantité de mémoire partagée à allouer afin de conserver +les informations à propos des clients
AuthFormAuthoritative On\|Off	On	dh	B
Détermine si l'autorisation et l'authentification sont confiés à +des modules de plus bas niveau
AuthFormBody `nom du champ`		d	B
Le nom du champ de formulaire contenant le corps de la +requête à effectuer en cas de connexion réussie
AuthFormDisableNoStore `On\|Off`	Off	d	B
Désactive l'en-tête CacheControl no-store sur la page de +connexion
AuthFormFakeBasicAuth `On\|Off`	Off	d	B
Simule une en-tête d'authentification de base
AuthFormLocation `nom du champ`		d	B
Le nom du champ de formulaire qui contiendra l'URL vers +laquelle l'utilisateur sera redirigé en cas de connexion +réussie
AuthFormLoginRequiredLocation `url`		d	B
L'URL de la page vers laquelle on doit être redirigé si une +authentification est requise
AuthFormLoginSuccessLocation `url`		d	B
L'URL de la page vers laquelle on doit être redirigé en cas +de connexion réussie
AuthFormLogoutLocation `uri`		d	B
L'URL vers laquelle un utilisateur devra être redirigé +après s'être déconnecté
AuthFormMethod `nom du champ`		d	B
Le nom du champ de formulaire contenant la méthode de la +requête à effectuer en cas de connexion réussie
AuthFormMimetype `nom du champ`		d	B
Le nom du champ de formulaire contenant le type MIME du +corps de la requête à effectuer en cas de connexion +réussie
AuthFormPassword `nom du champ`		d	B
Le nom du champ de formulaire qui contient le mot de passe +de connexion
AuthFormProvider `nom fournisseur` +[`nom fournisseur`] ...	file	dh	B
Définit le(s) fournisseur(s) d'authentification pour la +zone concernée
AuthFormSitePassphrase `secret`		d	B
Court-circuite l'authentification pour les sites à fort +trafic
AuthFormSize `taille`		d	B
La taille maximale en octets du formulaire dont seront +extraites les informations de connexion
AuthFormUsername `nom du champ`		d	B
Le nom du champ de formulaire qui contient le nom de +connexion
AuthGroupFile `chemin-fichier`		dh	B
Définit le nom d'un fichier texte contenant la liste des +groupes d'utilisateurs permettant de définir les autorisations des +utilisateurs
AuthLDAPAuthorizePrefix préfixe	AUTHORIZE_	dh	E
Spécifie le préfixe ajouté aux variables d'environnement +durant la phase d'autorisation
AuthLDAPBindAuthoritative off\|on	on	dh	E
Détermine si l'on doit utiliser d'autres fournisseurs +d'authentification lorsque le serveur ne peut pas valider les données +d'authentification de l'utilisateur, alors que ce dernier possède un +DN.
AuthLDAPBindDN dn		dh	E
Un DN optionnel pour se connecter au serveur +LDAP
AuthLDAPBindPassword mot-de-passe		dh	E
Mot de passe à utiliser en conjonction avec le DN de +connexion
AuthLDAPCharsetConfig chemin-fichier		s	E
Chemin du fichier de configuration de la correspondance +langage/jeu de caractères
AuthLDAPCompareAsUser on\|off	off	dh	E
Utilisation des données d'authentification de l'utilisateur +pour effectuer les comparaisons pour l'attribution des autorisations
AuthLDAPCompareDNOnServer on\|off	on	dh	E
Utilise le serveur LDAP pour comparer les DNs
AuthLDAPDereferenceAliases never\|searching\|finding\|always	always	dh	E
À quel moment le module va déréférencer les +alias
AuthLDAPGroupAttribute attribut	member uniquemember +	dh	E
L'attribut LDAP utilisé pour vérifier l'appartenance d'un +utilisateur à un groupe.
AuthLDAPGroupAttributeIsDN on\|off	on	dh	E
Utilise le DN de l'utilisateur pour vérifier son +appartenance à un groupe
AuthLDAPInitialBindAsUser off\|on	off	dh	E
Détermine si le serveur effectue la recherche initiale du +DN en utilisant le nom propre de l'utilisateur pour l'authentification +de base +et non de manière anonyme, ou en utilisant des données d'authentification +codées en dur pour le serveur
AuthLDAPInitialBindPattern `regex` `substitution`	(.*) $1 (nom de l'u +	dh	E
Spécifie la modification a apporter au nom d'utilisateur +pour l'authentification de base lors de l'authentification auprès du +serveur LDAP pour effectuer une recherche de DN
AuthLDAPMaxSubGroupDepth `Nombre`	0	dh	E
Spécifie la profondeur d'imbrication des sous-groupes +maximale prise en compte avant l'abandon de la recherche de +l'utilisateur.
AuthLDAPRemoteUserAttribute uid		dh	E
Spécifie l'attribut dont la valeur renvoyée au cours de la +requête de l'utilisateur sera utilisée pour définir la variable +d'environnement REMOTE_USER
AuthLDAPRemoteUserIsDN on\|off	off	dh	E
Utilise le DN de l'utilisateur pour définir la variable +d'environnement REMOTE_USER
AuthLDAPSearchAsUser on\|off	off	dh	E
Utilise les données d'authentification de l'utilisateur +pour la recherche des autorisations
AuthLDAPSubGroupAttribute attribut		dh	E
Spécifie les noms d'attribut, un par directive, utilisés +pour différencier les membres du groupe courant qui sont eux-mêmes des +groupes.
AuthLDAPSubGroupClass ObjectClass-LDAP	groupOfNames groupO +	dh	E
Spécifie quelles valeurs d'objectClass LDAP identifient les +objets de l'annuaire qui sont des groupes au cours du traitement des +sous-groupes.
AuthLDAPUrl url [NONE\|SSL\|TLS\|STARTTLS]		dh	E
L'URL permettant de spécifier les paramètres de la +recherche LDAP
AuthMerging Off \| And \| Or	Off	dh	B
Définit la manière dont chaque logique d'autorisation des +sections de configuration se combine avec celles des sections de +configuration précédentes.
AuthName `identifiant d'autorisation`		dh	B
L'identifiant de l'autorisation à utiliser avec +l'authentification HTTP
AuthnCacheContext `directory\|server\|chaîne-personnalisée`		d	B
Spécifie une chaîne de contexte à utiliser dans la clé du +cache
AuthnCacheEnable		s	B
Active la mise en cache de l'authentification en tout +endroit
AuthnCacheProvideFor `fournisseur-authn` [...]		dh	B
Spécifie le fournisseur pour lequel on veut effectuer une +mise en cache
AuthnCacheSOCache `nom-fournisseur[:arguments-fournisseur]`		s	B
Sélectionne le fournisseur socache d'arrière-plan à +utiliser
AuthnCacheTimeout `durée-de-vie` (secondes)		dh	B
Définit une durée de vie pour les entrées du cache
<AuthnProviderAlias `alias-fournisseur`> +... </AuthnProviderAlias>		s	B
Regroupe un ensemble de directives qui constituent une +extension d'un fournisseur d'authentification de base et lui attribue +l'alias spécifié
AuthnzFcgiCheckAuthnProvider provider-name\|`None` +option ...		d	E
Enables a FastCGI application to handle the check_authn +authentication hook.
AuthnzFcgiDefineProvider type provider-name +backend-address		s	E
Defines a FastCGI application as a provider for +authentication and/or authorization
AuthType None\|Basic\|Digest\|Form		dh	B
Type d'authentification utilisateur
AuthUserFile `chemin-fichier`		dh	B
Définit le nom d'un fichier texte pour l'authentification +contenant la liste des utilisateurs et de leurs mots de +passe
AuthzDBDLoginToReferer On\|Off	Off	d	E
Définit si le client doit être redirigé vers la page +d'origine en cas de connexion ou de déconnexion réussie si une en-tête +de requête `Referer` est présente
AuthzDBDQuery `requête`		d	E
Définit la requête SQL pour l'opération +requise
AuthzDBDRedirectQuery `requête`		d	E
Définit une requête pour rechercher une page vers laquelle +rediriger l'utilisateur après une connexion réussie
AuthzDBMType default\|SDBM\|GDBM\|NDBM\|DB	default	dh	E
Définit le type de fichier de base de données contenant +la liste des groupes d'utilisateurs
<AuthzProviderAlias `fournisseur-de-base Alias +Paramètres-Require`> +... </AuthzProviderAlias> +		s	B
Regroupe des directives représentant une extension d'un +fournisseur d'autorisation de base qui pourra être référencée à l'aide +de l'alias spécifié
AuthzSendForbiddenOnFailure On\|Off	Off	dh	B
Envoie '403 FORBIDDEN' au lieu de '401 UNAUTHORIZED' si +l'authentification réussit et si l'autorisation a été refusée. +
BalancerGrowth `#`	5	sv	E
Nombre de membres supplémentaires pouvant être ajoutés +après la configuration initiale
BalancerInherit On\|Off	On	sv	E
Héritage des membres du groupes de répartition de + charge du mandataire définis au niveau du serveur principal
BalancerMember [`balancerurl`] `url` [`clé=valeur [clé=valeur ...]]`		d	E
Ajoute un membre à un groupe de répartition de +charge
BalancerPersist On\|Off	Off	sv	E
Tente de conserver les changements effectués par le + gestionnaire de répartition de charge après un redémarrage du + serveur.
BrotliAlterETag AddSuffix\|NoChange\|Remove	AddSuffix	sv	E
How the outgoing ETag header should be modified during compression
BrotliCompressionMaxInputBlock `value`	0	sv	E
Maximum input block size
BrotliCompressionQuality `value`	5	sv	E
Compression quality
BrotliCompressionWindow `value`	18	sv	E
Brotli sliding compression window size
BrotliFilterNote [`type`] `notename`		sv	E
Places the compression ratio in a note for logging
BrowserMatch regex [!]env-variable[=valeur] +[[!]env-variable[=valeur]] ...		svdh	B
Définit des variables d'environnement en fonction du +contenu de l'en-tête HTTP User-Agent
BrowserMatchNoCase regex [!]env-variable[=valeur] + [[!]env-variable[=valeur]] ...		svdh	B
Définit des variables d'environnement en fonction du +contenu de l'en-tête HTTP User-Agent sans tenir compte de la +casse
BufferedLogs On\|Off	Off	s	B
Enregistre les entrées du journal dans un tampon en mémoire +avant de les écrire sur disque
BufferSize entier	131072	svdh	E
Taille maximale en octets du filtre par tampon
CacheDefaultExpire `secondes`	3600 (une heure)	svdh	E
La durée par défaut de mise en cache d'un document +lorsqu'aucune date d'expiration n'a été spécifiée.
CacheDetailHeader `on\|off`	off	svdh	E
Ajoute un en-tête X-Cache-Detail à la réponse.
CacheDirLength `longueur`	2	sv	E
Le nombre de caractères des noms des +sous-répertoires
CacheDirLevels `niveaux`	2	sv	E
Le nombre de niveaux de sous-répertoires que comportera le +cache.
CacheDisable `chaîne-url` \| `on`		svdh	E
Désactive la mise en cache des URLs +spécifiées
CacheEnable `type de cache` [`chaîne +URL`]		svd	E
Active la mise en cache des URLs spécifiées en utilisant le +gestionnaire de stockage précisé
CacheFile `chemin_fichier` [`chemin fichier`] ...		s	X
Met en cache une liste de gestionnaires de fichiers au +démarrage
CacheHeader `on\|off`	off	svdh	E
Ajoute un en-tête X-Cache à la réponse.
CacheIgnoreCacheControl On\|Off	Off	sv	E
Ignore les en-têtes de requête enjoignant de ne pas servir +le contenu au client depuis le cache
CacheIgnoreHeaders `en-tête` [`en-tête`] ...	None	sv	E
Ne pas stocker le(s) en-tête(s) spécifié(s) dans le cache. +
CacheIgnoreNoLastMod On\|Off	Off	svdh	E
Ignore le fait qu'une réponse ne possède pas d'en-tête Last +Modified.
CacheIgnoreQueryString On\|Off	Off	sv	E
Ignore la chaîne de paramètres lors de la mise en +cache
CacheIgnoreURLSessionIdentifiers `identifiant` +[`identifiant`] ...	None	sv	E
Ignore les identifiants de session définis encodés dans +l'URL lors de la mise en cache +
CacheKeyBaseURL `URL`	http://example.com	sv	E
Remplace l'URL de base des clés du cache mandatées en +inverse
CacheLastModifiedFactor `flottant`	0.1	svdh	E
Le facteur utilisé pour générer une date d'expiration en +fonction de la date de dernière modification.
CacheLock `on\|off`	off	sv	E
Active la protection contre les tempêtes de requêtes.
CacheLockMaxAge `entier`	5	sv	E
Définit la durée de vie maximale d'un verrou de cache.
CacheLockPath `répertoire`	mod_cache-lock	sv	E
Définit le répertoire des verrous.
CacheMaxExpire `secondes`	86400 (une journée) +	svdh	E
La durée maximale en secondes de mise en cache d'un +document
CacheMaxFileSize `octets`	1000000	svdh	E
>La taille maximale (en octets) d'un document pour pouvoir +être stocké dans le cache
CacheMinExpire `secondes`	0	svdh	E
La durée minimale en secondes de mise en cache d'un +document
CacheMinFileSize `octets`	1	svdh	E
La taille minimale (en octets) d'un document pour pouvoir +être stocké dans le cache
CacheNegotiatedDocs On\|Off	Off	sv	B
Permet la mise en cache au niveau des serveurs mandataires +des documents dont le contenu a été négocié
CacheQuickHandler `on\|off`	on	sv	E
Exécute le cache à partir d'un gestionnaire rapide.
CacheReadSize `octets`	0	svdh	E
La quantité minimale (en octets) de données à lire et à +mettre en cache avant de les envoyer au client
CacheReadTime `millisecondes`	0	svdh	E
Le temps minimum (en millisecondes) qui doit s'écouler +avant d'envoyer les données au client
CacheRoot `répertoire`		sv	E
La racine du répertoire dans lequel les fichiers du cache +seront stockés
CacheSocache `type[:args]`		sv	E
Implémentation du cache d'objets partagés à utiliser
CacheSocacheMaxSize `octets`	102400	svdh	E
La taille maximale d'une entrée pouvant être placée dans le +cache
CacheSocacheMaxTime `secondes`	86400	svdh	E
La durée maximale de stockage d'un document dans le cache +avant péremption
CacheSocacheMinTime `seconds`	600	svdh	E
La durée minimale de stockage d'un document dans le cache
CacheSocacheReadSize `octets`	0	svdh	E
La quantité minimale de données du document à lire et +mettre en cache avant envoi au client
CacheSocacheReadTime `millisecondes`	0	svdh	E
La durée minimale de lecture avant l'envoi des données
CacheStaleOnError `on\|off`	on	svdh	E
Sert du contenu non à jour à la place de réponses 5xx.
CacheStoreExpired On\|Off	Off	svdh	E
Tente de mettre en cache les réponses que le serveur +considère comme arrivées à expiration
CacheStoreNoStore On\|Off	Off	svdh	E
Tente de mettre en cache les requêtes ou réponses dont +l'entête Cache-Control: a pour valeur no-store.
CacheStorePrivate On\|Off	Off	svdh	E
Tente de mettre en cache des réponses que le serveur a +marquées comme privées
CGIDScriptTimeout `time`[s\|ms]		svdh	B
Durée maximale d'attente de la prochaine sortie du +programme CGI
CGIMapExtension `chemin CGI` `.extension`		dh	C
Technique permettant de localiser l'interpréteur des +scripts CGI
CGIPassAuth On\|Off	Off	dh	C
Active la transmission d'en-têtes d'autorisation HTTP aux scripts en +tant que variables CGI
CGIVar `variable` `rule`		dh	C
Contrôle la manière dont certaines variables CGI sont définies
CharsetDefault `jeu de caractères`		svdh	E
Jeu de caractère vers lequel la traduction doit +s'effectuer
CharsetOptions `option` [`option`] ...	ImplicitAdd	svdh	E
Précise les détails de la traduction du jeu de +caractères
CharsetSourceEnc `jeu de caractères`		svdh	E
Jeu de caractères source des fichiers
CheckBasenameMatch on\|off	Off	svdh	E
Vérifie aussi la correspondance des fichiers, même avec des +extensions différentes
CheckCaseOnly on\|off	Off	svdh	E
Limite l'action du module aux corrections de +majuscules
CheckSpelling on\|off	Off	svdh	E
Active le module de correction
ChrootDir `chemin-répertoire`		s	B
Répertoire dans lequel Apache doit se positionner au +démarrage après avoir effectué un chroot(8).
ContentDigest On\|Off	Off	svdh	C
Active la génération d'un en-tête `Content-MD5` +dans la réponse HTTP
CookieDomain domaine		svdh	E
Le domaine auquel le cookie traceur +s'applique
CookieExpires durée		svdh	E
Durée avant expiration du cookie traceur
CookieName symbole	Apache	svdh	E
Nom du cookie traceur
CookieStyle + Netscape\|Cookie\|Cookie2\|RFC2109\|RFC2965	Netscape	svdh	E
Format du champ d'en-tête cookie
CookieTracking on\|off	off	svdh	E
Active le cookie traceur
CoreDumpDirectory `répertoire`		s	M
Le répertoire dans lequel le serveur HTTP Apache va tenter de se +positionner avant d'effectuer un vidage mémoire
CryptoCipher name	aes256	svdh	E
Cipher to be used by the crypto filter
CryptoDriver name	openssl	s	E
Name of the crypto driver to use
CryptoIV value	none	svdh	E
IV (Initialisation Vector) to be used by the crypto filter
CryptoKey value	none	svdh	E
Key to be used by the crypto filter
CryptoSize integer	131072	svdh	E
Maximum size in bytes to buffer by the crypto filter
CTAuditStorage directory		s	E
Existing directory where data for off-line audit will be stored
CTLogClient executable		s	E
Location of certificate-transparency log client tool
CTLogConfigDB filename		s	E
Log configuration database supporting dynamic updates
CTMaxSCTAge num-seconds		s	E
Maximum age of SCT obtained from a log, before it will be +refreshed
CTProxyAwareness oblivious\|aware\|require		sv	E
Level of CT awareness and enforcement for a proxy +
CTSCTStorage directory		s	E
Existing directory where SCTs are managed
CTServerHelloSCTLimit limit		s	E
Limit on number of SCTs that can be returned in +ServerHello
CTStaticLogConfig log-id\|- public-key-file\|- +1\|0\|- min-timestamp\|- max-timestamp\|- +log-URL\|-		s	E
Static configuration of information about a log
CTStaticSCTs certificate-pem-file sct-directory		s	E
Static configuration of one or more SCTs for a server certificate +
CustomLog `fichier`\|`pipe`\|`provider` +`format`\|`alias` +[env=[!]`variable-environnement`\| +expr=`expression`]		sv	B
Définit le nom et le format du fichier +journal
Dav On\|Off\|`nom fournisseur`	Off	d	E
Active les méthodes HTTP WebDAV
DavDepthInfinity on\|off	off	svd	E
Autorise les requêtes PROPFIND avec en-tête Depth: +Infinity
DavGenericLockDB `chemin fichier`		svd	E
Chemin de la base de données des verrous DAV
DavLockDB `chemin fichier`		sv	E
Chemin de la base de données des verrous DAV
DavMinTimeout `secondes`	0	svd	E
Durée minimale pendant laquelle le serveur maintient un +verrou sur une ressource DAV
DBDExptime `durée en secondes`	300	sv	E
Durée de vie des connexions inactives
DBDInitSQL `"instruction SQL"`		sv	E
Exécute une instruction SQL après connexion à une base de +données
DBDKeep `nombre`	2	sv	E
Nombre maximum de connexions maintenues
DBDMax `nombre`	10	sv	E
Nombre maximum de connexions
DBDMin `nombre`	1	sv	E
Nombre minimum de connexions
DBDParams +`param1`=`valeur1`[,`param2`=`valeur2`]		sv	E
Paramètres de la connexion à la base de +données
DBDPersist On\|Off		sv	E
Utiliser ou non des connexions persistentes
DBDPrepareSQL `"requête SQL"` `étiquette`		sv	E
Définit une requête SQL préparée
DBDriver `nom`		sv	E
Spécifie un pilote SQL
DefaultIcon `chemin URL`		svdh	B
Icône à afficher par défaut lorsqu'aucun icône spécifique +n'est précisé
DefaultLanguage `symbole-langage`		svdh	B
Défini un symbole de langage par défaut à affecter au champ +d'en-tête Content-Language pour toutes les ressources dans le contexte +courant auxquelles aucun symbole de langage n'a été +associé.
DefaultRuntimeDir `chemin-répertoire`	DEFAULT_REL_RUNTIME +	s	C
Répertoire de base des fichiers créés au cours de l'exécution du serveur
DefaultType `type média\|none`	none	svdh	C
Les seuls effets de cette directive sont des émissions +d'avertissements si sa valeur est différente de `none`. Dans +les versions précédentes, DefaultType permettait de spécifier un type de +média à assigner par défaut au contenu d'une réponse pour lequel aucun +autre type de média n'avait été trouvé. +
Define `nom-paramètre` [`valeur-paramètre`]		svd	C
Permet de définir une variable
DeflateAlterETag AddSuffix\|NoChange\|Remove	AddSuffix	sv	E
Comment l'en-tête sortant ETag doit être modifié au cours +de la compression
DeflateBufferSize `valeur`	8096	sv	E
Taille du fragment que zlib devra comprimer en une seule +fois
DeflateCompressionLevel `valeur`		sv	E
Le niveau de compression que nous appliquons à la +sortie
DeflateFilterNote [`type`] `nom de la note`		sv	E
Enregistre le taux de compression sous la forme d'une note +à des fins de journalisation
DeflateInflateLimitRequestBody`value`		svdh	E
Taille maximale des corps de requête décompressés
DeflateInflateRatioBurst `value`		svdh	E
Nombre maximal de fois que le ratio de décompression d'un +corps de requête peut être dépassé
DeflateInflateRatioLimit `value`		svdh	E
Ratio de décompression maximum pour les corps de requêtes
DeflateMemLevel `valeur`	9	sv	E
La quantité de mémoire utilisable par zlib pour la +compression
DeflateWindowSize `valeur`	15	sv	E
Taille de la fenêtre de compression zlib
Deny from all\|`hôte`\|env=[!]`variable +d'environnement` +[`hôte`\|env=[!]`variable d'environnement`] ...		dh	E
Définit quels hôtes ne sont pas autorisés à accéder au +serveur
<Directory `chemin répertoire`> +... </Directory>		sv	C
Regroupe un ensemble de directives qui ne s'appliquent +qu'au répertoire concerné du système de fichiers, à ses +sous-répertoires, et à leur contenu.
DirectoryCheckHandler On\|Off	Off	svdh	B
Définit la réponse de ce module lorsqu'un autre +gestionnaire est utilisé
DirectoryIndex + disabled \| `url locale` [`url locale`] ...	index.html	svdh	B
Liste des fichiers ressources à rechercher lorsque le +client envoie une requête pour un répertoire
DirectoryIndexRedirect on \| off \| permanent \| temp \| seeother \| +`3xx-code` +	off	svdh	B
Définit une redirection externe pour les index de +répertoires. +
<DirectoryMatch `regex`> +... </DirectoryMatch>		sv	C
Regroupe des directives qui s'appliquent au contenu de répertoires +du système de fichiers correspondant à une expression rationnelle
DirectorySlash On\|Off	On	svdh	B
Activation/Désactivation de la redirection "slash de +fin"
DocumentRoot `chemin répertoire`	"/usr/local/apache/ +	sv	C
Racine principale de l'arborescence des documents visible +depuis Internet
DTracePrivileges On\|Off	Off	s	X
Détermine si les privilèges requis par dtrace sont +activés.
DumpIOInput On\|Off	Off	s	E
Enregistre toutes les entrées dans le journal des +erreurs
DumpIOOutput On\|Off	Off	s	E
Enregistre toutes les sorties dans le journal des +erreurs
<Else> ... </Else>		svdh	C
Contient des directives qui ne s'appliquent que si la +condition correspondant à la section `<If>` ou `<ElseIf>` précédente n'est pas satisfaite par la +requête à l'exécution
<ElseIf `expression`> ... </ElseIf>		svdh	C
Contient des directives qui ne s'appliquent que si la +condition correspondante est satisfaite par une requête à l'exécution, +alors que la condition correspondant à la section `<If>` ou `<ElseIf>` précédente ne l'était pas.
EnableExceptionHook On\|Off	Off	s	M
Active un hook ("point d'accrochage logiciel") qui exécute des +gestionnaires d'exception après un crash
EnableMMAP On\|Off	On	svdh	C
Utilise la projection en mémoire (Memory-Mapping) pour +lire les fichiers pendant qu'ils sont servis
EnableSendfile On\|Off	Off	svdh	C
Utilise le support sendfile du noyau pour servir les +fichiers aux clients
Error `message`		svdh	C
Interrompt la lecture de la configuration avec un message +d'erreur personnalisé
ErrorDocument `code erreur` `document`		svdh	C
Document que le serveur renvoie au client en cas +d'erreur
ErrorLog `chemin fichier`\|syslog[:`facility`]	logs/error_log (Uni +	sv	C
Définition du chemin du journal des erreurs
ErrorLogFormat [connection\|request] `format`		sv	C
Spécification du format des entrées du journal des erreurs
Example		svdh	X
Directive de démonstration pour illustrer l'API des modules +Apache
ExpiresActive On\|Off	Off	svdh	E
Active la génération d'en-têtes +`Expires`
ExpiresByType `type MIME` +`<code>secondes`		svdh	E
Définition de la valeur de l'en-tête `Expires` +en fonction du type MIME
ExpiresDefault `<code>secondes`		svdh	E
Mode de calcul par défaut de la date +d'expiration
ExtendedStatus On\|Off	Off	s	C
Extrait des informations d'état étendues pour chaque +requête
ExtFilterDefine `nom_filtre` `paramètres`		s	E
Définit un filtre externe
ExtFilterOptions `option` [`option`] ...	NoLogStderr	d	E
Configure les options de +`mod_ext_filter`
FallbackResource disabled \| `url-locale`		svdh	B
Définit une URL par défaut pour les requêtes qui ne ciblent +aucun fichier
FileETag `composant` ...	MTime Size	svdh	C
Caractéristiques de fichier utilisées lors de la génération +de l'en-tête de réponse HTTP ETag pour les fichiers statiques
<Files `nom fichier`> ... </Files>		svdh	C
Contient des directives qui s'appliquent aux fichiers +précisés
<FilesMatch `expression rationnelle`> ... +</FilesMatch>		svdh	C
Contient des directives qui s'appliquent à des fichiers +spécifiés sous la forme d'expressions rationnelles
FilterChain [+=-@!]`nom_filtre` `...`		svdh	B
Configure la chaîne de filtrage
FilterDeclare `nom_filtre` `[type]`		svdh	B
Déclare un filtre intelligent
FilterProtocol `nom_filtre` [`nom_fournisseur`] + `drapeaux_protocole`		svdh	B
Vérifie le respect du protocole HTTP
FilterProvider `nom_filtre` `nom_fournisseur` + `expression`		svdh	B
Enregistre un filtre de contenu
FilterTrace `nom_filtre` `niveau`		svd	B
Obtention d'informations de débogage/diagnostique en +provenance de `mod_filter`
FirehoseConnectionInput `[ block \| nonblock ]` `filename`		s	E
Capture traffic coming into the server on each connection
FirehoseConnectionOutput `[ block \| nonblock ]` `filename`		s	E
Capture traffic going out of the server on each connection
FirehoseProxyConnectionInput `[ block \| nonblock ]` `filename`		s	E
Capture traffic coming into the back of mod_proxy
FirehoseProxyConnectionOutput `[ block \| nonblock ]` `filename`		s	E
Capture traffic sent out from the back of mod_proxy
FirehoseRequestInput `[ block \| nonblock ]` `filename`		s	E
Capture traffic coming into the server on each request
FirehoseRequestOutput `[ block \| nonblock ]` `filename`		s	E
Capture traffic going out of the server on each request
ForceLanguagePriority None\|Prefer\|Fallback [Prefer\|Fallback]	Prefer	svdh	B
Action à entreprendre si un document acceptable unique +n'est pas trouvé
ForceType `type médium`\|None		dh	C
Force le type de médium spécifié dans le champ d'en-tête +HTTP Content-Type pour les fichiers correspondants
ForensicLog `nom-fichier`\|`pipe`		sv	E
Définit le nom de fichier du journal légal
GlobalLog `file`\|`pipe`\|`provider` +`format`\|`nickname` +[env=[!]`environment-variable`\| +expr=`expression`]		s	B
Définit le nom et le format du fichier journal
GprofDir `/tmp/gprof/`\|`/tmp/gprof/`%		sv	C
Répertoire dans lequel écrire les données de profiling +gmon.out.
GracefulShutdownTimeout `seconds`	0	s	M
Spécifie le délai maximum après lequel le serveur va +s'arrêter dans le cas d'un arrêt "en douceur"
Group `groupe unix`	#-1	s	B
Groupe sous lequel le serveur va traiter les +requêtes
H2CopyFiles on\|off	off	svdh	E
Determine file handling in responses
H2Direct on\|off	on for h2c, off for +	sv	E
H2 Direct Protocol Switch
H2EarlyHints on\|off	off	sv	E
Determine sending of 103 status codes
H2MaxSessionStreams n	100	sv	E
Maximum number of active streams per HTTP/2 session.
H2MaxWorkerIdleSeconds n	600	s	E
Maximum number of seconds h2 workers remain idle until shut down.
H2MaxWorkers n		s	E
Maximum number of worker threads to use per child process.
H2MinWorkers n		s	E
Minimal number of worker threads to use per child process.
H2ModernTLSOnly on\|off	on	sv	E
Require HTTP/2 connections to be "modern TLS" only
H2Push on\|off	on	sv	E
H2 Server Push Switch
H2PushDiarySize n	256	sv	E
H2 Server Push Diary Size
H2PushPriority mime-type [after\|before\|interleaved] [weight]	* After 16	sv	E
H2 Server Push Priority
H2PushResource [add] path [critical]		svdh	E
Declares resources for early pushing to the client
H2SerializeHeaders on\|off	off	sv	E
Serialize Request/Response Processing Switch
H2SessionExtraFiles n		sv	E
Number of Extra File Handles
H2StreamMaxMemSize bytes	65536	sv	E
Maximum amount of output data buffered per stream.
H2TLSCoolDownSecs seconds	1	sv	E
-
H2TLSWarmUpSize amount	1048576	sv	E
-
H2Upgrade on\|off	on for h2c, off for +	sv	E
H2 Upgrade Protocol Switch
H2WindowSize bytes	65535	sv	E
Size of Stream Window for upstream data.
Header [`condition`] add\|append\|echo\|edit\|edit*\|merge\|set\|setifempty\|unset\|note +`en-tête` [[expr=]`valeur` +[`remplacement`] +[early\|env=[!]`variable`\|expr=`expression`]] +		svdh	E
Configure les en-têtes d'une réponse HTTP
HeaderName `nom fichier`		svdh	B
Nom du fichier qui sera inséré au début de la page +contenant l'index
HeartbeatAddress `addr:port`		s	X
Adresse multicast à laquelle envoyer les requêtes +heartbeat
HeartbeatListen`addr:port`		s	X
Adresse multicast d'écoute des requêtes entrantes heartbeat
HeartbeatMaxServers `nombre-de-serveurs`	10	s	X
Spécifie le nombre maximal de serveurs qui pourront envoyer +des requêtes heartbeat à ce serveur.
HeartbeatStorage `chemin fichier`	logs/hb.dat	s	X
Chemin vers le stockage des données heartbeat
HeartbeatStorage `chemin-fichier`	logs/hb.dat	s	X
Indique le chemin permettant de lire les données +heartbeat
HostnameLookups On\|Off\|Double	Off	svd	C
Active la recherche DNS sur les adresses IP des +clients
HttpProtocolOptions [Strict\|Unsafe] [RegisteredMethods\|LenientMethods] + [Allow0.9\|Require1.0]	Strict LenientMetho +	sv	C
Modifie les contraintes sur les messages des requêtes HTTP
IdentityCheck On\|Off	Off	svd	E
Active la journalisation de l'identité RFC 1413 de +l'utilisateur distant
IdentityCheckTimeout `secondes`	30	svd	E
Détermine le délai d'attente pour les requêtes +ident
IdleShutdown seconds	0	s	E
Enable shutting down the httpd when it is idle for some time.
<If `expression`> ... </If>		svdh	C
Contient des directives qui ne s'appliquent que si une +condition est satisfaite au cours du traitement d'une +requête
<IfDefine [!]`paramètre`> ... + </IfDefine>		svdh	C
Contient des directives qui ne s'appliqueront que si un +test retourne "vrai" au démarrage du serveur
<IfFile [!]`parameter-name`> ... + </IfFile>		svdh	C
Regroupe des directives qui ne seront traitées que si un fichier +existe au démarrage
<IfModule [!]`fichier module`\|`identificateur +module`> ... </IfModule>		svdh	C
Contient des directives qui ne s'appliquent qu'en fonction +de la présence ou de l'absence d'un module spécifique
<IfVersion [[!]`operator`] `version`> ... +</IfVersion>		svdh	E
contains version dependent configuration
ImapBase map\|referer\|`URL`	http://nom_serveur/ +	svdh	B
Valeur par défaut de la directive `base` des +fichiers imagemap
ImapDefault error\|nocontent\|map\|referer\|`URL`	nocontent	svdh	B
Action à entreprendre par défaut lorsqu'un fichier imagemap +est invoqué avec des coordonnées qui ne correspondent à aucune +cible
ImapMenu none\|formatted\|semiformatted\|unformatted	formatted	svdh	B
Action à entreprendre si aucune coordonnée n'est fournie +lorsqu'on invoque un fichier imagemap
Include `chemin-fichier`\|`chemin-répertoire`\|`wildcard`		svd	C
Inclut d'autres fichiers de configuration dans un des +fichiers de configuration du serveur
IncludeOptional +`chemin-fichier`\|`chemin-répertoire`\|`wildcard`		svd	C
Inclusion de fichiers dans le fichier de configuration
IndexHeadInsert `"marque ..."`		svdh	B
Insère du texte dans la section HEAD de la page +d'index.
IndexIgnore `fichier` [`fichier`] ...	"."	svdh	B
Ajouts à la liste des fichiers à cacher lors de l'affichage +de l'index d'un répertoire
IndexIgnoreReset ON\|OFF		svdh	B
Vide la liste des fichiers à cacher lors de l'affichage du +contenu d'un répertoire
IndexOptions [+\|-]`option` [[+\|-]`option`] +...		svdh	B
Diverses options de configuration pour l'indexation d'un +répertoire
IndexOrderDefault Ascending\|Descending +Name\|Date\|Size\|Description	Ascending Name	svdh	B
Définit l'ordre d'affichage par défaut d'un index de +répertoire
IndexStyleSheet `chemin-url`		svdh	B
Ajoute une feuille de style CSS à l'index du +répertoire
InputSed `commande-sed`		dh
Commande sed à exécuter pour le filtrage des données d'une +requête (en général des données `POST`)
ISAPIAppendLogToErrors on\|off	off	svdh	B
Enregistrement des requêtes +`HSE_APPEND_LOG_PARAMETER` de la part des extensions ISAPI +dans le journal des erreurs
ISAPIAppendLogToQuery on\|off	on	svdh	B
Enregistre les requêtes +`HSE_APPEND_LOG_PARAMETER` de la part des extensions ISAPI +dans la partie arguments de la requête
ISAPICacheFile `chemin-fichier` +[`chemin-fichier`] +...		sv	B
Fichiers .dll ISAPI devant être chargés au +démarrage
ISAPIFakeAsync on\|off	off	svdh	B
Emulation du support des entrées/sorties asynchrones pour +les appels ISAPI
ISAPILogNotSupported on\|off	off	svdh	B
Journalisation des demandes de fonctionnalités non +supportées de la part des extensions ISAPI
ISAPIReadAheadBuffer `taille`	49152	svdh	B
Taille du tampon de lecture anticipée envoyé aux extensions +ISAPI
KeepAlive On\|Off	On	sv	C
Active les connexions HTTP persistantes
KeepAliveTimeout `nombre`[ms]	5	sv	C
Durée pendant laquelle le serveur va attendre une requête +avant de fermer une connexion persistante
KeptBodySize `taille maximale en octets`	0	d	B
Conserve le corps de la requête à concurrence de la taille +maximale spécifiée, pour une utilisation éventuelle par des filtres +comme mod_include.
LanguagePriority `langage-MIME` [`langage-MIME`] +...		svdh	B
L'ordre de priorité des variantes de langages pour les +cas où le client n'a pas formulé de préférences
LDAPCacheEntries `nombre`	1024	s	E
Nombre maximum d'entrées dans le cache LDAP +primaire
LDAPCacheTTL `secondes`	600	s	E
Durée pendant laquelle les entrées du cache restent +valides.
LDAPConnectionPoolTTL `n`	-1	sv	E
Désactive les connexions d'arrière-plan qui sont restées +inactives trop longtemps au sein du jeu de connexions.
LDAPConnectionTimeout `secondes`		s	E
Spécifie le délai d'attente en secondes de la socket de +connexion
LDAPLibraryDebug `7`		s	E
Active le débogage dans le SDK LDAP
LDAPOpCacheEntries `nombre`	1024	s	E
Nombre d'entrées utilisées pour mettre en cache les +opérations de comparaison LDAP
LDAPOpCacheTTL `secondes`	600	s	E
Durée pendant laquelle les entrées du cache d'opérations +restent valides
LDAPReferralHopLimit `nombre`		dh	E
Le nombre maximum de redirections vers des serveurs +alternatifs (referrals) avant l'abandon de la requête +LDAP.
LDAPReferrals `On\|Off\|default`	On	dh	E
Active la redirection vers des serveurs alternatifs au +cours des requêtes vers le serveur LDAP.
LDAPRetries `nombre d'essais`	3	s	E
Définit le nombre maximum de tentatives de connexions au +serveur LDAP.
LDAPRetryDelay `secondes`	0	s	E
Définit le temps d'attente avant un autre essai de connexion au +serveur LDAP.
LDAPSharedCacheFile `chemin-fichier`		s	E
Définit le fichier du cache en mémoire +partagée
LDAPSharedCacheSize `octets`	500000	s	E
Taille en octets du cache en mémoire partagée
LDAPTimeout `secondes`	60	s	E
Spécifie le délai d'attente pour les opérations de +recherche et d'identification LDAP en secondes
LDAPTrustedClientCert `type` +`chemin/nom-fichier/alias` `[mot de passe]`		svdh	E
Définit le nom de fichier contenant un certificat client ou +un alias renvoyant vers un certificat client spécifique à une connexion. +Tous les SDK LDAP ne supportent pas les certificats clients par +connexion.
LDAPTrustedGlobalCert `type` +`chemin/nom-fichier` `[mot de passe]`		s	E
Définit le nom de fichier ou la base de données contenant +les Autorités de Certification de confiance globales ou les certificats +clients globaux
LDAPTrustedMode `type`		sv	E
Spécifie le mode (SSL ou TLS) à utiliser lors de la +connexion à un serveur LDAP.
LDAPVerifyServerCert `On\|Off`	On	s	E
Force la vérification du certificat du +serveur
<Limit `méthode` [`méthode`] ... > ... + </Limit>		dh	C
Limite les contrôles d'accès que la section contient à +certaines méthodes HTTP
<LimitExcept `méthode` [`méthode`] ... > ... + </LimitExcept>		dh	C
Applique les contrôles d'accès à toutes les méthodes HTTP, +sauf celles qui sont spécifiées
LimitInternalRecursion `nombre` [`nombre`]	10	sv	C
Détermine le nombre maximal de redirections internes et de +sous-requêtes imbriquées
LimitRequestBody `octets`	0	svdh	C
limite la taille maximale du corps de la requête HTTP +envoyée par le client
LimitRequestFields `nombre`	100	sv	C
Limite le nombre de champs d'en-tête autorisés dans une +requête HTTP
LimitRequestFieldSize `octets`	8190	sv	C
Dédinit la taille maximale autorisée d'un en-tête de +requête HTTP
LimitRequestLine `octets`	8190	sv	C
Définit la taille maximale d'une ligne de requête +HTTP
LimitXMLRequestBody `octets`	1000000	svdh	C
Définit la taille maximale du corps d'une requête au format +XML
Listen [`adresse IP`:]`numéro port` +[`protocole`]		s	M
Les adresses IP et ports sur lesquels le serveur écoute
ListenBacklog `backlog`		s	M
Longueur maximale de la liste d'attente des +connexions
ListenCoresBucketsRatio `ratio`	0 (disabled)	s	M
Rapport entre le nombre de coeurs de processeur activés et +le nombre de segments d'écoute
LoadFile nom-fichier [nom-fichier] ...		sv	E
Liaison du fichier objet ou de la bibliothèque +spécifié
LoadModule module nom-fichier		sv	E
Liaison avec le serveur du fichier objet ou de la +bibliothèque spécifié, et ajout de ce dernier à la liste des modules +actifs
<Location + `chemin URL`\|`URL`> ... </Location>		sv	C
N'applique les directives contenues qu'aux URLs +spécifiées
<LocationMatch + `regex`> ... </LocationMatch>		sv	C
N'applique les directives contenues qu'aux URLs +correspondant à une expression rationnelle
LogFormat `format`\|`alias` +[`alias`]	"%h %l %u %t \"%r\" +	sv	B
Décrit un format utilisable dans un fichier +journal
LogIOTrackTTFB ON\|OFF	OFF	svdh	E
Permet d'enregistrer le délai avant le premier octet (time +to first byte - TTFB)
LogLevel [`module`:]`niveau` + [`module`:`niveau`] ... +	warn	svd	C
Contrôle la verbosité du journal des erreurs
LogLevel `ipaddress`[/`prefixlen`] + [`module`:]`level` [`module`:`level`] ... +		sv	C
Surcharge la verbosité du journal des erreurs pour certains +clients
LogMessage `message` +[hook=`hook`] [expr=`expression`] +		d	X
Enregistre des messages personnalisés dans le journal des +erreurs
LuaAuthzProvider provider_name /path/to/lua/script.lua function_name		s	X
Branche une fonction fournisseur d'autorisation dans `mod_authz_core` +
LuaCodeCache stat\|forever\|never	stat	svdh	X
Configure le cache de code compilé.
LuaHookAccessChecker /chemin/vers/lua/script.lua hook_function_name [early\|late]		svdh	X
Fournit un point d'entrée pour la phase access_checker du +traitement de la requête
LuaHookAuthChecker /chemin/vers/lua/script.lua hook_function_name [early\|late]		svdh	X
Fournit un point d'entrée pour la phase auth_checker du +traitement de la requête
LuaHookCheckUserID /path/to/lua/script.lua hook_function_name		svdh	X
Fournit un point d'entrée pour la phase check_user_id du +traitement de la requête
LuaHookFixups /chemin/vers/lua/script.lua hook_function_name		svdh	X
Fournit un point d'entrée pour la phase de correction du +traitement de la requête
LuaHookInsertFilter /chemin/vers/lua/script.lua hook_function_name		svdh	X
Fournit un point d'entrée pour la phase insert_filter du +traitement de la requête
LuaHookLog /path/to/lua/script.lua log_function_name		svdh	X
Permet une insertion dans la phase de journalisation du +traitement d'une requête
LuaHookMapToStorage /chemin/vers/lua/script.lua hook_function_name		svdh	X
Fournit un point d'entrée pour la phase map_to_storage du +traitement de la requête
LuaHookTranslateName /chemin/vers/lua/script.lua nom_fonction_hook [early\|late]		sv	X
Fournit un point d'entrée à la phase du nom de +traduction du traitement de la requête
LuaHookTypeChecker /chemin/vers/lua/script.lua hook_function_name		svdh	X
Fournit un point d'entrée pour la phase type_checker du +traitement de la requête
LuaInherit none\|parent-first\|parent-last	parent-first	svdh	X
Contrôle la manière dont les sections de configuration +parentes sont fusionnées dans les enfants
LuaInputFilter filter_name /path/to/lua/script.lua function_name		s	X
Fournit une fonction Lua pour le filtrage en entrée
LuaMapHandler modele-uri /chemin/vers/lua/script.lua +[nom-fonction]		svdh	X
Met en correspondance un chemin avec un gestionnaire lua
LuaOutputFilter filter_name /path/to/lua/script.lua function_name		s	X
Fournit une fonction Lua pour le filtrage de contenu en +sortie
LuaPackageCPath /chemin/vers/include/?.soa		svdh	X
Ajoute un répertoire au package.cpath de lua
LuaPackagePath /chemin/vers/include/?.lua		svdh	X
Ajoute un répertoire au package.path de lua
LuaQuickHandler /path/to/script.lua hook_function_name		svdh	X
Fournit un point d'entrée pour la gestion rapide du +traitement de la requête
LuaRoot /chemin/vers/un/répertoire		svdh	X
Spécifie le chemin de base pour la résolution des chemins +relatifs dans les directives de mod_lua
LuaScope once\|request\|conn\|thread\|server [min] [max]	once	svdh	X
Une valeur parmi once, request, conn, thread -- la valeur par défaut est once
+<Macro `nom` [`par1` .. `parN`]> +... </Macro>		svd	B
Définition d'une macro dans un fichier de configuration
MacroIgnoreBadNesting		svd	B
Ignore les avertissements et n'inscrit rien dans le journal à +propos d'une imbrication de Macros non conforme
MacroIgnoreEmptyArgs		svd	B
Ignore les avertissements et n'inscrit rien dans le journal à +propos des arguments de Macro vides
MaxConnectionsPerChild `number`	0	s	M
Limite le nombre de connexions qu'un processus enfant va +traiter au cours de son fonctionnement
MaxKeepAliveRequests `nombre`	100	sv	C
Nombre de requêtes permises pour une connexion +persistante
MaxMemFree `KOctets`	2048	s	M
Quantité maximale de mémoire que l'allocateur principal est +autorisé à conserver sans appeler `free()`
MaxRangeOverlaps default \| unlimited \| none \| `nombre de + chevauchements`	20	svd	C
Nombre de chevauchements de segments de données autorisé + (par exemple `100-200,150-300`) avant le renvoi de la + ressource complète
MaxRangeReversals default \| unlimited \| none \| `nombre + d'inversions`	20	svd	C
Nombre d'inversions d'ordre autorisé dans la spécification des + segments de données (par exemple `100-200,50-70`) avant le renvoi de la + ressource complète
MaxRanges default \| unlimited \| none \| `nombre de segments`	200	svd	C
Nombre de segments de données autorisé avant le renvoi de +l'intégralité de la ressource
MaxRequestWorkers `nombre`		s	M
Nombre maximum de connexions pouvant être traitées +simultanément
MaxSpareServers `nombre`	10	s	M
Nombre maximum de processus serveurs enfants +inactifs
MaxSpareThreads `nombre`		s	M
Nombre maximum de threads inactifs
MaxThreads `nombre`	2048	s	M
Définit le nombre maximum de threads esclaves
MemcacheConnTTL num[units]	15s	sv	E
Durée de conservation des connexions inactives
MergeTrailers [on\|off]	off	sv	C
Détermine si les données supplémentaires (trailers) sont +fusionnées avec les en-têtes
MetaDir `répertoire`	.web	svdh	E
Le nom du répertoire où trouver les fichiers de +métainformations dans le style du CERN
MetaFiles on\|off	off	svdh	E
Active le traitement des métafichiers du CERN
MetaSuffix `suffixe`	.meta	svdh	E
Suffixe du fichier contenant les métainformations dans le +style du CERN
MimeMagicFile `chemin-fichier`		sv	E
Active la détermination du type MIME en se basant sur le +contenu du fichier et en utilisant le fichier magique +spécifié
MinSpareServers `nombre`	5	s	M
Nombre minimum de processus serveurs enfants +inactifs
MinSpareThreads `nombre`		s	M
Nombre minimum de threads inactifs qui seront disponibles +pour pouvoir traiter les pics de requêtes
MMapFile `chemin fichier` [`chemin_fichier`] ...		s	X
Charge au démarrage une liste de fichiers en +mémoire
ModemStandard V.21\|V.26bis\|V.32\|V.34\|V.92		d	X
Standard de modem à simuler
ModMimeUsePathInfo On\|Off	Off	d	B
Indique à `mod_mime` de traiter les éléments +de `path_info` en tant que parties du nom de +fichier
MultiviewsMatch Any\|NegotiatedOnly\|Filters\|Handlers +[Handlers\|Filters]	NegotiatedOnly	svdh	B
Les types de fichiers qui seront inclus lors d'une +recherche de correspondance de fichier avec les vues multiples +(MultiViews)
Mutex `mécanisme` [default\|`nom-mutex`] ... [OmitPID]	default	s	C
Définit les mécanismes de mutex et le repertoire du fichier +verrou pour tous les mutex ou seulement les mutex spécifiés
NameVirtualHost `adresse`[:`port`]		s	C
OBSOLETE : Définit une adresse IP pour les serveurs virtuels à base de +nom
NoProxy `domaine` [`domaine`] ...		sv	E
Serveurs, domaines ou réseaux auquels on se connectera +directement
NWSSLTrustedCerts `nom-fichier` +[`nom-fichier`] ...		s	B
Liste de certificats clients supplémentaires
NWSSLUpgradeable [`adresse-IP`:]`num-port`		s	B
Permet de promouvoir une connexion non SSL au statut de +connexion SSL à la demande
Options + [+\|-]`option` [[+\|-]`option`] ...	FollowSymlinks	svdh	C
Définit les fonctionnalités disponibles pour un répertoire +particulier
Order `ordre`	Deny,Allow	dh	E
Définit le statut d'accès par défaut et l'ordre dans lequel +les directives `Allow` et +`Deny` sont évaluées.
OutputSed `commande-sed`		dh
Commande sed pour le filtrage des contenus de type +réponse
PassEnv `var-env` [`var-env`] +...		svdh	B
Transmet des variables d'environnement depuis le +shell
PidFile `nom fichier`	httpd.pid	s	M
Ficher dans lequel le serveur enregistre l'identificateur +de processus du démon
PolicyConditional `ignore\|log\|enforce`		svd	E
Enable the conditional request policy.
PolicyConditionalURL `url`		svd	E
URL describing the conditional request policy.
PolicyEnvironment `variable` `log-value` `ignore-value`		svd	E
Override policies based on an environment variable.
PolicyFilter `on\|off`		svd	E
Enable or disable policies for the given URL space.
PolicyKeepalive `ignore\|log\|enforce`		svd	E
Enable the keepalive policy.
PolicyKeepaliveURL `url`		svd	E
URL describing the keepalive policy.
PolicyLength `ignore\|log\|enforce`		svd	E
Enable the content length policy.
PolicyLengthURL `url`		svd	E
URL describing the content length policy.
PolicyMaxage `ignore\|log\|enforce` `age`		svd	E
Enable the caching minimum max-age policy.
PolicyMaxageURL `url`		svd	E
URL describing the caching minimum freshness lifetime policy.
PolicyNocache `ignore\|log\|enforce`		svd	E
Enable the caching no-cache policy.
PolicyNocacheURL `url`		svd	E
URL describing the caching no-cache policy.
PolicyType `ignore\|log\|enforce` `type` [ `type` [ ... ]]		svd	E
Enable the content type policy.
PolicyTypeURL `url`		svd	E
URL describing the content type policy.
PolicyValidation `ignore\|log\|enforce`		svd	E
Enable the validation policy.
PolicyValidationURL `url`		svd	E
URL describing the content type policy.
PolicyVary `ignore\|log\|enforce` `header` [ `header` [ ... ]]		svd	E
Enable the Vary policy.
PolicyVaryURL `url`		svd	E
URL describing the content type policy.
PolicyVersion `ignore\|log\|enforce` `HTTP/0.9\|HTTP/1.0\|HTTP/1.1`		svd	E
Enable the version policy.
PolicyVersionURL `url`		svd	E
URL describing the minimum request HTTP version policy.
PrivilegesMode FAST\|SECURE\|SELECTIVE	FAST	svd	X
Fait un compromis entre d'une part l'efficacité et la +vitesse de traitement et d'autre part la sécurité à l'encontre des codes +malicieux supportant les privilèges.
Protocol `protocole`		sv	C
Protocole pour une socket d'écoute
ProtocolEcho On\|Off	Off	sv	X
Active ou désactive le serveur d'écho
Protocols `protocole` ...	http/1.1	sv	C
Protocoles disponibles pour un serveur virtuel ou non
ProtocolsHonorOrder On\|Off	On	sv	C
Détermine qui du client ou du serveur détermine l'ordre + des protocoles au cours de la négociation de la connexion
<Proxy `url-avec-jokers`> ...</Proxy>		sv	E
Conteneur de directives s'appliquant à des ressources +mandatées
ProxyAddHeaders Off\|On	On	svd	E
Ajoute des informations à propos du mandataire aux +en-têtes X-Forwarded-*
ProxyBadHeader IsError\|Ignore\|StartBody	IsError	sv	E
Détermine la manière de traiter les lignes d'en-tête +incorrectes d'une réponse
ProxyBlock *\|`nom d'hôte`\|`nom d'hôte partiel` +[`nom d'hôte`\|`nom d'hôte partiel`]...		sv	E
Interdit les requêtes mandatées vers certains hôtes
ProxyDomain `Domaine`		sv	E
Nom de domaine par défaut pour les requêtes +mandatées
ProxyErrorOverride On\|Off	Off	svd	E
Outrepasser les pages d'erreur pour les contenus +mandatés
ProxyExpressDBMFile <chemin>		sv	E
Chemin du fichier DBM.
ProxyExpressDBMFile <type>		sv	E
Type de fichier DBM.
ProxyExpressEnable [on\|off]		sv	E
Active la fonctionnalité du module.
ProxyFCGIBackendType FPM\|GENERIC	FPM	svdh	E
Spécifie le type de l'application FastCGI d'arrière-plan
ProxyFCGISetEnvIf `conditional-expression` + `environment-variable-name` + `value-expression`		svdh	E
Allow variables sent to FastCGI servers to be fixed up
ProxyFtpDirCharset `jeu-caractères`	ISO-8859-1	svd	E
Définit le jeu de caractères des listings FTP +mandatés
ProxyFtpEscapeWildcards [on\|off]		svd	E
Les caractères génériques dans les noms de fichiers +doivent-ils être échappés lorsqu'ils sont envoyés au serveur FTP ?
ProxyFtpListOnWildcard [on\|off]		svd	E
Les caractères génériques dans les noms de fichiers +demandés doivent-ils déclencher l'affichage d'un listing ?
ProxyHCExpr name {ap_expr expression}		sv	E
Creates a named condition expression to use to determine health of the backend based on its response.
ProxyHCTemplate name parameter=setting <...>		sv	E
Creates a named template for setting various health check parameters
ProxyHCTPsize <size>		sv	E
Sets the size of the threadpool used for the health check workers.
ProxyHTMLBufSize `nb-octets`		svd	B
Définit l'incrément de la taille du tampon, ainsi que sa +taille initiale, pour la mise en +tampon des scripts en ligne et des feuilles de style.
ProxyHTMLCharsetOut `jeu-de-caractères \| *`		svd	B
Spécifie un jeu de caractères pour la sortie de +mod_proxy_html.
ProxyHTMLDocType `HTML\|XHTML [Legacy]` OU + ProxyHTMLDocType `fpi [SGML\|XML]` OU + ProxyHTMLDocType `html5` OU + ProxyHTMLDocType `auto`	auto (2.5/trunk ver +	svd	B
Définit une déclaration de type de document HTML ou XHTML.
ProxyHTMLEnable `On\|Off`	Off	svd	B
Permet d'activer/désactiver le filtre proxy_html.
ProxyHTMLEvents `attribut [attribut ...]`		svd	B
Spécifie les attributs à traiter comme des évènements de +type scripting.
ProxyHTMLExtended `On\|Off`	Off	svd	B
Détermine si l'on doit corriger les liens dans les scripts +en ligne, les feuilles de style et les évènements de type scripting.
ProxyHTMLFixups `[lowercase] [dospath] [reset]`		svd	B
Corrige les erreurs HTML simples.
ProxyHTMLInterp `On\|Off`	Off	svd	B
Active la réinterprétation des règles +`ProxyHTMLURLMap` pour chaque requête.
ProxyHTMLLinks `élément attribut [attribut2 ...]`		svd	B
Spécifie les éléments HTML dont les attributs d'URL doivent +être réécrits.
ProxyHTMLMeta `On\|Off`	Off	svd	B
Active ou désactive une préinterprétation supplémentaire +des métadonnées dans les sections HTML `<head>`.
ProxyHTMLStripComments `On\|Off`	Off	svd	B
Détermine si les commentaires HTML doivent être supprimés.
ProxyHTMLURLMap `modèle-source modèle-cible [drapeaux] [cond]`		svd	B
Définit une règle de réécriture des liens HTML
ProxyIOBufferSize `octets`	8192	sv	E
Détermine la taille du tampon interne de transfert de +données
<ProxyMatch `regex`> ...</ProxyMatch>		sv	E
Conteneur de directives s'appliquant à des ressources +mandatées correspondant à une expression rationnelle
ProxyMaxForwards `nombre`	-1	sv	E
Nombre maximum de mandataires à travers lesquelles une +requête peut être redirigée
ProxyPass [`chemin`] !\|`url` [`clé=valeur` + `[clé=valeur` ...]] [nocanon] [interpolate] [noquery]		svd	E
Référencer des serveurs distants depuis +l'espace d'URLs du serveur local
ProxyPassInherit On\|Off	On	sv	E
Héritage des directives ProxyPass définies au niveau du +serveur principal
ProxyPassInterpolateEnv On\|Off	Off	svd	E
Active l'interpolation des variables d'environnement dans +les configurations de mandataires inverses
ProxyPassMatch [`regex`] !\|`url` +[`clé=valeur` + `[clé=valeur` ...]]		svd	E
Fait correspondre des serveurs distants dans l'espace d'URL +du serveur local en utilisant des expressions rationnelles
ProxyPassReverse [`chemin`] `url` +[`interpolate`]		svd	E
Ajuste l'URL dans les en-têtes de la réponse HTTP envoyée +par un serveur mandaté en inverse
ProxyPassReverseCookieDomain `domaine-interne` +`domaine-public` [`interpolate`]		svd	E
Ajuste la chaîne correspondant au domaine dans les en-têtes +Set-Cookie en provenance d'un serveur mandaté
ProxyPassReverseCookiePath `chemin-interne` +`chemin-public` [`interpolate`]		svd	E
Ajuste la chaîne correspondant au chemin dans les en-têtes +Set-Cookie en provenance d'un serveur mandaté
ProxyPreserveHost On\|Off	Off	svd	E
Utilise l'en-tête de requête entrante Host pour la requête +du mandataire
ProxyReceiveBufferSize `octets`	0	sv	E
Taille du tampon réseau pour les connexions mandatées HTTP +et FTP
ProxyRemote `comparaison` `serveur-distant`		sv	E
Mandataire distant à utiliser pour traiter certaines +requêtes
ProxyRemoteMatch `regex` `serveur-distant`		sv	E
Le mandataire distant à utiliser pour traiter les requêtes +correspondant à une expression rationnelle
ProxyRequests On\|Off	Off	sv	E
Active la fonctionnalité (standard) de mandataire +direct
ProxySCGIInternalRedirect On\|Off\|`Headername`	On	svd	E
Active ou désactive les réponses de redirection interne en +provenance du serveur cible.
ProxySCGISendfile On\|Off\|`nom-en-tête`	Off	svd	E
Active l'évaluation du pseudo en-tête de réponse +`X-Sendfile`
ProxySet `url` `clé=valeur [clé=valeur ...]`		d	E
Définit différents paramètres relatifs à la répartition de +charge des mandataires et aux membres des groupes de répartition de +charge
ProxySourceAddress `adresse`		sv	E
Définit l'adresse IP locale pour les connexions mandatées +sortantes
ProxyStatus Off\|On\|Full	Off	sv	E
Affiche l'état du répartiteur de charge du mandataire dans +mod_status
ProxyTimeout `secondes`		sv	E
Délai d'attente réseau pour les requêtes +mandatées
ProxyVia On\|Off\|Full\|Block	Off	sv	E
Information fournie dans l'en-tête de réponse HTTP +`Via` pour les requêtes mandatées
ProxyWebsocketAsync ON\|OFF		sv	E
Instructs this module to try to create an asynchronous tunnel
ProxyWebsocketAsyncDelay `num`[ms]	0	sv	E
Sets the amount of time the tunnel waits synchronously for data
ProxyWebsocketIdleTimeout `num`[ms]	0	sv	E
Sets the maximum amount of time to wait for data on the websockets tunnel
QualifyRedirectURL ON\|OFF	OFF	svd	C
Vérifie si la variable d'environnement REDIRECT_URL est +pleinement qualifiée
ReadmeName `nom-fichier`		svdh	B
Nom du fichier dont le contenu sera inséré à la fin de +l'index
ReceiveBufferSize `octets`	0	s	M
Taille du tampon TCP en entrée
Redirect [`état`] [`URL-path`] +`URL`		svdh	B
Envoie une redirection externe demandant au client +d'effectuer une autre requête avec une URL différente
RedirectMatch [`état`] `regex` +`URL`		svdh	B
Envoie une redirection externe faisant appel aux +expressions rationnelles pour la mise en correspondance de l'URL +courante
RedirectPermanent `chemin URL` `URL`		svdh	B
Envoie une redirection externe permanente demandant au +client d'effectuer une nouvelle requête avec une URL +différente
RedirectTemp `chemin URL` `URL`		svdh	B
Envoie une redirection externe temporaire demandant au +client d'effectuer une nouvelle requête avec une URL +différente
ReflectorHeader `en-tête-entrée` `[en-tête-sortie]`		svdh	B
Renvoie un en-tête d'entrée dans les en-têtes de sortie
RegisterHttpMethod `méthode` [`méthode` [...]]		s	C
Enregistrement de méthodes HTTP non standards
RemoteIPHeader `en-tête`		sv	B
Définit le champ d'en-tête qui contiendra les adresses IP +du client
RemoteIPInternalProxy +`ip-mandataire`\|`ip-mandataire/sous-réseau`\|`nom-hôte` ...		sv	B
Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader
RemoteIPInternalProxyList `nom-fichier`		sv	B
Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader
RemoteIPProxiesHeader `Nom_en-tête`		sv	B
Déclare le champ d'en-tête qui contiendra toutes les +adresses IP intermédiaires
RemoteIPProxyProtocol On\|Optional\|Off		sv	B
Active ou désactive la gestion du protocole PROXY
RemoteIPTrustedProxy +`ip-mandataire`\|`ip-mandataire/sous-réseau`\|`nom-hôte` ...		sv	B
Restreint les adresses IP clients dignes de +confiance pour présenter la valeur RemoteIPHeader
RemoteIPTrustedProxyList `nom-fichier`		sv	B
Restreint les adresses IP clients dignes de +confiance pour présenter la valeur RemoteIPHeader
RemoveCharset `extension` [`extension`] +...		vdh	B
Supprime toute association de jeu de caractères pour un +ensemble d'extensions de noms de fichiers
RemoveEncoding `extension` [`extension`] +...		vdh	B
Supprime toute association de codage de contenu pour un +ensemble d'extensions de noms de fichiers
RemoveHandler `extension` [`extension`] +...		vdh	B
Supprime toute association de gestionnaire à un ensemble +d'extensions de noms de fichiers
RemoveInputFilter `extension` [`extension`] +...		vdh	B
Supprime toute association de filtre en entrée à un +ensemble d'extensions de noms de fichiers
RemoveLanguage `extension` [`extension`] +...		vdh	B
Supprime toute association de langage à un ensemble +d'extensions de noms de fichiers
RemoveOutputFilter `extension` [`extension`] +...		vdh	B
Supprime toute association de filtre en sortie à un +ensemble d'extensions de noms de fichiers
RemoveType `extension` [`extension`] +...		vdh	B
Supprime toute association de type de contenu à un ensemble +d'extensions de noms de fichiers
RequestHeader add\|append\|edit\|edit*\|merge\|set\|setifempty\|unset +`en-tête` [[expr=]`valeur` +[`remplacement`] +[early\|env=[!]`variable`\|expr=`expression`]] +		svdh	E
Configure les en-têtes d'une requête HTTP
RequestReadTimeout +[header=`délai`[-`délai-maxi`][,MinRate=`taux-mini`] +[body=`délai`[-`délai-maxi`][,MinRate=`taux-mini`] +		sv	E
Définit des délais maximums pour la réception des en-têtes +et corps des requêtes en provenance du client. +
Require [not] `nom-entité` [`nom-entité`] +...		dh	B
Vérifie si un utilisateur authentifié a une +autorisation d'accès accordée par un fournisseur +d'autorisation.
<RequireAll> ... </RequireAll>		dh	B
Regroupe plusieurs directives d'autorisation dont aucune ne +doit échouer et dont au moins une doit retourner un résultat positif +pour que la directive globale retourne elle-même un résultat +positif.
<RequireAny> ... </RequireAny>		dh	B
Regroupe des directives d'autorisation dont au moins une +doit retourner un résultat positif pour que la directive globale +retourne elle-même un résultat positif.
<RequireNone> ... </RequireNone>		dh	B
Regroupe des directives d'autorisation dont aucune ne doit +retourner un résultat positif pour que la directive globale n'échoue +pas.
RewriteBase chemin_URL		dh	E
Définit l'URL de base pour les réécritures au niveau +répertoire
RewriteCond + chaîne_de_test expression_de_comparaison [drapeaux]		svdh	E
Définit une condition qui devra être satisfaite pour que +la réécriture soit effectuée +
RewriteEngine on\|off	off	svdh	E
Active ou désactive l'exécution du +moteur de réécriture
RewriteMap MapName MapType:MapSource MapTypeOptions +		sv	E
Définit une fonction de mise en correspondance pour la +recherche de mots-clés
RewriteOptions `Options`		svdh	E
Configure certaines options spéciales +pour le moteur de réécriture
RewriteRule + Modèle Substitution [drapeaux]		svdh	E
Définit les règles pour le moteur de réécriture
RLimitCPU `secondes`\|max [`secondes`\|max]		svdh	C
Limite le temps CPU alloué aux processus initiés par les +processus enfants d'Apache httpd
RLimitMEM `octets`\|max [`octets`\|max]		svdh	C
Limite la mémoire allouée aux processus initiés par les +processus enfants d'Apache httpd
RLimitNPROC `nombre`\|max [`nombre`\|max]		svdh	C
Limite le nombre de processus qui peuvent être initiés par +les processus initiés par les processus enfants d'Apache httpd
Satisfy Any\|All	All	dh	E
Interaction entre le contrôle d'accès en fonction de l'hôte +et l'authentification utilisateur
ScoreBoardFile `file-path`	apache_runtime_stat +	s	M
Chemin du fichier où sont stockées les données concernant +la coordination des processus enfants
Script `méthode` `script cgi`		svd	B
Active un script CGI dans le cas d'une méthode de requête +particulière.
ScriptAlias [`chemin URL`] +`chemin fichier`\|`chemin répertoire`		svd	B
Fait correspondre une URL à une zone du système de fichiers +et désigne la cible comme script CGI
ScriptAliasMatch `regex` +`chemin fichier`\|`chemin répertoire`		sv	B
Fait correspondre une URL à une zone du système de fichiers +en faisant appel aux expressions rationnelles et en désignant la cible +comme un script CGI
ScriptInterpreterSource Registry\|Registry-Strict\|Script	Script	svdh	C
Permet de localiser l'interpréteur des scripts +CGI
ScriptLog `chemin fichier`		sv	B
Chemin du fichier journal des erreurs du script +CGI
ScriptLogBuffer `octets`	1024	sv	B
Taille maximale des requêtes PUT ou POST qui seront +enregistrées dans le journal du script
ScriptLogLength `octets`	10385760	sv	B
Taille maximale du fichier journal des scripts +CGI
ScriptSock `chemin fichier`	cgisock	s	B
Le préfixe du nom de fichier du socket à utiliser pour +communiquer avec le démon CGI
SecureListen [`adresse-IP`:]`num-port` +`nom-certificat` [MUTUAL]		s	B
Active le chiffrement SSL pour le port +spécifié
SeeRequestTail On\|Off	Off	s	C
Détermine si mod_status affiche les 63 premiers caractères +d'une requête ou les 63 derniers, en supposant que la requête +elle-même possède plus de 63 caractères.
SendBufferSize `octets`	0	s	M
Taille du tampon TCP en sortie
ServerAdmin `adresse électronique`\|`URL`		sv	C
L'adresse électronique que le serveur inclut dans les +messages d'erreur envoyés au client
ServerAlias `nom serveur` [`nom serveur`] +...		v	C
Autres noms d'un serveur utilisables pour atteindre des +serveurs virtuels à base de nom
ServerLimit `nombre`		s	M
Limite supérieure de la définition du nombre de +processus
ServerName +[`protocole`://]`nom-de-domaine`\|`adresse-ip`[:`port`]		sv	C
Nom d'hôte et port que le serveur utilise pour +s'authentifier lui-même
ServerPath `chemin d'URL`		v	C
Nom de chemin d'URL hérité pour un serveur virtuel à base +de nom accédé par un navigateur incompatible
ServerRoot `chemin de répertoire`	/usr/local/apache	s	C
Racine du répertoire d'installation du +serveur
ServerSignature On\|Off\|EMail	Off	svdh	C
Définit un pied de page pour les documents générés par le +serveur
ServerTokens Major\|Minor\|Min[imal]\|Prod[uctOnly]\|OS\|Full	Full	s	C
Configure l'en-tête `Server` de la réponse +HTTP
Session On\|Off	Off	svdh	E
Ouvre une session pour le contexte courant
SessionCookieName `nom` `attributs`		svdh	E
Nom et attributs du cookie RFC2109 dans lequel la session +est stockée
SessionCookieName2 `nom` `attributs`		svdh	E
Nom et attributs pour le cookie RFC2965 dans lequel est +stockée la session
SessionCookieRemove On\|Off	Off	svdh	E
Détermine si les cookies de session doivent être supprimés +des en-têtes HTTP entrants
SessionCryptoCipher `algorithme`		svdh	X
L'algorithme à utiliser pour le chiffrement de la session
SessionCryptoDriver `nom` `[param[=valeur]]`		s	X
Le pilote de chiffrement à utiliser pour chiffrer les +sessions
SessionCryptoPassphrase `secret` [ `secret` ... ]		svdh	X
La clé utilisée pour chiffrer la session
SessionCryptoPassphraseFile `nom-fichier`		svd	X
Le fichier contenant les clés utilisées pour chiffrer la +session
SessionDBDCookieName `nom` `attributs`		svdh	E
Nom et attributs du cookie RFC2109 qui contient +l'identifiant de session
SessionDBDCookieName2 `nom` `attributs`		svdh	E
Nom et attributs du cookie RFC2965 qui contient +l'identifiant de session
SessionDBDCookieRemove On\|Off	On	svdh	E
Détermine si les cookies de session doivent être supprimés +des en-têtes HTTP entrants
SessionDBDDeleteLabel `étiquette`	deletesession	svdh	E
La requête SQL à utiliser pour supprimer des sessions de la +base de données
SessionDBDInsertLabel `étiquette`	insertsession	svdh	E
La requête SQL à utiliser pour insérer des sessions dans la +base de données
SessionDBDPerUser On\|Off	Off	svdh	E
Active une session propre à un utilisateur
SessionDBDSelectLabel `étiquette`	selectsession	svdh	E
La requête SQL à utiliser pour sélectionner des sessions +dans la base de données
SessionDBDUpdateLabel `étiquette`	updatesession	svdh	E
La requête SQL à utiliser pour mettre à jour des sessions +préexistantes dans la base de données
SessionEnv On\|Off	Off	svdh	E
Définit si le contenu de la session doit être enregistré +dans la variable d'environnement `HTTP_SESSION`
SessionExclude `chemin`		svdh	E
Définit les préfixes d'URLs pour lesquels une session sera +ignorée
SessionExpiryUpdateInterval `interval`	0 (mise à jour syst +	svdh	E
Définit le nombre de secondes dont la durée d'expiration d'une +session peut changer sans que cette session soit mise à jour
SessionHeader `en-tête`		svdh	E
Importation des mises à jour de session depuis l'en-tête de +réponse HTTP spécifié
SessionInclude `chemin`		svdh	E
Définit les préfixes d'URL pour lesquels une session est +valide
SessionMaxAge `durée de vie maximale`	0	svdh	E
Définit une durée de vie maximale pour la session en +secondes
SetEnv `var-env` [`valeur`]		svdh	B
Définit des variables d'environnement
SetEnvIf attribut + regex [!]env-variable[=valeur] + [[!]env-variable[=valeur]] ...		svdh	B
Définit des variables d'environnement en fonction des +attributs de la requête
SetEnvIfExpr expr + [!]env-variable[=valeur] + [[!]env-variable[=valeur]] ...		svdh	B
Définit des variables d'environnement en fonction d'une expression ap_expr
SetEnvIfNoCase attribut regex + [!]env-variable[=valeur] + [[!]env-variable[=valeur]] ...		svdh	B
Définit des variables d'environnement en fonction des +attributs de la requête sans tenir compte de la casse
SetHandler `handler-name`\|none\|`expression`		svdh	C
Force le traitement des fichiers spécifiés par un +gestionnaire particulier
SetInputFilter `filtre`[;`filtre`...]		svdh	C
Définit les filtres par lesquels vont passer les requêtes +client et les données POST
SetOutputFilter `filtre`[;`filtre`...]		svdh	C
Définit les filtres par lesquels vont passer les réponses +du serveur
SSIEndTag `tag`	"-->"	sv	B
Chaîne qui termine l'élément include
SSIErrorMsg `message`	"[an error occurred +	svdh	B
Message d'erreur affiché lorsqu'une erreur SSI +survient
SSIETag on\|off	off	dh	B
Définit si des en-têtes ETags sont générés par le serveur.
SSILastModified on\|off	off	dh	B
Définit si des en-têtes `Last-Modified` sont +générés par le serveur.
SSILegacyExprParser on\|off	off	dh	B
Active le mode de compatibilité pour les expressions +conditionnelles.
SSIStartTag `tag`	"<!--#"	sv	B
Chaîne qui marque le début d'un élément +include
SSITimeFormat `chaîne de formatage`	"%A, %d-%b-%Y %H:%M +	svdh	B
Configuration du format d'affichage des dates
SSIUndefinedEcho `chaîne`	"(none)"	svdh	B
Chaîne à afficher lorsqu'on tente d'extraire le contenu +d'une variable non définie
SSLCACertificateFile chemin-fichier		sv	E
Fichier contenant une concaténation des certificats de CA +codés en PEM pour l'authentification des clients
SSLCACertificatePath chemin-répertoire		sv	E
Répertoire des certificats de CA codés en PEM pour +l'authentification des clients
SSLCADNRequestFile chemin-fichier		sv	E
Fichier contenant la concaténation des certificats de CA +codés en PEM pour la définition de noms de CA acceptables
SSLCADNRequestPath chemin-répertoire		sv	E
Répertoire contenant des fichiers de certificats de CA +codés en PEM pour la définition de noms de CA acceptables
SSLCARevocationCheck chain\|leaf\|none flags	none	sv	E
Active la vérification des révocations basée sur les CRL
SSLCARevocationFile chemin-fichier		sv	E
Fichier contenant la concaténation des CRLs des CA codés en +PEM pour l'authentification des clients
SSLCARevocationPath chemin-répertoire		sv	E
Répertoire des CRLs de CA codés en PEM pour +l'authentification des clients
SSLCertificateChainFile chemin-fichier		sv	E
Fichier contenant les certificats de CA du serveur codés en +PEM
SSLCertificateFile chemin-fichier		sv	E
Fichier de données contenant les informations de certificat X.509 du serveur +codées au format PEM
SSLCertificateKeyFile chemin-fichier		sv	E
Fichier contenant la clé privée du serveur codée en +PEM
SSLCipherSuite algorithmes	DEFAULT (dépend de +	svdh	E
Algorithmes de chiffrement disponibles pour la négociation +au cours de l'initialisation de la connexion SSL
SSLCompression on\|off	off	sv	E
Permet d'activer la compression au niveau SSL
SSLCryptoDevice moteur	builtin	s	E
Active l'utilisation d'un accélérateur matériel de +chiffrement
SSLEngine on\|off\|optional	off	sv	E
Interrupteur marche/arrêt du moteur SSL
SSLFIPS on\|off	off	s	E
Coimmutateur du mode SSL FIPS
SSLHonorCipherOrder on\|off	off	sv	E
Option permettant de classer les algorithmes de chiffrement +du serveur par ordre de préférence
SSLInsecureRenegotiation on\|off	off	sv	E
Option permettant d'activer le support de la renégociation +non sécurisée
SSLOCSDefaultResponder uri		sv	E
Définit l'URI du répondeur par défaut pour la validation +OCSP
SSLOCSPEnable on\|off	off	sv	E
Active la validation OCSP de la chaîne de certificats du +client
SSLOCSPNoverify On/Off	Off	sv	E
skip the OCSP responder certificates verification
SSLOCSPOverrideResponder on\|off	off	sv	E
Force l'utilisation de l'URI du répondeur par défaut pour +la validation OCSP
SSLOCSPProxyURL url		sv	E
Adresse de mandataire à utiliser pour les requêtes OCSP
SSLOCSPResponderCertificateFile file		sv	E
Set of trusted PEM encoded OCSP responder certificates
SSLOCSPResponderTimeout secondes	10	sv	E
Délai d'attente pour les requêtes OCSP
SSLOCSPResponseMaxAge secondes	-1	sv	E
Age maximum autorisé pour les réponses OCSP
SSLOCSPResponseTimeSkew secondes	300	sv	E
Dérive temporelle maximale autorisée pour la validation des +réponses OCSP
SSLOCSPUseRequestNonce on\|off	on	sv	E
Utilisation d'un nombre à usage unique au sein des requêtes +OCSP
SSLOpenSSLConfCmd commande valeur		sv	E
Configuration des paramètres d'OpenSSL via son API SSL_CONF
SSLOptions [+\|-]option ...		svdh	E
Configure différentes options d'exécution du moteur +SSL
SSLPassPhraseDialog type	builtin	s	E
Méthode utilisée pour entrer le mot de passe pour les clés +privées chiffrées
SSLProtocol [+\|-]protocole ...	all -SSLv3	sv	E
Indique les versions du protocole SSL/TLS +disponibles
SSLProxyCACertificateFile file-path		sv	E
Fichier contenant la concaténation des certificats de CA +codés en PEM pour l'authentification des serveurs distants
SSLProxyCACertificatePath chemin-répertoire		sv	E
Répertoire des certificats de CA codés en PEM pour +l'authentification des serveurs distants
SSLProxyCARevocationCheck chain\|leaf\|none	none	sv	E
Active la vérification des révocations basée sur les CRLs +pour l'authentification du serveur distant
SSLProxyCARevocationFile chemin-fichier		sv	E
Fichier contenant la concaténation des CRLs de CA codés en +PEM pour l'authentification des serveurs distants
SSLProxyCARevocationPath chemin-répertoire		sv	E
Répertoire des CRLs de CA codés en PEM pour +l'authentification des serveurs distants
SSLProxyCheckPeerCN on\|off	on	sv	E
Configuration de la vérification du champ CN du certificat +du serveur distant +
SSLProxyCheckPeerExpire on\|off	on	sv	E
Configuration de la vérification de l'expiration du +certificat du serveur distant +
SSLProxyCheckPeerName on\|off	on	sv	E
Configure la vérification du nom d'hôte pour les +certificats serveur distant +
SSLProxyCipherSuite algorithmes	ALL:!ADH:RC4+RSA:+H +	sv	E
Algorithmes de chiffrement disponibles pour la négociation +lors de l'initialisation d'une connexion SSL de mandataire
SSLProxyEngine on\|off	off	sv	E
Interrupteur marche/arrêt du moteur de mandataire +SSL
SSLProxyMachineCertificateChainFile nom-fichier		sv	E
Fichier de certificats de CA encodés PEM concaténés permettant au +mandataire de choisir un certificat
SSLProxyMachineCertificateFile chemin-fichier		sv	E
Fichier contenant la concaténation des clés et certificats +clients codés en PEM que le mandataire doit utiliser
SSLProxyMachineCertificatePath chemin-répertoire		sv	E
Répertoire des clés et certificats clients codés en PEM que +le mandataire doit utiliser
SSLProxyProtocol [+\|-]protocole ...	all -SSLv3	sv	E
Définit les protocoles SSL disponibles pour la fonction de +mandataire
SSLProxyVerify niveau	none	sv	E
Niveau de vérification du certificat du serveur +distant
SSLProxyVerifyDepth niveau	1	sv	E
Niveau de profondeur maximum dans les certificats de CA +lors de la vérification du certificat du serveur distant
SSLRandomSeed contexte source +[nombre]		s	E
Source de déclenchement du Générateur de Nombres +Pseudo-Aléatoires (PRNG)
SSLRenegBufferSize `taille`	131072	dh	E
Définit la taille du tampon de renégociation +SSL
SSLRequire expression		dh	E
N'autorise l'accès que lorsqu'une expression booléenne +complexe et arbitraire est vraie
SSLRequireSSL		dh	E
Interdit l'accès lorsque la requête HTTP n'utilise pas +SSL
SSLSessionCache type	none	s	E
Type du cache de session SSL global et +inter-processus
SSLSessionCacheTimeout secondes	300	sv	E
Nombre de secondes avant l'expiration d'une session SSL +dans le cache de sessions
SSLSessionTicketKeyFile chemin-fichier		sv	E
Clé de chiffrement/déchiffrement permanente pour les +tickets de session TLS
SSLSessionTickets on\|off	on	sv	E
Active ou désactive les tickets de session TLS
SSLSRPUnknownUserSeed secret-string		sv	E
Source de randomisation pour utilisateur SRP inconnu
SSLSRPVerifierFile file-path		sv	E
Chemin du fichier de vérification SRP
SSLStaplingCache type		s	E
Configuration du cache pour l'agrafage OCSP
SSLStaplingErrorCacheTimeout secondes	600	sv	E
Durée de vie des réponses invalides dans le cache pour +agrafage OCSP
SSLStaplingFakeTryLater on\|off	on	sv	E
Génère une réponse "tryLater" pour les requêtes OCSP échouées
SSLStaplingForceURL uri		sv	E
Remplace l'URI du serveur OCSP spécifié dans l'extension +AIA du certificat
SSLStaplingResponderTimeout secondes	10	sv	E
Temps d'attente maximum pour les requêtes vers les serveurs +OCSP
SSLStaplingResponseMaxAge secondes	-1	sv	E
Age maximum autorisé des réponses OCSP incluses dans la +négociation TLS
SSLStaplingResponseTimeSkew secondes	300	sv	E
Durée de vie maximale autorisée des réponses OCSP incluses dans la +négociation TLS
SSLStaplingReturnResponderErrors on\|off	on	sv	E
Transmet au client les erreurs survenues lors des requêtes +OCSP
SSLStaplingStandardCacheTimeout secondes	3600	sv	E
Durée de vie des réponses OCSP dans le cache
SSLStrictSNIVHostCheck on\|off	off	sv	E
Contrôle de l'accès des clients non-SNI à un serveur virtuel à +base de nom. +
SSLUserName nom-var		sdh	E
Nom de la variable servant à déterminer le nom de +l'utilisateur
SSLUseStapling on\|off	off	sv	E
Active l'ajout des réponses OCSP à la négociation TLS
SSLVerifyClient niveau	none	svdh	E
Niveau de vérification du certificat client
SSLVerifyDepth nombre	1	svdh	E
Profondeur maximale des certificats de CA pour la +vérification des certificats clients
StartServers `nombre`		s	M
Nombre de processus enfants du serveur créés au +démarrage
StartThreads `nombre`		s	M
Nombre de threads créés au démarrage
Substitute `s/modèle/substitution/[infq]`		dh	E
Modèle de substition dans le contenu de la +réponse
SubstituteInheritBefore on\|off	on	dh	E
Modifie l'ordre de fusion des modèles hérités
SubstituteMaxLineLength `octets`(b\|B\|k\|K\|m\|M\|g\|G)	1m	dh	E
Définit la longueur de ligne maximale
Suexec On\|Off		s	B
Active ou désactive la fonctionnalité suEXEC
SuexecUserGroup Utilisateur Groupe		sv	E
L'utilisateur et le groupe sous lesquels les programmes CGI +doivent s'exécuter
ThreadLimit `nombre`		s	M
Le nombre de threads maximum que l'on peut définir par +processus enfant
ThreadsPerChild `nombre`		s	M
Nombre de threads créés par chaque processus +enfant
ThreadStackSize `taille`		s	M
La taille en octets de la pile qu'utilisent les threads qui +traitent les connexions clients
TimeOut `secondes`	60	sv	C
Temps pendant lequel le serveur va attendre certains +évènements avant de considérer qu'une requête a échoué
TraceEnable `[on\|off\|extended]`	on	sv	C
Détermine le comportement des requêtes +`TRACE`
TransferLog `fichier`\|`pipe`		sv	B
Spécifie l'emplacement d'un fichier journal
TypesConfig `chemin-fichier`	conf/mime.types	s	B
Le chemin du fichier `mime.types`
UnDefine `nom-variable`		sv	C
Invalide la définition d'une variable
UndefMacro `nom`		svd	B
Supprime une macro
UnsetEnv `var-env` [`var-env`] +...		svdh	B
Supprime des variables de l'environnement
Use `nom` [`valeur1` ... `valeurN`] +		svd	B
Utilisation d'une macro
UseCanonicalName On\|Off\|DNS	Off	svd	C
Définit la manière dont le serveur détermine son propre nom +et son port
UseCanonicalPhysicalPort On\|Off	Off	svd	C
Définit la manière dont le serveur +détermine son propre port
User `utilisateur unix`	#-1	s	B
L'utilisateur sous lequel le serveur va traiter les +requêtes
UserDir nom-répertoire [nom-répertoire] ... +		sv	B
Chemin des répertoires propres à un +utilisateur
VHostCGIMode On\|Off\|Secure	On	v	X
Détermine si le serveur virtuel peut exécuter des +sous-processus, et définit les privilèges disponibles pour ces +dernier.
VHostPrivs [+-]?`nom-privilège` [[+-]?nom-privilège] ...		v	X
Assigne des privilèges au choix aux sous-processus créés +par un serveur virtuel.
VHostGroup `identifiant-groupe-unix`		v	X
Définit l'identifiant du groupe sous lequel s'exécute un +serveur virtuel.
VHostPrivs [+-]?`nom-privilège` [[+-]?nom-privilège] ...		v	X
Assigne des privilèges à un serveur virtuel.
VHostSecure On\|Off	On	v	X
Détermine si le serveur s'exécute avec une sécurité avancée +pour les serveurs virtuels.
VHostUser `identifiant-utilisateur-unix`		v	X
Définit l'identifiant utilisateur sous lequel s'exécute un +serveur virtuel.
VirtualDocumentRoot répertoire-interpolé\|none	none	sv	E
Permet une configuration dynamique de la racine des +documents d'un serveur virtuel donné
VirtualDocumentRootIP répertoire-interpolé\|none	none	sv	E
Configuration dynamique de la racine des documents pour un +serveur virtuel donné
<VirtualHost + `adresse IP`[:`port`] [`adresse + IP`[:`port`]] ...> ... + </VirtualHost>		s	C
Contient des directives qui ne s'appliquent qu'à un nom +d'hôte spécifique ou à une adresse IP
VirtualScriptAlias répertoire-interpolé\|none	none	sv	E
Configuration dynamique du répertoire des scripts CGI pour +un serveur virtuel donné
VirtualScriptAliasIP répertoire-interpolé\|none	none	sv	E
Configuration dynamique du répertoire des scripts CGI pour +un serveur virtuel donné
Warning `message`		svdh	C
Message d'avertissement personnalisable en provenance de +l'interprétation du fichier de configuration
WatchdogInterval `number-of-seconds`	1	s	B
Watchdog interval in seconds
XBitHack on\|off\|full	off	svdh	B
Interprète les directives SSI dans les fichiers dont le bit +d'exécution est positionné
xml2EncAlias `charset alias [alias ...]`		s	B
Recognise Aliases for encoding values
xml2EncDefault `name`		svdh	B
Sets a default encoding to assume when absolutely no information +can be automatically detected
xml2StartParse `element [element ...]`		svdh	B
Advise the parser to skip leading junk.

Langues Disponibles: de | + en | + es | + fr | + ja | + ko | + tr | + zh-cn

Commentaires

+ \ No newline at end of file diff --git a/docs/manual/mod/quickreference.xml.fr b/docs/manual/mod/quickreference.xml.fr new file mode 100644 index 00000000000..9fd77b292a5 --- /dev/null +++ b/docs/manual/mod/quickreference.xml.fr @@ -0,0 +1,44 @@ + + + + + + + + + + + Document de rÃ©fÃ©rence rapide des directives +

Le document de rÃ©fÃ©rence rapide des directives montre l'usage, + les valeurs par dÃ©faut, le statut, + et le contexte de chaque directive de configuration d'Apache. Pour plus + d'informations sur chacun de ces termes, voir le Dictionnaire des directives.

+ +

La premiÃ¨re colonne donne le nom de la directive et son usage. + Si la directive possÃ¨de une valeur par dÃ©faut, elle est indiquÃ©e dans la + deuxiÃ¨me colonne. + Si la valeur par dÃ©faut est trop grande pour pouvoir Ãªtre affichÃ©e, + elle sera tronquÃ©e et suivie d'un "+".

+ +

La troisiÃ¨me colonne Ã©numÃ¨re les contextes dans + lesquels la directive est applicable, et la quatriÃ¨me indique son statut en accord avec le + tableau des lÃ©gendes ci-dessous.

+ diff --git a/docs/manual/mod/quickreference.xml.meta b/docs/manual/mod/quickreference.xml.meta index 8f772577275..35c6a34df46 100644 --- a/docs/manual/mod/quickreference.xml.meta +++ b/docs/manual/mod/quickreference.xml.meta @@ -10,6 +10,7 @@ de en es + fr ja ko tr diff --git a/docs/manual/mod/worker.html b/docs/manual/mod/worker.html index 3a21309d37c..4cfc7337ea7 100644 --- a/docs/manual/mod/worker.html +++ b/docs/manual/mod/worker.html @@ -8,6 +8,10 @@ URI: worker.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: worker.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: worker.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/worker.html.fr b/docs/manual/mod/worker.html.fr new file mode 100644 index 00000000000..4510196f551 --- /dev/null +++ b/docs/manual/mod/worker.html.fr @@ -0,0 +1,212 @@ + + + + + +worker - Serveur Apache HTTP Version 2.5 + + + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.5 > Modules

Apache MPM worker

Langues Disponibles: de | + en | + fr | + ja | + tr

+ + + +

Description:	Module multi-processus implémentant un serveur web hybride +multi-processus multi-thread
Statut:	MPM
Identificateur de Module:	mpm_worker_module
Fichier Source:	worker.c

Sommaire

+ +

Ce module multi-processus (MPM) implémente un serveur hybride + multi-processus multi-thread. En utilisant les threads pour servir + les requêtes, il peut en traiter un grand nombre tout en consommant + moins de ressources qu'un serveur à base de processus. Cependant, il + conserve une grande partie de la stabilité d'un serveur à base de + processus en maintenant plusieurs processus disponibles, chacun de + ces derniers possédant de nombreux threads.

+ +

Les directives les plus importantes qui permettent de contrôler + ce MPM sont ThreadsPerChild, qui définit le + nombre de threads lancés par chaque processus enfant et MaxRequestWorkers, qui définit le nombre + global maximum de threads qui peuvent être lancés.

Sujets

Comment ça marche

Directives

+ +

Traitement des bugs

Voir aussi

Comment ça marche

Un processus de contrôle unique (le parent) a pour tâche de + lancer les processus enfants. Chaque processus enfant crée un nombre + fixe de threads serveurs selon la valeur de la directive ThreadsPerChild, ainsi + qu'un thread chargé d'attendre les connexions et de les passer à un + thread serveur pour traitement au fur et à mesure de leur arrivée.

+ +

Le serveur HTTP Apache essaie toujours de maintenir un jeu de + threads serveurs + inactifs ou en réserve, qui se tiennent prêts à traiter + les requêtes entrantes. De cette façon, les clients n'ont pas besoin + d'attendre la création d'un nouveau thread ou d'un nouveau processus + pour que leurs requêtes puissent être traitées. Le nombre de + processus lancés initialement est défini par la directive StartServers. En cours de + fonctionnement, le serveur évalue le nombre total de threads inactifs + dans tous les processus, et en crée ou en arrête de façon à + maintenir ce nombre à l'intérieur des limites définies par les + directives MinSpareThreads et MaxSpareThreads. Comme ce module + s'auto-contrôle de manière efficace, on peut en général conserver + les valeurs par défaut. Le nombre maximum de clients pouvant être + servis simultanément (c'est à dire le nombre global maximum de + threads pour tous les processus) est défini par la directive + MaxRequestWorkers. Le nombre + maximum de processus enfants actifs est défini par la valeur de la + directive MaxRequestWorkers + divisée par la valeur de la directive + ThreadsPerChild.

+ +

Deux directives permettent de fixer des limites absolues pour le + nombre de processus enfants actifs et le nombre de threads serveurs + par processus enfant, et ne peuvent être modifiées qu'en + arrêtant complètement le serveur et en le démarrant à nouveau. + La valeur de la directive ServerLimit constitue une limite + absolue pour le nombre de processus enfants actifs, et doit être + supérieure ou égale à la valeur de la directive MaxRequestWorkers divisée par la valeur de + la directive + ThreadsPerChild. La valeur de la directive ThreadLimit constitue une limite + absolue pour le nombre de threads par processus enfant, et doit être + supérieure ou égale à la valeur de la directive ThreadsPerChild.

+ +

En plus du jeu de processus enfants actifs, il peut exister + quelques processus enfants en cours d'arrêt, mais dont au moins un + thread serveur est encore en train de traiter une connexion client + existante. Il peut subsister en théorie jusqu'à MaxRequestWorkers processus en cours + d'arrêt, bien qu'en réalité, ce nombre sera en général beaucoup plus + petit. Ce comportement peut être évité en désactivant l'arrêt de + processus enfants individuels de la manière suivante :

+ +

définir la valeur de + MaxConnectionsPerChild à zéro
Définir la valeur de + MaxSpareThreads à la même valeur que MaxRequestWorkers

+ +

Voici un exemple typique de configuration du contrôle + processus-thread pour le MPM worker :

+ +

ServerLimit         16
+StartServers         2
+MaxRequestWorkers  150
+MinSpareThreads     25
+MaxSpareThreads     75
+ThreadsPerChild     25

+ + +

Alors que le processus parent est en général démarré en tant que + root sous Unix afin de se mettre en écoute du port 80, + les processus enfants et les threads sont lancés par le serveur sous un + utilisateur avec privilèges restreints. On peut utiliser les + directives User et Group pour définir les privilèges + des processus enfants. Les processus enfants doivent pouvoir être en + mesure de lire tous les contenus destinés à être servis, mais + doivent avoir des privilèges aussi bas que possible. De plus, ces + directives définissent également les privilèges dont vont hériter les + scripts CGI (sauf si on utilise suexec).

+ +

La directive MaxConnectionsPerChild permet de + définir la fréquence à laquelle le serveur recycle ses processus en + arrêtant les plus anciens et en en lançant de nouveaux.

+ +

Ce module MPM utilise le mutex mpm-accept pour + sérialiser l'accès aux connexions entrantes lorsqu'un problème + d'afflux de requêtes peut survenir (en général, lorsqu'il y a + plusieurs sockets en écoute). Les différents aspects de + l'implémentation de ce mutex peuvent être configurés via la + directive Mutex. Vous + trouverez des informations plus détaillées à propos de ce mutex dans + la documentation sur les conseils en matière de + performances.

+ +

Langues Disponibles: de | + en | + fr | + ja | + tr

Commentaires

+ \ No newline at end of file diff --git a/docs/manual/mod/worker.xml.fr b/docs/manual/mod/worker.xml.fr new file mode 100644 index 00000000000..8c7936fc9f9 --- /dev/null +++ b/docs/manual/mod/worker.xml.fr @@ -0,0 +1,202 @@ + + + + + + + + + + +worker +Module multi-processus implÃ©mentant un serveur web hybride +multi-processus multi-thread +MPM +worker.c +mpm_worker_module + +

Ce module multi-processus (MPM) implÃ©mente un serveur hybride + multi-processus multi-thread. En utilisant les threads pour servir + les requÃªtes, il peut en traiter un grand nombre tout en consommant + moins de ressources qu'un serveur Ã base de processus. Cependant, il + conserve une grande partie de la stabilitÃ© d'un serveur Ã base de + processus en maintenant plusieurs processus disponibles, chacun de + ces derniers possÃ©dant de nombreux threads.

+ +

Les directives les plus importantes qui permettent de contrÃ´ler + ce MPM sont ThreadsPerChild, qui dÃ©finit le + nombre de threads lancÃ©s par chaque processus enfant et MaxRequestWorkers, qui dÃ©finit le nombre + global maximum de threads qui peuvent Ãªtre lancÃ©s.

Comment Ã§a marche +

Un processus de contrÃ´le unique (le parent) a pour tÃ¢che de + lancer les processus enfants. Chaque processus enfant crÃ©e un nombre + fixe de threads serveurs selon la valeur de la directive ThreadsPerChild, ainsi + qu'un thread chargÃ© d'attendre les connexions et de les passer Ã un + thread serveur pour traitement au fur et Ã mesure de leur arrivÃ©e.

+ +

Le serveur HTTP Apache essaie toujours de maintenir un jeu de + threads serveurs + inactifs ou en rÃ©serve, qui se tiennent prÃªts Ã traiter + les requÃªtes entrantes. De cette faÃ§on, les clients n'ont pas besoin + d'attendre la crÃ©ation d'un nouveau thread ou d'un nouveau processus + pour que leurs requÃªtes puissent Ãªtre traitÃ©es. Le nombre de + processus lancÃ©s initialement est dÃ©fini par la directive StartServers. En cours de + fonctionnement, le serveur Ã©value le nombre total de threads inactifs + dans tous les processus, et en crÃ©e ou en arrÃªte de faÃ§on Ã + maintenir ce nombre Ã l'intÃ©rieur des limites dÃ©finies par les + directives MinSpareThreads et MaxSpareThreads. Comme ce module + s'auto-contrÃ´le de maniÃ¨re efficace, on peut en gÃ©nÃ©ral conserver + les valeurs par dÃ©faut. Le nombre maximum de clients pouvant Ãªtre + servis simultanÃ©ment (c'est Ã dire le nombre global maximum de + threads pour tous les processus) est dÃ©fini par la directive + MaxRequestWorkers. Le nombre + maximum de processus enfants actifs est dÃ©fini par la valeur de la + directive MaxRequestWorkers + divisÃ©e par la valeur de la directive + ThreadsPerChild.

+ +

Deux directives permettent de fixer des limites absolues pour le + nombre de processus enfants actifs et le nombre de threads serveurs + par processus enfant, et ne peuvent Ãªtre modifiÃ©es qu'en + arrÃªtant complÃ¨tement le serveur et en le dÃ©marrant Ã nouveau. + La valeur de la directive ServerLimit constitue une limite + absolue pour le nombre de processus enfants actifs, et doit Ãªtre + supÃ©rieure ou Ã©gale Ã la valeur de la directive MaxRequestWorkers divisÃ©e par la valeur de + la directive + ThreadsPerChild. La valeur de la directive ThreadLimit constitue une limite + absolue pour le nombre de threads par processus enfant, et doit Ãªtre + supÃ©rieure ou Ã©gale Ã la valeur de la directive ThreadsPerChild.

+ +

En plus du jeu de processus enfants actifs, il peut exister + quelques processus enfants en cours d'arrÃªt, mais dont au moins un + thread serveur est encore en train de traiter une connexion client + existante. Il peut subsister en thÃ©orie jusqu'Ã MaxRequestWorkers processus en cours + d'arrÃªt, bien qu'en rÃ©alitÃ©, ce nombre sera en gÃ©nÃ©ral beaucoup plus + petit. Ce comportement peut Ãªtre Ã©vitÃ© en dÃ©sactivant l'arrÃªt de + processus enfants individuels de la maniÃ¨re suivante :

+ +

Voici un exemple typique de configuration du contrÃ´le + processus-thread pour le MPM worker :

+ + +ServerLimit 16 +StartServers 2 +MaxRequestWorkers 150 +MinSpareThreads 25 +MaxSpareThreads 75 +ThreadsPerChild 25 + + +

Alors que le processus parent est en gÃ©nÃ©ral dÃ©marrÃ© en tant que + root sous Unix afin de se mettre en Ã©coute du port 80, + les processus enfants et les threads sont lancÃ©s par le serveur sous un + utilisateur avec privilÃ¨ges restreints. On peut utiliser les + directives User et Group pour dÃ©finir les privilÃ¨ges + des processus enfants. Les processus enfants doivent pouvoir Ãªtre en + mesure de lire tous les contenus destinÃ©s Ã Ãªtre servis, mais + doivent avoir des privilÃ¨ges aussi bas que possible. De plus, ces + directives dÃ©finissent Ã©galement les privilÃ¨ges dont vont hÃ©riter les + scripts CGI (sauf si on utilise suexec).

+ +

La directive MaxConnectionsPerChild permet de + dÃ©finir la frÃ©quence Ã laquelle le serveur recycle ses processus en + arrÃªtant les plus anciens et en en lanÃ§ant de nouveaux.

+ +

Ce module MPM utilise le mutex mpm-accept pour + sÃ©rialiser l'accÃ¨s aux connexions entrantes lorsqu'un problÃ¨me + d'afflux de requÃªtes peut survenir (en gÃ©nÃ©ral, lorsqu'il y a + plusieurs sockets en Ã©coute). Les diffÃ©rents aspects de + l'implÃ©mentation de ce mutex peuvent Ãªtre configurÃ©s via la + directive Mutex. Vous + trouverez des informations plus dÃ©taillÃ©es Ã propos de ce mutex dans + la documentation sur les conseils en matiÃ¨re de + performances.

+ +

+ +CoreDumpDirectory + +EnableExceptionHook + +Group + +PidFile + +Listen + +ListenBacklog + +MaxRequestWorkers + +MaxMemFree + +MaxConnectionsPerChild + +MaxSpareThreads + +MinSpareThreads + +ScoreBoardFile + +ReceiveBufferSize + +SendBufferSize + +ServerLimit + +StartServers + +ThreadLimit + +ThreadsPerChild + +ThreadStackSize + +User + + + diff --git a/docs/manual/mod/worker.xml.meta b/docs/manual/mod/worker.xml.meta index 25512566c93..660a545e074 100644 --- a/docs/manual/mod/worker.xml.meta +++ b/docs/manual/mod/worker.xml.meta @@ -9,6 +9,7 @@ de en + fr ja tr