From ec86cfe2d6f8a827b69f9999a9ea605547a2c5ed Mon Sep 17 00:00:00 2001 From: Lucien Gentis Date: Wed, 9 May 2012 18:39:32 +0000 Subject: [PATCH] Update. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1336338 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/core.xml.fr | 885 ++++++++++++++++-------------------- 1 file changed, 390 insertions(+), 495 deletions(-) diff --git a/docs/manual/mod/core.xml.fr b/docs/manual/mod/core.xml.fr index 9df2a36f38..fb722ab9b0 100644 --- a/docs/manual/mod/core.xml.fr +++ b/docs/manual/mod/core.xml.fr @@ -1,7 +1,7 @@ - + @@ -55,7 +55,9 @@ sur les autres plates-formes. filtre d'acceptation pour ce protocole. Ceci s'avère utile pour les protocoles qui nécessitent l'envoi de données par le serveur en premier, comme ftp: ou nntp:

- AcceptFilter nntp none + + AcceptFilter nntp none +

Les noms de protocoles par défaut sont https pour le port 443 et http pour tous les autres ports. Pour @@ -64,10 +66,10 @@ sur les autres plates-formes. module="mpm_common">Listen.

Sous FreeBSD, les valeurs par défaut sont :

- - AcceptFilter http httpready
- AcceptFilter https dataready - + +AcceptFilter http httpready +AcceptFilter https dataready +

Le filtre d'acceptation httpready met en tampon des requêtes HTTP entières au niveau du noyau. Quand une requête @@ -80,10 +82,10 @@ sur les autres plates-formes. sektion=9">accf_data(9).

Sous Linux, les valeurs par défaut sont :

- - AcceptFilter http data
- AcceptFilter https data - + +AcceptFilter http data +AcceptFilter https data +

Le filtre TCP_DEFER_ACCEPT de Linux ne supporte pas la mise en tampon des requêtes http. Toute valeur autre que @@ -94,10 +96,10 @@ sur les autres plates-formes. tcp.7.html">tcp(7).

Sous Windows, les valeurs par défaut sont :

- - AcceptFilter http data
- AcceptFilter https data - + +AcceptFilter http data +AcceptFilter https data +

Le module MPM pour Windows mpm_winnt utilise la directive AcceptFilter comme commutateur de l'API AcceptEx(), et ne supporte @@ -119,7 +121,7 @@ sur les autres plates-formes. anti-spyware.

-Protocol +Protocol @@ -186,16 +188,14 @@ supérieures sur PATH_INFO. Le gestionnaire de base va en général rejeter la requête, et vous pouvez utiliser la configuration suivante pour utiliser un tel script :

- - - <Files "mes-chemins.shtml">
- - Options +Includes
- SetOutputFilter INCLUDES
- AcceptPathInfo On
- - </Files> - + +<Files "mypaths.shtml"> + Options +Includes + SetOutputFilter INCLUDES + AcceptPathInfo On +</Files> + + @@ -218,9 +218,7 @@ host href="#allowoverride">activés pour ce répertoire. Par exemple :

- - AccessFileName .acl - + AccessFileName .acl

avant de renvoyer le document /usr/local/web/index.html, le serveur va rechercher les @@ -229,13 +227,11 @@ host pour y lire d'éventuelles directives, à moins quelles n'aient été désactivées avec

- - <Directory />
- - AllowOverride None
- - </Directory> - + +<Directory /> + AllowOverride None +</Directory> + AllowOverride Fichiers de configuration @@ -273,9 +269,7 @@ type de contenu d'une réponse est text/plain ou types de média Internet (types MIME). Par exemple :

- - AddDefaultCharset utf-8 - + AddDefaultCharset utf-8

La directive AddDefaultCharset ne doit être utilisée que lorsque toutes les ressources textes auxquelles @@ -512,9 +506,7 @@ All pour les versions antérieures

Exemple :

- - AllowOverride AuthConfig Indexes - + AllowOverride AuthConfig Indexes

Dans l'exemple ci-dessus, toutes les directives qui ne font partie ni du groupe AuthConfig, ni du groupe @@ -566,10 +558,10 @@ All pour les versions antérieures

Example:

- - AllowOverride None
- AllowOverrideList Redirect RedirectMatch - + +AllowOverride None +AllowOverrideList Redirect RedirectMatch +

Dans l'exemple ci-dessus, seules les directives Redirect et RedirectMatch sont autorisées. @@ -577,10 +569,10 @@ All pour les versions antérieures

