You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2012/05/09 20:39:57 UTC
svn commit: r1336339 - /httpd/httpd/trunk/docs/manual/mod/core.xml.fr
Author: lgentis
Date: Wed May 9 18:39:57 2012
New Revision: 1336339
URL: http://svn.apache.org/viewvc?rev=1336339&view=rev
Log:
Update.
Modified:
httpd/httpd/trunk/docs/manual/mod/core.xml.fr
Modified: httpd/httpd/trunk/docs/manual/mod/core.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/core.xml.fr?rev=1336339&r1=1336338&r2=1336339&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/core.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/core.xml.fr Wed May 9 18:39:57 2012
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1302855:1332627 (outdated) -->
+<!-- English Revision : 1332627 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -55,7 +55,9 @@ sur les autres plates-formes.</compatibi
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 <code>ftp:</code> ou <code>nntp</code>:</p>
- <example>AcceptFilter nntp none</example>
+ <highlight language="config">
+ AcceptFilter nntp none
+ </highlight>
<p>Les noms de protocoles par défaut sont <code>https</code> pour le
port 443 et <code>http</code> pour tous les autres ports. Pour
@@ -64,10 +66,10 @@ sur les autres plates-formes.</compatibi
module="mpm_common">Listen</directive>.</p>
<p>Sous FreeBSD, les valeurs par défaut sont :</p>
- <example>
- AcceptFilter http httpready <br/>
- AcceptFilter https dataready
- </example>
+ <highlight language="config">
+AcceptFilter http httpready
+AcceptFilter https dataready
+ </highlight>
<p>Le filtre d'acceptation <code>httpready</code> 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.</compatibi
sektion=9">accf_data(9)</a>.</p>
<p>Sous Linux, les valeurs par défaut sont :</p>
- <example>
- AcceptFilter http data <br/>
- AcceptFilter https data
- </example>
+ <highlight language="config">
+AcceptFilter http data
+AcceptFilter https data
+ </highlight>
<p>Le filtre <code>TCP_DEFER_ACCEPT</code> 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.</compatibi
tcp.7.html">tcp(7)</a>.</p>
<p>Sous Windows, les valeurs par défaut sont :</p>
- <example>
- AcceptFilter http data <br/>
- AcceptFilter https data
- </example>
+ <highlight language="config">
+AcceptFilter http data
+AcceptFilter https data
+ </highlight>
<p>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.</compatibi
anti-spyware.</p>
</usage>
-<seealso><directive>Protocol</directive></seealso>
+<seealso><directive module="core">Protocol</directive></seealso>
</directivesynopsis>
<directivesynopsis>
@@ -186,16 +188,14 @@ supérieures</compatibility>
sur <code>PATH_INFO</code>. 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 :</p>
-
- <example>
- <Files "mes-chemins.shtml"><br />
- <indent>
- Options +Includes<br />
- SetOutputFilter INCLUDES<br />
- AcceptPathInfo On<br />
- </indent>
- </Files>
- </example>
+<highlight language="config">
+<Files "mypaths.shtml">
+ Options +Includes
+ SetOutputFilter INCLUDES
+ AcceptPathInfo On
+</Files>
+ </highlight>
+
</usage>
</directivesynopsis>
@@ -218,9 +218,7 @@ host</context>
href="#allowoverride">activés pour ce répertoire</a>. Par exemple
:</p>
- <example>
- AccessFileName .acl
- </example>
+ <highlight language="config">AccessFileName .acl</highlight>
<p>avant de renvoyer le document
<code>/usr/local/web/index.html</code>, le serveur va rechercher les
@@ -229,13 +227,11 @@ host</context>
pour y lire d'éventuelles directives, à moins quelles n'aient été
désactivées avec</p>
- <example>
- <Directory /><br />
- <indent>
- AllowOverride None<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory />
+ AllowOverride None
+</Directory>
+ </highlight>
</usage>
<seealso><directive module="core">AllowOverride</directive></seealso>
<seealso><a href="../configuring.html">Fichiers de configuration</a></seealso>
@@ -273,9 +269,7 @@ type de contenu d'une réponse est
types de média Internet (types MIME).
Par exemple :</p>
- <example>
- AddDefaultCharset utf-8
- </example>
+ <highlight language="config">AddDefaultCharset utf-8</highlight>
<p>La directive <directive>AddDefaultCharset</directive> ne doit
être utilisée que lorsque toutes les ressources textes auxquelles
@@ -512,9 +506,7 @@ All pour les versions antérieures
<p>Exemple :</p>
- <example>
- AllowOverride AuthConfig Indexes
- </example>
+ <highlight language="config">AllowOverride AuthConfig Indexes</highlight>
<p>Dans l'exemple ci-dessus, toutes les directives qui ne font
partie ni du groupe <code>AuthConfig</code>, ni du groupe
@@ -566,10 +558,10 @@ All pour les versions antérieures
<p>Example:</p>
- <example>
- AllowOverride None<br />
- AllowOverrideList Redirect RedirectMatch
- </example>
+ <highlight language="config">
+AllowOverride None
+AllowOverrideList Redirect RedirectMatch
+ </highlight>
<p>Dans l'exemple ci-dessus, seules les directives
<code>Redirect</code> et <code>RedirectMatch</code> sont autorisées.
@@ -577,10 +569,10 @@ All pour les versions antérieures
<p>Example:</p>
- <example>
- AllowOverride AuthConfig<br />
- AllowOverrideList CookieTracking CookieName
- </example>
+ <highlight language="config">
+AllowOverride AuthConfig
+AllowOverrideList CookieTracking CookieName
+ </highlight>
<p>Dans l'exemple ci-dessus, la directive <directive
module="core">AllowOverride</directive> autorise les directives du
@@ -675,9 +667,10 @@ host</context>
généré relativement à la valeur de la directive
<directive>ServerRoot</directive>.</p>
- <example><title>Exemple</title>
- DefaultRuntimeDir scratch/
- </example>
+ <p><strong>Example</strong></p>
+ <highlight language="config">
+DefaultRuntimeDir scratch/
+ </highlight>
<p>La valeur par défaut de la directive
<directive>DefaultRuntimeDir</directive> peut être modifiée en
@@ -721,9 +714,8 @@ DESACTIVÉS à partir des ve
être spécifiée avec la valeur <code>none</code>, c'est à dire sans
type de médium par défaut. Par exemple :</p>
- <example>
- DefaultType None
- </example>
+ <highlight language="config">DefaultType None</highlight>
+
<p><code>DefaultType None</code> n'est disponible que dans les
versions d'Apache 2.2.7 et supérieures.</p>
@@ -759,15 +751,15 @@ DESACTIVÉS à partir des ve
La portée de la variable est toujours globale, et n'est jamais
limitée à la section de configuration courante.</p>
- <example>
- <IfDefine TEST><br/>
- Define servername test.example.com<br/>
- </IfDefine><br/>
- <IfDefine !TEST><br/>
- Define servername www.example.com<br/>
- Define SSL<br/>
- </IfDefine><br/>
- </example>
+ <highlight language="config">
+<IfDefine TEST>
+ Define servername test.example.com
+</IfDefine>
+<IfDefine !TEST>
+ Define servername www.example.com
+ Define SSL
+</IfDefine>
+ </highlight>
<p>Le caractère ":" est interdit dans les noms de variables afin
d'éviter les conflits avec la syntaxe de la directive <directive
@@ -805,13 +797,11 @@ host</context>
* <code>/home/user/public_html</code>, alors que <code><Directory
/home/*/public_html></code> conviendra. Exemple :</p>
- <example>
- <Directory /usr/local/httpd/htdocs><br />
- <indent>
- Options Indexes FollowSymLinks<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory "/usr/local/httpd/htdocs">
+ Options Indexes FollowSymLinks
+</Directory>
+ </highlight>
<note>
<p>Soyez prudent avec l'argument <var>chemin répertoire</var> : il
@@ -827,9 +817,11 @@ host</context>
peuvent aussi être utilisées en ajoutant le caractère
<code>~</code>. Par exemple :</p>
- <example>
- <Directory ~ "^/www/.*/[0-9]{3}">
- </example>
+ <highlight language="config">
+<Directory ~ "^/www/.*/[0-9]{3}">
+
+</Directory>
+</highlight>
<p>pourra correspondre à tout répertoire situé dans /www/ et dont le
nom se compose de trois chiffres.</p>
@@ -843,19 +835,15 @@ host</context>
directives des fichiers <a href="#accessfilename">.htaccess</a>. Par
exemple, avec</p>
- <example>
- <Directory /><br />
- <indent>
- AllowOverride None<br />
- </indent>
- </Directory><br />
- <br />
- <Directory /home><br />
- <indent>
- AllowOverride FileInfo<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory />
+ AllowOverride None
+</Directory>
+
+<Directory "/home">
+ AllowOverride FileInfo
+</Directory>
+ </highlight>
<p>l'accès au document <code>/home/web/dir/doc.html</code> emprunte
le chemin suivant :</p>
@@ -880,13 +868,11 @@ host</context>
testés selon l'ordre dans lequel ils apparaissent dans le fichier de
configuration. Par exemple, avec</p>
- <example>
- <Directory ~ abc$><br />
- <indent>
- # ... directives here ...<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory ~ "abc$">
+ # ... directives ici ...
+</Directory>
+ </highlight>
<p>la section avec expression rationnelle ne sera prise en compte
qu'après les sections <directive
@@ -902,13 +888,11 @@ host</context>
correspondant à une URL. Il est recommandé de modifier cette
situation à l'aide d'un bloc du style</strong></p>
- <example>
- <Directory /><br />
- <indent>
- Require all denied<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory />
+ Require all denied
+</Directory>
+ </highlight>
<p><strong>puis d'affiner la configuration pour les répertoires que vous
voulez rendre accessibles. Voir la page <a
@@ -947,9 +931,11 @@ du système de fichiers correspond
répertoire est précisé sous la forme d'une <glossary
ref="regex">expression rationnelle</glossary>. Par exemple :</p>
- <example>
- <DirectoryMatch "^/www/(.+/)?[0-9]{3}">
- </example>
+ <highlight language="config">
+<DirectoryMatch "^/www/(.+/)?[0-9]{3}">
+ # ...
+</DirectoryMatch>
+</highlight>
<p>conviendrait pour les sous-répertoires de <code>/www/</code> dont
le nom se compose de trois chiffres.</p>
@@ -998,9 +984,7 @@ host</context>
de l'URL sera ajouté par le serveur à la racine des documents afin
de construire le chemin du document recherché. Exemple :</p>
- <example>
- DocumentRoot /usr/web
- </example>
+ <highlight language="config">DocumentRoot "/usr/web"</highlight>
<p>un accès à <code>http://my.example.com/index.html</code> se
réfère alors à <code>/usr/web/index.html</code>. Si <var>chemin
@@ -1037,14 +1021,14 @@ requête à l'exécutio
supérieure et dans la même portée n'ont pas été satisfaites. Par
exemple, dans :</p>
- <example>
- <If "-z req('Host')"><br/>
- ...<br/>
- </If><br/>
- <Else><br/>
- ...<br/>
- </Else><br/>
- </example>
+ <highlight language="config">
+<If "-z req('Host')">
+ # ...
+</If>
+<Else>
+ # ...
+</Else>
+ </highlight>
<p>La condition de la section <directive
type="section">If</directive> serait satisfaite pour les requêtes
@@ -1084,17 +1068,17 @@ type="section">ElseIf</directive> pr&eac
ou <directive type="section">ElseIf</directive> de la même portée ne
l'est pas. Par exemple, dans :</p>
- <example>
- <If "-R '10.1.0.0/16'"><br/>
- ...<br/>
- </If><br/>
- <ElseIf "-R '10.0.0.0/8'"><br/>
- ...<br/>
- </ElseIf><br/>
- <Else><br/>
- ...<br/>
- </Else><br/>
- </example>
+ <highlight language="config">
+<If "-R '10.1.0.0/16'">
+ #...
+</If>
+<ElseIf "-R '10.0.0.0/8'">
+ #...
+</ElseIf>
+<Else>
+ #...
+</Else>
+ </highlight>
<p>La condition correspondant à la section <directive
type="section">ElseIf</directive> est satisfaite si l'adresse
@@ -1154,21 +1138,17 @@ host</context>
problème, il est préférable de désactiver la projection en mémoire
des fichiers servis en spécifiant :</p>
- <example>
- EnableMMAP Off
- </example>
+ <highlight language="config">EnableMMAP Off</highlight>
<p>Pour les montages NFS, cette fonctionnalité peut être
explicitement désactivée pour les fichiers concernés en spécifiant
:</p>
- <example>
- <Directory "/chemin vers montage NFS">
- <indent>
- EnableMMAP Off
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory "/path-to-nfs-files">
+ EnableMMAP Off
+</Directory>
+ </highlight>
</usage>
</directivesynopsis>
@@ -1224,21 +1204,17 @@ supérieures. Par défaut &a
problème, vous pouvez activer cette fonctionnalité en
spécifiant :</p>
- <example>
- EnableSendfile On
- </example>
+ <highlight language="config">EnableSendfile On</highlight>
<p>Pour les montages réseau, cette fonctionnalité peut être
explicitement désactivée pour les fichiers concernés en spécifiant
:</p>
- <example>
- <Directory "/chemin vers montage réseau">
- <indent>
- EnableSendfile Off
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory "/path-to-nfs-files">
+ EnableSendfile Off
+</Directory>
+ </highlight>
<p>Veuillez noter que la configuration de la directive
<directive>EnableSendfile</directive> dans un contexte de répertoire
ou de fichier .htaccess n'est pas supportée par
@@ -1265,26 +1241,25 @@ d'erreur personnalisé</descriptio
directive peut être utilisée pour générer un message d'erreur
personnalisé, et interrompre la lecture de la configuration. </p>
- <example><title>Exemple</title>
- # vérification du chargement de mod_include<br />
- <IfModule !include_module><br />
- Error mod_foo nécessite mod_include. Chargez-le via LoadModule.<br />
- </IfModule><br />
- <br />
- # vérification de la définition de SSL ou (exclusif) NOSSL<br />
- <IfDefine SSL><br />
- <IfDefine NOSSL><br />
- Error SSL et NOSSL sont définies. Vous devez définir soit l'une,
- soit l'autre.<br />
- </IfDefine><br />
- </IfDefine><br />
- <IfDefine !SSL><br />
- <IfDefine !NOSSL><br />
- Error Vous devez définir une et une seule des deux variables SSL
- ou NOSSL.<br />
- </IfDefine><br />
- </IfDefine><br />
- </example>
+ <highlight language="config">
+# 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>
+ </highlight>
</usage>
</directivesynopsis>
@@ -1330,14 +1305,13 @@ host</context>
Alternativement, un message à afficher par le navigateur pourra être
fourni. Exemples :</p>
- <example>
- ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
- ErrorDocument 404 /cgi-bin/bad_urls.pl<br />
- ErrorDocument 401 /subscription_info.html<br />
- ErrorDocument 403 "Désolé, vous n'avez pas l'autorisation d'accès
- aujourd'hui"<br />
- ErrorDocument 403 Interdit!
- </example>
+ <highlight language="config">
+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!
+ </highlight>
<p>De plus, on peut spécifier la valeur spéciale <code>default</code>
pour indiquer l'utilisation d'un simple message d'Apache httpd codé en
@@ -1347,14 +1321,13 @@ host</context>
les configurations qui sans cela, hériteraient d'une directive
<directive>ErrorDocument</directive> existante.</p>
- <example>
- ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
- <Directory /web/docs><br />
- <indent>
- ErrorDocument 404 default<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+ErrorDocument 404 /cgi-bin/bad_urls.pl
+
+<Directory /web/docs>
+ ErrorDocument 404 default
+</Directory>
+ </highlight>
<p>Notez que lorsque vous spécifiez une directive
<directive>ErrorDocument</directive> pointant vers une URL distante
@@ -1425,17 +1398,13 @@ host</context>
absolu, il est considéré comme relatif au chemin défini par la
directive <directive module="core">ServerRoot</directive>.</p>
- <example><title>Exemple</title>
- ErrorLog /var/log/httpd/error_log
- </example>
+ <highlight language="config">ErrorLog "/var/log/httpd/error_log"</highlight>
<p>Si le <var>chemin fichier</var> commence par une barre verticale
"<code>(|)</code>", il est considéré comme une commande à lancer pour traiter la
journalisation de l'erreur.</p>
- <example><title>Exemple</title>
- ErrorLog "|/usr/local/bin/erreurs_httpd"
- </example>
+ <highlight language="config">ErrorLog "|/usr/local/bin/httpd_errors"</highlight>
<p>Voir les notes à propos des <a href="../logs.html#piped">journaux
redirigés</a> pour plus d'informations.</p>
@@ -1450,9 +1419,7 @@ host</context>
global, et si il est modifié dans un serveur virtuel, le dispositif
final spécifié affecte l'ensemble du serveur</p>
- <example><title>Exemple</title>
- ErrorLog syslog:user
- </example>
+ <highlight language="config">ErrorLog syslog:user</highlight>
<p>SECURITE : Voir le document <a
href="../misc/security_tips.html#serverroot">conseils à propos de
@@ -1486,9 +1453,10 @@ host</context>
spécifier quelles informations supplémentaires vont être enregistrées
dans le journal des erreurs en plus du message habituel.</p>
- <example><title>Exemple simple</title>
- ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"
- </example>
+ <highlight language="config">
+# Exemple simple
+ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"
+ </highlight>
<p>La spécification de <code>connection</code> ou
<code>request</code> comme premier paramètre permet de définir des
@@ -1670,10 +1638,10 @@ host</context>
c'est son identifiant unique qui sera utilisé comme identifiant de
journal pour les requêtes.</p>
- <example><title>Exemple (format par défaut)</title>
- ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a]
- %M% ,\ referer\ %{Referer}i"
- </example>
+ <highlight language="config">
+# Exemple (format par défaut)
+ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"
+ </highlight>
<p>Cet exemple renverrait un message d'erreur du style :</p>
@@ -1684,19 +1652,19 @@ host</context>
<p>Notez que, comme indiqué plus haut, certains champs sont
totalement supprimés s'ils n'ont pas été définis.</p>
- <example><title>Exemple (similaire au format 2.2.x)</title>
- ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a]
- %M% ,\ referer\ %{Referer}i"
- </example>
-
- <example><title>Exemple avancé avec identifiants journal de
- requête/connexion</title>
- ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"<br/>
- ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"<br/>
- ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"<br/>
- ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"<br/>
- ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"<br/>
- </example>
+ <highlight language="config">
+# Exemple (similaire au format 2.2.x)
+ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"
+ </highlight>
+
+ <highlight language="config">
+# 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"
+ </highlight>
</usage>
<seealso><directive module="core">ErrorLog</directive></seealso>
@@ -1780,8 +1748,8 @@ dans les versions 2.3.14 et antér
<dd>La taille du fichier en octets sera incluse</dd>
<dt><strong>All</strong></dt>
<dd>Tous les champs disponibles seront utilisés. Cette définition
- est équivalente à : <example>FileETag INode MTime
- Size</example></dd>
+ est équivalente à :
+ <highlight language="config">FileETag INode MTime Size</highlight></dd>
<dt><strong>None</strong></dt>
<dd>Si le document se compose d'un fichier, aucun champ
<code>ETag</code> ne sera inclus dans la réponse</dd>
@@ -1861,9 +1829,11 @@ host</context>
ref="regex">Expressions rationnelles</glossary> en ajoutant la
caractère <code>~</code>. Par exemple :</p>
- <example>
- <Files ~ "\.(gif|jpe?g|png)$">
- </example>
+ <highlight language="config">
+<Files ~ "\.(gif|jpe?g|png)$">
+ #...
+</Files>
+</highlight>
<p>correspondrait à la plupart des formats graphiques de l'Internet.
Il est cependant préférable d'utiliser la directive <directive
@@ -1904,9 +1874,11 @@ host</context>
<glossary ref="regex">expressions rationnelles</glossary>. Par
exemple :</p>
- <example>
- <FilesMatch "\.(gif|jpe?g|png)$">
- </example>
+ <highlight language="config">
+<FilesMatch "\.(gif|jpe?g|png)$">
+ # ...
+</FilesMatch>
+</highlight>
<p>correspondrait à la plupart des formats graphiques de
l'Internet.</p>
@@ -1941,9 +1913,7 @@ HTTP Content-Type pour les fichiers corr
pas leur ajouter l'extension <code>.gif</code>, vous pouvez utiliser
:</p>
- <example>
- ForceType image/gif
- </example>
+ <highlight language="config">ForceType image/gif</highlight>
<p>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 corr
<directive>ForceType</directive> en affectant la valeur
<code>None</code> à l'argument <var>type médium</var> :</p>
- <example>
- # force le type MIME de tous les fichiers à image/gif:<br />
- <Location /images><br />
- <indent>
- ForceType image/gif<br />
- </indent>
- </Location><br />
- <br />
- # mais utilise les méthodes classiques d'attribution du type MIME
- # dans le sous-répertoire suivant :<br />
- <Location /images/mixed><br />
- <indent>
- ForceType None<br />
- </indent>
- </Location>
- </example>
+ <highlight language="config">
+# 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>
+ </highlight>
<p>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</context>
si et seulement si l'expression renvoie la valeur "vrai". Par
exemple :</p>
- <example>
- <If "-z req('Host')">
- </example>
+ <highlight language="config"><If "-z req('Host')"></highlight>
<p>serait satisfaite pour les requêtes HTTP/1.0 sans en-tête
<var>Host:</var>. Les expressions peuvent contenir différents
@@ -2083,9 +2047,7 @@ host</context>
à usages divers (<code>-n</code>, <code>-z</code>, <code>-f</code>,
...). Les expressions rationnelles sont aussi supportées,</p>
- <example>
- <If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/">
- </example>
+ <highlight language="config"><If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/"></highlight>
<p>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</context>
peuvent être imbriquées, ce qui permet d'implémenter un test
multi-paramètres simple. Exemple :</p>
- <example>
- httpd -DReverseProxy -DUseCache -DMemCache ...<br />
- <br />
- # httpd.conf<br />
- <IfDefine ReverseProxy><br />
- <indent>
- LoadModule proxy_module modules/mod_proxy.so<br />
- LoadModule proxy_http_module modules/mod_proxy_http.so<br />
- <IfDefine UseCache><br />
- <indent>
- LoadModule cache_module modules/mod_cache.so<br />
- <IfDefine MemCache><br />
- <indent>
- LoadModule mem_cache_module modules/mod_mem_cache.so<br />
- </indent>
- </IfDefine><br />
- <IfDefine !MemCache><br />
- <indent>
- LoadModule cache_disk_module modules/mod_cache_disk.so<br />
- </indent>
- </IfDefine>
- </indent>
- </IfDefine>
- </indent>
- </IfDefine>
- </example>
+ <example>httpd -DReverseProxy -DUseCache -DMemCache ...</example>
+ <highlight language="config">
+<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>
+ </highlight>
</usage>
</directivesynopsis>
@@ -2287,35 +2239,31 @@ version 2.3.6</compatibility>
<p>Exemples :</p>
- <example>
- Include /usr/local/apache2/conf/ssl.conf<br />
- Include /usr/local/apache2/conf/vhosts/*.conf
- </example>
+ <highlight language="config">
+Include /usr/local/apache2/conf/ssl.conf
+Include /usr/local/apache2/conf/vhosts/*.conf
+ </highlight>
<p>ou encore, avec des chemins relatifs au répertoire défini par la
directive <directive module="core">ServerRoot</directive> :</p>
- <example>
- Include conf/ssl.conf<br />
- Include conf/vhosts/*.conf
- </example>
+ <highlight language="config">
+Include conf/ssl.conf
+Include conf/vhosts/*.conf
+ </highlight>
<p>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 :</p>
- <example>
- Include conf/vhosts/*/*.conf
- </example>
+ <highlight language="config">Include conf/vhosts/*/*.conf</highlight>
<p>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 :</p>
- <example>
- IncludeOptional conf/vhosts/*/*.conf
- </example>
+ <highlight language="config">IncludeOptional conf/vhosts/*/*.conf</highlight>
</usage>
@@ -2448,13 +2396,11 @@ certaines méthodes HTTP</descript
<code>DELETE</code>, en laissant les autres méthodes sans protection
:</p>
- <example>
- <Limit POST PUT DELETE><br />
- <indent>
- Require valid-user<br />
- </indent>
- </Limit>
- </example>
+ <highlight language="config">
+<Limit POST PUT DELETE>
+ Require valid-user
+</Limit>
+ </highlight>
<p>La liste des noms de méthodes peut contenir une ou plusieurs
valeurs parmi les suivantes : <code>GET</code>, <code>POST</code>,
@@ -2497,18 +2443,14 @@ certaines méthodes HTTP</descript
<code>POST</code>, et la directive <code>Require group
editors</code> sera ignorée dans tous les cas :</p>
- <example>
- <LimitExcept GET>
- <indent>
- Require valid-user
- </indent>
- </LimitExcept><br />
- <Limit POST>
- <indent>
- Require group editors
- </indent>
- </Limit>
- </example>
+ <highlight language="config">
+<LimitExcept GET>
+ Require valid-user
+</LimitExcept>
+<Limit POST>
+ Require group editors
+</Limit>
+ </highlight>
</usage>
</directivesynopsis>
@@ -2537,13 +2479,11 @@ sauf celles qui sont spécifi&eacu
<p>Par exemple :</p>
- <example>
- <LimitExcept POST GET><br />
- <indent>
- Require valid-user<br />
- </indent>
- </LimitExcept>
- </example>
+ <highlight language="config">
+<LimitExcept POST GET>
+ Require valid-user
+</LimitExcept>
+ </highlight>
</usage>
</directivesynopsis>
@@ -2581,9 +2521,7 @@ host</context>
maximum des sous-requêtes. Si vous ne spécifiez qu'un seul
<var>nombre</var>, il sera affecté aux deux limites.</p>
- <example><title>Exemple</title>
- LimitInternalRecursion 5
- </example>
+ <highlight language="config">LimitInternalRecursion 5</highlight>
</usage>
</directivesynopsis>
@@ -2630,9 +2568,7 @@ host</context>
fichiers chargés à 100Ko, vous pouvez utiliser la directive suivante
:</p>
- <example>
- LimitRequestBody 102400
- </example>
+ <highlight language="config">LimitRequestBody 102400</highlight>
<note><p>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</description>
<p>Par exemple :</p>
- <example>
- LimitRequestFields 50
- </example>
+ <highlight language="config">LimitRequestFields 50</highlight>
<note type="warning"><title>Avertissement</title>
<p>Dans le cas des serveurs virtuels à base de noms, la valeur de
@@ -2721,9 +2655,7 @@ requête HTTP</description>
<p>Par exemple ::</p>
- <example>
- LimitRequestFieldSize 4094
- </example>
+ <highlight language="config">LimitRequestFieldSize 4094</highlight>
<note>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</description>
<p>Par exemple :</p>
- <example>
- LimitRequestLine 4094
- </example>
+ <highlight language="config">LimitRequestLine 4094</highlight>
<note>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</context>
<p>Exemple :</p>
- <example>
- LimitXMLRequestBody 0
- </example>
+ <highlight language="config">LimitXMLRequestBody 0</highlight>
</usage>
</directivesynopsis>
@@ -2867,19 +2795,21 @@ host</context>
directives contenues dans la section s'appliqueront à /private1,
/private1/ et /private1/file.txt, mais pas à /private1other.
</p>
- <example>
- <Location /private1>
- ...
- </example>
+ <highlight language="config">
+<Location /private1>
+ # ...
+</Location>
+ </highlight>
<p>
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.
</p>
- <example>
- <Location /private2<em>/</em>>
- ...
- </example>
+ <highlight language="config">
+<Location /private2<em>/</em>>
+ # ...
+</Location>
+ </highlight>
<note><title>Quand utiliser la section <directive
type="section">Location</directive></title>
@@ -2913,9 +2843,11 @@ host</context>
rationnelles</glossary>, moyennant l'addition d'un caractère
<code>~</code>. Par exemple :</p>
- <example>
- <Location ~ "/(extra|special)/data">
- </example>
+ <highlight language="config">
+<Location ~ "/(extra|special)/data">
+ #...
+</Location>
+</highlight>
<p>concernerait les URLs contenant les sous-chaîne
<code>/extra/data</code> ou <code>/special/data</code>. La directive
@@ -2934,14 +2866,12 @@ host</context>
appartenant au domaine <code>example.com</code>, vous pouvez
utiliser :</p>
- <example>
- <Location /status><br />
- <indent>
- SetHandler server-status<br />
- Require host example.com<br />
- </indent>
- </Location>
- </example>
+ <highlight language="config">
+<Location /status>
+ SetHandler server-status
+ Require host example.com
+</Location>
+ </highlight>
<note><title>Note à propos du slash (/)</title>
<p>La signification du caractère slash dépend de l'endroit où il
@@ -2996,9 +2926,11 @@ host</context>
ref="regex">expression rationnelle</glossary> au lieu d'une simple
chaîne de caractères. Par exemple :</p>
- <example>
- <LocationMatch "/(extra|special)/data">
- </example>
+ <highlight language="config">
+<LocationMatch "/(extra|special)/data">
+ # ...
+</LocationMatch>
+</highlight>
<p>correspondrait à toute URL contenant les sous-chaînes
<code>/extra/data</code> ou <code>/special/data</code>.</p>
@@ -3177,9 +3109,7 @@ Apache</compatibility>
<p>Par exemple :</p>
- <example>
- LogLevel notice
- </example>
+ <highlight language="config">LogLevel notice</highlight>
<note><title>Note</title>
<p>Si la journalisation s'effectue directement dans un fichier,
@@ -3196,21 +3126,21 @@ Apache</compatibility>
identificateur, avec ou sans le suffixe <code>_module</code>. Les
trois spécifications suivantes sont donc équivalentes :</p>
- <example>
- LogLevel info ssl:warn<br />
- LogLevel info mod_ssl.c:warn<br />
- LogLevel info ssl_module:warn<br />
- </example>
+ <highlight language="config">
+LogLevel info ssl:warn
+LogLevel info mod_ssl.c:warn
+LogLevel info ssl_module:warn
+ </highlight>
<p>Il est aussi possible d'attribuer un niveau de journalisation par
répertoire :</p>
- <example>
- LogLevel info<br />
- <Directory /usr/local/apache/htdocs/app><br />
- LogLevel debug<br />
- </Files>
- </example>
+ <highlight language="config">
+LogLevel info
+<Directory "/usr/local/apache/htdocs/app">
+ LogLevel debug
+</Directory>
+ </highlight>
<note>
La configuration du niveau de journalisation par répertoire
@@ -3242,9 +3172,7 @@ host</context>
<p>Par exemple :</p>
- <example>
- MaxKeepAliveRequests 500
- </example>
+ <highlight language="config">MaxKeepAliveRequests 500</highlight>
</usage>
</directivesynopsis>
@@ -3598,10 +3526,10 @@ verrou pour tous les mutex ou seulement
mutex par défaut pour tous les autres mutex deviendra
<code>sysvsem</code>.</p>
- <example>
- Mutex sysvsem default<br />
- Mutex fcntl:/var/httpd/locks mpm-accept
- </example>
+ <highlight language="config">
+Mutex sysvsem default
+Mutex fcntl:/var/httpd/locks mpm-accept
+ </highlight>
</usage>
</directivesynopsis>
@@ -3766,38 +3694,30 @@ host</context>
<p>Par exemple, sans aucun symbole <code>+</code> et <code>-</code>
:</p>
- <example>
- <Directory /web/docs><br />
- <indent>
- Options Indexes FollowSymLinks<br />
- </indent>
- </Directory><br />
- <br />
- <Directory /web/docs/spec><br />
- <indent>
- Options Includes<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory "/web/docs">
+ Options Indexes FollowSymLinks
+</Directory>
+
+<Directory "/web/docs/spec">
+ Options Includes
+</Directory>
+ </highlight>
<p>ici, seule l'option <code>Includes</code> sera prise en compte
pour le répertoire <code>/web/docs/spec</code>. Par contre, si la
seconde directive <directive>Options</directive> utilise les
symboles <code>+</code> et <code>-</code> :</p>
- <example>
- <Directory /web/docs><br />
- <indent>
- Options Indexes FollowSymLinks<br />
- </indent>
- </Directory><br />
- <br />
- <Directory /web/docs/spec><br />
- <indent>
- Options +Includes -Indexes<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory "/web/docs">
+ Options Indexes FollowSymLinks
+</Directory>
+
+<Directory "/web/docs/spec">
+ Options +Includes -Indexes
+</Directory>
+ </highlight>
<p>alors, les options <code>FollowSymLinks</code> et
<code>Includes</code> seront prises en compte pour le répertoire
@@ -3838,14 +3758,12 @@ seulement depuis la version 2.3.3 sous W
<code>https</code> sur un port non standard, spécifiez le protocole
de manière explicite :</p>
- <example>
- Protocol https
- </example>
+ <highlight language="config">Protocol https</highlight>
<p>Vous pouvez aussi spécifier le protocole via la directive
<directive module="mpm_common">Listen</directive>.</p>
</usage>
-<seealso><directive>AcceptFilter</directive></seealso>
+<seealso><directive module="core">AcceptFilter</directive></seealso>
<seealso><directive module="mpm_common">Listen</directive></seealso>
</directivesynopsis>
@@ -3992,16 +3910,12 @@ l'option <code>Registry-Strict</code> es
<code>#!</code>). Sur les systèmes Win32, cette ligne ressemble
souvent à ceci :</p>
- <example>
- #!C:/Perl/bin/perl.exe
- </example>
+ <highlight language="perl">#!C:/Perl/bin/perl.exe</highlight>
<p>ou simplement, dans le cas où <code>perl</code> est dans le
<code>PATH</code> :</p>
- <example>
- #!perl
- </example>
+ <highlight language="perl">#!perl</highlight>
<p>Avec <code>ScriptInterpreterSource Registry</code>, Windows va
effectuer une recherche dans l'arborescence
@@ -4106,9 +4020,7 @@ host</context>
<p>Il peut s'avérer utile de définir une adresse dédiée à
l'administration du serveur, par exemple :</p>
- <example>
- ServerAdmin www-admin@foo.example.com
- </example>
+ <highlight language="config">ServerAdmin www-admin@foo.example.com</highlight>
<p>car les utilisateurs ne mentionnent pas systématiquement le
serveur dont ils parlent !</p>
</usage>
@@ -4129,15 +4041,15 @@ serveurs virtuels à base de nom</
nom</a>. La directive <directive>ServerAlias</directive> peut
contenir des caractères génériques, si nécessaire.</p>
- <example>
- <VirtualHost *:80><br />
- ServerName serveur.example.com<br />
- ServerAlias serveur serveur2.example.com serveur2<br />
- ServerAlias *.example.com<br />
- UseCanonicalName Off<br />
- # ...<br />
- </VirtualHost>
- </example>
+ <highlight language="config">
+<VirtualHost *:80>
+ ServerName server.example.com
+ ServerAlias server server2.example.com server2
+ ServerAlias *.example.com
+ UseCanonicalName Off
+ # ...
+</VirtualHost>
+ </highlight>
<p>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 <directive type="section"
@@ -4183,9 +4095,7 @@ host</context>
web s'identifie avec cet alias, vous devez utilisez la définition
suivante :</p>
- <example>
- ServerName www.example.com
- </example>
+ <highlight language="config">ServerName www.example.com</highlight>
<p>La directive <directive>ServerName</directive> peut apparaître à
toutes les étapes de la définition du serveur. Toute occurrence
@@ -4284,9 +4194,7 @@ serveur</description>
module="mod_so">LoadModule</directive>) seront définis par
rapport à ce répertoire.</p>
- <example><title>Example</title>
- ServerRoot /home/httpd
- </example>
+ <highlight language="config">ServerRoot "/home/httpd"</highlight>
<p>La valeur par défaut de <directive>ServerRoot</directive> peut
être modifiée via l'argument <code>--prefix</code> de la commande <a
@@ -4360,13 +4268,10 @@ HTTP</description>
<dl>
<dt><code>ServerTokens Full</code> (ou non spécifié)</dt>
- <dd>Le serveur envoie par exemple : <code>Server: Apache/2.4.1
+ <dd>Le serveur envoie par exemple : <code>Server: Apache/2.4.2
(Unix) PHP/4.2.2 MyMod/1.2</code></dd>
-
-
-
- <dt><code>ServerTokens Prod[uctOnly]</code></dt>
+ <dt><code>ServerTokens Prod[uctOnly]</code></dt>
<dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
Apache</code></dd>
@@ -4384,12 +4289,12 @@ HTTP</description>
<dt><code>ServerTokens Min[imal]</code></dt>
<dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
- Apache/2.4.1</code></dd>
+ Apache/2.4.2</code></dd>
<dt><code>ServerTokens OS</code></dt>
<dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
- Apache/2.4.1 (Unix)</code></dd>
+ Apache/2.4.2 (Unix)</code></dd>
@@ -4443,22 +4348,18 @@ host</context>
extensions, vous pouvez ajouter la ligne suivante dans un fichier
<code>.htaccess</code> de ce répertoire :</p>
- <example>
- SetHandler imap-file
- </example>
+ <highlight language="config">SetHandler imap-file</highlight>
<p>Autre exemple : si vous voulez que le serveur affiche un
compte-rendu d'état chaque fois qu'une URL du type <code>http://nom
serveur/status</code> est appelée, vous pouvez ajouter ceci dans
<code>httpd.conf</code> :</p>
- <example>
- <Location /status><br />
- <indent>
- SetHandler server-status<br />
- </indent>
- </Location>
- </example>
+ <highlight language="config">
+<Location "/status">
+ SetHandler server-status
+</Location>
+ </highlight>
<p>Vous pouvez écraser la définition antérieure d'une directive
<directive>SetHandler</directive> en utilisant la valeur
@@ -4525,13 +4426,11 @@ host</context>
fichiers du répertoire <code>/www/data/</code> comme des inclusions
côté serveur (SSI) :</p>
- <example>
- <Directory /www/data/><br />
- <indent>
- SetOutputFilter INCLUDES<br />
- </indent>
- </Directory>
- </example>
+ <highlight language="config">
+<Directory "/www/data/">
+ SetOutputFilter INCLUDES
+</Directory>
+ </highlight>
<p>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</context>
l'authentification, ceci va obliger l'utilisateur à s'authentifier
deux fois (une première fois pour <code>www</code> et une seconde
fois pour <code>www.example.com</code> -- voir <a
- href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">la
- foire aux questions sur ce sujet pour plus d'informations</a>). Par
- contre, si <directive>UseCanonicalName</directive> 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</a>).
+ Par contre, si <directive>UseCanonicalName</directive> est définie à
<code>Off</code>, Apache httpd redirigera l'utilisateur vers
<code>http://www/splat/</code>.</p>
@@ -4797,17 +4696,15 @@ d'hôte spécifique ou &agrav
</ul>
- <example><title>Exemple</title>
- <VirtualHost 10.1.2.3:80><br />
- <indent>
- ServerAdmin webmaster@host.example.com<br />
- DocumentRoot /www/docs/host.example.com<br />
- ServerName host.example.com<br />
- ErrorLog logs/host.example.com-error_log<br />
- TransferLog logs/host.example.com-access_log<br />
- </indent>
- </VirtualHost>
- </example>
+ <highlight language="config">
+<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>
+ </highlight>
<p>Les adresses IPv6 doivent être entourées de crochets car dans le
@@ -4815,17 +4712,15 @@ d'hôte spécifique ou &agrav
déterminé. Voici un exemple de serveur virtuel avec adresse IPv6
:</p>
- <example>
- <VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80><br />
- <indent>
- ServerAdmin webmaster@host.example.com<br />
- DocumentRoot /www/docs/host.example.com<br />
- ServerName host.example.com<br />
- ErrorLog logs/host.example.com-error_log<br />
- TransferLog logs/host.example.com-access_log<br />
- </indent>
- </VirtualHost>
- </example>
+ <highlight language="config">
+<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>
+ </highlight>
<p>Chaque serveur virtuel doit correspondre à une adresse IP, un
port ou un nom d'hôte spécifique ; dans le premier cas, le serveur