diff options
Diffstat (limited to 'docs/manual/mod/core.html.fr')
| -rw-r--r-- | docs/manual/mod/core.html.fr | 1029 |
1 files changed, 528 insertions, 501 deletions
diff --git a/docs/manual/mod/core.html.fr b/docs/manual/mod/core.html.fr index 93369abf..6af37d0f 100644 --- a/docs/manual/mod/core.html.fr +++ b/docs/manual/mod/core.html.fr @@ -8,11 +8,14 @@ <title>core - Serveur Apache HTTP</title> <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> -<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.js" type="text/javascript"> +</script> + <link href="../images/favicon.ico" rel="shortcut icon" /></head> <body> <div id="page-header"> -<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> <p class="apache">Serveur Apache HTTP Version 2.4</p> <img alt="" src="../images/feather.gif" /></div> <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> @@ -25,10 +28,11 @@ <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> | <a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español"> es </a> | <a href="../fr/mod/core.html" title="Français"> fr </a> | -<a href="../hold/mod/core.html" hreflang="hold" rel="alternate" title=""> hold </a> | <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> </div> +<div class="outofdate">Cette traduction peut être périmée. Vérifiez la version + anglaise pour les changements récents.</div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fonctionnalités de base du serveur HTTP Apache toujours disponibles</td></tr> <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Core</td></tr></table> @@ -113,7 +117,7 @@ disponibles</td></tr> <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li> </ul> -</div> +<ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">Directive</a></h2> @@ -141,7 +145,10 @@ sur les autres plates-formes.</td></tr> 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> - <div class="example"><p><code>AcceptFilter nntp none</code></p></div> + <pre class="prettyprint lang-config"> + AcceptFilter nntp none + </pre> + <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 @@ -149,10 +156,11 @@ sur les autres plates-formes.</td></tr> ajoutez l'argument <var>protocol</var> à la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p> <p>Sous FreeBSD, les valeurs par défaut sont :</p> - <div class="example"><p><code> - AcceptFilter http httpready <br /> - AcceptFilter https dataready - </code></p></div> + <pre class="prettyprint lang-config"> +AcceptFilter http httpready +AcceptFilter https dataready + </pre> + <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 @@ -161,10 +169,11 @@ sur les autres plates-formes.</td></tr> HTTPS sont chiffrées, celles-ci n'autorisent que le filtre <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data& sektion=9">accf_data(9)</a>.</p> <p>Sous Linux, les valeurs par défaut sont :</p> - <div class="example"><p><code> - AcceptFilter http data <br /> - AcceptFilter https data - </code></p></div> + <pre class="prettyprint lang-config"> +AcceptFilter http data +AcceptFilter https data + </pre> + <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 @@ -173,10 +182,11 @@ sur les autres plates-formes.</td></tr> manuel Linux de <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/ tcp.7.html">tcp(7)</a>.</p> <p>Sous Windows, les valeurs par défaut sont :</p> - <div class="example"><p><code> - AcceptFilter http data <br /> - AcceptFilter https data - </code></p></div> + <pre class="prettyprint lang-config"> +AcceptFilter http data +AcceptFilter https data + </pre> + <p>Le module MPM pour Windows mpm_winnt utilise la directive AcceptFilter comme commutateur de l'API AcceptEx(), et ne supporte @@ -200,7 +210,7 @@ sur les autres plates-formes.</td></tr> <h3>Voir aussi</h3> <ul> -<li><code class="directive">Protocol</code></li> +<li><code class="directive"><a href="#protocol">Protocol</a></code></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -262,16 +272,15 @@ supérieures</td></tr> 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> +<pre class="prettyprint lang-config"> +<Files "mypaths.shtml"> + Options +Includes + SetOutputFilter INCLUDES + AcceptPathInfo On +</Files> + </pre> - <div class="example"><p><code> - <Files "mes-chemins.shtml"><br /> - <span class="indent"> - Options +Includes<br /> - SetOutputFilter INCLUDES<br /> - AcceptPathInfo On<br /> - </span> - </Files> - </code></p></div> + </div> @@ -292,9 +301,8 @@ supérieures</td></tr> partir du moment où les fichiers de configuration distribués sont <a href="#allowoverride">activés pour ce répertoire</a>. Par exemple :</p> - <div class="example"><p><code> - AccessFileName .acl - </code></p></div> + <pre class="prettyprint lang-config">AccessFileName .acl</pre> + <p>avant de renvoyer le document <code>/usr/local/web/index.html</code>, le serveur va rechercher les @@ -303,13 +311,12 @@ supérieures</td></tr> pour y lire d'éventuelles directives, à moins quelles n'aient été désactivées avec</p> - <div class="example"><p><code> - <Directory /><br /> - <span class="indent"> - AllowOverride None<br /> - </span> - </Directory> - </code></p></div> + <pre class="prettyprint lang-config"> +<Directory /> + AllowOverride None +</Directory> + </pre> + <h3>Voir aussi</h3> <ul> @@ -348,9 +355,8 @@ type de contenu d'une réponse est <code>text/plain</code> ou types de média Internet (types MIME). Par exemple :</p> - <div class="example"><p><code> - AddDefaultCharset utf-8 - </code></p></div> + <pre class="prettyprint lang-config">AddDefaultCharset utf-8</pre> + <p>La directive <code class="directive">AddDefaultCharset</code> ne doit être utilisée que lorsque toutes les ressources textes auxquelles @@ -550,9 +556,8 @@ All pour les versions antérieures</code></td></tr> <p>Exemple :</p> - <div class="example"><p><code> - AllowOverride AuthConfig Indexes - </code></p></div> + <pre class="prettyprint lang-config">AllowOverride AuthConfig Indexes</pre> + <p>Dans l'exemple ci-dessus, toutes les directives qui ne font partie ni du groupe <code>AuthConfig</code>, ni du groupe @@ -604,10 +609,11 @@ All pour les versions antérieures</code></td></tr> <p>Example:</p> - <div class="example"><p><code> - AllowOverride None<br /> - AllowOverrideList Redirect RedirectMatch - </code></p></div> + <pre class="prettyprint lang-config"> +AllowOverride None +AllowOverrideList Redirect RedirectMatch + </pre> + <p>Dans l'exemple ci-dessus, seules les directives <code>Redirect</code> et <code>RedirectMatch</code> sont autorisées. @@ -615,10 +621,11 @@ All pour les versions antérieures</code></td></tr> <p>Example:</p> - <div class="example"><p><code> - AllowOverride AuthConfig<br /> - AllowOverrideList CookieTracking CookieName - </code></p></div> + <pre class="prettyprint lang-config"> +AllowOverride AuthConfig +AllowOverrideList CookieTracking CookieName + </pre> + <p>Dans l'exemple ci-dessus, la directive <code class="directive"><a href="#allowoverride">AllowOverride</a></code> autorise les directives du groupement <code>AuthConfig</code>, et @@ -698,41 +705,42 @@ dans la réponse HTTP</td></tr> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="DefaultRuntimeDir" id="DefaultRuntimeDir">DefaultRuntimeDir</a> <a name="defaultruntimedir" id="defaultruntimedir">Directive</a></h2> <table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire de base des fichiers créés par le serveur au -cours de son exécution</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultRuntimeDir <var>chemin</var></code></td></tr> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire de base des fichiers créés au cours de l'exécution du serveur</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultRuntimeDir <var>chemin-répertoire</var></code></td></tr> <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/)</code></td></tr> <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> </table> <p>La directive <code class="directive">DefaultRuntimeDir</code> 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 <code class="directive">ServerRoot</code>.</p> + 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 + <code class="directive">ServerRoot</code>.</p> - <div class="example"><h3>Exemple</h3><p><code> - DefaultRuntimeDir scratch/ - </code></p></div> + <p><strong>Example</strong></p> + <pre class="prettyprint lang-config"> +DefaultRuntimeDir scratch/ + </pre> - <p>Il est possible de modifier la valeur par défaut de la directive - <code class="directive">DefaultRuntimeDir</code> en redéfinissant la valeur - de la variable <code>DEFAULT_REL_RUNTIMEDIR</code> à la compilation.</p> - <p>Note: la directive <code class="directive">ServerRoot</code> doit être - déjà définie pour utiliser cette directive, car dans le cas - contraire, c'est la valeur par défaut de - <code class="directive">ServerRoot</code> qui sera utilisée pour construire - la répertoire de base.</p> + <p>La valeur par défaut de la directive + <code class="directive">DefaultRuntimeDir</code> peut être modifiée en + changeant la valeur de la macro <code>DEFAULT_REL_RUNTIMEDIR</code> + définie à la compilation.</p> + + <p>Note: si la valeur de <code class="directive">ServerRoot</code> n'a pas + été spécifiée avant d'utiliser cette directive, c'est la valeur par + défaut de <code class="directive">ServerRoot</code> qui sera utilisée pour + définir la base du répertoire.</p> <h3>Voir aussi</h3> <ul> -<li><a href="../misc/security_tips.html#serverroot">Conseil en -matière de sécurité</a> pour plus d'information à propos des permissions -à définir sur le répertoire d'installation -<code class="directive">ServerRoot</code> du serveur.</li> +<li>Voir les <a href="../misc/security_tips.html#serverroot">conseils à propos de +sésurité</a> pour plus d'informations en vue de définir correctement les +permissions sur la racine du serveur <code class="directive">ServerRoot</code></li> </ul> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -759,9 +767,9 @@ DESACTIVÉS à partir des version 2.3.x.</td></tr> être spécifiée avec la valeur <code>none</code>, c'est à dire sans type de médium par défaut. Par exemple :</p> - <div class="example"><p><code> - DefaultType None - </code></p></div> + <pre class="prettyprint lang-config">DefaultType None</pre> + + <p><code>DefaultType None</code> n'est disponible que dans les versions d'Apache 2.2.7 et supérieures.</p> @@ -796,15 +804,16 @@ DESACTIVÉS à partir des version 2.3.x.</td></tr> La portée de la variable est toujours globale, et n'est jamais limitée à la section de configuration courante.</p> - <div class="example"><p><code> - <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 /> - </code></p></div> + <pre class="prettyprint lang-config"> +<IfDefine TEST> + Define servername test.example.com +</IfDefine> +<IfDefine !TEST> + Define servername www.example.com + Define SSL +</IfDefine> + </pre> + <p>Le caractère ":" est interdit dans les noms de variables afin d'éviter les conflits avec la syntaxe de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p> @@ -840,13 +849,12 @@ sous-répertoires, et à leur contenu.</td></tr> * <code>/home/user/public_html</code>, alors que <code><Directory /home/*/public_html></code> conviendra. Exemple :</p> - <div class="example"><p><code> - <Directory /usr/local/httpd/htdocs><br /> - <span class="indent"> - Options Indexes FollowSymLinks<br /> - </span> - </Directory> - </code></p></div> + <pre class="prettyprint lang-config"> +<Directory "/usr/local/httpd/htdocs"> + Options Indexes FollowSymLinks +</Directory> + </pre> + <div class="note"> <p>Soyez prudent avec l'argument <var>chemin répertoire</var> : il @@ -862,9 +870,12 @@ sous-répertoires, et à leur contenu.</td></tr> peuvent aussi être utilisées en ajoutant le caractère <code>~</code>. Par exemple :</p> - <div class="example"><p><code> - <Directory ~ "^/www/.*/[0-9]{3}"> - </code></p></div> + <pre class="prettyprint lang-config"> +<Directory ~ "^/www/.*/[0-9]{3}"> + +</Directory> +</pre> + <p>pourra correspondre à tout répertoire situé dans /www/ et dont le nom se compose de trois chiffres.</p> @@ -876,19 +887,16 @@ sous-répertoires, et à leur contenu.</td></tr> directives des fichiers <a href="#accessfilename">.htaccess</a>. Par exemple, avec</p> - <div class="example"><p><code> - <Directory /><br /> - <span class="indent"> - AllowOverride None<br /> - </span> - </Directory><br /> - <br /> - <Directory /home><br /> - <span class="indent"> - AllowOverride FileInfo<br /> - </span> - </Directory> - </code></p></div> + <pre class="prettyprint lang-config"> +<Directory /> + AllowOverride None +</Directory> + +<Directory "/home"> + AllowOverride FileInfo +</Directory> + </pre> + <p>l'accès au document <code>/home/web/dir/doc.html</code> emprunte le chemin suivant :</p> @@ -913,13 +921,12 @@ sous-répertoires, et à leur contenu.</td></tr> testés selon l'ordre dans lequel ils apparaissent dans le fichier de configuration. Par exemple, avec</p> - <div class="example"><p><code> - <Directory ~ abc$><br /> - <span class="indent"> - # ... directives here ...<br /> - </span> - </Directory> - </code></p></div> + <pre class="prettyprint lang-config"> +<Directory ~ "abc$"> + # ... directives ici ... +</Directory> + </pre> + <p>la section avec expression rationnelle ne sera prise en compte qu'après les sections <code class="directive"><Directory></code> sans expression rationnelle @@ -934,13 +941,12 @@ sous-répertoires, et à leur contenu.</td></tr> correspondant à une URL. Il est recommandé de modifier cette situation à l'aide d'un bloc du style</strong></p> - <div class="example"><p><code> - <Directory /><br /> - <span class="indent"> - Require all denied<br /> - </span> - </Directory> - </code></p></div> + <pre class="prettyprint lang-config"> +<Directory /> + Require all denied +</Directory> + </pre> + <p><strong>puis d'affiner la configuration pour les répertoires que vous voulez rendre accessibles. Voir la page <a href="../misc/security_tips.html">Conseils à propos de sécurité</a> @@ -975,9 +981,12 @@ du système de fichiers correspondant à une expression rationnelle</td></tr> précisé (et aux fichiers qu'il contient), comme pour la section <code class="directive"><a href="#directory"><Directory></a></code>. Cependant, le répertoire est précisé sous la forme d'une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>. Par exemple :</p> - <div class="example"><p><code> - <DirectoryMatch "^/www/(.+/)?[0-9]{3}"> - </code></p></div> + <pre class="prettyprint lang-config"> +<DirectoryMatch "^/www/(.+/)?[0-9]{3}"> + # ... +</DirectoryMatch> +</pre> + <p>conviendrait pour les sous-répertoires de <code>/www/</code> dont le nom se compose de trois chiffres.</p> @@ -1025,9 +1034,8 @@ depuis Internet</td></tr> de l'URL sera ajouté par le serveur à la racine des documents afin de construire le chemin du document recherché. Exemple :</p> - <div class="example"><p><code> - DocumentRoot /usr/web - </code></p></div> + <pre class="prettyprint lang-config">DocumentRoot "/usr/web"</pre> + <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 @@ -1063,14 +1071,15 @@ requête à l'exécution</td></tr> supérieure et dans la même portée n'ont pas été satisfaites. Par exemple, dans :</p> - <div class="example"><p><code> - <If "-z req('Host')"><br /> - ...<br /> - </If><br /> - <Else><br /> - ...<br /> - </Else><br /> - </code></p></div> + <pre class="prettyprint lang-config"> +<If "-z req('Host')"> + # ... +</If> +<Else> + # ... +</Else> + </pre> + <p>La condition de la section <code class="directive"><If></code> serait satisfaite pour les requêtes HTTP/1.0 sans en-tête <var>Host:</var>, alors que celle de la section @@ -1108,17 +1117,18 @@ alors que la condition correspondant à la section <code class="directive"><a hre ou <code class="directive"><ElseIf></code> de la même portée ne l'est pas. Par exemple, dans :</p> - <div class="example"><p><code> - <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 /> - </code></p></div> + <pre class="prettyprint lang-config"> +<If "-R '10.1.0.0/16'"> + #... +</If> +<ElseIf "-R '10.0.0.0/8'"> + #... +</ElseIf> +<Else> + #... +</Else> + </pre> + <p>La condition correspondant à la section <code class="directive"><ElseIf></code> est satisfaite si l'adresse distante de la requête appartient au sous-réseau 10.0.0.0/8, mais @@ -1177,21 +1187,19 @@ lire les fichiers pendant qu'ils sont servis</td></tr> problème, il est préférable de désactiver la projection en mémoire des fichiers servis en spécifiant :</p> - <div class="example"><p><code> - EnableMMAP Off - </code></p></div> + <pre class="prettyprint lang-config">EnableMMAP Off</pre> + <p>Pour les montages NFS, cette fonctionnalité peut être explicitement désactivée pour les fichiers concernés en spécifiant :</p> - <div class="example"><p><code> - <Directory "/chemin vers montage NFS"> - <span class="indent"> - EnableMMAP Off - </span> - </Directory> - </code></p></div> + <pre class="prettyprint lang-config"> +<Directory "/path-to-nfs-files"> + EnableMMAP Off +</Directory> + </pre> + </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -1244,21 +1252,19 @@ supérieures. Par défaut à Off depuis la version 2.3.9.</td></tr> problème, vous pouvez activer cette fonctionnalité en spécifiant :</p> - <div class="example"><p><code> - EnableSendfile On - </code></p></div> + <pre class="prettyprint lang-config">EnableSendfile On</pre> + <p>Pour les montages réseau, cette fonctionnalité peut être explicitement désactivée pour les fichiers concernés en spécifiant :</p> - <div class="example"><p><code> - <Directory "/chemin vers montage réseau"> - <span class="indent"> - EnableSendfile Off - </span> - </Directory> - </code></p></div> + <pre class="prettyprint lang-config"> +<Directory "/path-to-nfs-files"> + EnableSendfile Off +</Directory> + </pre> + <p>Veuillez noter que la configuration de la directive <code class="directive">EnableSendfile</code> dans un contexte de répertoire ou de fichier .htaccess n'est pas supportée par @@ -1284,26 +1290,26 @@ d'erreur personnalisé</td></tr> directive peut être utilisée pour générer un message d'erreur personnalisé, et interrompre la lecture de la configuration. </p> - <div class="example"><h3>Exemple</h3><p><code> - # 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 /> - </code></p></div> + <pre class="prettyprint lang-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> + </pre> + </div> @@ -1346,14 +1352,14 @@ d'erreur</td></tr> Alternativement, un message à afficher par le navigateur pourra être fourni. Exemples :</p> - <div class="example"><p><code> - 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! - </code></p></div> + <pre class="prettyprint lang-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! + </pre> + <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 @@ -1363,14 +1369,14 @@ d'erreur</td></tr> les configurations qui sans cela, hériteraient d'une directive <code class="directive">ErrorDocument</code> existante.</p> - <div class="example"><p><code> - ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br /> - <Directory /web/docs><br /> - <span class="indent"> - ErrorDocument 404 default<br /> - </span> - </Directory> - </code></p></div> + <pre class="prettyprint lang-config"> +ErrorDocument 404 /cgi-bin/bad_urls.pl + +<Directory /web/docs> + ErrorDocument 404 default +</Directory> + </pre> + <p>Notez que lorsque vous spécifiez une directive <code class="directive">ErrorDocument</code> pointant vers une URL distante @@ -1439,17 +1445,15 @@ personnalisation des réponses</a></li> absolu, il est considéré comme relatif au chemin défini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p> - <div class="example"><h3>Exemple</h3><p><code> - ErrorLog /var/log/httpd/error_log - </code></p></div> + <pre class="prettyprint lang-config">ErrorLog "/var/log/httpd/error_log"</pre> + <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> - <div class="example"><h3>Exemple</h3><p><code> - ErrorLog "|/usr/local/bin/erreurs_httpd" - </code></p></div> + <pre class="prettyprint lang-config">ErrorLog "|/usr/local/bin/httpd_errors"</pre> + <p>Voir les notes à propos des <a href="../logs.html#piped">journaux redirigés</a> pour plus d'informations.</p> @@ -1464,9 +1468,8 @@ personnalisation des réponses</a></li> global, et si il est modifié dans un serveur virtuel, le dispositif final spécifié affecte l'ensemble du serveur</p> - <div class="example"><h3>Exemple</h3><p><code> - ErrorLog syslog:user - </code></p></div> + <pre class="prettyprint lang-config">ErrorLog syslog:user</pre> + <p>SECURITE : Voir le document <a href="../misc/security_tips.html#serverroot">conseils à propos de sécurité</a> pour des détails sur les raisons pour lesquelles votre @@ -1502,9 +1505,11 @@ personnalisation des réponses</a></li> spécifier quelles informations supplémentaires vont être enregistrées dans le journal des erreurs en plus du message habituel.</p> - <div class="example"><h3>Exemple simple</h3><p><code> - ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M" - </code></p></div> + <pre class="prettyprint lang-config"> +# Exemple simple +ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M" + </pre> + <p>La spécification de <code>connection</code> ou <code>request</code> comme premier paramètre permet de définir des @@ -1648,10 +1653,11 @@ personnalisation des réponses</a></li> c'est son identifiant unique qui sera utilisé comme identifiant de journal pour les requêtes.</p> - <div class="example"><h3>Exemple (format par défaut)</h3><p><code> - ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] - %M% ,\ referer\ %{Referer}i" - </code></p></div> + <pre class="prettyprint lang-config"> +# Exemple (format par défaut) +ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i" + </pre> + <p>Cet exemple renverrait un message d'erreur du style :</p> @@ -1662,19 +1668,21 @@ personnalisation des réponses</a></li> <p>Notez que, comme indiqué plus haut, certains champs sont totalement supprimés s'ils n'ont pas été définis.</p> - <div class="example"><h3>Exemple (similaire au format 2.2.x)</h3><p><code> - ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] - %M% ,\ referer\ %{Referer}i" - </code></p></div> + <pre class="prettyprint lang-config"> +# Exemple (similaire au format 2.2.x) +ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i" + </pre> + + + <pre class="prettyprint lang-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" + </pre> - <div class="example"><h3>Exemple avancé avec identifiants journal de - requête/connexion</h3><p><code> - 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 /> - </code></p></div> <h3>Voir aussi</h3> @@ -1759,8 +1767,9 @@ dans les versions 2.3.14 et antérieures.</td></tr> <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 à : <div class="example"><p><code>FileETag INode MTime - Size</code></p></div></dd> + est équivalente à : + <pre class="prettyprint lang-config">FileETag INode MTime Size</pre> +</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> @@ -1829,12 +1838,28 @@ précisés</td></tr> <p>L'argument <var>filename</var> peut contenir un nom de fichier ou une chaîne de caractères avec caractères génériques, où <code>?</code> remplace un caractère, et <code>*</code> toute chaîne - de caractères. On peut aussi utiliser les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> en ajoutant la + de caractères.</p> + <pre class="prettyprint lang-config"> +<Files "cat.html"> + # Insérer ici des directives qui s'appliquent au fichier cat.html +</Files> + +<Files "?at.*"> + # Les directives insérées ici s'appliqueront aux fichiers + # cat.html, bat.html, hat.php, et ainsi de suite. +</Files> +</pre> + + + <p>On peut aussi utiliser les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> en ajoutant la caractère <code>~</code>. Par exemple :</p> - <div class="example"><p><code> - <Files ~ "\.(gif|jpe?g|png)$"> - </code></p></div> + <pre class="prettyprint lang-config"> +<Files ~ "\.(gif|jpe?g|png)$"> + #... +</Files> +</pre> + <p>correspondrait à la plupart des formats graphiques de l'Internet. Il est cependant préférable d'utiliser la directive <code class="directive"><a href="#filesmatch"><FilesMatch></a></code>.</p> @@ -1871,9 +1896,12 @@ spécifiés sous la forme d'expressions rationnelles</td></tr> <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>. Par exemple :</p> - <div class="example"><p><code> - <FilesMatch "\.(gif|jpe?g|png)$"> - </code></p></div> + <pre class="prettyprint lang-config"> +<FilesMatch "\.(gif|jpe?g|png)$"> + # ... +</FilesMatch> +</pre> + <p>correspondrait à la plupart des formats graphiques de l'Internet.</p> @@ -1907,9 +1935,8 @@ HTTP Content-Type pour les fichiers correspondants</td></tr> pas leur ajouter l'extension <code>.gif</code>, vous pouvez utiliser :</p> - <div class="example"><p><code> - ForceType image/gif - </code></p></div> + <pre class="prettyprint lang-config">ForceType image/gif</pre> + <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 @@ -1919,22 +1946,19 @@ HTTP Content-Type pour les fichiers correspondants</td></tr> <code class="directive">ForceType</code> en affectant la valeur <code>None</code> à l'argument <var>type médium</var> :</p> - <div class="example"><p><code> - # force le type MIME de tous les fichiers à image/gif:<br /> - <Location /images><br /> - <span class="indent"> - ForceType image/gif<br /> - </span> - </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 /> - <span class="indent"> - ForceType None<br /> - </span> - </Location> - </code></p></div> + <pre class="prettyprint lang-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> + </pre> + <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 @@ -2034,9 +2058,8 @@ requête</td></tr> si et seulement si l'expression renvoie la valeur "vrai". Par exemple :</p> - <div class="example"><p><code> - <If "-z req('Host')"> - </code></p></div> + <pre class="prettyprint lang-config"><If "-z req('Host')"></pre> + <p>serait satisfaite pour les requêtes HTTP/1.0 sans en-tête <var>Host:</var>. Les expressions peuvent contenir différents @@ -2046,9 +2069,8 @@ requête</td></tr> à usages divers (<code>-n</code>, <code>-z</code>, <code>-f</code>, ...). Les expressions rationnelles sont aussi supportées,</p> - <div class="example"><p><code> - <If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/"> - </code></p></div> + <pre class="prettyprint lang-config"><If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/"></pre> + <p>ainsi que les comparaison de modèles de type shell et de nombreuses autres opérations. Ces opérations peuvent être effectuées @@ -2113,32 +2135,23 @@ test retourne "vrai" au démarrage du serveur</td></tr> peuvent être imbriquées, ce qui permet d'implémenter un test multi-paramètres simple. Exemple :</p> - <div class="example"><p><code> - httpd -DReverseProxy -DUseCache -DMemCache ...<br /> - <br /> - # httpd.conf<br /> - <IfDefine ReverseProxy><br /> - <span class="indent"> - LoadModule proxy_module modules/mod_proxy.so<br /> - LoadModule proxy_http_module modules/mod_proxy_http.so<br /> - <IfDefine UseCache><br /> - <span class="indent"> - LoadModule cache_module modules/mod_cache.so<br /> - <IfDefine MemCache><br /> - <span class="indent"> - LoadModule mem_cache_module modules/mod_mem_cache.so<br /> - </span> - </IfDefine><br /> - <IfDefine !MemCache><br /> - <span class="indent"> - LoadModule cache_disk_module modules/mod_cache_disk.so<br /> - </span> - </IfDefine> - </span> - </IfDefine> - </span> - </IfDefine> - </code></p></div> + <div class="example"><p><code>httpd -DReverseProxy -DUseCache -DMemCache ...</code></p></div> + <pre class="prettyprint lang-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> + </pre> + </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -2239,35 +2252,35 @@ version 2.3.6</td></tr> <p>Exemples :</p> - <div class="example"><p><code> - Include /usr/local/apache2/conf/ssl.conf<br /> - Include /usr/local/apache2/conf/vhosts/*.conf - </code></p></div> + <pre class="prettyprint lang-config"> +Include /usr/local/apache2/conf/ssl.conf +Include /usr/local/apache2/conf/vhosts/*.conf + </pre> + <p>ou encore, avec des chemins relatifs au répertoire défini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code> :</p> - <div class="example"><p><code> - Include conf/ssl.conf<br /> - Include conf/vhosts/*.conf - </code></p></div> + <pre class="prettyprint lang-config"> +Include conf/ssl.conf +Include conf/vhosts/*.conf + </pre> + <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> - <div class="example"><p><code> - Include conf/vhosts/*/*.conf - </code></p></div> + <pre class="prettyprint lang-config">Include conf/vhosts/*/*.conf</pre> + <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> - <div class="example"><p><code> - IncludeOptional conf/vhosts/*/*.conf - </code></p></div> + <pre class="prettyprint lang-config">IncludeOptional conf/vhosts/*/*.conf</pre> + <h3>Voir aussi</h3> @@ -2400,13 +2413,12 @@ certaines méthodes HTTP</td></tr> <code>DELETE</code>, en laissant les autres méthodes sans protection :</p> - <div class="example"><p><code> - <Limit POST PUT DELETE><br /> - <span class="indent"> - Require valid-user<br /> - </span> - </Limit> - </code></p></div> + <pre class="prettyprint lang-config"> +<Limit POST PUT DELETE> + Require valid-user +</Limit> + </pre> + <p>La liste des noms de méthodes peut contenir une ou plusieurs valeurs parmi les suivantes : <code>GET</code>, <code>POST</code>, @@ -2441,18 +2453,15 @@ certaines méthodes HTTP</td></tr> <code>POST</code>, et la directive <code>Require group editors</code> sera ignorée dans tous les cas :</p> - <div class="example"><p><code> - <LimitExcept GET> - <span class="indent"> - Require valid-user - </span> - </LimitExcept><br /> - <Limit POST> - <span class="indent"> - Require group editors - </span> - </Limit> - </code></p></div> + <pre class="prettyprint lang-config"> +<LimitExcept GET> + Require valid-user +</LimitExcept> +<Limit POST> + Require group editors +</Limit> + </pre> + </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -2480,13 +2489,12 @@ sauf celles qui sont spécifiées</td></tr> <p>Par exemple :</p> - <div class="example"><p><code> - <LimitExcept POST GET><br /> - <span class="indent"> - Require valid-user<br /> - </span> - </LimitExcept> - </code></p></div> + <pre class="prettyprint lang-config"> +<LimitExcept POST GET> + Require valid-user +</LimitExcept> + </pre> + </div> @@ -2522,9 +2530,8 @@ sous-requêtes imbriquées</td></tr> maximum des sous-requêtes. Si vous ne spécifiez qu'un seul <var>nombre</var>, il sera affecté aux deux limites.</p> - <div class="example"><h3>Exemple</h3><p><code> - LimitInternalRecursion 5 - </code></p></div> + <pre class="prettyprint lang-config">LimitInternalRecursion 5</pre> + </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -2569,9 +2576,8 @@ envoyée par le client</td></tr> fichiers chargés à 100Ko, vous pouvez utiliser la directive suivante :</p> - <div class="example"><p><code> - LimitRequestBody 102400 - </code></p></div> + <pre class="prettyprint lang-config">LimitRequestBody 102400</pre> + <div class="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 @@ -2618,9 +2624,8 @@ requête HTTP</td></tr> <p>Par exemple :</p> - <div class="example"><p><code> - LimitRequestFields 50 - </code></p></div> + <pre class="prettyprint lang-config">LimitRequestFields 50</pre> + <div class="warning"><h3>Avertissement</h3> <p>Dans le cas des serveurs virtuels à base de noms, la valeur de @@ -2662,14 +2667,11 @@ requête HTTP</td></tr> <p>Par exemple ::</p> - <div class="example"><p><code> - LimitRequestFieldSize 4094 - </code></p></div> + <pre class="prettyprint lang-config">LimitRequestFieldSize 4094</pre> + <div class="note">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.</div> + directive ne doit pas être modifiée.</div> <div class="warning"><h3>Avertissement</h3> <p>Dans le cas des serveurs virtuels à base de noms, la valeur de @@ -2711,9 +2713,8 @@ HTTP</td></tr> <p>Par exemple :</p> - <div class="example"><p><code> - LimitRequestLine 4094 - </code></p></div> + <pre class="prettyprint lang-config">LimitRequestLine 4094</pre> + <div class="note">Dans des conditions normales, la valeur par défaut de cette directive ne doit pas être modifiée. En outre, vous ne @@ -2747,9 +2748,8 @@ XML</td></tr> <p>Exemple :</p> - <div class="example"><p><code> - LimitXMLRequestBody 0 - </code></p></div> + <pre class="prettyprint lang-config">LimitXMLRequestBody 0</pre> + </div> @@ -2803,19 +2803,23 @@ spécifiées</td></tr> directives contenues dans la section s'appliqueront à /private1, /private1/ et /private1/file.txt, mais pas à /private1other. </p> - <div class="example"><p><code> - <Location /private1> - ... - </code></p></div> + <pre class="prettyprint lang-config"> +<Location /private1> + # ... +</Location> + </pre> + <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> - <div class="example"><p><code> - <Location /private2<em>/</em>> - ... - </code></p></div> + <pre class="prettyprint lang-config"> +<Location /private2<em>/</em>> + # ... +</Location> + </pre> + <div class="note"><h3>Quand utiliser la section <code class="directive"><Location></code></h3> @@ -2845,9 +2849,12 @@ spécifiées</td></tr> rationnelles</a>, moyennant l'addition d'un caractère <code>~</code>. Par exemple :</p> - <div class="example"><p><code> - <Location ~ "/(extra|special)/data"> - </code></p></div> + <pre class="prettyprint lang-config"> +<Location ~ "/(extra|special)/data"> + #... +</Location> +</pre> + <p>concernerait les URLs contenant les sous-chaîne <code>/extra/data</code> ou <code>/special/data</code>. La directive @@ -2864,14 +2871,13 @@ spécifiées</td></tr> appartenant au domaine <code>example.com</code>, vous pouvez utiliser :</p> - <div class="example"><p><code> - <Location /status><br /> - <span class="indent"> - SetHandler server-status<br /> - Require host example.com<br /> - </span> - </Location> - </code></p></div> + <pre class="prettyprint lang-config"> +<Location /status> + SetHandler server-status + Require host example.com +</Location> + </pre> + <div class="note"><h3>Note à propos du slash (/)</h3> <p>La signification du caractère slash dépend de l'endroit où il @@ -2922,9 +2928,12 @@ correspondant à une expression rationnelle</td></tr> spécifier les URLs concernées est une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a> au lieu d'une simple chaîne de caractères. Par exemple :</p> - <div class="example"><p><code> - <LocationMatch "/(extra|special)/data"> - </code></p></div> + <pre class="prettyprint lang-config"> +<LocationMatch "/(extra|special)/data"> + # ... +</LocationMatch> +</pre> + <p>correspondrait à toute URL contenant les sous-chaînes <code>/extra/data</code> ou <code>/special/data</code>.</p> @@ -3105,9 +3114,8 @@ Apache</td></tr> <p>Par exemple :</p> - <div class="example"><p><code> - LogLevel notice - </code></p></div> + <pre class="prettyprint lang-config">LogLevel notice</pre> + <div class="note"><h3>Note</h3> <p>Si la journalisation s'effectue directement dans un fichier, @@ -3124,21 +3132,23 @@ Apache</td></tr> identificateur, avec ou sans le suffixe <code>_module</code>. Les trois spécifications suivantes sont donc équivalentes :</p> - <div class="example"><p><code> - LogLevel info ssl:warn<br /> - LogLevel info mod_ssl.c:warn<br /> - LogLevel info ssl_module:warn<br /> - </code></p></div> + <pre class="prettyprint lang-config"> +LogLevel info ssl:warn +LogLevel info mod_ssl.c:warn +LogLevel info ssl_module:warn + </pre> + <p>Il est aussi possible d'attribuer un niveau de journalisation par répertoire :</p> - <div class="example"><p><code> - LogLevel info<br /> - <Directory /usr/local/apache/htdocs/app><br /> - LogLevel debug<br /> - </Files> - </code></p></div> + <pre class="prettyprint lang-config"> +LogLevel info +<Directory "/usr/local/apache/htdocs/app"> + LogLevel debug +</Directory> + </pre> + <div class="note"> La configuration du niveau de journalisation par répertoire @@ -3169,9 +3179,8 @@ persistante</td></tr> <p>Par exemple :</p> - <div class="example"><p><code> - MaxKeepAliveRequests 500 - </code></p></div> + <pre class="prettyprint lang-config">MaxKeepAliveRequests 500</pre> + </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -3520,10 +3529,11 @@ verrou pour tous les mutex ou seulement les mutex spécifiés</td></tr> mutex par défaut pour tous les autres mutex deviendra <code>sysvsem</code>.</p> - <div class="example"><p><code> - Mutex sysvsem default<br /> - Mutex fcntl:/var/httpd/locks mpm-accept - </code></p></div> + <pre class="prettyprint lang-config"> +Mutex sysvsem default +Mutex fcntl:/var/httpd/locks mpm-accept + </pre> + </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -3681,38 +3691,32 @@ particulier</td></tr> <p>Par exemple, sans aucun symbole <code>+</code> et <code>-</code> :</p> - <div class="example"><p><code> - <Directory /web/docs><br /> - <span class="indent"> - Options Indexes FollowSymLinks<br /> - </span> - </Directory><br /> - <br /> - <Directory /web/docs/spec><br /> - <span class="indent"> - Options Includes<br /> - </span> - </Directory> - </code></p></div> + <pre class="prettyprint lang-config"> +<Directory "/web/docs"> + Options Indexes FollowSymLinks +</Directory> + +<Directory "/web/docs/spec"> + Options Includes +</Directory> + </pre> + <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 <code class="directive">Options</code> utilise les symboles <code>+</code> et <code>-</code> :</p> - <div class="example"><p><code> - <Directory /web/docs><br /> - <span class="indent"> - Options Indexes FollowSymLinks<br /> - </span> - </Directory><br /> - <br /> - <Directory /web/docs/spec><br /> - <span class="indent"> - Options +Includes -Indexes<br /> - </span> - </Directory> - </code></p></div> + <pre class="prettyprint lang-config"> +<Directory "/web/docs"> + Options Indexes FollowSymLinks +</Directory> + +<Directory "/web/docs/spec"> + Options +Includes -Indexes +</Directory> + </pre> + <p>alors, les options <code>FollowSymLinks</code> et <code>Includes</code> seront prises en compte pour le répertoire @@ -3754,16 +3758,15 @@ seulement depuis la version 2.3.3 sous Windows.</td></tr> <code>https</code> sur un port non standard, spécifiez le protocole de manière explicite :</p> - <div class="example"><p><code> - Protocol https - </code></p></div> + <pre class="prettyprint lang-config">Protocol https</pre> + <p>Vous pouvez aussi spécifier le protocole via la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p> <h3>Voir aussi</h3> <ul> -<li><code class="directive">AcceptFilter</code></li> +<li><code class="directive"><a href="#acceptfilter">AcceptFilter</a></code></li> <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li> </ul> </div> @@ -3915,16 +3918,14 @@ l'option <code>Registry-Strict</code> est disponible dans les versions <code>#!</code>). Sur les systèmes Win32, cette ligne ressemble souvent à ceci :</p> - <div class="example"><p><code> - #!C:/Perl/bin/perl.exe - </code></p></div> + <pre class="prettyprint lang-perl">#!C:/Perl/bin/perl.exe</pre> + <p>ou simplement, dans le cas où <code>perl</code> est dans le <code>PATH</code> :</p> - <div class="example"><p><code> - #!perl - </code></p></div> + <pre class="prettyprint lang-perl">#!perl</pre> + <p>Avec <code>ScriptInterpreterSource Registry</code>, Windows va effectuer une recherche dans l'arborescence @@ -4026,9 +4027,8 @@ messages d'erreur envoyés au client</td></tr> <p>Il peut s'avérer utile de définir une adresse dédiée à l'administration du serveur, par exemple :</p> - <div class="example"><p><code> - ServerAdmin www-admin@foo.example.com - </code></p></div> + <pre class="prettyprint lang-config">ServerAdmin www-admin@foo.example.com</pre> + <p>car les utilisateurs ne mentionnent pas systématiquement le serveur dont ils parlent !</p> @@ -4049,15 +4049,16 @@ serveurs virtuels à base de nom</td></tr> nom</a>. La directive <code class="directive">ServerAlias</code> peut contenir des caractères génériques, si nécessaire.</p> - <div class="example"><p><code> - <VirtualHost *:80><br /> - ServerName serveur.example.com<br /> - ServerAlias serveur serveur2.example.com serveur2<br /> - ServerAlias *.example.com<br /> - UseCanonicalName Off<br /> - # ...<br /> - </VirtualHost> - </code></p></div> + <pre class="prettyprint lang-config"> +<VirtualHost *:80> + ServerName server.example.com + ServerAlias server server2.example.com server2 + ServerAlias *.example.com + UseCanonicalName Off + # ... +</VirtualHost> + </pre> + <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 <code class="directive"><a href="#virtualhost"><virtualhost></a></code> dans le fichier de @@ -4065,6 +4066,11 @@ serveurs virtuels à base de nom</td></tr> priorité particulière si le nom contient des caractères génériques (que ce soit pour ServerName ou ServerAlias).</p> + <p>Tous les noms spécifiés au sein d'une section + <code class="directive">VirtualHost</code> sont traités comme un + <code class="directive">ServerAlias</code> (sans caractères génériques).</p> + + <h3>Voir aussi</h3> <ul> <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li> @@ -4101,9 +4107,8 @@ entièrement qualifié</var>[:<var>port</var>]</code></td></tr> web s'identifie avec cet alias, vous devez utilisez la définition suivante :</p> - <div class="example"><p><code> - ServerName www.example.com - </code></p></div> + <pre class="prettyprint lang-config">ServerName www.example.com</pre> + <p>La directive <code class="directive">ServerName</code> peut apparaître à toutes les étapes de la définition du serveur. Toute occurrence @@ -4202,9 +4207,8 @@ serveur</td></tr> directives (comme <code class="directive"><a href="#include">Include</a></code> ou <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>) seront définis par rapport à ce répertoire.</p> - <div class="example"><h3>Example</h3><p><code> - ServerRoot /home/httpd - </code></p></div> + <pre class="prettyprint lang-config">ServerRoot "/home/httpd"</pre> + <p>La valeur par défaut de <code class="directive">ServerRoot</code> peut être modifiée via l'argument <code>--prefix</code> de la commande <a href="../programs/configure.html"><code>configure</code></a>, et de @@ -4282,13 +4286,10 @@ HTTP</td></tr> <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> @@ -4306,12 +4307,12 @@ HTTP</td></tr> <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> @@ -4362,22 +4363,31 @@ gestionnaire particulier</td></tr> extensions, vous pouvez ajouter la ligne suivante dans un fichier <code>.htaccess</code> de ce répertoire :</p> - <div class="example"><p><code> - SetHandler imap-file - </code></p></div> + <pre class="prettyprint lang-config">SetHandler imap-file</pre> + <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> - <div class="example"><p><code> - <Location /status><br /> - <span class="indent"> - SetHandler server-status<br /> - </span> - </Location> - </code></p></div> + <pre class="prettyprint lang-config"> +<Location "/status"> + SetHandler server-status +</Location> + </pre> + + + <p>Vous pouvez aussi utiliser cette directive pour associer un + gestionnaire à des fichiers possèdant une extension de nom de + fichier particulière. Par exemple :</p> + + <pre class="prettyprint lang-config"> +<FilesMatch \.php$> + SetHandler application/x-httpd-php +</FilesMatch> + </pre> + <p>Vous pouvez écraser la définition antérieure d'une directive <code class="directive">SetHandler</code> en utilisant la valeur @@ -4441,13 +4451,12 @@ du serveur</td></tr> fichiers du répertoire <code>/www/data/</code> comme des inclusions côté serveur (SSI) :</p> - <div class="example"><p><code> - <Directory /www/data/><br /> - <span class="indent"> - SetOutputFilter INCLUDES<br /> - </span> - </Directory> - </code></p></div> + <pre class="prettyprint lang-config"> +<Directory "/www/data/"> + SetOutputFilter INCLUDES +</Directory> + </pre> + <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 @@ -4594,9 +4603,9 @@ et son port</td></tr> <code>http://www.example.com/splat/</code>. Si vous avez activé 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 <code class="directive">UseCanonicalName</code> est définie à + fois pour <code>www.example.com</code> -- voir <a 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 <code class="directive">UseCanonicalName</code> est définie à <code>Off</code>, Apache httpd redirigera l'utilisateur vers <code>http://www/splat/</code>.</p> @@ -4720,17 +4729,16 @@ d'hôte spécifique ou à une adresse IP</td></tr> </ul> - <div class="example"><h3>Exemple</h3><p><code> - <VirtualHost 10.1.2.3:80><br /> - <span class="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 /> - </span> - </VirtualHost> - </code></p></div> + <pre class="prettyprint lang-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> + </pre> + <p>Les adresses IPv6 doivent être entourées de crochets car dans le @@ -4738,17 +4746,16 @@ d'hôte spécifique ou à une adresse IP</td></tr> déterminé. Voici un exemple de serveur virtuel avec adresse IPv6 :</p> - <div class="example"><p><code> - <VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80><br /> - <span class="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 /> - </span> - </VirtualHost> - </code></p></div> + <pre class="prettyprint lang-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> + </pre> + <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 @@ -4815,10 +4822,30 @@ entre elles à la réception d'une requête</li> <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> | <a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español"> es </a> | <a href="../fr/mod/core.html" title="Français"> fr </a> | -<a href="../hold/mod/core.html" hreflang="hold" rel="alternate" title=""> hold </a> | <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> -</div><div id="footer"> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/core.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> <p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> -<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> </body></html>
\ No newline at end of file |