Example:

- - AllowOverride AuthConfig
- AllowOverrideList CookieTracking CookieName - + +AllowOverride AuthConfig +AllowOverrideList CookieTracking CookieName +

Dans l'exemple ci-dessus, la directive AllowOverride autorise les directives du @@ -662,38 +654,39 @@ host DefaultRuntimeDir -Répertoire de base des fichiers créés par le serveur au -cours de son exécution -DefaultRuntimeDir chemin +Répertoire de base des fichiers créés au cours de l'exécution du serveur +DefaultRuntimeDir chemin-répertoire DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/) server config

La directive DefaultRuntimeDir permet de - définir le répertoire dans lequel le serveur va créer différents - fichiers au cours de son exécution (mémoire partagée, verrous, - etc...). Si on spécifie un chemin relatif, ce chemin sera relatif au - chemin défini par la directive ServerRoot.

- - Exemple - DefaultRuntimeDir scratch/ - - -

Il est possible de modifier la valeur par défaut de la directive - DefaultRuntimeDir en redéfinissant la valeur - de la variable DEFAULT_REL_RUNTIMEDIR à la compilation.

- -

Note: la directive ServerRoot doit être - déjà définie pour utiliser cette directive, car dans le cas - contraire, c'est la valeur par défaut de - ServerRoot qui sera utilisée pour construire - la répertoire de base.

+ définir le répertoire dans lequel le serveur va créer les différents + fichiers relatifs à son exécution (mémoire partagée, verrous, + etc...). Si le chemin spécifié est relatif, le chemin absolu sera + généré relativement à la valeur de la directive + ServerRoot.

+ +

Example

+ +DefaultRuntimeDir scratch/ + + +

La valeur par défaut de la directive + DefaultRuntimeDir peut être modifiée en + changeant la valeur de la macro DEFAULT_REL_RUNTIMEDIR + définie à la compilation.

+ +

Note: si la valeur de ServerRoot n'a pas + été spécifiée avant d'utiliser cette directive, c'est la valeur par + défaut de ServerRoot qui sera utilisée pour + définir la base du répertoire.

-Conseil en -matière de sécurité pour plus d'information à propos des permissions -à définir sur le répertoire d'installation -ServerRoot du serveur. +Voir les conseils à propos de +sésurité pour plus d'informations en vue de définir correctement les +permissions sur la racine du serveur ServerRoot @@ -721,9 +714,8 @@ DESACTIVÉS à partir des version 2.3.x. être spécifiée avec la valeur none, c'est à dire sans type de médium par défaut. Par exemple :

- - DefaultType None - + DefaultType None +

DefaultType None n'est disponible que dans les versions d'Apache 2.2.7 et supérieures.

@@ -759,15 +751,15 @@ DESACTIVÉS à partir des version 2.3.x. La portée de la variable est toujours globale, et n'est jamais limitée à la section de configuration courante.

- - <IfDefine TEST>
-   Define servername test.example.com
- </IfDefine>
- <IfDefine !TEST>
-   Define servername www.example.com
-   Define SSL
- </IfDefine>
- + +<IfDefine TEST> + Define servername test.example.com +</IfDefine> +<IfDefine !TEST> + Define servername www.example.com + Define SSL +</IfDefine> +

Le caractère ":" est interdit dans les noms de variables afin d'éviter les conflits avec la syntaxe de la directive * /home/user/public_html, alors que <Directory /home/*/public_html> conviendra. Exemple :

- - <Directory /usr/local/httpd/htdocs>
- - Options Indexes FollowSymLinks
- - </Directory> - + +<Directory "/usr/local/httpd/htdocs"> + Options Indexes FollowSymLinks +</Directory> +

Soyez prudent avec l'argument chemin répertoire : il @@ -827,9 +817,11 @@ host peuvent aussi être utilisées en ajoutant le caractère ~. Par exemple :

- - <Directory ~ "^/www/.*/[0-9]{3}"> - + +<Directory ~ "^/www/.*/[0-9]{3}"> + +</Directory> +

pourra correspondre à tout répertoire situé dans /www/ et dont le nom se compose de trois chiffres.

@@ -843,19 +835,15 @@ host directives des fichiers .htaccess. Par exemple, avec

- - <Directory />
- - AllowOverride None
- - </Directory>
-
- <Directory /home>
- - AllowOverride FileInfo
- - </Directory> - + +<Directory /> + AllowOverride None +</Directory> + +<Directory "/home"> + AllowOverride FileInfo +</Directory> +

