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.

    +
    +
    + +