X-Git-Url: https://granicus.if.org/sourcecode?a=blobdiff_plain;f=docs%2Fmanual%2Fmod%2Fcore.xml.fr;h=459ceebda158e39de91d847f55d4868507b313eb;hb=d0fef61ba3a281ab044c7a8d9ead569ba0dc232f;hp=116c3567eb9c2ef91fa5c1d1591fd395005bd2f2;hpb=36e572d87ee4631b771f802d5251c50ad5f2f08f;p=apache
diff --git a/docs/manual/mod/core.xml.fr b/docs/manual/mod/core.xml.fr
index 116c3567eb..459ceebda1 100644
--- a/docs/manual/mod/core.xml.fr
+++ b/docs/manual/mod/core.xml.fr
@@ -1,7 +1,7 @@
-
+
@@ -36,8 +36,6 @@ l'écoute d'un protocole
AcceptFilter protocole filtre
d'acceptation
server config
-Disponible depuis la version 2.3.3 sous Windows et 2.1.5
-sur les autres plates-formes.
Cette directive permet d'effectuer une optimisation de la socket
@@ -134,8 +132,6 @@ nom de chemin en fin de requête.
virtual hostdirectory
.htaccess
FileInfo
-Disponible dans Apache httpd version 2.0.30 et
-supérieures
@@ -297,8 +293,7 @@ autorisés à transiter dans les URLs tels quels
server configvirtual
host
-Disponible dans Apache httpd version 2.0.46 et
-supérieures. L'option NoDecode est disponible depuis la version
+L'option NoDecode est disponible depuis la version
2.3.12.
@@ -622,6 +617,47 @@ scripts CGI
+
+CGIPassAuth
+Active la transmission d'en-têtes d'autorisation HTTP aux scripts en
+tant que variables CGI
+CGIPassAuth On|Off
+CGIPassAuth Off
+directory.htaccess
+
+AuthConfig
+Disponible à partir de la version 2.5.0 du serveur HTTP
+Apache
+
+
+ La directive CGIPassAuth permet aux
+ scripts d'accéder aux en-têtes d'autorisation HTTP tels que
+ Authorization
, en-tête nécessaire aux scripts qui
+ implémente une authentification HTTP de base. Normalement, ces
+ en-têtes HTTP sont invisibles pour les scripts car ils leurs
+ permettraient de voir les identifiants et mots de passe
+ utilisés pour accéder au serveur lorsque l'authentification HTTP de
+ base est activée au niveau du serveur web. Cette directive doit être
+ définie à "On" lorsque des scripts sont autorisés à implémenter une
+ authentification HTTP de base.
+
+ Cette directive constitue une alternative à l'option de
+ compilation SECURITY_HOLE_PASS_AUTHORIZATION
qui était
+ déjà disponible dans les versions précédentes du serveur HTTP
+ Apache.
+
+ Cette option est prise en compte par tout module qui utilise
+ ap_add_common_vars()
, comme mod_cgi,
+ mod_cgid, mod_proxy_fcgi,
+ mod_proxy_scgi, etc... En particulier, elle affecte
+ les modules qui ne traitent pas à proprement parler les requêtes,
+ mais utilisent quand-même cette API, comme
+ mod_include ou mod_ext_filter. Les
+ modules tiers qui n'utilisent pas ap_add_common_vars()
+ peuvent aussi choisir de prendre en compte cette option.
+
+
+
ContentDigest
Active la génération d'un en-tête Content-MD5
@@ -673,6 +709,8 @@ host
DefaultRuntimeDir chemin-répertoire
DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/)
server config
+Disponible depuis de la version 2.4.2 du serveur HTTP
+Apache
La directive DefaultRuntimeDir permet de
@@ -719,9 +757,8 @@ host
directory.htaccess
FileInfo
-L'argument none
est disponible dans les
-versions d'Apache httpd 2.2.7 et supérieures. Tous les autres choix sont
-DESACTIVÉS à partir des version 2.3.x.
+Tous les arguments, excepté none
, sont
+DESACTIVÉS à partir de la version 2.3.0.
Cette directive a été désactivée. Pour la compatibilité
@@ -781,6 +818,10 @@ DESACTIVÉS à partir des version 2.3.x.
Le caractère ":" est interdit dans les noms de variables afin
d'éviter les conflits avec la syntaxe de la directive RewriteMap.
+
+ Si cette directive est définie au sein d'un bloc VirtualHost, les
+ changements qu'elle induit sont visibles de toute directive
+ ultérieure, au delà de tout bloc VirtualHost.
@@ -972,6 +1013,22 @@ du système de fichiers correspondant à une expression rationnelle<
de ligne ($) doivent donc faire l'objet d'une attention
particulière.
+
+
A partir de la version 2.4.8, les groupes nommés et les
+ références arrières sont extraits et enregistrés dans
+ l'environnement avec leur nom en majuscules et préfixé
+ par "MATCH_". Ceci permet
+ de référencer des URLs dans des expressions
+ ou au sein de modules comme mod_rewrite. Pour
+ éviter toute confusion, les références arrières numérotées (non
+ nommées) sont ignorées. Vous devez utiliser à la place des groupes
+ nommés.
+
+
+<DirectoryMatch ^/var/www/combined/(?<sitename>[^/]+)>
+ require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
+</DirectoryMatch>
+
Directory
pour une description de la manière dont les expressions rationnelles
@@ -1180,8 +1237,7 @@ host
directory.htaccess
FileInfo
-Disponible dans les versions 2.0.44 et
-supérieures. Par défaut à Off depuis la version 2.3.9.
+Par défaut à Off depuis la version 2.3.9.
Cette directive définit si le programme httpd
@@ -1301,7 +1357,7 @@ host
afficher un message personnalisé
- rediriger vers un chemin d'URL local pour traiter
+ rediriger en interne vers un chemin d'URL local pour traiter
le problème ou l'erreur
rediriger vers une URL externe pour traiter
@@ -1315,19 +1371,26 @@ host
httpd fournit parfois des informations supplémentaires à propos du
problème ou de l'erreur.
+ A partir de la version 2.4.13, cette directive peut utiliser la
+ syntaxe des expressions pour générer des
+ chaînes de caractères et des URLs dynamiques.
+
Les URLs peuvent commencer par un slash (/) pour les chemins web
locaux (relatifs au répertoire défini par la directive DocumentRoot), ou se présenter sous la
forme d'une URL complète que le client pourra résoudre.
Alternativement, un message à afficher par le navigateur pourra être
- fourni. Exemples :
+ fourni. Notez que la décision à propos de la nature du paramètre, à
+ savoir une URL, un chemin ou un message, est prise avant
+ l'interprétation de toute expression. Exemples :
ErrorDocument 500 http://foo.example.com/cgi-bin/tester
ErrorDocument 404 /cgi-bin/bad_urls.pl
ErrorDocument 401 /subscription_info.html
-ErrorDocument 403 "Sorry can't allow you access today"
+ErrorDocument 403 "Désolé, nous ne pouvons pas vous accorder l'accès aujourd'hui"
ErrorDocument 403 Forbidden!
+ErrorDocument 403 /cgi-bin/forbidden.pl?referrer=%{escape:%{HTTP_REFERER}}
De plus, on peut spécifier la valeur spéciale default
@@ -1428,7 +1491,8 @@ host
L'utilisation de syslog
à la place d'un nom de
fichier active la journalisation via syslogd(8) si le système le
- supporte. Le dispositif syslog par défaut est local7
,
+ supporte et si mod_syslog a été chargé. Le
+ dispositif syslog par défaut est local7
,
mais vous pouvez le modifier à l'aide de la syntaxe
syslog:facility
, où facility peut
être remplacé par un des noms habituellement documentés dans la page
@@ -1438,6 +1502,10 @@ host
ErrorLog syslog:user
+
Des modules additionnels peuvent implémenter leur propre
+ fournisseur ErrorLog. La syntaxe est similaire à l'exemple
+ syslog
ci-dessus.
+
SECURITE : Voir le document conseils à propos de
sécurité pour des détails sur les raisons pour lesquelles votre
@@ -1463,7 +1531,6 @@ host
ErrorLogFormat [connection|request] format
server configvirtual host
-Disponible depuis la version 2.3.9 d'Apache
La directive ErrorLogFormat permet de
@@ -1656,7 +1723,7 @@ ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"
journal pour les requêtes.
-# Exemple (format par défaut)
+# Exemple (format par défaut pour les MPMs threadés)
ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"
@@ -1911,6 +1978,22 @@ host
correspondrait à la plupart des formats graphiques de
l'Internet.
+
+ A partir de la version 2.4.8, les groupes nommés et les
+ références arrières sont extraits et enregistrés dans
+ l'environnement avec leur nom en majuscules et préfixé
+ par "MATCH_". Ceci permet
+ de référencer des URLs dans des expressions
+ ou au sein de modules comme mod_rewrite. Pour
+ éviter toute confusion, les références arrières numérotées (non
+ nommées) sont ignorées. Vous devez utiliser à la place des groupes
+ nommés.
+
+
+<FilesMatch ^(?<sitename>[^/]+)>
+ require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
+</FilesMatch>
+
Comment fonctionnent les sections
@@ -1927,8 +2010,6 @@ HTTP Content-Type pour les fichiers correspondants
directory.htaccess
FileInfo
-Intégré dans le coeur d'Apache httpd depuis la version
-2.0
Lorsqu'elle est placée dans un fichier .htaccess
ou
@@ -2071,7 +2152,7 @@ host
serait satisfaite pour les requêtes HTTP/1.0 sans en-tête
Host:. Les expressions peuvent contenir différents
opérateurs de type shell pour la comparaison de chaînes
- (=
, !=
, <
, ...), la
+ (==
, !=
, <
, ...), la
comparaison d'entiers (-eq
, -ne
, ...), ou
à usages divers (-n
, -z
, -f
,
...). Les expressions rationnelles sont aussi supportées,
@@ -2085,6 +2166,10 @@ host
propriétés. La documentation complète est disponible dans Les expressions dans le serveur HTTP Apache.
+ Cette section de configuration ne peut contenir que des
+ directives qui supportent le contexte de répertoire.
+
Les expressions dans le serveur HTTP
@@ -2175,8 +2260,6 @@ host
directory.htaccess
All
-Les identificateurs de modules sont disponibles dans les
-versions 2.1 et supérieures.
La section <IfModule
@@ -2232,9 +2315,8 @@ fichiers de configuration du serveur
host
directory
-Utilisation des caractères génériques dans la partie nom
-de fichier depuis la version 2.0.41, et dans la partie chemin depuis la
-version 2.3.6
+Utilisation des caractères
+génériques dans la partie chemin depuis la version 2.3.6
Cette directive permet l'inclusion d'autres fichiers de
@@ -2375,8 +2457,6 @@ avant de fermer une connexion persistante
server configvirtual
host
-La spécification d'une valeur en millisecondes est
-possible depuis les versions 2.3.2 et supérieures d'Apache httpd
Le nombre de secondes pendant lesquelles Apache httpd va attendre une
@@ -2392,9 +2472,10 @@ possible depuis les versions 2.3.2 et supérieures d'Apache httpd
-
Dans un contexte de serveur virtuel à base de nom, c'est
- la valeur de la paire adresse IP/port du serveur virtuel qui
- correspond le mieux qui sera utilisée.
+ Si la directive KeepAliveTimeout
+ n'est pas définie pour un des serveurs virtuels
+ à base de nom, c'est le serveur virtuel dont la paire adresse
+ IP/port correspond le mieux qui sera utilisée.
@@ -2526,7 +2607,6 @@ sous-requêtes imbriquées
server configvirtual
host
-Disponible à partir de la version 2.0.47 d'Apache httpd
Une redirection interne survient, par exemple, quand on utilise
@@ -2730,10 +2810,8 @@ HTTP
LimitRequestLine 4094
- Dans des conditions normales, la valeur par défaut de cette
- directive ne doit pas être modifiée. En outre, vous ne
- pouvez pas spécifier une valeur supérieure à 8190 sans modifier le
- code source et recompiler.
+ Dans des conditions normales, cette directive doit conserver
+ sa valeur par défaut.
Avertissement
Dans le cas des serveurs virtuels à base de noms, la valeur de
@@ -2961,6 +3039,22 @@ host
correspondrait à toute URL contenant les sous-chaînes
/extra/data
ou /special/data
.
+
+ A partir de la version 2.4.8, les groupes nommés et les
+ références arrières sont extraits et enregistrés dans
+ l'environnement avec leur nom en majuscules et préfixé
+ par "MATCH_". Ceci permet
+ de référencer des URLs dans des expressions
+ ou au sein de modules comme mod_rewrite. Pour
+ éviter toute confusion, les références arrières numérotées (non
+ nommées) sont ignorées. Vous devez utiliser à la place des groupes
+ nommés.
+
+
+<LocationMatch ^/combined/(?<sitename>[^/]+)>
+ require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
+</LocationMatch>
+
Comment fonctionnent les sections
<Directory>, <Location> et <Files> pour une
@@ -3173,10 +3267,72 @@ LogLevel info
La configuration du niveau de journalisation par répertoire
n'affecte que les messages journalisés après l'interprétation de
la requête et qui sont associés à cette dernière. Les messages
- de journalisation associés à la connexion ou au serveur ne sont
- pas affectés.
+ de journalisation associés au serveur ou à la connexion ne sont
+ pas affectés. Il est cependant possible d'agir sur ces
+ derniers à l'aide de la directive LogLevelOverride.
+ErrorLog
+ErrorLogFormat
+LogLevelOverride
+Journaux du serveur HTTP Apache
+
+
+
+LogLevelOverride
+Surcharge la verbosité du journal des erreurs pour certains
+clients
+LogLevel ipaddress[/prefixlen]
+ [module:]level [module:level] ...
+
+non définie
+server configvirtual host
+
+Disponible à partir de la version 2.5.0 du serveur HTTP
+Apache.
+
+
+ La directive LogLevelOverride permet
+ d'affiner la définition de la directive LogLevel pour les requêtes en provenance
+ de certaines adresses IP. Il est ainsi possible d'activer une
+ journalisation détaillée seulement pour certains clients à des fins
+ de test. Les adresses IP sont vérifiées à un stade très précoce du
+ processus de connexion. Ainsi, la directive
+ LogLevelOverride permet de modifier le niveau
+ de journalisation pour des processus comme la négociation SSL qui
+ intervient avant l'évaluation d'une éventuelle directive LogLevel au sein d'un conteneur If.
+
+ La directive LogLevelOverride accepte soit
+ une adresse IP simple, soit une spécification de sous-réseau CIDR de
+ la forme adresse-IP/masque. Pour la syntaxe de la spécification du
+ niveau de journalisation, voir la directive LogLevel directive.
+
+ Pour les requêtes concernées par une directive
+ LogLevelOverride, les spécifications de
+ niveau répertoire de la directive LogLevel sont ignorées.
+
+ Exemples:
+
+
+ LogLevelOverride 192.0.2.0/24 ssl:trace6
+ LogLevelOverride 192.0.2.7 ssl:trace8
+
+
+
+ La directive LogLevelOverride n'affecte que les
+ messages associés à la requête ou à la connexion. Les messages
+ associés au serveur ne sont pas affectés.
+
+
+
+LogLevel
@@ -3777,8 +3933,8 @@ host
Protocole pour une socket d'écoute
Protocol protocole
server configvirtual host
-Disponible depuis la version 2.1.5 d'Apache, mais
-seulement depuis la version 2.3.3 sous Windows.
+Sous Windows, disponible à partir de la version 2.3.3 du
+serveur HTTP Apache.
Cette directive permet de spécifier le protocole utilisé pour une
@@ -3935,9 +4091,7 @@ CGI
host
directory.htaccess
FileInfo
-Win32 seulement ;
-l'option Registry-Strict
est disponible dans les versions
-2.0 et supérieures du serveur HTTP Apache
+Win32 seulement
Cette directive permet de contrôler la méthode qu'utilise Apache
@@ -4000,8 +4154,6 @@ elle-même possède plus de 63 caractères.
SeeRequestTail On|Off
SeeRequestTail Off
server config
-Disponible depuis la version 2.2.7
-d'Apache httpd.
Avec ExtendedStatus On
, mod_status affiche la
@@ -4145,8 +4297,11 @@ host
annule cependant la précédente (pour ce serveur).
Si la directive ServerName n'est pas
- définie, le serveur tente de déterminer le nom d'hôte en effectuant
- une recherche DNS inverse sur son adresse IP. Si la directive
+ définie, le serveur tente de déterminer le nom
+ d'hôte visible du point de vue du client en effectuant
+ une recherche DNS inverse sur une adresse IP du serveur.
+
+ Si la directive
ServerName ne précise pas de port, le serveur
utilisera celui de la requête entrante. Il est recommandé de
spécifier un nom d'hôte et un port spécifiques à l'aide de la
@@ -4375,8 +4530,6 @@ host
directory.htaccess
FileInfo
-Intégré dans le noyau d'Apache httpd depuis la version
-2.0
Lorsqu'elle se situe à l'intérieur d'un fichier
@@ -4515,7 +4668,7 @@ host
maximum jusqu'à l'arrivée de l'accusé-réception d'un paquet si le
tampon d'envoi est plein.
-
Avec mod_cgi, le temps d'attente maximum des
+ Avec mod_cgi et mod_cgid, le temps d'attente maximum des
sorties d'un script CGI.
Avec mod_ext_filter, le temps d'attente
@@ -4536,8 +4689,6 @@ host
TraceEnable [on|off|extended]
TraceEnable on
server configvirtual host
-Disponible dans les versions 1.3.34, 2.0.55 et
-supérieures du serveur HTTP Apache
Cette directive l'emporte sur le comportement de
@@ -4573,7 +4724,8 @@ supérieures du serveur HTTP Apache
UnDefine
Invalide la définition d'une variable
UnDefine nom-variable
-server config
+server config
+virtual host
Annule l'effet d'une directive
section IfDefine
sans avoir à modifier les arguments -D
dans les scripts
de démarrage.
+ Si cette directive est définie au sein d'un bloc VirtualHost, les
+ changements qu'elle induit sont visibles de toute directive
+ ultérieure, au delà de tout bloc VirtualHost.
@@ -4837,4 +4992,80 @@ explication de la manière dont ces différentes sections se combine
entre elles à la réception d'une requête
+
+RegisterHttpMethod
+Enregistrement de méthodes HTTP non standards
+RegisterHttpMethod méthode [méthode [...]]
+server config
+
+
+Normalement, les méthodes HTTP non conformes aux RFCs correspondantes
+sont rejetées au cours du traitement de la requête par HTTPD. Pour
+éviter ceci, les modules peuvent enregistrer les méthodes HTTP non
+standards qu'ils supportent. La directive
+RegisterHttpMethod permet d'enregistrer de telles
+méthodes manuellement. Ceci peut s'avérer utile si de telle méthodes
+doivent être utilisées dans un traitement externe, comme un script CGI.
+
+
+
+
+Warning
+Message d'avertissement personnalisable en provenance de
+l'interprétation du fichier de configuration
+Warning message
+server configvirtual host
+directory.htaccess
+
+Disponible à partir de la version 2.5 du serveur HTTP
+Apache.
+
+
+ Cette directive permet de signaler la détection d'un problème de
+ configuration en générant un message d'avertissement
+ personnalisable. L'interprétation du fichier de configuration n'est
+ pas interrompue. Un exemple typique d'utilisation est la
+ vérification de la définition de certaines options définies par
+ l'utilisateur, et l'envoi d'un avertissement éventuel.
+
+
+# Exemple
+# signale que ReverseProxy n'est pas défini
+<IfDefine !ReverseProxy>
+ Warning "le mandataire inverse n'a pas été spécifié, veuillez corriger
+ si nécessaire"
+</IfDefine>
+
+<IfDefine ReverseProxy>
+ # définition de la configuration personnalisée du mandataire
+</IfDefine>
+
+
+
+
+
+
+MergeTrailers
+Détermine si les données supplémentaires (trailers) sont
+fusionnées avec les en-têtes
+MergeTrailers [on|off]
+MergeTrailers off
+server configvirtual host
+Disponible à partir de la version 2.4.10 du serveur HTTP
+Apache
+
+
+ Cette directive permet de contrôler la fusion des données HTTP
+ supplémentaires (trailers) avec la représentation interne des
+ en-têtes. Cette fusion intervient lorsque le corps de la requête a
+ été entièrement reçu, bien longtemps après que la majeure partie du
+ traitement des en-têtes ait une chance de pouvoir examiner ou
+ modifier les en-têtes de la requête.
+ Cette option a été introduite dans un souci de compatibilité avec
+ les versions antérieures à 2.4.10, où les données supplémentaires
+ étaient systématiquement fusionnées avec les en-têtes de la requête.
+
+
+
+