l'accès au document /home/web/dir/doc.html emprunte le chemin suivant :

@@ -880,13 +868,11 @@ host testés selon l'ordre dans lequel ils apparaissent dans le fichier de configuration. Par exemple, avec

- - <Directory ~ abc$>
- - # ... directives here ...
- - </Directory> - + +<Directory ~ "abc$"> + # ... directives ici ... +</Directory> +

la section avec expression rationnelle ne sera prise en compte qu'après les sections correspondant à une URL. Il est recommandé de modifier cette situation à l'aide d'un bloc du style

- - <Directory />
- - Require all denied
- - </Directory> - + +<Directory /> + Require all denied +</Directory> +

puis d'affiner la configuration pour les répertoires que vous voulez rendre accessibles. Voir la page expression rationnelle. Par exemple :

- - <DirectoryMatch "^/www/(.+/)?[0-9]{3}"> - + +<DirectoryMatch "^/www/(.+/)?[0-9]{3}"> + # ... +</DirectoryMatch> +

conviendrait pour les sous-répertoires de /www/ dont le nom se compose de trois chiffres.

@@ -998,9 +984,7 @@ host de l'URL sera ajouté par le serveur à la racine des documents afin de construire le chemin du document recherché. Exemple :

- - DocumentRoot /usr/web - + DocumentRoot "/usr/web"

un accès à http://my.example.com/index.html se réfère alors à /usr/web/index.html. Si chemin @@ -1037,14 +1021,14 @@ requête à l'exécution supérieure et dans la même portée n'ont pas été satisfaites. Par exemple, dans :

- - <If "-z req('Host')">
- ...
- </If>
- <Else>
- ...
- </Else>
- + +<If "-z req('Host')"> + # ... +</If> +<Else> + # ... +</Else> +

La condition de la section If serait satisfaite pour les requêtes @@ -1084,17 +1068,17 @@ type="section">ElseIf précédente ne l'était pas ou ElseIf de la même portée ne l'est pas. Par exemple, dans :

- - <If "-R '10.1.0.0/16'">
- ...
- </If>
- <ElseIf "-R '10.0.0.0/8'">
- ...
- </ElseIf>
- <Else>
- ...
- </Else>
- + +<If "-R '10.1.0.0/16'"> + #... +</If> +<ElseIf "-R '10.0.0.0/8'"> + #... +</ElseIf> +<Else> + #... +</Else> +

La condition correspondant à la section ElseIf est satisfaite si l'adresse @@ -1154,21 +1138,17 @@ host problème, il est préférable de désactiver la projection en mémoire des fichiers servis en spécifiant :

- - EnableMMAP Off - + EnableMMAP Off

Pour les montages NFS, cette fonctionnalité peut être explicitement désactivée pour les fichiers concernés en spécifiant :

- - <Directory "/chemin vers montage NFS"> - - EnableMMAP Off - - </Directory> - + +<Directory "/path-to-nfs-files"> + EnableMMAP Off +</Directory> + @@ -1224,21 +1204,17 @@ supérieures. Par défaut à Off depuis la version 2.3.9. - - EnableSendfile On - + EnableSendfile On

Pour les montages réseau, cette fonctionnalité peut être explicitement désactivée pour les fichiers concernés en spécifiant :

- - <Directory "/chemin vers montage réseau"> - - EnableSendfile Off - - </Directory> - + +<Directory "/path-to-nfs-files"> + EnableSendfile Off +</Directory> +

Veuillez noter que la configuration de la directive EnableSendfile dans un contexte de répertoire ou de fichier .htaccess n'est pas supportée par @@ -1265,26 +1241,25 @@ d'erreur personnalisé directive peut être utilisée pour générer un message d'erreur personnalisé, et interrompre la lecture de la configuration.

- Exemple - # vérification du chargement de mod_include
- <IfModule !include_module>
- Error mod_foo nécessite mod_include. Chargez-le via LoadModule.
- </IfModule>
-
- # vérification de la définition de SSL ou (exclusif) NOSSL
- <IfDefine SSL>
- <IfDefine NOSSL>
- Error SSL et NOSSL sont définies. Vous devez définir soit l'une, - soit l'autre.
- </IfDefine>
- </IfDefine>
- <IfDefine !SSL>
- <IfDefine !NOSSL>
- Error Vous devez définir une et une seule des deux variables SSL - ou NOSSL.
- </IfDefine>
- </IfDefine>
- + +# Exemple +# vérification du chargement de mod_include +<IfModule !include_module> + Error "mod_include is required by mod_foo. Load it with LoadModule." +</IfModule> + +# vérification de la définition de SSL ou (exclusif) NOSSL +<IfDefine SSL> +<IfDefine NOSSL> + Error "Both SSL and NOSSL are defined. Define only one of them." +</IfDefine> +</IfDefine> +<IfDefine !SSL> +<IfDefine !NOSSL> + Error "Either SSL or NOSSL must be defined." +</IfDefine> +</IfDefine> + @@ -1330,14 +1305,13 @@ host Alternativement, un message à afficher par le navigateur pourra être fourni. Exemples :

- - ErrorDocument 500 http://foo.example.com/cgi-bin/tester
- ErrorDocument 404 /cgi-bin/bad_urls.pl
- ErrorDocument 401 /subscription_info.html
- ErrorDocument 403 "Désolé, vous n'avez pas l'autorisation d'accès - aujourd'hui"
- ErrorDocument 403 Interdit! - + +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 Forbidden! +

De plus, on peut spécifier la valeur spéciale default pour indiquer l'utilisation d'un simple message d'Apache httpd codé en @@ -1347,14 +1321,13 @@ host les configurations qui sans cela, hériteraient d'une directive ErrorDocument existante.

- - ErrorDocument 404 /cgi-bin/bad_urls.pl

- <Directory /web/docs>
- - ErrorDocument 404 default
- - </Directory> - + +ErrorDocument 404 /cgi-bin/bad_urls.pl + +<Directory /web/docs> + ErrorDocument 404 default +</Directory> +

Notez que lorsque vous spécifiez une directive ErrorDocument pointant vers une URL distante @@ -1425,17 +1398,13 @@ host absolu, il est considéré comme relatif au chemin défini par la directive ServerRoot.

- Exemple - ErrorLog /var/log/httpd/error_log - + ErrorLog "/var/log/httpd/error_log"

Si le chemin fichier commence par une barre verticale "(|)", il est considéré comme une commande à lancer pour traiter la journalisation de l'erreur.

- Exemple - ErrorLog "|/usr/local/bin/erreurs_httpd" - + ErrorLog "|/usr/local/bin/httpd_errors"

Voir les notes à propos des journaux redirigés pour plus d'informations.

@@ -1450,9 +1419,7 @@ host global, et si il est modifié dans un serveur virtuel, le dispositif final spécifié affecte l'ensemble du serveur

- Exemple - ErrorLog syslog:user - + ErrorLog syslog:user

SECURITE : Voir le document conseils à propos de @@ -1486,9 +1453,10 @@ host spécifier quelles informations supplémentaires vont être enregistrées dans le journal des erreurs en plus du message habituel.

- Exemple simple - ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M" - + +# Exemple simple +ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M" +

La spécification de connection ou request comme premier paramètre permet de définir des @@ -1670,10 +1638,10 @@ host c'est son identifiant unique qui sera utilisé comme identifiant de journal pour les requêtes.

- Exemple (format par défaut) - ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] - %M% ,\ referer\ %{Referer}i" - + +# Exemple (format par défaut) +ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i" +

Cet exemple renverrait un message d'erreur du style :

@@ -1684,19 +1652,19 @@ host

Notez que, comme indiqué plus haut, certains champs sont totalement supprimés s'ils n'ont pas été définis.

- Exemple (similaire au format 2.2.x) - ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] - %M% ,\ referer\ %{Referer}i" - + +# Exemple (similaire au format 2.2.x) +ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i" + - Exemple avancé avec identifiants journal de - requête/connexion - ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"
- ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"
- ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"
- ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"
- ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"
- + +# Exemple avancé avec identifiants journal de requête/connexion +ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M" +ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T" +ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'" +ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'" +ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A" + ErrorLog @@ -1780,8 +1748,8 @@ dans les versions 2.3.14 et antérieures.
La taille du fichier en octets sera incluse
All
Tous les champs disponibles seront utilisés. Cette définition - est équivalente à : FileETag INode MTime - Size
+ est équivalente à : + FileETag INode MTime Size
None
Si le document se compose d'un fichier, aucun champ ETag ne sera inclus dans la réponse
@@ -1861,9 +1829,11 @@ host ref="regex">Expressions rationnelles en ajoutant la caractère ~. Par exemple :

- - <Files ~ "\.(gif|jpe?g|png)$"> - + +<Files ~ "\.(gif|jpe?g|png)$"> + #... +</Files> +

correspondrait à la plupart des formats graphiques de l'Internet. Il est cependant préférable d'utiliser la directive expressions rationnelles. Par exemple :

- - <FilesMatch "\.(gif|jpe?g|png)$"> - + +<FilesMatch "\.(gif|jpe?g|png)$"> + # ... +</FilesMatch> +

correspondrait à la plupart des formats graphiques de l'Internet.

@@ -1941,9 +1913,7 @@ HTTP Content-Type pour les fichiers correspondants pas leur ajouter l'extension .gif, vous pouvez utiliser :

- - ForceType image/gif - + ForceType image/gif

Notez que cette directive l'emporte sur d'autres associations de type de médium indirectes définies dans mime.types ou via la @@ -1953,22 +1923,18 @@ HTTP Content-Type pour les fichiers correspondants ForceType en affectant la valeur None à l'argument type médium :

- - # force le type MIME de tous les fichiers à image/gif:
- <Location /images>
- - ForceType image/gif
- - </Location>
-
- # mais utilise les méthodes classiques d'attribution du type MIME - # dans le sous-répertoire suivant :
- <Location /images/mixed>
- - ForceType None
- - </Location> - + +# force le type MIME de tous les fichiers à image/gif: +<Location /images> + ForceType image/gif +</Location> + +# mais utilise les méthodes classiques d'attribution du type MIME +# dans le sous-répertoire suivant : +<Location /images/mixed> + ForceType None +</Location> +

A la base, cette directive écrase le type de contenu généré pour les fichiers statiques servis à partir du sytème de fichiers. Pour @@ -2071,9 +2037,7 @@ host si et seulement si l'expression renvoie la valeur "vrai". Par exemple :

- - <If "-z req('Host')"> - + <If "-z req('Host')">

serait satisfaite pour les requêtes HTTP/1.0 sans en-tête Host:. Les expressions peuvent contenir différents @@ -2083,9 +2047,7 @@ host à usages divers (-n, -z, -f, ...). Les expressions rationnelles sont aussi supportées,

- - <If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/"> - + <If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/">

ainsi que les comparaison de modèles de type shell et de nombreuses autres opérations. Ces opérations peuvent être effectuées @@ -2154,32 +2116,22 @@ host peuvent être imbriquées, ce qui permet d'implémenter un test multi-paramètres simple. Exemple :

- - httpd -DReverseProxy -DUseCache -DMemCache ...
-
- # httpd.conf
- <IfDefine ReverseProxy>
- - LoadModule proxy_module modules/mod_proxy.so
- LoadModule proxy_http_module modules/mod_proxy_http.so
- <IfDefine UseCache>
- - LoadModule cache_module modules/mod_cache.so
- <IfDefine MemCache>
- - LoadModule mem_cache_module modules/mod_mem_cache.so
- - </IfDefine>
- <IfDefine !MemCache>
- - LoadModule cache_disk_module modules/mod_cache_disk.so
- - </IfDefine> - - </IfDefine> - - </IfDefine> - + httpd -DReverseProxy -DUseCache -DMemCache ... + +<IfDefine ReverseProxy> + LoadModule proxy_module modules/mod_proxy.so + LoadModule proxy_http_module modules/mod_proxy_http.so + <IfDefine UseCache> + LoadModule cache_module modules/mod_cache.so + <IfDefine MemCache> + LoadModule mem_cache_module modules/mod_mem_cache.so + </IfDefine> + <IfDefine !MemCache> + LoadModule cache_disk_module modules/mod_cache_disk.so + </IfDefine> + </IfDefine> +</IfDefine> + @@ -2287,35 +2239,31 @@ version 2.3.6

Exemples :

- - Include /usr/local/apache2/conf/ssl.conf
- Include /usr/local/apache2/conf/vhosts/*.conf - + +Include /usr/local/apache2/conf/ssl.conf +Include /usr/local/apache2/conf/vhosts/*.conf +

ou encore, avec des chemins relatifs au répertoire défini par la directive ServerRoot :

- - Include conf/ssl.conf
- Include conf/vhosts/*.conf - + +Include conf/ssl.conf +Include conf/vhosts/*.conf +

On peut aussi insérer des caractères génériques dans la partie répertoires du chemin. Dans l'exemple suivant, la directive échouera si aucun sous-répertoire de conf/vhosts ne contient au moins un fichier *.conf :

- - Include conf/vhosts/*/*.conf - + Include conf/vhosts/*/*.conf

Par contre, dans l'exemple suivant, la directive sera simplement ignorée si aucun sous-répertoire de conf/vhosts ne contient au moins un fichier *.conf :

- - IncludeOptional conf/vhosts/*/*.conf - + IncludeOptional conf/vhosts/*/*.conf @@ -2448,13 +2396,11 @@ certaines méthodes HTTP DELETE, en laissant les autres méthodes sans protection :

- - <Limit POST PUT DELETE>
- - Require valid-user
- - </Limit> - + +<Limit POST PUT DELETE> + Require valid-user +</Limit> +

La liste des noms de méthodes peut contenir une ou plusieurs valeurs parmi les suivantes : GET, POST, @@ -2497,18 +2443,14 @@ certaines méthodes HTTP POST, et la directive Require group editors sera ignorée dans tous les cas :

- - <LimitExcept GET> - - Require valid-user - - </LimitExcept>
- <Limit POST> - - Require group editors - - </Limit> - + +<LimitExcept GET> + Require valid-user +</LimitExcept> +<Limit POST> + Require group editors +</Limit> + @@ -2537,13 +2479,11 @@ sauf celles qui sont spécifiées

Par exemple :

- - <LimitExcept POST GET>
- - Require valid-user
- - </LimitExcept> - + +<LimitExcept POST GET> + Require valid-user +</LimitExcept> + @@ -2581,9 +2521,7 @@ host maximum des sous-requêtes. Si vous ne spécifiez qu'un seul nombre, il sera affecté aux deux limites.

- Exemple - LimitInternalRecursion 5 - + LimitInternalRecursion 5 @@ -2630,9 +2568,7 @@ host fichiers chargés à 100Ko, vous pouvez utiliser la directive suivante :

- - LimitRequestBody 102400 - + LimitRequestBody 102400

Pour une description détaillée de la manière dont cette directive est interprétée par les requêtes mandatées, voir la @@ -2678,9 +2614,7 @@ requête HTTP

Par exemple :

- - LimitRequestFields 50 - + LimitRequestFields 50 Avertissement

Dans le cas des serveurs virtuels à base de noms, la valeur de @@ -2721,9 +2655,7 @@ requête HTTP

Par exemple ::

- - LimitRequestFieldSize 4094 - + LimitRequestFieldSize 4094 Dans des conditions normales, la valeur par défaut de cette directive ne doit pas être modifiée. En outre, vous ne @@ -2769,9 +2701,7 @@ HTTP

Par exemple :

- - LimitRequestLine 4094 - + LimitRequestLine 4094 Dans des conditions normales, la valeur par défaut de cette directive ne doit pas être modifiée. En outre, vous ne @@ -2806,9 +2736,7 @@ host

Exemple :

- - LimitXMLRequestBody 0 - + LimitXMLRequestBody 0 @@ -2867,19 +2795,21 @@ host directives contenues dans la section s'appliqueront à /private1, /private1/ et /private1/file.txt, mais pas à /private1other.

- - <Location /private1> - ... - + +<Location /private1> + # ... +</Location> +

De même, dans l'exemple ci-dessous, où l'on utilise un slash de fin, les directives contenues dans la section s'appliqueront à /private2/ et à /private2/file.txt, mais pas à /private2other.

- - <Location /private2/> - ... - + +<Location /private2/> + # ... +</Location> + Quand utiliser la section <directive type="section">Location</directive> @@ -2913,9 +2843,11 @@ host rationnelles, moyennant l'addition d'un caractère ~. Par exemple :

- - <Location ~ "/(extra|special)/data"> - + +<Location ~ "/(extra|special)/data"> + #... +</Location> +

concernerait les URLs contenant les sous-chaîne /extra/data ou /special/data. La directive @@ -2934,14 +2866,12 @@ host appartenant au domaine example.com, vous pouvez utiliser :

- - <Location /status>
- - SetHandler server-status
- Require host example.com
- - </Location> - + +<Location /status> + SetHandler server-status + Require host example.com +</Location> + Note à propos du slash (/)

La signification du caractère slash dépend de l'endroit où il @@ -2996,9 +2926,11 @@ host ref="regex">expression rationnelle au lieu d'une simple chaîne de caractères. Par exemple :

- - <LocationMatch "/(extra|special)/data"> - + +<LocationMatch "/(extra|special)/data"> + # ... +</LocationMatch> +

correspondrait à toute URL contenant les sous-chaînes /extra/data ou /special/data.

@@ -3177,9 +3109,7 @@ Apache

Par exemple :

- - LogLevel notice - + LogLevel notice Note

Si la journalisation s'effectue directement dans un fichier, @@ -3196,21 +3126,21 @@ Apache identificateur, avec ou sans le suffixe _module. Les trois spécifications suivantes sont donc équivalentes :

- - LogLevel info ssl:warn
- LogLevel info mod_ssl.c:warn
- LogLevel info ssl_module:warn
- + +LogLevel info ssl:warn +LogLevel info mod_ssl.c:warn +LogLevel info ssl_module:warn +

Il est aussi possible d'attribuer un niveau de journalisation par répertoire :

- - LogLevel info
- <Directory /usr/local/apache/htdocs/app>
-   LogLevel debug
- </Files> - + +LogLevel info +<Directory "/usr/local/apache/htdocs/app"> + LogLevel debug +</Directory> + La configuration du niveau de journalisation par répertoire @@ -3242,9 +3172,7 @@ host

Par exemple :

- - MaxKeepAliveRequests 500 - + MaxKeepAliveRequests 500 @@ -3598,10 +3526,10 @@ verrou pour tous les mutex ou seulement les mutex spécifiéssysvsem.

- - Mutex sysvsem default
- Mutex fcntl:/var/httpd/locks mpm-accept - + +Mutex sysvsem default +Mutex fcntl:/var/httpd/locks mpm-accept + @@ -3766,38 +3694,30 @@ host

Par exemple, sans aucun symbole + et - :

- - <Directory /web/docs>
- - Options Indexes FollowSymLinks
- - </Directory>
-
- <Directory /web/docs/spec>
- - Options Includes
- - </Directory> - + +<Directory "/web/docs"> + Options Indexes FollowSymLinks +</Directory> + +<Directory "/web/docs/spec"> + Options Includes +</Directory> +

ici, seule l'option Includes sera prise en compte pour le répertoire /web/docs/spec. Par contre, si la seconde directive Options utilise les symboles + et - :

- - <Directory /web/docs>
- - Options Indexes FollowSymLinks
- - </Directory>
-
- <Directory /web/docs/spec>
- - Options +Includes -Indexes
- - </Directory> - + +<Directory "/web/docs"> + Options Indexes FollowSymLinks +</Directory> + +<Directory "/web/docs/spec"> + Options +Includes -Indexes +</Directory> +

alors, les options FollowSymLinks et Includes seront prises en compte pour le répertoire @@ -3838,14 +3758,12 @@ seulement depuis la version 2.3.3 sous Windows. https sur un port non standard, spécifiez le protocole de manière explicite :

- - Protocol https - + Protocol https

Vous pouvez aussi spécifier le protocole via la directive Listen.

-AcceptFilter +AcceptFilter Listen @@ -3992,16 +3910,12 @@ l'option Registry-Strict est disponible dans les versions #!). Sur les systèmes Win32, cette ligne ressemble souvent à ceci :

- - #!C:/Perl/bin/perl.exe - + #!C:/Perl/bin/perl.exe

ou simplement, dans le cas où perl est dans le PATH :

- - #!perl - + #!perl

Avec ScriptInterpreterSource Registry, Windows va effectuer une recherche dans l'arborescence @@ -4106,9 +4020,7 @@ host

Il peut s'avérer utile de définir une adresse dédiée à l'administration du serveur, par exemple :

- - ServerAdmin www-admin@foo.example.com - + ServerAdmin www-admin@foo.example.com

car les utilisateurs ne mentionnent pas systématiquement le serveur dont ils parlent !

@@ -4129,15 +4041,15 @@ serveurs virtuels à base de nom nom. La directive ServerAlias peut contenir des caractères génériques, si nécessaire.

- - <VirtualHost *:80>
- ServerName serveur.example.com
- ServerAlias serveur serveur2.example.com serveur2
- ServerAlias *.example.com
- UseCanonicalName Off
- # ...
- </VirtualHost> - + +<VirtualHost *:80> + ServerName server.example.com + ServerAlias server server2.example.com server2 + ServerAlias *.example.com + UseCanonicalName Off + # ... +</VirtualHost> +

La recherche du serveur virtuel à base de nom correspondant au plus près à la requête s'effectue selon l'ordre d'apparition des directives web s'identifie avec cet alias, vous devez utilisez la définition suivante :

- - ServerName www.example.com - + ServerName www.example.com

La directive ServerName peut apparaître à toutes les étapes de la définition du serveur. Toute occurrence @@ -4284,9 +4194,7 @@ serveur module="mod_so">LoadModule) seront définis par rapport à ce répertoire.

- Example - ServerRoot /home/httpd - + ServerRoot "/home/httpd"

La valeur par défaut de ServerRoot peut être modifiée via l'argument --prefix de la commande

ServerTokens Full (ou non spécifié)
-
Le serveur envoie par exemple : Server: Apache/2.4.1 +
Le serveur envoie par exemple : Server: Apache/2.4.2 (Unix) PHP/4.2.2 MyMod/1.2
- - - -
ServerTokens Prod[uctOnly]
+
ServerTokens Prod[uctOnly]
Le serveur renvoie (par exemple): Server: Apache
@@ -4384,12 +4289,12 @@ HTTP
ServerTokens Min[imal]
Le serveur renvoie (par exemple): Server: - Apache/2.4.1
+ Apache/2.4.2
ServerTokens OS
Le serveur renvoie (par exemple): Server: - Apache/2.4.1 (Unix)
+ Apache/2.4.2 (Unix) @@ -4443,22 +4348,18 @@ host extensions, vous pouvez ajouter la ligne suivante dans un fichier .htaccess de ce répertoire :

- - SetHandler imap-file - + SetHandler imap-file

Autre exemple : si vous voulez que le serveur affiche un compte-rendu d'état chaque fois qu'une URL du type http://nom serveur/status est appelée, vous pouvez ajouter ceci dans httpd.conf :

- - <Location /status>
- - SetHandler server-status
- - </Location> - + +<Location "/status"> + SetHandler server-status +</Location> +

Vous pouvez écraser la définition antérieure d'une directive SetHandler en utilisant la valeur @@ -4525,13 +4426,11 @@ host fichiers du répertoire /www/data/ comme des inclusions côté serveur (SSI) :

- - <Directory /www/data/>
- - SetOutputFilter INCLUDES
- - </Directory> - + +<Directory "/www/data/"> + SetOutputFilter INCLUDES +</Directory> +

Si la directive comporte plusieurs filtres, ils doivent être séparés par des points-virgules, et spécifiés selon l'ordre dans @@ -4677,9 +4576,9 @@ host l'authentification, ceci va obliger l'utilisateur à s'authentifier deux fois (une première fois pour www et une seconde fois pour www.example.com -- voir la - foire aux questions sur ce sujet pour plus d'informations). Par - contre, si UseCanonicalName est définie à + href="http://wiki.apache.org/httpd/FAQ#Why_does_Apache_ask_for_my_password_twice_before_serving_a_file.3F">la + foire aux questions sur ce sujet pour plus d'informations). + Par contre, si UseCanonicalName est définie à Off, Apache httpd redirigera l'utilisateur vers http://www/splat/.

@@ -4797,17 +4696,15 @@ d'hôte spécifique ou à une adresse IP - Exemple - <VirtualHost 10.1.2.3:80>
- - ServerAdmin webmaster@host.example.com
- DocumentRoot /www/docs/host.example.com
- ServerName host.example.com
- ErrorLog logs/host.example.com-error_log
- TransferLog logs/host.example.com-access_log
- - </VirtualHost> - + +<VirtualHost 10.1.2.3:80> + ServerAdmin webmaster@host.example.com + DocumentRoot /www/docs/host.example.com + ServerName host.example.com + ErrorLog logs/host.example.com-error_log + TransferLog logs/host.example.com-access_log +</VirtualHost> +

Les adresses IPv6 doivent être entourées de crochets car dans le @@ -4815,17 +4712,15 @@ d'hôte spécifique ou à une adresse IP déterminé. Voici un exemple de serveur virtuel avec adresse IPv6 :

- - <VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80>
- - ServerAdmin webmaster@host.example.com
- DocumentRoot /www/docs/host.example.com
- ServerName host.example.com
- ErrorLog logs/host.example.com-error_log
- TransferLog logs/host.example.com-access_log
- - </VirtualHost> - + +<VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80> + ServerAdmin webmaster@host.example.com + DocumentRoot /www/docs/host.example.com + ServerName host.example.com + ErrorLog logs/host.example.com-error_log + TransferLog logs/host.example.com-access_log +</VirtualHost> +

Chaque serveur virtuel doit correspondre à une adresse IP, un port ou un nom d'hôte spécifique ; dans le premier cas, le serveur -- 2.40.0