granicus.if.org Git - apache/blob - docs/manual/mod/core.html.fr

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>core - Serveur Apache HTTP</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <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>
  16 <p class="apache">Serveur Apache HTTP Version 2.3</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">Modules</a></div>
  21 <div id="page-content">
  22 <div id="preamble"><h1>Fonctionalités de Base Apache</h1>
  23 <div class="toplang">
  24 <p><span>Langues Disponibles: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
  25 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  26 <a href="../fr/mod/core.html" title="Français">&nbsp;fr&nbsp;</a> |
  27 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  28 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  29 </div>
  30 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fonctionnalités de base du serveur HTTP Apache toujours
  31 disponibles</td></tr>
  32 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Core</td></tr></table>
  33 </div>
  34 <div id="quickview"><h3 class="directives">Directives</h3>
  35 <ul id="toc">
  36 <li><img alt="" src="../images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li>
  37 <li><img alt="" src="../images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
  38 <li><img alt="" src="../images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
  39 <li><img alt="" src="../images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
  40 <li><img alt="" src="../images/down.gif" /> <a href="#addoutputfilterbytype">AddOutputFilterByType</a></li>
  41 <li><img alt="" src="../images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
  42 <li><img alt="" src="../images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
  43 <li><img alt="" src="../images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
  44 <li><img alt="" src="../images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
  45 <li><img alt="" src="../images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
  46 <li><img alt="" src="../images/down.gif" /> <a href="#define">Define</a></li>
  47 <li><img alt="" src="../images/down.gif" /> <a href="#directory">&lt;Directory&gt;</a></li>
  48 <li><img alt="" src="../images/down.gif" /> <a href="#directorymatch">&lt;DirectoryMatch&gt;</a></li>
  49 <li><img alt="" src="../images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
  50 <li><img alt="" src="../images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
  51 <li><img alt="" src="../images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
  52 <li><img alt="" src="../images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
  53 <li><img alt="" src="../images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
  54 <li><img alt="" src="../images/down.gif" /> <a href="#fileetag">FileETag</a></li>
  55 <li><img alt="" src="../images/down.gif" /> <a href="#files">&lt;Files&gt;</a></li>
  56 <li><img alt="" src="../images/down.gif" /> <a href="#filesmatch">&lt;FilesMatch&gt;</a></li>
  57 <li><img alt="" src="../images/down.gif" /> <a href="#forcetype">ForceType</a></li>
  58 <li><img alt="" src="../images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
  59 <li><img alt="" src="../images/down.gif" /> <a href="#if">&lt;If&gt;</a></li>
  60 <li><img alt="" src="../images/down.gif" /> <a href="#ifdefine">&lt;IfDefine&gt;</a></li>
  61 <li><img alt="" src="../images/down.gif" /> <a href="#ifmodule">&lt;IfModule&gt;</a></li>
  62 <li><img alt="" src="../images/down.gif" /> <a href="#include">Include</a></li>
  63 <li><img alt="" src="../images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
  64 <li><img alt="" src="../images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
  65 <li><img alt="" src="../images/down.gif" /> <a href="#limit">&lt;Limit&gt;</a></li>
  66 <li><img alt="" src="../images/down.gif" /> <a href="#limitexcept">&lt;LimitExcept&gt;</a></li>
  67 <li><img alt="" src="../images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
  68 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
  69 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
  70 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
  71 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
  72 <li><img alt="" src="../images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
  73 <li><img alt="" src="../images/down.gif" /> <a href="#location">&lt;Location&gt;</a></li>
  74 <li><img alt="" src="../images/down.gif" /> <a href="#locationmatch">&lt;LocationMatch&gt;</a></li>
  75 <li><img alt="" src="../images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
  76 <li><img alt="" src="../images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
  77 <li><img alt="" src="../images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
  78 <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
  79 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
  80 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
  81 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
  82 <li><img alt="" src="../images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
  83 <li><img alt="" src="../images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
  84 <li><img alt="" src="../images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
  85 <li><img alt="" src="../images/down.gif" /> <a href="#servername">ServerName</a></li>
  86 <li><img alt="" src="../images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
  87 <li><img alt="" src="../images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
  88 <li><img alt="" src="../images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
  89 <li><img alt="" src="../images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
  90 <li><img alt="" src="../images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
  91 <li><img alt="" src="../images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
  92 <li><img alt="" src="../images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
  93 <li><img alt="" src="../images/down.gif" /> <a href="#timeout">TimeOut</a></li>
  94 <li><img alt="" src="../images/down.gif" /> <a href="#traceenable">TraceEnable</a></li>
  95 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
  96 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li>
  97 <li><img alt="" src="../images/down.gif" /> <a href="#virtualhost">&lt;VirtualHost&gt;</a></li>
  98 </ul>
  99 </div>
 100
 101 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 102 <div class="directive-section"><h2><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">Directive</a></h2>
 103 <table class="directive">
 104 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'optimiser la configuration d'une socket pour
 105 l'écoute d'un protocole</td></tr>
 106 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptFilter <var>protocole</var> <var>filtre
 107 d'acceptation</var></code></td></tr>
 108 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
 109 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 110 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 111 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.3 sous Windows et 2.1.5
 112 sur les autres plates-formes.</td></tr>
 113 </table>
 114     <p>Cette directive permet d'effectuer une optimisation de la socket
 115     d'écoute d'un type de protocole en fonction du système
 116     d'exploitation. Le but premier est de faire en sorte que le noyau
 117     n'envoie pas de socket au processus du serveur jusqu'à ce que
 118     des données soient reçues, ou qu'une requête HTTP complète soit mise
 119     en tampon. Seuls les <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&amp;     sektion=9">Filtres d'acceptation de FreeBSD</a>, le filtre plus
 120     primitif <code>TCP_DEFER_ACCEPT</code> sous Linux, et la version
 121     optimisée d'AcceptEx() de Windows sont actuellement supportés.</p>
 122
 123     <p>L'utilisation de l'argument <code>none</code> va désactiver tout
 124     filtre d'acceptation pour ce protocole. Ceci s'avère utile pour les
 125     protocoles qui nécessitent l'envoi de données par le serveur en
 126     premier, comme <code>ftp:</code> ou <code>nntp</code>:</p>
 127     <div class="example"><p><code>AcceptFilter nntp none</code></p></div>
 128
 129     <p>Sous FreeBSD, les valeurs par défaut sont :</p>
 130     <div class="example"><p><code>
 131         AcceptFilter http httpready <br />
 132         AcceptFilter https dataready
 133     </code></p></div>
 134
 135     <p>Le filtre d'acceptation <code>httpready</code> met en tampon des
 136     requêtes HTTP entières au niveau du noyau. Quand une requête
 137     entière a été reçue, le noyau l'envoie au serveur. Voir la page de
 138     manuel de <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&amp;     sektion=9">accf_http(9)</a> pour plus de détails. Comme les requêtes
 139     HTTPS sont chiffrées, celles-ci n'autorisent que le filtre <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&amp;     sektion=9">accf_data(9)</a>.</p>
 140
 141     <p>Sous Linux, les valeurs par défaut sont :</p>
 142     <div class="example"><p><code>
 143         AcceptFilter http data <br />
 144         AcceptFilter https data
 145     </code></p></div>
 146
 147     <p>Le filtre <code>TCP_DEFER_ACCEPT</code> de Linux ne supporte pas
 148     la mise en tampon des requêtes http. Toute valeur autre que
 149     <code>none</code> active le filtre <code>TCP_DEFER_ACCEPT</code>
 150     pour ce protocole. Pour plus de détails, voir la page de
 151     manuel Linux de <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/     tcp.7.html">tcp(7)</a>.</p>
 152
 153     <p>Sous Windows, les valeurs par défaut sont :</p>
 154     <div class="example"><p><code>
 155         AcceptFilter http data <br />
 156         AcceptFilter https data
 157     </code></p></div>
 158
 159     <p>Le module MPM pour Windows mpm_winnt utilise la directive
 160     AcceptFilter comme commutateur de l'API AcceptEx(), et ne supporte
 161     pas la mise en tampon du protocole http. Deux valeurs utilisent
 162     l'API Windows AcceptEx() et vont recycler les sockets réseau entre
 163     les connexions. <code>data</code> attend jusqu'à ce que les données
 164     aient été transmises comme décrit plus haut, et le tampon de données
 165     initiales ainsi que les adresses réseau finales sont tous extraits
 166     grâce à une seule invocation d'AcceptEx(). <code>connect</code>
 167     utilise l'API AcceptEx(), extrait aussi les adresses réseau finales,
 168     mais à l'instar de <code>none</code>, la valeur <code>connect</code>
 169     n'attend pas la transmission des données initiales.</p>
 170
 171     <p>Sous Windows, <code>none</code> utilise accept() au lieu
 172     d'AcceptEx(), et ne recycle pas les sockets entre les connexions.
 173     Ceci s'avère utile pour les interfaces réseau dont le pilote est
 174     défectueux, ainsi que pour certains fournisseurs de réseau comme les
 175     pilotes vpn, ou les filtres anti-spam, anti-virus ou
 176     anti-spyware.</p>
 177
 178
 179 </div>
 180 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 181 <div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">Directive</a></h2>
 182 <table class="directive">
 183 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les ressources acceptent des informations sous forme d'un
 184 nom de chemin en fin de requête.</td></tr>
 185 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
 186 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
 187 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 188 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
 189 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 190 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 191 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans Apache version 2.0.30 et
 192 supérieures</td></tr>
 193 </table>
 194
 195     <p>Cette directive permet de définir si les requêtes contenant des
 196     informations sous forme d'un nom de chemin suivant le nom d'un
 197     fichier réel (ou un fichier qui n'existe pas dans un répertoire qui
 198     existe) doivent être acceptées ou rejetées. Les scripts peuvent
 199     accéder à cette information via la variable d'environnement
 200     <code>PATH_INFO</code>.</p>
 201
 202     <p>Supposons par exemple que <code>/test/</code> pointe vers un
 203     répertoire qui ne contient que le fichier <code>here.html</code>.
 204     Les requêtes pour <code>/test/here.html/more</code> et
 205     <code>/test/nothere.html/more</code> vont affecter la valeur
 206     <code>/more</code> à la variable d'environnement
 207     <code>PATH_INFO</code>.</p>
 208
 209     <p>L'argument de la directive <code class="directive">AcceptPathInfo</code>
 210     possède trois valeurs possibles :</p>
 211     <dl>
 212     <dt><code>Off</code></dt><dd>Une requête ne sera acceptée que si
 213     elle correspond à un chemin qui existe. Par conséquent, une requête
 214     contenant une information de chemin après le nom de fichier réel
 215     comme <code>/test/here.html/more</code> dans l'exemple ci-dessus
 216     renverra une erreur "404 NOT FOUND".</dd>
 217
 218     <dt><code>On</code></dt><dd>Une requête sera acceptée si la partie
 219     principale du chemin correspond à un fichier existant. Dans
 220     l'exemple ci-dessus <code>/test/here.html/more</code>, la requête
 221     sera acceptée si <code>/test/here.html</code> correspond à un nom de
 222     fichier valide.</dd>
 223
 224     <dt><code>Default</code></dt><dd>Le traitement des requêtes est
 225     déterminé par le <a href="../handler.html">gestionnaire</a> responsable de la requête.
 226     Le gestionnaire de base pour les fichiers normaux rejette par défaut
 227     les requêtes avec <code>PATH_INFO</code>. Les gestionnaires qui
 228     servent des scripts, comme<a href="mod_cgi.html">cgi-script</a> et <a href="mod_isapi.html">isapi-handler</a>, acceptent en général par
 229     défaut les requêtes avec <code>PATH_INFO</code>.</dd>
 230     </dl>
 231
 232     <p>Le but premier de la directive <code>AcceptPathInfo</code> est de
 233     vous permettre de remplacer le choix du gestionnaire d'accepter ou
 234     de rejeter <code>PATH_INFO</code>. Ce remplacement est nécessaire
 235     par exemple, lorsque vous utilisez un <a href="../filter.html">filtre</a>, comme <a href="mod_include.html">INCLUDES</a>, pour générer un contenu basé
 236     sur <code>PATH_INFO</code>. Le gestionnaire de base va en général
 237     rejeter la requête, et vous pouvez utiliser la configuration
 238     suivante pour utiliser un tel script :</p>
 239
 240     <div class="example"><p><code>
 241       &lt;Files "mes-chemins.shtml"&gt;<br />
 242       <span class="indent">
 243         Options +Includes<br />
 244         SetOutputFilter INCLUDES<br />
 245         AcceptPathInfo On<br />
 246       </span>
 247       &lt;/Files&gt;
 248     </code></p></div>
 249
 250
 251 </div>
 252 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 253 <div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">Directive</a></h2>
 254 <table class="directive">
 255 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du fichier de configuration distribué</td></tr>
 256 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AccessFileName <var>nom-du-fichier</var>
 257 [<var>nom-du-fichier</var>] ...</code></td></tr>
 258 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
 259 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 260 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 261 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 262 </table>
 263     <p>Au cours du traitement d'une requête, le serveur recherche le
 264     premier fichier de configuration existant à partir de la liste
 265     de noms dans chaque répertoire composant le chemin du document, à
 266     partir du moment où les fichiers de configuration distribués sont <a href="#allowoverride">activés pour ce répertoire</a>. Par exemple
 267     :</p>
 268
 269     <div class="example"><p><code>
 270       AccessFileName .acl
 271     </code></p></div>
 272
 273     <p>avant de renvoyer le document
 274     <code>/usr/local/web/index.html</code>, le serveur va rechercher les
 275     fichiers <code>/.acl</code>, <code>/usr/.acl</code>,
 276     <code>/usr/local/.acl</code> et <code>/usr/local/web/.acl</code>
 277     pour y lire d'éventuelles directives, à moins quelles n'aient été
 278     désactivées avec</p>
 279
 280     <div class="example"><p><code>
 281       &lt;Directory /&gt;<br />
 282       <span class="indent">
 283         AllowOverride None<br />
 284       </span>
 285       &lt;/Directory&gt;
 286     </code></p></div>
 287
 288 <h3>Voir aussi</h3>
 289 <ul>
 290 <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
 291 <li><a href="../configuring.html">Fichiers de configuration</a></li>
 292 <li><a href="../howto/htaccess.html">Fichiers .htaccess</a></li>
 293 </ul>
 294 </div>
 295 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 296 <div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">Directive</a></h2>
 297 <table class="directive">
 298 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Paramètre jeu de caractères par défaut à ajouter quand le
 299 type de contenu d'une réponse est <code>text/plain</code> ou
 300 <code>text/html</code></td></tr>
 301 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddDefaultCharset On|Off|<var>jeu de caractères</var></code></td></tr>
 302 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
 303 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 304 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
 305 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 306 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 307 </table>
 308     <p>Cette directive spécifie une valeur par défaut pour le paramètre
 309     jeu de caractères du type de média (le nom d'un codage de
 310     caractères) à ajouter à une réponse, si et seulement si le type de
 311     contenu de la réponse est soit <code>text/plain</code>, soit
 312     <code>text/html</code>. Ceci va remplacer
 313     tout jeu de caractères spécifié dans le corps de la réponse via un
 314     élément <code>META</code>, bien que cet effet dépende en fait
 315     souvent de la configuration du client de l'utilisateur. La
 316     définition de <code>AddDefaultCharset Off</code> désactive cette
 317     fonctionnalité. <code>AddDefaultCharset On</code> ajoute un jeu de
 318     caractères par défaut de <code>iso-8859-1</code>. Toute autre valeur
 319     peut être définie via le paramètre <var>jeu de caractères</var>, qui
 320     doit appartenir à la liste des <a href="http://www.iana.org/assignments/character-sets">valeurs de
 321     jeux de caractères enregistrés par l'IANA</a> à utiliser dans les
 322     types de média Internet (types MIME).
 323     Par exemple :</p>
 324
 325     <div class="example"><p><code>
 326       AddDefaultCharset utf-8
 327     </code></p></div>
 328
 329     <p>La directive <code class="directive">AddDefaultCharset</code> ne doit
 330     être utilisée que lorsque toutes les ressources textes auxquelles
 331     elle s'applique possèdent le jeu de caractère spécifié, et qu'il est
 332     trop contraignant de définir leur jeu de caractères
 333     individuellement. Un exemple de ce type est l'ajout du paramètre jeu
 334     de caractères aux ressources comportant un contenu généré, comme les
 335     scripts CGI hérités qui peuvent être vulnérables à des attaques de
 336     type cross-site scripting à cause des données utilisateurs incluses
 337     dans leur sortie. Notez cependant qu'une meilleur solution consiste
 338     à corriger (ou supprimer) ces scripts, car la définition d'un jeu de
 339     caractères par défaut ne protège pas les utilisateurs qui ont activé
 340     la fonctionnalité "Détection automatique de l'encodage des
 341     caractères" dans leur navigateur.</p>
 342
 343 <h3>Voir aussi</h3>
 344 <ul>
 345 <li><code class="directive"><a href="../mod/mod_mime.html#addcharset">AddCharset</a></code></li>
 346 </ul>
 347 </div>
 348 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 349 <div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a> <a name="addoutputfilterbytype" id="addoutputfilterbytype">Directive</a></h2>
 350 <table class="directive">
 351 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>assigne un filtre en sortie pour un type de média
 352 particulier</td></tr>
 353 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddOutputFilterByType <var>filtre</var>[;<var>filtre</var>...]
 354 <var>type de média</var> [<var>type de média</var>] ...</code></td></tr>
 355 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 356 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
 357 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 358 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 359 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans Apache version 2.0.33 et supérieures ;
 360 obsolète dans les versions 2.1 et supérieures</td></tr>
 361 </table>
 362     <p>Cette directive active un <a href="../filter.html">filtre</a> en sortie particulier pour une
 363     requête en fonction du <a class="glossarylink" href="../glossary.html#type de média" title="voir glossaire">type de média</a> de la réponse.
 364     Suite à certains problèmes évoqués plus loin, cette directive a été
 365     abandonnée. Le même résultat peut être obtenu à l'aide du module
 366     <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>.</p>
 367
 368     <p>L'exemple suivant active le filtre <code>DEFLATE</code> qui est
 369     fourni par le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>. Il va compresser
 370     toute sortie dont le type MIME est <code>text/html</code> ou
 371     <code>text/plain</code> avant de l'envoyer au client.</p>
 372
 373     <div class="example"><p><code>
 374       AddOutputFilterByType DEFLATE text/html text/plain
 375     </code></p></div>
 376
 377     <p>Si vous voulez assigner plusieurs filtres au contenu, leurs noms
 378     doivent être séparés par des points-virgules. On peut aussi utiliser
 379     une directive <code class="directive">AddOutputFilterByType</code> pour
 380     chacun des filtres à assigner.</p>
 381
 382     <p>La configuration ci-dessous impose le traitement de toute sortie
 383     de script dont le type MIME est <code>text/html</code> en premier
 384     lieu par le filtre <code>INCLUDES</code>, puis par le filtre
 385     <code>DEFLATE</code>.</p>
 386
 387     <div class="example"><p><code>
 388     &lt;Location /cgi-bin/&gt;<br />
 389     <span class="indent">
 390       Options Includes<br />
 391       AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
 392     </span>
 393     &lt;/Location&gt;
 394     </code></p></div>
 395
 396     <div class="warning"><h3>Note</h3>
 397       <p>L'activation de filtres par la directive
 398       <code class="directive">AddOutputFilterByType</code> peut partiellement
 399       échouer, ou même complètement dans certains cas. Par exemple,
 400       aucun filtre n'est appliqué si le <a class="glossarylink" href="../glossary.html#type de&#10;      média" title="voir glossaire">type de
 401       média</a> n'a pas pu être déterminé. Si vous voulez vous
 402       assurer que les filtres seront
 403       appliqués, assignez explicitement le type de contenu à une
 404       ressource, par exemple à l'aide d'une directive <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> ou <code class="directive"><a href="#forcetype">ForceType</a></code>. Il est aussi recommandé de
 405       définir le type de contenu dans un script CGI (non-nph).</p>
 406
 407     </div>
 408
 409 <h3>Voir aussi</h3>
 410 <ul>
 411 <li><code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li>
 412 <li><code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code></li>
 413 <li><a href="../filter.html">Les filtres</a></li>
 414 </ul>
 415 </div>
 416 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 417 <div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">Directive</a></h2>
 418 <table class="directive">
 419 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si les séparateurs de chemin encodés sont
 420 autorisés à transiter dans les URLs tels quels</td></tr>
 421 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
 422 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
 423 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 424 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 425 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 426 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans Apache version 2.0.46 et
 427 supérieures</td></tr>
 428 </table>
 429     <p>La directive <code class="directive">AllowEncodedSlashes</code> permet
 430     l'utilisation des URLs contenant des séparateurs de chemin encodés
 431     (<code>%2F</code> pour <code>/</code> et même <code>%5C</code> pour
 432     <code>\</code> sur les systèmes concernés). Habituellement, ces URLs
 433     sont rejetées avec un code d'erreur 404 (Not found).</p>
 434
 435     <p>Définir <code class="directive">AllowEncodedSlashes</code> à
 436     <code>On</code> est surtout utile en association avec
 437     <code>PATH_INFO</code>.</p>
 438
 439     <div class="note"><h3>Note</h3>
 440       <p>Permettre les slashes encodés n'implique <em>pas</em> leur
 441       <em>décodage</em>. Toutes les occurrences de <code>%2F</code> ou
 442       <code>%5C</code> (<em>seulement</em> sur les systèmes concernés)
 443       seront laissés telles quelles dans la chaîne de l'URL décodée.</p>
 444     </div>
 445
 446 <h3>Voir aussi</h3>
 447 <ul>
 448 <li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
 449 </ul>
 450 </div>
 451 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 452 <div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">Directive</a></h2>
 453 <table class="directive">
 454 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types de directives autorisées dans les fichiers
 455 <code>.htaccess</code></td></tr>
 456 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowOverride All|None|<var>type directive</var>
 457 [<var>type directive</var>] ...</code></td></tr>
 458 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowOverride All</code></td></tr>
 459 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 460 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 461 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 462 </table>
 463     <p>Lorsque le serveur trouve un fichier <code>.htaccess</code> (dont
 464     le nom est défini par la directive <code class="directive"><a href="#accessfilename">AccessFileName</a></code>), il doit savoir lesquelles
 465     des directives placées dans ce fichier sont autorisées à modifier la
 466     configuration préexistante.</p>
 467
 468     <div class="note"><h3>Valable seulement dans les sections
 469     &lt;Directory&gt;</h3>
 470     La directive <code class="directive">AllowOverride</code> ne peut être
 471     utilisée que dans les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> définies sans expressions
 472     rationnelles, et non dans les sections <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, <code class="directive"><a href="#directorymatch">&lt;DirectoryMatch&gt;</a></code> ou
 473     <code class="directive"><a href="#files">&lt;Files&gt;</a></code>.
 474     </div>
 475
 476     <p>Lorsque cette directive est définie à <code>None</code>, les
 477     fichiers <a href="#accessfilename">.htaccess</a> sont totalement
 478     ignorés. Dans ce cas, le serveur n'essaiera même pas de lire les
 479     fichiers <code>.htaccess</code> du système de fichiers.</p>
 480
 481     <p>Lorsque cette directive est définie à <code>All</code>, toute
 482     directive valable dans le <a href="directive-dict.html#Context">Contexte</a> .htaccess sera
 483     autorisée dans les fichiers <code>.htaccess</code>.</p>
 484
 485     <p>L'argument <var>type directive</var> peut contenir les
 486     groupements de directives suivants :</p>
 487
 488     <dl>
 489       <dt>AuthConfig</dt>
 490
 491       <dd>
 492
 493       Permet l'utilisation des directives d'autorisation (<code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
 494       <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
 495       <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
 496       <code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code>,
 497       <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>, <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>, <em>etc...</em>).</dd>
 498
 499       <dt>FileInfo</dt>
 500
 501       <dd>
 502       Permet l'utilisation des directives qui contrôlent les types de
 503       documents (directives  <code class="directive"><a href="#errordocument">ErrorDocument</a></code>, <code class="directive"><a href="#forcetype">ForceType</a></code>, <code class="directive"><a href="../mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,
 504       <code class="directive"><a href="#sethandler">SetHandler</a></code>, <code class="directive"><a href="#setinputfilter">SetInputFilter</a></code>, <code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code>, et directives du
 505       module <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> Add* et Remove*), des metadonnées
 506       des documents (<code class="directive"><a href="../mod/mod_headers.html#header">Header</a></code>, <code class="directive"><a href="../mod/mod_headers.html#requestheader">RequestHeader</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code>, <code class="directive"><a href="../mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookieexpires">CookieExpires</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiedomain">CookieDomain</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiestyle">CookieStyle</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookietracking">CookieTracking</a></code>, <code class="directive"><a href="../mod/mod_usertrack.html#cookiename">CookieName</a></code>), des directives du
 507       module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> <code class="directive"><a href="../mod/mod_rewrite.html#rewriteengine">RewriteEngine</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewriteoptions">RewriteOptions</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>, <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>) et de la directive
 508       <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> du module
 509       <code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code>.
 510       </dd>
 511
 512       <dt>Indexes</dt>
 513
 514       <dd>
 515       Permet l'utilisation des directives qui contrôlent l'indexation
 516       des répertoires (<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
 517       <code class="directive"><a href="../mod/mod_autoindex.html#addicon">AddIcon</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#addiconbyencoding">AddIconByEncoding</a></code>,
 518       <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
 519       <code class="directive"><a href="../mod/mod_autoindex.html#defaulticon">DefaultIcon</a></code>, <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#fancyindexing">FancyIndexing</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#headername">HeaderName</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexignore">IndexIgnore</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#indexoptions">IndexOptions</a></code>, <code class="directive"><a href="../mod/mod_autoindex.html#readmename">ReadmeName</a></code>,
 520       <em>etc...</em>).</dd>
 521
 522       <dt>Limit</dt>
 523
 524       <dd>
 525       Permet l'utilisation des directives contrôlant l'accès au serveur
 526       (<code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code>, <code class="directive"><a href="../mod/mod_authz_host.html#deny">Deny</a></code> et <code class="directive"><a href="../mod/mod_authz_host.html#order">Order</a></code>).</dd>
 527
 528       <dt>Options[=<var>Option</var>,...]</dt>
 529
 530       <dd>
 531       Permet l'utilisation des directives contrôlant les fonctionnalités
 532       spécifiques d'un répertoire (<code class="directive"><a href="#options">Options</a></code> et <code class="directive"><a href="../mod/mod_include.html#xbithack">XBitHack</a></code>). "Options" doit être
 533       suivi d'un signe "égal", puis d'une liste d'options séparées par des
 534       virgules (pas d'espaces) ; ces options doivent être définies à
 535       l'aide de la commande <code class="directive"><a href="#options">Options</a></code>.</dd>
 536     </dl>
 537
 538     <p>Exemple :</p>
 539
 540     <div class="example"><p><code>
 541       AllowOverride AuthConfig Indexes
 542     </code></p></div>
 543
 544     <p>Dans l'exemple ci-dessus, toutes les directives qui ne font
 545     partie ni du groupe <code>AuthConfig</code>, ni du groupe
 546     <code>Indexes</code>, provoquent une erreur "internal
 547     server error".</p>
 548
 549     <div class="note"><p>Pour des raisons de sécurité et de performance, ne
 550     définissez pas <code>AllowOverride</code> à autre chose que
 551     <code>None</code> dans votre bloc <code>&lt;Directory /&gt;</code>.
 552     Recherchez plutôt (ou créez) le bloc <code>&lt;Directory&gt;</code>
 553     qui se réfère au répertoire où vous allez précisément placer un
 554     fichier <code>.htaccess</code>.</p>
 555     </div>
 556
 557 <h3>Voir aussi</h3>
 558 <ul>
 559 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
 560 <li><a href="../configuring.html">Configuration Files</a></li>
 561 <li><a href="../howto/htaccess.html">.htaccess Files</a></li>
 562 </ul>
 563 </div>
 564 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 565 <div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">Directive</a></h2>
 566 <table class="directive">
 567 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique permettant de localiser l'interpréteur des
 568 scripts CGI</td></tr>
 569 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIMapExtension <var>chemin CGI</var> <var>.extension</var></code></td></tr>
 570 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
 571 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
 572 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 573 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 574 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>NetWare uniquement</td></tr>
 575 </table>
 576     <p>Cette directive permet de contrôler la manière dont Apache trouve
 577     l'interpréteur servant à exécuter les scripts CGI. Par exemple, avec
 578     la définition <code>CGIMapExtension sys:\foo.nlm .foo</code>, tous
 579     les fichiers scripts CGI possédant une extension <code>.foo</code>
 580     seront passés à l'interpréteur FOO.</p>
 581
 582 </div>
 583 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 584 <div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a> <a name="contentdigest" id="contentdigest">Directive</a></h2>
 585 <table class="directive">
 586 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la génération d'un en-tête <code>Content-MD5</code>
 587 dans la réponse HTTP</td></tr>
 588 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ContentDigest On|Off</code></td></tr>
 589 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ContentDigest Off</code></td></tr>
 590 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 591 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Options</td></tr>
 592 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 593 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 594 </table>
 595     <p>Cette directive active la génération d'un en-tête
 596     <code>Content-MD5</code> selon les définitions des RFC 1864 et
 597     2616.</p>
 598
 599     <p>MD5 est un algorithme permettant de générer un condensé (parfois
 600     appelé "empreinte") à partir de données d'une taille aléatoire ; le
 601     degré de précision est tel que la moindre altération des données
 602     d'origine entraîne une altération de l'empreinte.</p>
 603
 604     <p>L'en-tête <code>Content-MD5</code> permet de vérifier
 605     l'intégrité de la réponse HTTP dans son ensemble. Un serveur mandataire
 606     ou un client peut utiliser cet en-tête pour rechercher une
 607     éventuelle modification accidentelle de la réponse au cours de sa
 608     transmission. Exemple d'en-tête :</p>
 609
 610     <div class="example"><p><code>
 611       Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
 612     </code></p></div>
 613
 614     <p>Notez que des problèmes de performances peuvent affecter votre
 615     serveur, car l'empreinte est générée pour chaque requête (il n'y a
 616     pas de mise en cache).</p>
 617
 618     <p>L'en-tête <code>Content-MD5</code> n'est envoyé qu'avec les
 619     documents servis par le module <code class="module"><a href="../mod/core.html">core</a></code>, à l'exclusion
 620     de tout autre module. Ainsi, les documents SSI, les sorties de
 621     scripts CGI, et les réponses à des requêtes partielles (byte range)
 622     ne comportent pas cet en-tête.</p>
 623
 624 </div>
 625 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 626 <div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">Directive</a></h2>
 627 <table class="directive">
 628 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les seuls effets de cette directive sont des émissions
 629 d'avertissements si sa valeur est différente de <code>none</code>. Dans
 630 les versions précédentes, DefaultType permettait de spécifier un type de
 631 média à assigner par défaut au contenu d'une réponse pour lequel aucun
 632 autre type de média n'avait été trouvé.
 633 </td></tr>
 634 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultType <var>type média|none</var></code></td></tr>
 635 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DefaultType none</code></td></tr>
 636 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 637 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
 638 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 639 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 640 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>L'argument <code>none</code> est disponible dans les
 641 versions d'Apache 2.2.7 et supérieures. Tous les autres choix sont
 642 DESACTIVÉS à partir des version 2.3.x.</td></tr>
 643 </table>
 644     <p>Cette directive a été désactivée. Pour la compatibilité
 645     ascendante avec les anciens fichiers de configuration, elle peut
 646     être spécifiée avec la valeur <code>none</code>, c'est à dire sans
 647     type de médium par défaut. Par exemple :</p>
 648
 649     <div class="example"><p><code>
 650       DefaultType None
 651     </code></p></div>
 652     <p><code>DefaultType None</code> n'est disponible que dans les
 653     versions d'Apache 2.2.7 et supérieures.</p>
 654
 655     <p>Utilisez le fichier de configuration mime.types et la directive
 656     <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> pour configurer
 657     l'assignement d'un type de médium via les extensions de fichiers, ou
 658     la directive <code class="directive"><a href="#forcetype">ForceType</a></code> pour
 659     attribuer un type de médium à des ressources spécifiques. Dans le
 660     cas contraire, le serveur enverra sa réponse sans champ d'en-tête
 661     Content-Type, et le destinataire devra déterminer lui-même le type
 662     de médium.</p>
 663
 664 </div>
 665 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 666 <div class="directive-section"><h2><a name="Define" id="Define">Define</a> <a name="define" id="define">Directive</a></h2>
 667 <table class="directive">
 668 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de définir l'existence d'une variable</td></tr>
 669 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Define <var>nom variable</var></code></td></tr>
 670 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
 671 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 672 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 673 </table>
 674     <p>Cette directive produit le même effet que l'argument
 675     <code>-D</code> du programme <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p>
 676     <p>Elle permet de faire basculer le fonctionnement de sections
 677     <code class="directive"><a href="#ifdefine">&lt;IfDefine&gt;</a></code> sans
 678     avoir à modifier les arguments de l'option <code>-D</code> dans
 679     aucun script de démarrage.</p>
 680
 681 </div>
 682 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 683 <div class="directive-section"><h2><a name="Directory" id="Directory">&lt;Directory&gt;</a> <a name="directory" id="directory">Directive</a></h2>
 684 <table class="directive">
 685 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe un ensemble de directives qui ne s'appliquent
 686 qu'au répertoire concerné du système de fichiers et à ses
 687 sous-répertoires</td></tr>
 688 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Directory <var>chemin répertoire</var>&gt;
 689 ... &lt;/Directory&gt;</code></td></tr>
 690 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 691 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 692 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 693 </table>
 694     <p>Les balises <code class="directive">&lt;Directory&gt;</code> et
 695     <code>&lt;/Directory&gt;</code> permettent de regrouper un ensemble
 696     de directives qui ne s'appliquent qu'au répertoire précisé
 697     et à ses sous-répertoires. Toute directive
 698     autorisée dans un contexte de répertoire peut être utilisée.
 699     <var>chemin répertoire</var> est soit le chemin absolu d'un
 700     répertoire, soit une chaîne de caractères avec caractères génériques
 701     utilisant la comparaison Unix de style shell. Dans une chaîne de
 702     caractères avec caractères génériques, <code>?</code> correspond à
 703     un caractère quelconque, et <code>*</code> à toute chaîne de
 704     caractères. Les intervalles de caractères <code>[]</code> sont aussi
 705     autorisés. Aucun caractère générique ne peut remplacer le caractère
 706     `/', si bien que l'expression <code>&lt;Directory
 707     /*/public_html&gt;</code> ne conviendra pas pour le chemin
 708      * <code>/home/user/public_html</code>, alors que <code>&lt;Directory
 709     /home/*/public_html&gt;</code> conviendra. Exemple :</p>
 710
 711     <div class="example"><p><code>
 712       &lt;Directory /usr/local/httpd/htdocs&gt;<br />
 713       <span class="indent">
 714         Options Indexes FollowSymLinks<br />
 715       </span>
 716       &lt;/Directory&gt;
 717     </code></p></div>
 718
 719     <div class="note">
 720       <p>Soyez prudent avec l'argument <var>chemin répertoire</var> : il
 721       doit correspondre exactement au chemin du système de fichier
 722       qu'Apache utilise pour accéder aux fichiers. Les directives
 723       comprises dans une section <code>&lt;Directory&gt;</code> ne
 724       s'appliqueront pas aux fichiers du même répertoire auxquels on
 725       aura accédé via un chemin différent, per exemple via un lien
 726       symbolique.</p>
 727     </div>
 728
 729     <p> Les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a>
 730     peuvent aussi être utilisées en ajoutant le caractère
 731     <code>~</code>. Par exemple :</p>
 732
 733     <div class="example"><p><code>
 734       &lt;Directory ~ "^/www/.*/[0-9]{3}"&gt;
 735     </code></p></div>
 736
 737     <p>pourra correspondre à tout répertoire situé dans /www/ et dont le
 738     nom se compose de trois chiffres.</p>
 739
 740     <p>Si plusieurs sections <code class="directive">&lt;Directory&gt;</code> (sans expression rationnelle)
 741     correspondent au répertoire (ou à un de ses parents) qui contient le
 742     document, les directives de la section <code class="directive">&lt;Directory&gt;</code> dont le chemin est le plus
 743     court sont appliquées en premier, en s'intercalant avec les
 744     directives des fichiers <a href="#accessfilename">.htaccess</a>. Par
 745     exemple, avec</p>
 746
 747     <div class="example"><p><code>
 748       &lt;Directory /&gt;<br />
 749       <span class="indent">
 750         AllowOverride None<br />
 751       </span>
 752       &lt;/Directory&gt;<br />
 753       <br />
 754       &lt;Directory /home/&gt;<br />
 755       <span class="indent">
 756         AllowOverride FileInfo<br />
 757       </span>
 758       &lt;/Directory&gt;
 759     </code></p></div>
 760
 761     <p>l'accès au document <code>/home/web/dir/doc.html</code> emprunte
 762     le chemin suivant :</p>
 763
 764     <ul>
 765       <li>Aplication de la directive <code>AllowOverride None</code>
 766       (qui désactive les fichiers <code>.htaccess</code>).</li>
 767
 768       <li>Application de la directive <code>AllowOverride
 769       FileInfo</code> (pour le répertoire <code>/home</code>).</li>
 770
 771       <li>Application de toute directive <code>FileInfo</code> qui se
 772       trouverait dans d'éventuels fichiers <code>/home/.htaccess</code>,
 773       <code>/home/web/.htaccess</code> ou
 774       <code>/home/web/dir/.htaccess</code>, dans cet ordre.</li>
 775     </ul>
 776
 777     <p>Les directives associées aux répertoires sous forme d'expressions
 778     rationnelles ne sont prises en compte qu'une fois toutes les
 779     directives des sections sans expressions rationnelles appliquées.
 780     Alors, tous les répertoires avec expressions rationnelles sont
 781     testés selon l'ordre dans lequel ils apparaissent dans le fichier de
 782     configuration. Par exemple, avec</p>
 783
 784     <div class="example"><p><code>
 785       &lt;Directory ~ abc$&gt;<br />
 786       <span class="indent">
 787         # ... directives here ...<br />
 788       </span>
 789       &lt;/Directory&gt;
 790     </code></p></div>
 791
 792     <p>la section avec expression rationnelle ne sera prise en compte
 793     qu'après les sections <code class="directive">&lt;Directory&gt;</code> sans expression rationnelle
 794     et les fichiers <code>.htaccess</code>. Alors, l'expression
 795     rationnelle conviendra pour <code>/home/abc/public_html/abc</code>
 796     et la section <code class="directive">&lt;Directory&gt;</code>
 797     correspondante s'appliquera.</p>
 798
 799    <p><strong>Notez que pour Apache, la politique d'accès par défaut
 800    dans les sections <code>&lt;Directory /&gt;</code> est <code>Allow
 801    from All</code>. Ceci signifie qu'Apache va servir tout fichier
 802    correspondant à une URL. Il est recommandé de modifier cette
 803    situation à l'aide d'un bloc du style</strong></p>
 804
 805     <div class="example"><p><code>
 806       &lt;Directory /&gt;<br />
 807       <span class="indent">
 808         Order Deny,Allow<br />
 809         Deny from All<br />
 810       </span>
 811       &lt;/Directory&gt;
 812     </code></p></div>
 813
 814     <p><strong>puis d'affiner la configuration pour les répertoires que vous
 815     voulez rendre accessibles. Voir la page <a href="../misc/security_tips.html">Conseils à propos de sécurité</a>
 816     pour plus de détails.</strong></p>
 817
 818     <p>Les sections <code class="directive">&lt;Directory&gt;</code> se situent
 819     dans le fichier <code>httpd.conf</code>. Les directives <code class="directive">&lt;Directory&gt;</code> ne peuvent pas être imbriquées
 820     et ne sont pas autorisées dans les sections <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> ou <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>.</p>
 821
 822 <h3>Voir aussi</h3>
 823 <ul>
 824 <li><a href="../sections.html">Comment fonctionnent les sections
 825 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour des
 826 explications à propos de la manière dont ces différentes sections se
 827 combinent entre elles à la réception d'une requête</li>
 828 </ul>
 829 </div>
 830 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 831 <div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch">&lt;DirectoryMatch&gt;</a> <a name="directorymatch" id="directorymatch">Directive</a></h2>
 832 <table class="directive">
 833 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives qui s'appliquent à des répertoires
 834 du système de fichiers correspondant à une expression rationnelle et à
 835 leurs sous-répertoires</td></tr>
 836 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;DirectoryMatch <var>regex</var>&gt;
 837 ... &lt;/DirectoryMatch&gt;</code></td></tr>
 838 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 839 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 840 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 841 </table>
 842     <p>Les balises <code class="directive">&lt;DirectoryMatch&gt;</code>
 843     et <code>&lt;/DirectoryMatch&gt;</code> permettent de regrouper un
 844     ensemble de directives qui ne s'appliqueront qu'au répertoire
 845     précisé et à ses sous-répertoires, comme pour la section <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>. Cependant, le
 846     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>
 847
 848     <div class="example"><p><code>
 849       &lt;DirectoryMatch "^/www/(.+/)?[0-9]{3}"&gt;
 850     </code></p></div>
 851
 852     <p>conviendrait pour les sous-répertoires de <code>/www/</code> dont
 853     le nom se compose de trois chiffres.</p>
 854
 855 <h3>Voir aussi</h3>
 856 <ul>
 857 <li><code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>
 858 pour une description de la manière dont les expressions rationnelles
 859 sont traitées en présence d'autres sections <code class="directive">&lt;Directory&gt;</code> sans expressions rationnelles</li>
 860 <li><a href="../sections.html">Comment fonctionnent les sections
 861 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
 862 explication à propos de la manière dont ces différentes sections se
 863 combinent entre elles à la réception d'une requête</li>
 864 </ul>
 865 </div>
 866 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 867 <div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">Directive</a></h2>
 868 <table class="directive">
 869 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine principale de l'arborescence des documents visible
 870 depuis Internet</td></tr>
 871 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DocumentRoot <var>chemin répertoire</var></code></td></tr>
 872 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
 873 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 874 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 875 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 876 </table>
 877     <p>Cette directive permet de définir le répertoire à partir duquel
 878     <code class="program"><a href="../programs/httpd.html">httpd</a></code> va servir les fichiers. S'il ne correspond
 879     pas à un <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, le chemin
 880     de l'URL sera ajouté par le serveur à la racine des documents afin
 881     de construire le chemin du document recherché. Exemple :</p>
 882
 883     <div class="example"><p><code>
 884       DocumentRoot /usr/web
 885     </code></p></div>
 886
 887     <p>un accès à <code>http://www.my.host.com/index.html</code> se
 888     réfère alors à <code>/usr/web/index.html</code>. Si <var>chemin
 889     répertoire</var> n'est pas un chemin absolu, il est considéré comme
 890     relatif au chemin défini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
 891
 892     <p>Le répertoire défini par la directive
 893     <code class="directive">DocumentRoot</code> ne doit pas comporter de slash
 894     final.</p>
 895
 896 <h3>Voir aussi</h3>
 897 <ul>
 898 <li><a href="../urlmapping.html#documentroot">Mise en
 899 correspondance des URLs avec le système de fichiers</a></li>
 900 </ul>
 901 </div>
 902 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 903 <div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">Directive</a></h2>
 904 <table class="directive">
 905 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise la projection en mémoire (Memory-Mapping) pour
 906 lire les fichiers pendant qu'ils sont servis</td></tr>
 907 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
 908 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>EnableMMAP On</code></td></tr>
 909 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 910 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
 911 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 912 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 913 </table>
 914     <p>Cette directive définit si <code class="program"><a href="../programs/httpd.html">httpd</a></code> peut utiliser
 915     la projection en mémoire (Memory-Mapping) quand il doit lire le contenu
 916     d'un fichier pendant qu'il est servi. Par défaut, lorsque le
 917     traitement d'une requête requiert l'accès aux données contenues dans
 918     un fichier -- par exemple, pour servir un fichier interprété par le
 919     serveur à l'aide de <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> -- Apache projette
 920     le fichier en mémoire si le système d'exploitation le permet.</p>
 921
 922     <p>Cette projection en mémoire induit parfois une amélioration des
 923     performances. Sur certains systèmes cependant, il est préférable de
 924     désactiver la projection en mémoire afin d'éviter certains problèmes
 925     opérationnels :</p>
 926
 927     <ul>
 928     <li>Sur certains systèmes multi-processeurs, la projection en
 929     mémoire peut dégrader les performances du programme
 930     <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</li>
 931
 932     </ul>
 933
 934     <p>Pour les configurations de serveur sujettes à ce genre de
 935     problème, il est préférable de désactiver la projection en mémoire
 936     des fichiers servis en spécifiant :</p>
 937     <ul><li>S'il fait l'objet d'une projection en mémoire par
 938     <code class="program"><a href="../programs/httpd.html">httpd</a></code>, la suppression ou la troncature d'un
 939     fichier peut provoquer un crash de <code class="program"><a href="../programs/httpd.html">httpd</a></code> avec une
 940     erreur de segmentation.</li></ul>
 941     <div class="example"><p><code>
 942       EnableMMAP Off
 943     </code></p></div>
 944
 945     <p>Pour les montages NFS, cette fonctionnalité peut être
 946     explicitement désactivée pour les fichiers concernés en spécifiant
 947     :</p>
 948
 949     <div class="example"><p><code>
 950       &lt;Directory "/chemin vers montage NFS"&gt;
 951       <span class="indent">
 952         EnableMMAP Off
 953       </span>
 954       &lt;/Directory&gt;
 955     </code></p></div>
 956
 957 </div>
 958 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 959 <div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">Directive</a></h2>
 960 <table class="directive">
 961 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise le support sendfile du noyau pour servir les
 962 fichiers aux clients</td></tr>
 963 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
 964 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>EnableSendfile On</code></td></tr>
 965 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 966 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
 967 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
 968 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 969 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans les versions 2.0.44 et
 970 supérieures</td></tr>
 971 </table>
 972     <p>Cette directive définit si le programme <code class="program"><a href="../programs/httpd.html">httpd</a></code>
 973     peut utiliser le support sendfile du noyau pour transmettre le
 974     contenu des fichiers aux clients. Par défaut, lorsque le traitement
 975     d'une requête ne requiert pas l'accès aux données contenues dans un
 976     fichier -- par exemple, pour la transmission d'un fichier statique
 977     -- Apache utilise sendfile pour transmettre le contenu du fichier
 978     sans même lire ce dernier, si le système d'exploitation le
 979     permet.</p>
 980
 981     <p>Ce mécanisme sendfile évite la séparation des opérations de
 982     lecture et d'envoi, ainsi que les réservations de tampons. sur
 983     certains systèmes cependant, ou sous certains systèmes de fichiers,
 984     il est préférable de désactiver cette fonctionnalité afin d'éviter
 985     certains problèmes opérationnels :</p>
 986
 987     <ul>
 988     <li>Certains systèmes peuvent présenter un support sendfile
 989     défectueux que le système de compilation n'a pas détecté, en
 990     particulier si les exécutables ont été compilés sur une autre
 991     machine, puis copiés sur la première avec un support sendfile
 992     défectueux.</li>
 993     <li>Sous Linux, l'utilisation de sendfile induit des bogues lors de
 994     la récupération des paquets de vérification TCP (TCP-checksum) avec
 995     certaines cartes réseau lorsqu'on utilise IPv6.</li>
 996     <li>Sous Linux sur Itanium, sendfile peut s'avérer incapable de
 997     traiter les fichiers de plus de 2 Go.</li>
 998     <li>Avec un montage réseau de <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (par exemple NFS ou SMB), le
 999     noyau peut s'avérer incapable de servir un fichier de ce montage
1000     réseau en passant par son propre cache.</li>
1001     </ul>
1002
1003     <p>Pour les configurations de serveur sujettes à ce genre de
1004     problème, il est recommandé de désactiver cette fonctionnalité en
1005     spécifiant :</p>
1006
1007     <div class="example"><p><code>
1008       EnableSendfile Off
1009     </code></p></div>
1010
1011     <p>Pour les montages NFS ou SMB, cette fonctionnalité peut être
1012     explicitement désactivée pour les fichiers concernés en spécifiant
1013     :</p>
1014
1015     <div class="example"><p><code>
1016       &lt;Directory "/chemin vers montage réseau"&gt;
1017       <span class="indent">
1018         EnableSendfile Off
1019       </span>
1020       &lt;/Directory&gt;
1021     </code></p></div>
1022     <p>Veuillez noter que la configuration de la directive
1023     <code class="directive">EnableSendfile</code> dans un contexte de répertoire
1024     ou de fichier .htaccess n'est pas supportée par
1025     <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code>. Le module ne prend en compte la
1026     définition de <code class="directive">EnableSendfile</code> que dans un
1027     contexte global.
1028     </p>
1029
1030 </div>
1031 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1032 <div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">Directive</a></h2>
1033 <table class="directive">
1034 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Document que le serveur renvoie au client en cas
1035 d'erreur</td></tr>
1036 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ErrorDocument <var>code erreur</var> <var>document</var></code></td></tr>
1037 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1038 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
1039 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1040 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1041 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>La syntaxe des guillemets pour les messages textes est
1042 différente dans Apache 2.0</td></tr>
1043 </table>
1044     <p>Apache peut traiter les problèmes et les erreurs de quatre
1045     manières,</p>
1046
1047     <ol>
1048       <li>afficher un simple message d'erreur au contenu fixe</li>
1049
1050       <li>afficher un message personnalisé</li>
1051
1052       <li>rediriger vers un <var>chemin d'URL</var> local pour traiter
1053       le problème ou l'erreur</li>
1054
1055       <li>rediriger vers une <var>URL</var> externe pour traiter
1056       le problème ou l'erreur</li>
1057     </ol>
1058
1059     <p>La première option constitue le comportement par défaut; pour
1060     choisir une des trois autres options, il faut configurer Apache à
1061     l'aide de la directive <code class="directive">ErrorDocument</code>, suivie
1062     du code de la réponse HTTP et d'une URL ou d'un message. Apache
1063     fournit parfois des informations supplémentaires à propos du
1064     problème ou de l'erreur.</p>
1065
1066     <p>Les URLs peuvent commencer par un slash (/) pour les chemins web
1067     locaux (relatifs au répertoire défini par la directive <code class="directive"><a href="#documentroot">DocumentRoot</a></code>), ou se présenter sous la
1068     forme d'une URL complète que le client pourra résoudre.
1069     Alternativement, un message à afficher par le navigateur pourra être
1070     fourni. Exemples :</p>
1071
1072     <div class="example"><p><code>
1073       ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
1074       ErrorDocument 404 /cgi-bin/bad_urls.pl<br />
1075       ErrorDocument 401 /subscription_info.html<br />
1076       ErrorDocument 403 "Désolé, vous n'avez pas l'autorisation d'accès
1077       aujourd'hui"
1078     </code></p></div>
1079
1080     <p>De plus, on peut spécifier la valeur spéciale <code>default</code>
1081     pour indiquer l'utilisation d'un simple message d'Apache codé en
1082     dur. Bien que non nécessaire dans des circonstances normales, la
1083     spécification de la valeur <code>default</code> va permettre de
1084     rétablir l'utilisation du simple message d'Apache codé en dur pour
1085     les configurations qui sans cela, hériteraient d'une directive
1086     <code class="directive">ErrorDocument</code> existante.</p>
1087
1088     <div class="example"><p><code>
1089       ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
1090       &lt;Directory /web/docs&gt;<br />
1091       <span class="indent">
1092         ErrorDocument 404 default<br />
1093       </span>
1094       &lt;/Directory&gt;
1095     </code></p></div>
1096
1097     <p>Notez que lorsque vous spécifiez une directive
1098     <code class="directive">ErrorDocument</code> pointant vers une URL distante
1099     (c'est à dire tout ce qui commence par le préfixe http), Apache va
1100     envoyer une redirection au client afin de lui indiquer où trouver le
1101     document, même dans le cas où ce document se trouve sur le serveur
1102     local. Ceci a de nombreuses conséquences dont la plus importante
1103     réside dans le fait que le client ne recevra pas le code d'erreur
1104     original, mais au contraire un code de statut de redirection. Ceci
1105     peut en retour semer la confusion chez les robots web et divers
1106     clients qui tentent de déterminer la validité d'une URL en examinant
1107     le code de statut. De plus, si vous utilisez une URL distante avec
1108     <code>ErrorDocument 401</code>, le client ne saura pas qu'il doit
1109     demander un mot de passe à l'utilisateur car il ne recevra pas le
1110     code de statut 401. C'est pourquoi, <strong>si vous utilisez une
1111     directive <code>ErrorDocument 401</code>, elle devra faire référence
1112     à un document par le biais d'un chemin local.</strong></p>
1113
1114     <p>Microsoft Internet Explorer (MSIE) ignore par défaut les messages
1115     d'erreur générés par le serveur lorsqu'ils sont trop courts et
1116     remplacent ses propres messages d'erreur "amicaux". Le seuil de
1117     taille varie en fonction du type d'erreur, mais en général, si la
1118     taille de votre message d'erreur est supérieure à 512 octets, il y a
1119     peu de chances pour que MSIE l'occulte, et il sera affiché par ce
1120     dernier. Vous trouverez d'avantage d'informations dans l'article de
1121     la base de connaissances Microsoft <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>
1122
1123     <p>Bien que la plupart des messages d'erreur internes originaux
1124     puissent être remplacés, ceux-ci sont cependant conservés dans
1125     certaines circonstances sans tenir compte de la définition de la
1126     directive <code class="directive"><a href="#errordocument">ErrorDocument</a></code>. En
1127     particulier, en cas de détection d'une requête mal formée, le
1128     processus de traitement normal des requêtes est immédiatement
1129     interrompu, et un message d'erreur interne est renvoyé, ceci afin de
1130     se prémunir contre les problèmes de sécurité liés aux requêtes mal
1131     formées.</p>
1132
1133     <p>Avant la version 2.0, les messages étaient indiqués en les
1134     préfixant par un seul caractère guillemet isolé.</p>
1135
1136 <h3>Voir aussi</h3>
1137 <ul>
1138 <li><a href="../custom-error.html">documentation sur la
1139 personnalisation des réponses</a></li>
1140 </ul>
1141 </div>
1142 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1143 <div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">Directive</a></h2>
1144 <table class="directive">
1145 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définition du chemin du journal des erreurs</td></tr>
1146 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> ErrorLog <var>chemin fichier</var>|syslog[:<var>facility</var>]</code></td></tr>
1147 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2)</code></td></tr>
1148 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1149 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1150 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1151 </table>
1152     <p>La directive <code class="directive">ErrorLog</code> permet de définir le
1153     nom du fichier dans lequel le serveur va journaliser toutes les
1154     erreurs qu'il rencontre. Si le <var>chemin fichier</var> n'est pas
1155     absolu, il est considéré comme relatif au chemin défini par la
1156     directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
1157
1158     <div class="example"><h3>Exemple</h3><p><code>
1159     ErrorLog /var/log/httpd/error_log
1160     </code></p></div>
1161
1162     <p>Si le <var>chemin fichier</var> commence par une barre verticale
1163     (|), il est considéré comme une commande à lancer pour traiter la
1164     journalisation de l'erreur.</p>
1165
1166     <div class="example"><h3>Exemple</h3><p><code>
1167     ErrorLog "|/usr/local/bin/erreurs_httpd"
1168     </code></p></div>
1169
1170     <p>L'utilisation de <code>syslog</code> à la place d'un nom de
1171     fichier active la journalisation via syslogd(8) si le système le
1172     supporte. Le dispositif syslog par défaut est <code>local7</code>,
1173     mais vous pouvez le modifier à l'aide de la syntaxe
1174     <code>syslog:<var>facility</var></code>, où <var>facility</var> peut
1175     être remplacé par un des noms habituellement documentés dans la page
1176     de man syslog(1).</p>
1177
1178     <div class="example"><h3>Exemple</h3><p><code>
1179     ErrorLog syslog:user
1180     </code></p></div>
1181
1182     <p>SECURITE : Voir le document <a href="../misc/security_tips.html#serverroot">conseils à propos de
1183     sécurité</a> pour des détails sur les raisons pour lesquelles votre
1184     sécurité peut être compromise si le répertoire contenant les
1185     fichiers journaux présente des droits en écriture pour tout autre
1186     utilisateur que celui sous lequel le serveur est démarré.</p>
1187     <div class="warning"><h3>Note</h3>
1188       <p>Lors de la spécification d'un chemin de fichier sur les
1189       plates-formes non-Unix, on doit veiller à n'utiliser que des
1190       slashes (/), même si la plate-forme autorise l'utilisation des
1191       anti-slashes (\). Et d'une manière générale, il est recommandé de
1192       n'utiliser que des slashes (/) dans les fichiers de
1193       configuration.</p>
1194     </div>
1195
1196 <h3>Voir aussi</h3>
1197 <ul>
1198 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1199 <li><a href="../logs.html">Fichiers journaux d'Apache</a></li>
1200 </ul>
1201 </div>
1202 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1203 <div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">Directive</a></h2>
1204 <table class="directive">
1205 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Caractéristiques de fichier utilisés lors de la génération
1206 de l'en-tête de réponse HTTP ETag</td></tr>
1207 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FileETag <var>composant</var> ...</code></td></tr>
1208 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>FileETag INode MTime Size</code></td></tr>
1209 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1210 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
1211 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1212 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1213 </table>
1214     <p>
1215     La directive <code class="directive">FileETag</code> définit les
1216     caractéristiques de fichier utilisées lors de la génération de
1217     l'en-tête de réponse HTTP <code>ETag</code> (entity tag) quand le
1218     document est contenu dans un fichier (la valeur de <code>ETag</code>
1219     est utilisée dans le cadre de la gestion du cache pour préserver la
1220     bande passante réseau). Dans les versions 1.3.22 et antérieures
1221     d'Apache, la valeur de l'en-tête <code>ETag</code> se composait
1222     <em>toujours</em> de l'inode du fichier, de sa taille et de sa date
1223     de dernière modification (mtime). La directive
1224     <code class="directive">FileETag</code> vous permet maintenant de choisir
1225     quelles caractéristiques du fichier vont être utilisées, le cas
1226     échéant. Les mots-clés reconnus sont :
1227     </p>
1228
1229     <dl>
1230      <dt><strong>INode</strong></dt>
1231      <dd>Le numéro d'i-node du fichier sera inclus dans le processus de
1232      génération</dd>
1233      <dt><strong>MTime</strong></dt>
1234      <dd>La date et l'heure auxquelles le fichier a été modifié la
1235      dernière fois seront incluses</dd>
1236      <dt><strong>Size</strong></dt>
1237      <dd>La taille du fichier en octets sera incluse</dd>
1238      <dt><strong>All</strong></dt>
1239      <dd>Tous les champs disponibles seront utilisés. Cette définition
1240      est équivalente à : <div class="example"><p><code>FileETag INode MTime
1241      Size</code></p></div></dd>
1242      <dt><strong>None</strong></dt>
1243      <dd>Si le document se compose d'un fichier, aucun champ
1244      <code>ETag</code> ne sera inclus dans la réponse</dd>
1245     </dl>
1246
1247     <p>Les mots-clés <code>INode</code>, <code>MTime</code>, et
1248     <code>Size</code> peuvent être préfixés par <code>+</code> ou
1249     <code>-</code>, ce qui permet de modifier les valeurs par défaut
1250     héritées d'un niveau de configuration plus général. Tout mot-clé
1251     apparaissant sans aucun préfixe annule entièrement et immédiatement
1252     les configurations héritées.</p>
1253
1254     <p>Si la configuration d'un répertoire contient
1255     <code>FileETag&nbsp;INode&nbsp;MTime&nbsp;Size</code>, et si un de
1256     ses sous-répertoires contient <code>FileETag&nbsp;-INode</code>, la
1257     configuration de ce sous-répertoire (qui sera propagée vers tout
1258     sou-répertoire qui ne la supplante pas), sera équivalente à
1259     <code>FileETag&nbsp;MTime&nbsp;Size</code>.</p>
1260     <div class="warning"><h3>Avertissement</h3>
1261     Ne modifiez pas les valeurs par défaut pour les répertoires ou
1262     localisations où WebDAV est activé et qui utilisent
1263     <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> comme fournisseur de stockage.
1264     <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> utilise
1265     <code>INode&nbsp;MTime&nbsp;Size</code> comme format fixe pour les
1266     comparaisons de champs <code>ETag</code> dans les requêtes
1267     conditionnelles. Ces requêtes conditionnelles échoueront si le
1268     format <code>ETag</code> est modifié via la directive
1269     <code class="directive">FileETag</code>.
1270     </div>
1271
1272 </div>
1273 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1274 <div class="directive-section"><h2><a name="Files" id="Files">&lt;Files&gt;</a> <a name="files" id="files">Directive</a></h2>
1275 <table class="directive">
1276 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent aux fichiers
1277 précisés</td></tr>
1278 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Files <var>nom fichier</var>&gt; ... &lt;/Files&gt;</code></td></tr>
1279 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1280 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
1281 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1282 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1283 </table>
1284     <p>La directive <code class="directive">&lt;Files&gt;</code> limite
1285     la portée des directives qu'elle contient aux fichiers précisés.
1286     Elle est comparable aux directives <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Elle doit se terminer par une
1287     balise <code>&lt;/Files&gt;</code>. Les directives contenues dans
1288     cette section s'appliqueront à tout objet dont le nom de base (la
1289     dernière partie du nom de fichier) correspond au fichier spécifié.
1290     Les sections <code class="directive">&lt;Files&gt;</code> sont
1291     traitées selon l'ordre dans lequel elles apparaissent dans le
1292     fichier de configuration, après les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et la lecture des fichiers
1293     <code>.htaccess</code>, mais avant les sections <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Notez que les
1294     sections <code class="directive">&lt;Files&gt;</code> peuvent être
1295     imbriquées dans les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> afin de restreindre la portion
1296     du système de fichiers à laquelle ces dernières vont
1297     s'appliquer.</p>
1298
1299     <p>L'argument <var>filename</var> peut contenir un nom de fichier
1300     ou une chaîne de caractères avec caractères génériques, où
1301     <code>?</code> remplace un caractère, et <code>*</code> toute chaîne
1302     de caractères. On peut aussi utiliser les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> en ajoutant la
1303     caractère <code>~</code>. Par exemple :</p>
1304
1305     <div class="example"><p><code>
1306       &lt;Files ~ "\.(gif|jpe?g|png)$"&gt;
1307     </code></p></div>
1308
1309     <p>correspondrait à la plupart des formats graphiques de l'Internet.
1310     Il est cependant préférable d'utiliser la directive <code class="directive"><a href="#filesmatch">&lt;FilesMatch&gt;</a></code>.</p>
1311
1312     <p>Notez qu'à la différence des sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, les sections <code class="directive">&lt;Files&gt;</code> peuvent être utilisées dans les
1313     fichiers <code>.htaccess</code>. Ceci permet aux utilisateurs de
1314     contrôler l'accès à leurs propres ressources, fichier par
1315     fichier.</p>
1316
1317
1318 <h3>Voir aussi</h3>
1319 <ul>
1320 <li><a href="../sections.html">Comment fonctionnent les sections
1321 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
1322 explication de la manière dont ces différentes sections se combinent
1323 entre elles à la réception d'une requête</li>
1324 </ul>
1325 </div>
1326 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1327 <div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch">&lt;FilesMatch&gt;</a> <a name="filesmatch" id="filesmatch">Directive</a></h2>
1328 <table class="directive">
1329 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent à des fichiers
1330 spécifiés sous la forme d'expressions rationnelles</td></tr>
1331 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;FilesMatch <var>expression rationnelle</var>&gt; ...
1332 &lt;/FilesMatch&gt;</code></td></tr>
1333 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1334 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
1335 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1336 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1337 </table>
1338     <p>La section <code class="directive">&lt;FilesMatch&gt;</code>
1339     limite la portée des directives qu'elle contient aux fichiers
1340     spécifiés, tout comme le ferait une section <code class="directive"><a href="#files">&lt;Files&gt;</a></code>. Mais elle accepte aussi les
1341     <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>. Par
1342     exemple :</p>
1343
1344     <div class="example"><p><code>
1345       &lt;FilesMatch "\.(gif|jpe?g|png)$"&gt;
1346     </code></p></div>
1347
1348     <p>correspondrait à la plupart des formats graphiques de
1349     l'Internet.</p>
1350
1351 <h3>Voir aussi</h3>
1352 <ul>
1353 <li><a href="../sections.html">Comment fonctionnent les sections
1354 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
1355 explication de la manière dont ces différentes sections se combinent
1356 entre elles à la réception d'une requête</li>
1357 </ul>
1358 </div>
1359 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1360 <div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">Directive</a></h2>
1361 <table class="directive">
1362 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force le type de médium spécifié dans le champ d'en-tête
1363 HTTP Content-Type pour les fichiers correspondants</td></tr>
1364 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForceType <var>type médium</var>|None</code></td></tr>
1365 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
1366 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
1367 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1368 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1369 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Intégré dans le coeur d'Apache depuis la version
1370 2.0</td></tr>
1371 </table>
1372     <p>Lorsqu'elle est placée dans un fichier <code>.htaccess</code> ou
1373     une section <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>, <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, ou <code class="directive"><a href="#files">&lt;Files&gt;</a></code>, cette directive force
1374     l'identification du type MIME des fichiers spécifiés à la valeur de
1375     l'argument <var>type médium</var>. Par exemple, si vous possédez un
1376     répertoire ne contenant que des fichiers GIF, et si vous ne voulez
1377     pas leur ajouter l'extension <code>.gif</code>, vous pouvez utiliser
1378     :</p>
1379
1380     <div class="example"><p><code>
1381       ForceType image/gif
1382     </code></p></div>
1383
1384     <p>Notez que cette directive l'emporte sur d'autres associations de
1385     type de médium indirectes définies dans mime.types ou via la
1386     directive <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code>.</p>
1387
1388     <p>Vous pouvez aussi annuler toute définition plus générale de
1389     <code class="directive">ForceType</code> en affectant la valeur
1390     <code>None</code> à l'argument <var>type médium</var> :</p>
1391
1392     <div class="example"><p><code>
1393       # force le type MIME de tous les fichiers à image/gif:<br />
1394       &lt;Location /images&gt;<br />
1395         <span class="indent">
1396           ForceType image/gif<br />
1397         </span>
1398       &lt;/Location&gt;<br />
1399       <br />
1400       # mais utilise les méthodes classiques d'attribution du type MIME
1401       # dans le sous-répertoire suivant :<br />
1402       &lt;Location /images/mixed&gt;<br />
1403       <span class="indent">
1404         ForceType None<br />
1405       </span>
1406       &lt;/Location&gt;
1407     </code></p></div>
1408
1409 </div>
1410 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1411 <div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">Directive</a></h2>
1412 <table class="directive">
1413 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la recherche DNS sur les adresses IP des
1414 clients</td></tr>
1415 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
1416 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>HostnameLookups Off</code></td></tr>
1417 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
1418 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1419 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1420 </table>
1421     <p>Cette directive active la recherche DNS afin de pouvoir
1422     journaliser les nom d'hôtes (et les passer aux programmes CGI et aux
1423     inclusions SSI via la variable <code>REMOTE_HOST</code>). La valeur
1424     <code>Double</code> déclenche une double recherche DNS inverse. En
1425     d'autres termes, une fois la recherche inverse effectuée, on lance
1426     une recherche directe sur le résultat de cette dernière. Au moins
1427     une des adresses IP fournies par la recherche directe doit
1428     correspondre à l'adresse originale (ce que l'on nomme
1429     <code>PARANOID</code> dans la terminologie "tcpwrappers").</p>
1430
1431     <p>Quelle que soit la configuration, lorsqu'on utilise
1432     <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> pour contrôler l'accès en fonction
1433     du nom d'hôte, une double recherche DNS inverse est effectuée,
1434     sécurité oblige. Notez cependant que le résultat de cette double
1435     recherche n'est en général pas accessible, à moins que vous n'ayez
1436     spécifié <code>HostnameLookups Double</code>. Par exemple, si vous
1437     n'avez spécifié que <code>HostnameLookups On</code>, et si une
1438     requête concerne un objet protégé par des restrictions en fonction
1439     du nom d'hôte, quel que soit le résultat de la double recherche
1440     inverse, les programmes CGI ne recevront que le résultat de la
1441     recherche inverse simple dans la variable
1442     <code>REMOTE_HOST</code>.</p>
1443
1444     <p>La valeur par défaut est <code>Off</code> afin de préserver le
1445     traffic réseau des sites pour lesquels la recherche inverse n'est
1446     pas vraiment nécessaire. Cette valeur par défaut est aussi bénéfique
1447     pour les utilisateurs finaux car il n'ont ainsi pas à subir de temps
1448     d'attente supplémentaires dus aux recherches DNS. Les sites
1449     fortement chargés devraient laisser cette directive à
1450     <code>Off</code>, car les recherches DNS peuvent prendre des temps
1451     très longs. Vous pouvez éventuellement utiliser hors ligne
1452     l'utilitaire <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>, compilé par défaut dans
1453     le sous-répertoire <code>bin</code> de votre répertoire
1454     d'installation, afin de déterminer les noms d'hôtes associés aux
1455     adresses IP journalisées.</p>
1456
1457 </div>
1458 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1459 <div class="directive-section"><h2><a name="If" id="If">&lt;If&gt;</a> <a name="if" id="if">Directive</a></h2>
1460 <table class="directive">
1461 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si une
1462 condition est satisfaite au cours du traitement d'une
1463 requête</td></tr>
1464 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;If <var>expression</var>&gt; ... &lt;/If&gt;</code></td></tr>
1465 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1466 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
1467 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1468 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1469 </table>
1470     <p>La directive <code class="directive">&lt;If&gt;</code> évalue une
1471     expression à la volée, et applique les directives qu'elle contient
1472     si et seulement si l'expression renvoie la valeur "vrai". Par
1473     exemple :</p>
1474
1475     <div class="example"><p><code>
1476         &lt;If "$req{Host} = ''"&gt;
1477     </code></p></div>
1478
1479     <p>sera satisfaite dans le cas des requêtes HTTP/1.0 sans en-tête
1480     <var>Host:</var>.</p>
1481
1482     <p>Vous pouvez tester la valeur de tout en-tête de requête ($req),
1483     de tout en-tête de réponse ($resp) ou de toute variable
1484     d'environnement ($env) dans votre expression.</p>
1485
1486 <h3>Voir aussi</h3>
1487 <ul>
1488 <li><a href="../sections.html">Comment fonctionnent les sections
1489 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
1490 explication de la manière dont ces différentes sections se combinent
1491 entre elles à la réception d'une requête. La directive <code class="directive">&lt;If&gt;</code> possède la même priorité et s'utilise de
1492 la même façon que la directive <code class="directive">&lt;Files&gt;</code></li>
1493 </ul>
1494 </div>
1495 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1496 <div class="directive-section"><h2><a name="IfDefine" id="IfDefine">&lt;IfDefine&gt;</a> <a name="ifdefine" id="ifdefine">Directive</a></h2>
1497 <table class="directive">
1498 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliqueront que si un
1499 test retourne "vrai" au démarrage du serveur</td></tr>
1500 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;IfDefine [!]<var>paramètre</var>&gt; ...
1501     &lt;/IfDefine&gt;</code></td></tr>
1502 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1503 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
1504 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1505 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1506 </table>
1507     <p>La section <code>&lt;IfDefine
1508     <var>test</var>&gt;...&lt;/IfDefine&gt;</code> permet de
1509     conférer un caractère conditionnel à un ensemble de directives. Les
1510     directives situées à l'intérieur d'une section <code class="directive">&lt;IfDefine&gt;</code> ne s'appliquent que si
1511     <var>test</var> est vrai. Si <var>test</var> est faux, tout ce qui
1512     se trouve entre les balises de début et de fin est ignoré.</p>
1513
1514     <p><var>test</var> peut se présenter sous deux formes :</p>
1515
1516     <ul>
1517       <li><var>nom paramètre</var></li>
1518
1519       <li><code>!</code><var>nom paramètre</var></li>
1520     </ul>
1521
1522     <p>Dans le premier cas, les directives situées entre les balises de
1523     début et de fin ne s'appliqueront que si le paramètre nommé <var>nom
1524     paramètre</var> est défini. Le second format inverse le test, et
1525     dans ce cas, les directives ne s'appliqueront que si <var>nom
1526     paramètre</var> n'est <strong>pas</strong> défini.</p>
1527
1528     <p>L'argument <var>nom paramètre</var> est une définition qui peut
1529     être effectuée par la ligne de commande
1530     <code class="program"><a href="../programs/httpd.html">httpd</a></code> via le paramètre
1531     <code>-D<var>paramètre</var></code> au démarrage du serveur, ou via la
1532     directive <code class="directive"><a href="#define">Define</a></code>.</p>
1533
1534     <p>Les sections <code class="directive">&lt;IfDefine&gt;</code>
1535     peuvent être imbriquées, ce qui permet d'implémenter un test
1536     multi-paramètres simple. Exemple :</p>
1537
1538     <div class="example"><p><code>
1539       httpd -DReverseProxy -DUseCache -DMemCache ...<br />
1540       <br />
1541       # httpd.conf<br />
1542       &lt;IfDefine ReverseProxy&gt;<br />
1543       <span class="indent">
1544         LoadModule proxy_module   modules/mod_proxy.so<br />
1545         LoadModule proxy_http_module   modules/mod_proxy_http.so<br />
1546         &lt;IfDefine UseCache&gt;<br />
1547         <span class="indent">
1548           LoadModule cache_module   modules/mod_cache.so<br />
1549           &lt;IfDefine MemCache&gt;<br />
1550           <span class="indent">
1551             LoadModule mem_cache_module   modules/mod_mem_cache.so<br />
1552           </span>
1553           &lt;/IfDefine&gt;<br />
1554           &lt;IfDefine !MemCache&gt;<br />
1555           <span class="indent">
1556             LoadModule disk_cache_module   modules/mod_disk_cache.so<br />
1557           </span>
1558           &lt;/IfDefine&gt;
1559         </span>
1560         &lt;/IfDefine&gt;
1561       </span>
1562       &lt;/IfDefine&gt;
1563     </code></p></div>
1564
1565 </div>
1566 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1567 <div class="directive-section"><h2><a name="IfModule" id="IfModule">&lt;IfModule&gt;</a> <a name="ifmodule" id="ifmodule">Directive</a></h2>
1568 <table class="directive">
1569 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent qu'en fonction
1570 de la présence ou de l'absence d'un module spécifique</td></tr>
1571 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;IfModule [!]<var>fichier module</var>|<var>identificateur
1572 module</var>&gt; ... &lt;/IfModule&gt;</code></td></tr>
1573 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1574 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
1575 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1576 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1577 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les identificateurs de modules sont disponibles dans les
1578 versions 2.1 et supérieures.</td></tr>
1579 </table>
1580     <p>La section <code>&lt;IfModule
1581     <var>test</var>&gt;...&lt;/IfModule&gt;</code> permet de conférer à
1582     des directives un caractère conditionnel basé sur la présence d'un
1583     module spécifique. Les directives situées dans une section
1584     <code class="directive">&lt;IfModule&gt;</code> ne s'appliquent que
1585     si <var>test</var> est vrai. Si <var>test</var> est faux, tout ce
1586     qui se trouve entre les balises de début et de fin est ignoré.</p>
1587
1588     <p><var>test</var> peut se présenter sous deux formes :</p>
1589
1590     <ul>
1591       <li><var>module</var></li>
1592
1593       <li>!<var>module</var></li>
1594     </ul>
1595
1596     <p>Dans le premier cas, les directives situées entre les balises de
1597     début et de fin ne s'appliquent que si le module <var>module</var>
1598     est présent -- soit compilé avec le binaire httpd, soit chargé
1599     dynamiquement via la directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>. Le second format inverse le test, et dans
1600     ce cas, les directives ne s'appliquent que si <var>module</var>
1601     n'est <strong>pas</strong> présent.</p>
1602
1603     <p>L'argument <var>module</var> peut contenir soit l'identificateur
1604     du module, soit le nom du fichier source du module. Par exemple,
1605     <code>rewrite_module</code> est un identificateur et
1606     <code>mod_rewrite.c</code> le nom du fichier source
1607     correspondant. Si un module comporte plusieurs fichiers sources,
1608     utilisez le nom du fichier qui contient la chaîne de caractères
1609     <code>STANDARD20_MODULE_STUFF</code>.</p>
1610
1611     <p>Les sections <code class="directive">&lt;IfModule&gt;</code>
1612     peuvent être imbriquées, ce qui permet d'implémenter des tests
1613     multi-modules simples.</p>
1614
1615     <div class="note">Cette section ne doit être utilisée que si votre fichier de
1616     configuration ne fonctionne qu'en fonction de la présence ou de
1617     l'absence d'un module spécifique. D'une manière générale, il n'est
1618     pas nécessaire de placer les directives à l'intérieur de sections
1619     <code class="directive">&lt;IfModule&gt;</code>.</div>
1620
1621 </div>
1622 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1623 <div class="directive-section"><h2><a name="Include" id="Include">Include</a> <a name="include" id="include">Directive</a></h2>
1624 <table class="directive">
1625 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inclut d'autres fichiers de configuration dans un des
1626 fichiers de configuration du serveur</td></tr>
1627 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Include <var>chemin fichier</var>|<var>chemin
1628 répertoire</var></code></td></tr>
1629 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
1630 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1631 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1632 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Utilisation des caractères génériques depuis la version
1633 2.0.41</td></tr>
1634 </table>
1635     <p>Cette directive permet l'inclusion d'autres fichiers de
1636     configuration dans un des fichiers de configuration du serveur.</p>
1637
1638     <p>On peut utiliser des caractères génériques de style Shell
1639     (<code>fnmatch()</code>) pour inclure plusieurs fichiers en une
1640     seule fois, selon leur ordre alphabétique. De plus, si la directive
1641     <code class="directive">Include</code> pointe vers un répertoire, Apache
1642     inclura tous les fichiers de ce répertoire et de tous ces
1643     sous-répertoires. L'inclusion de répertoires entiers est cependant
1644     déconseillée, car il est fréquent d'oublier des fichiers
1645     temporaires dans un répertoire, ce qui causerait une erreur
1646     <code class="program"><a href="../programs/httpd.html">httpd</a></code> en cas d'inclusion. Pour inclure des
1647     fichiers qui correspondent à un certain modèle, comme *.conf par
1648     exemple, nous vous recommandons d'utiliser plutôt la syntaxe avec
1649     caractères génériques comme ci-dessous.</p>
1650
1651     <p>Le chemin fichier spécifié peut être soit un chemin absolu, soit
1652     un chemin relatif au répertoire défini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
1653
1654     <p>Exemples :</p>
1655
1656     <div class="example"><p><code>
1657       Include /usr/local/apache2/conf/ssl.conf<br />
1658       Include /usr/local/apache2/conf/vhosts/*.conf
1659     </code></p></div>
1660
1661     <p>ou encore, avec des chemins relatifs au répertoire défini par la
1662     directive <code class="directive"><a href="#serverroot">ServerRoot</a></code> :</p>
1663
1664     <div class="example"><p><code>
1665       Include conf/ssl.conf<br />
1666       Include conf/vhosts/*.conf
1667     </code></p></div>
1668
1669 <h3>Voir aussi</h3>
1670 <ul>
1671 <li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
1672 </ul>
1673 </div>
1674 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1675 <div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">Directive</a></h2>
1676 <table class="directive">
1677 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active les connexions HTTP persistantes</td></tr>
1678 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeepAlive On|Off</code></td></tr>
1679 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>KeepAlive On</code></td></tr>
1680 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1681 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1682 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1683 </table>
1684     <p>L'extension Keep-Alive de HTTP/1.0 et l'implémentation des
1685     connexions persistantes dans HTTP/1.1 ont rendu possibles des
1686     sessions HTTP de longue durée, ce qui permet de transmettre
1687     plusieurs requêtes via la même connexion TCP. Dans certains cas, le
1688     gain en rapidité pour des documents comportant de nombreuses images
1689     peut atteindre 50%. Pour activer les connexions persistantes,
1690     définissez <code>KeepAlive On</code>.</p>
1691
1692     <p>Pour les clients HTTP/1.0, les connexions persistantes ne seront
1693     mises en oeuvre que si elles ont été spécialement demandées par un
1694     client. De plus, une connexion persistante avec un client HTTP/1.0
1695     ne peut être utilisée que si la taille du contenu est connue
1696     d'avance. Ceci implique que les contenus dynamiques comme les
1697     sorties CGI, les pages SSI, et les listings de répertoires générés
1698     par le serveur n'utiliseront en général pas les connexions
1699     persistantes avec les clients HTTP/1.0. Avec les clients HTTP/1.1,
1700     les connexions persistantes sont utilisées par défaut, sauf
1701     instructions contraires. Si le client le demande, le transfert par
1702     tronçons de taille fixe (chunked encoding) sera utilisé afin de
1703     transmettre un contenu de longueur inconnue via une connexion
1704     persistante.</p>
1705
1706     <p>Lorsqu'un client utilise une connexion persistante, elle comptera
1707     pour une seule requête pour la directive <code class="directive"><a href="../mod/mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></code>, quel
1708     que soit le nombre de requêtes transmises via cette connexion.</p>
1709
1710 <h3>Voir aussi</h3>
1711 <ul>
1712 <li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li>
1713 </ul>
1714 </div>
1715 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1716 <div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">Directive</a></h2>
1717 <table class="directive">
1718 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée pendant laquelle le serveur va attendre une requête
1719 avant de fermer une connexion persistante</td></tr>
1720 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeepAliveTimeout <var>nombre</var>[ms]</code></td></tr>
1721 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
1722 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1723 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1724 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1725 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>La spécification d'une valeur en millisecondes est
1726 possible depuis les versions 2.3.2 et supérieures d'Apache</td></tr>
1727 </table>
1728     <p>Le nombre de secondes pendant lesquelles Apache va attendre une
1729     requête avant de fermer la connexion. Le délai peut être défini en
1730     millisecondes en suffixant sa valeur par ms. La valeur du délai
1731     spécifiée par la directive <code class="directive"><a href="#timeout">Timeout</a></code> s'applique dès qu'une requête a
1732     été reçue.</p>
1733
1734     <p>Donner une valeur trop élévée à
1735     <code class="directive">KeepAliveTimeout</code> peut induire des problèmes
1736     de performances sur les serveurs fortement chargés. Plus le délai
1737     est élévé, plus nombreux seront les processus serveur en attente de
1738     requêtes de la part de clients inactifs.</p>
1739
1740     <p>Dans un contexte de serveur virtuel à base de nom, c'est le délai
1741     du premier serveur virtuel défini (le serveur par défaut) parmi un
1742     ensemble de directives <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code> qui sera utilisé. Les
1743     autres valeurs seront ignorées.</p>
1744
1745 </div>
1746 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1747 <div class="directive-section"><h2><a name="Limit" id="Limit">&lt;Limit&gt;</a> <a name="limit" id="limit">Directive</a></h2>
1748 <table class="directive">
1749 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite les contrôles d'accès que la section contient à
1750 certaines méthodes HTTP</td></tr>
1751 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Limit <var>méthode</var> [<var>méthode</var>] ... &gt; ...
1752     &lt;/Limit&gt;</code></td></tr>
1753 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
1754 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig, Limit</td></tr>
1755 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1756 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1757 </table>
1758     <p>Les contrôles d'accès s'appliquent normalement à
1759     <strong>toutes</strong> les méthodes d'accès, et c'est en général le
1760     comportement souhaité. <strong>Dans le cas général, les directives
1761     de contrôle d'accès n'ont pas à être placées dans une section
1762     <code class="directive">&lt;Limit&gt;</code>.</strong></p>
1763
1764     <p>La directive <code class="directive">&lt;Limit&gt;</code> a pour
1765     but de limiter les effets des contrôles d'accès aux méthodes HTTP
1766     spécifiées. Pour toutes les autres méthodes, les restrictions
1767     d'accès contenues dans la section <code class="directive">&lt;Limit&gt;</code> <strong>n'auront aucun
1768     effet</strong>. L'exemple suivant n'applique les contrôles d'accès
1769     qu'aux méthodes <code>POST</code>, <code>PUT</code>, et
1770     <code>DELETE</code>, en laissant les autres méthodes sans protection
1771     :</p>
1772
1773     <div class="example"><p><code>
1774       &lt;Limit POST PUT DELETE&gt;<br />
1775       <span class="indent">
1776         Require valid-user<br />
1777       </span>
1778       &lt;/Limit&gt;
1779     </code></p></div>
1780
1781     <p>La liste des noms de méthodes peut contenir une ou plusieurs
1782     valeurs parmi les suivantes : <code>GET</code>, <code>POST</code>,
1783     <code>PUT</code>, <code>DELETE</code>, <code>CONNECT</code>,
1784     <code>OPTIONS</code>, <code>PATCH</code>, <code>PROPFIND</code>,
1785     <code>PROPPATCH</code>, <code>MKCOL</code>, <code>COPY</code>,
1786     <code>MOVE</code>, <code>LOCK</code>, et <code>UNLOCK</code>.
1787     <strong>Le nom de méthode est sensible à la casse.</strong> Si la
1788     valeur <code>GET</code> est présente, les requêtes <code>HEAD</code>
1789     seront aussi concernées. La méthode <code>TRACE</code> ne peut pas
1790     être limitée (voir la directive <code class="directive"><a href="#traceenable">TraceEnable</a></code>).</p>
1791
1792     <div class="warning">Une section <code class="directive">&lt;LimitExcept&gt;</code> doit toujours être préférée à
1793     une section <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> pour la restriction d'accès, car une
1794     section <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code> fournit une protection contre
1795     les méthodes arbitraires.</div>
1796
1797     <p>Les directives <code class="directive">&lt;Limit&gt;</code> et
1798     <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>
1799     peuvent être imbriquées. Dans ce cas, pour chaque niveau des
1800     directives <code class="directive">&lt;Limit&gt;</code> ou  <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>, ces dernières
1801     doivent restreindre l'accès pour les méthodes auxquelles les
1802     contrôles d'accès s'appliquent.</p>
1803
1804     <div class="warning">Lorsqu'on utilise les directives <code class="directive">&lt;Limit&gt;</code> ou <code class="directive">&lt;LimitExcept&gt;</code> avec la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>, la première directive
1805     <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> dont la
1806     condition est satisfaite autorise la requête, sans tenir compte de
1807     la présence d'autres directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>.</div>
1808
1809     <p>Par exemple, avec la configuration suivante, tous les
1810     utilisateurs seront autorisés à effectuer des requêtes
1811     <code>POST</code>, et la directive <code>Require group
1812     editors</code> sera ignorée dans tous les cas :</p>
1813
1814     <div class="example"><p><code>
1815       &lt;LimitExcept GET&gt;
1816       <span class="indent">
1817         Require valid-user
1818       </span>
1819       &lt;/LimitExcept&gt;<br />
1820       &lt;Limit POST&gt;
1821       <span class="indent">
1822         Require group editors
1823       </span>
1824       &lt;/Limit&gt;
1825     </code></p></div>
1826
1827 </div>
1828 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1829 <div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept">&lt;LimitExcept&gt;</a> <a name="limitexcept" id="limitexcept">Directive</a></h2>
1830 <table class="directive">
1831 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applique les contrôles d'accès à toutes les méthodes HTTP,
1832 sauf celles qui sont spécifiées</td></tr>
1833 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;LimitExcept <var>méthode</var> [<var>méthode</var>] ... &gt; ...
1834     &lt;/LimitExcept&gt;</code></td></tr>
1835 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
1836 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig, Limit</td></tr>
1837 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1838 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1839 </table>
1840     <p><code class="directive">&lt;LimitExcept&gt;</code> et
1841     <code>&lt;/LimitExcept&gt;</code> permettent de regrouper des
1842     directives de contrôle d'accès qui s'appliqueront à toutes les
1843     méthodes d'accès HTTP qui ne font <strong>pas</strong> partie de la
1844     liste des arguments ; en d'autres termes, elles ont un comportement
1845     opposé à celui de la section <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code>, et on peut les utiliser pour
1846     contrôler aussi bien les méthodes standards que les méthodes non
1847     standards ou non reconnues. Voir la documentation de la section
1848     <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> pour plus
1849     de détails.</p>
1850
1851     <p>Par exemple :</p>
1852
1853     <div class="example"><p><code>
1854       &lt;LimitExcept POST GET&gt;<br />
1855       <span class="indent">
1856         Require valid-user<br />
1857       </span>
1858       &lt;/LimitExcept&gt;
1859     </code></p></div>
1860
1861
1862 </div>
1863 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1864 <div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a name="limitinternalrecursion" id="limitinternalrecursion">Directive</a></h2>
1865 <table class="directive">
1866 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le nombre maximal de redirections internes et de
1867 sous-requêtes imbriquées</td></tr>
1868 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitInternalRecursion <var>nombre</var> [<var>nombre</var>]</code></td></tr>
1869 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
1870 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1871 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1872 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1873 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.0.47 d'Apache</td></tr>
1874 </table>
1875     <p>Une redirection interne survient, par exemple, quand on utilise
1876     la directive <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> qui
1877     redirige en interne la requête d'origine vers un script CGI. Une
1878     sous-requête est le mécanisme qu'utilise Apache pour déterminer ce
1879     qui se passerait pour un URI s'il faisait l'objet d'une requête. Par
1880     exemple, <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> utilise les sous-requêtes pour
1881     rechercher les fichiers listés dans la directive <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>.</p>
1882
1883     <p>La directive <code class="directive">LimitInternalRecursion</code> permet
1884     d'éviter un crash du serveur dû à un bouclage infini de redirections
1885     internes ou de sous-requêtes. De tels bouclages sont dus en général
1886     à des erreurs de configuration.</p>
1887
1888     <p>La directive accepte, comme arguments, deux limites qui sont
1889     évaluées à chaque requête. Le premier <var>nombre</var> est le
1890     nombre maximum de redirections internes qui peuvent se succéder. Le
1891     second <var>nombre</var> détermine la profondeur d'imbrication
1892     maximum des sous-requêtes. Si vous ne spécifiez qu'un seul
1893     <var>nombre</var>, il sera affecté aux deux limites.</p>
1894
1895     <div class="example"><h3>Exemple</h3><p><code>
1896       LimitInternalRecursion 5
1897     </code></p></div>
1898
1899 </div>
1900 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1901 <div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">Directive</a></h2>
1902 <table class="directive">
1903 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>limite la taille maximale du corps de la requête HTTP
1904 envoyée par le client</td></tr>
1905 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestBody <var>octets</var></code></td></tr>
1906 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestBody 0</code></td></tr>
1907 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1908 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
1909 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1910 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1911 </table>
1912     <p>Cette directive spécifie la taille maximale autorisée pour le
1913     corps d'une requête ; la valeur de l'argument <var>octets</var> va
1914     de 0 (pour une taille illimitée), à 2147483647 (2Go).</p>
1915
1916     <p>La directive <code class="directive">LimitRequestBody</code> permet de
1917     définir une limite pour la taille maximale autorisée du corps d'une
1918     requête HTTP en tenant compte du contexte dans lequel la directive
1919     a été placée (c'est à dire au niveau du serveur, d'un répertoire,
1920     d'un fichier ou d'une localisation). Si la requête du client dépasse
1921     cette limite, le serveur répondra par un message d'erreur et ne
1922     traitera pas la requête. La taille du corps d'une requête normale va
1923     varier de manière importante en fonction de la nature de la
1924     ressource et des méthodes autorisées pour cette dernière. Les
1925     scripts CGI utilisent souvent le corps du message pour extraire les
1926     informations d'un formulaire. Les implémentations de la méthode
1927     <code>PUT</code> nécessitent une valeur au moins aussi élevée que la
1928     taille maximale des représentations que le serveur désire accepter
1929     pour cette ressource.</p>
1930
1931     <p>L'administrateur du serveur peut utiliser cette directive pour
1932     contrôler plus efficacement les comportements anormaux des requêtes
1933     des clients, ce qui lui permettra de prévenir certaines formes
1934     d'attaques par déni de service.</p>
1935
1936     <p>Si par exemple, vous autorisez le chargement de fichiers vers une
1937     localisation particulière, et souhaitez limiter la taille des
1938     fichiers chargés à 100Ko, vous pouvez utiliser la directive suivante
1939     :</p>
1940
1941     <div class="example"><p><code>
1942       LimitRequestBody 102400
1943     </code></p></div>
1944
1945
1946 </div>
1947 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1948 <div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">Directive</a></h2>
1949 <table class="directive">
1950 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de champs d'en-tête autorisés dans une
1951 requête HTTP</td></tr>
1952 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFields <var>nombre</var></code></td></tr>
1953 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestFields 100</code></td></tr>
1954 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
1955 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
1956 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1957 </table>
1958     <p><var>nombre</var> est un entier de 0 (nombre de champs illimité)
1959     à 32767. La valeur par défaut est définie à la compilation par la
1960     constante <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (100 selon la
1961     distribution).</p>
1962
1963     <p>La directive <code class="directive">LimitRequestFields</code> permet à
1964     l'administrateur du serveur de modifier le nombre maximum de champs
1965     d'en-tête autorisés dans une requête HTTP. Pour un serveur, cette
1966     valeur doit être supérieure au nombre de champs qu'une requête
1967     client normale peut contenir. Le nombre de champs d'en-tête d'une
1968     requête qu'un client utilise dépasse rarement 20, mais ce nombre
1969     peut varier selon les implémentations des clients, et souvent en
1970     fonction des extensions que les utilisateurs configurent dans leurs
1971     navigateurs pour supporter la négociation de contenu détaillée. Les
1972     extensions HTTP optionnelles utilisent souvent les
1973     champs d'en-tête des requêtes.</p>
1974
1975     <p>L'administrateur du serveur peut utiliser cette directive pour
1976     contrôler plus efficacement les comportements anormaux des requêtes
1977     des clients, ce qui lui permettra de prévenir certaines formes
1978     d'attaques par déni de service. La valeur spécifiée doit être
1979     augmentée si les clients standards reçoivent une erreur du serveur
1980     indiquant que la requête comportait un nombre d'en-têtes trop
1981     important.</p>
1982
1983     <p>Par exemple :</p>
1984
1985     <div class="example"><p><code>
1986       LimitRequestFields 50
1987     </code></p></div>
1988
1989
1990 </div>
1991 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1992 <div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">Directive</a></h2>
1993 <table class="directive">
1994 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dédinit la taille maximale autorisée d'un en-tête de
1995 requête HTTP</td></tr>
1996 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFieldSize <var>octets</var></code></td></tr>
1997 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestFieldSize 8190</code></td></tr>
1998 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
1999 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2000 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2001 </table>
2002     <p>Cette directive permet de définir le nombre maximum
2003     d'<var>octets</var> autorisés dans un en-tête de requête HTTP.</p>
2004
2005     <p>La directive <code class="directive">LimitRequestFieldSize</code> permet
2006     à l'administrateur du serveur de réduire ou augmenter la taille
2007     maximale autorisée d'un en-tête de requête HTTP. Pour un serveur,
2008     cette valeur doit être suffisamment grande pour contenir tout
2009     en-tête d'une requête client normale. La taille d'un champ d'en-tête
2010     de requête normal va varier selon les implémentations des clients,
2011     et en fonction des extensions que les utilisateurs
2012     configurent dans leurs navigateurs pour supporter la négociation de
2013     contenu détaillée. Les en-têtes d'authentification SPNEGO peuvent
2014     atteindre une taille de 12392 octets.</p>
2015
2016     <p>&gt;L'administrateur du serveur peut utiliser cette directive pour
2017     contrôler plus efficacement les comportements anormaux des requêtes
2018     des clients, ce qui lui permettra de prévenir certaines formes
2019     d'attaques par déni de service.</p>
2020
2021     <p>Par exemple ::</p>
2022
2023     <div class="example"><p><code>
2024       LimitRequestFieldSize 4094
2025     </code></p></div>
2026
2027     <div class="note">Dans des conditions normales, la valeur par défaut de cette
2028     directive ne doit pas être modifiée.</div>
2029
2030
2031 </div>
2032 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2033 <div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">Directive</a></h2>
2034 <table class="directive">
2035 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la taille maximale d'une ligne de requête
2036 HTTP</td></tr>
2037 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestLine <var>octets</var></code></td></tr>
2038 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
2039 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
2040 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2041 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2042 </table>
2043     <p>Cette directive permet de définir la taille maximale autorisée
2044     pour une ligne de requête HTTP en <var>octets</var>.</p>
2045
2046     <p>La directive <code class="directive">LimitRequestLine</code> permet à
2047     l'administrateur du serveur de réduire ou augmenter la taille
2048     maximale autorisée d'une ligne de requête HTTP client. Comme une
2049     requête comporte une méthode HTTP, un URI, et une version de
2050     protocole, la directive <code class="directive">LimitRequestLine</code>
2051     impose une restriction sur la longueur maximale autorisée pour un
2052     URI dans une requête au niveau du serveur. Pour un serveur, cette
2053     valeur doit être suffisamment grande pour référencer les noms de
2054     toutes ses ressources, y compris toutes informations pouvant être
2055     ajoutées dans la partie requête d'une méthode <code>GET</code>.</p>
2056
2057     <p>L'administrateur du serveur peut utiliser cette directive pour
2058     contrôler plus efficacement les comportements anormaux des requêtes
2059     des clients, ce qui lui permettra de prévenir certaines formes
2060     d'attaques par déni de service.</p>
2061
2062     <p>Par exemple :</p>
2063
2064     <div class="example"><p><code>
2065       LimitRequestLine 4094
2066     </code></p></div>
2067
2068     <div class="note">Dans des conditions normales, la valeur par défaut de cette
2069     directive ne doit pas être modifiée.</div>
2070
2071 </div>
2072 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2073 <div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a></h2>
2074 <table class="directive">
2075 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la taille maximale du corps d'une requête au format
2076 XML</td></tr>
2077 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitXMLRequestBody <var>octets</var></code></td></tr>
2078 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
2079 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
2080 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
2081 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2082 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2083 </table>
2084     <p>Taille maximale (en octets) du corps d'une requête au format XML.
2085     Une valeur de <code>0</code> signifie qu'aucune limite n'est
2086     imposée.</p>
2087
2088     <p>Exemple :</p>
2089
2090     <div class="example"><p><code>
2091       LimitXMLRequestBody 0
2092     </code></p></div>
2093
2094
2095 </div>
2096 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2097 <div class="directive-section"><h2><a name="Location" id="Location">&lt;Location&gt;</a> <a name="location" id="location">Directive</a></h2>
2098 <table class="directive">
2099 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'applique les directives contenues qu'aux URLs
2100 spécifiées</td></tr>
2101 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Location
2102     <var>chemin URL</var>|<var>URL</var>&gt; ... &lt;/Location&gt;</code></td></tr>
2103 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
2104 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2105 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2106 </table>
2107     <p>La directive <code class="directive">&lt;Location&gt;</code>
2108     limite la portée des directives contenues aux URLs définies par
2109     l'argument URL. Elle est similaire à la directive <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>, et marque le
2110     début d'une section qui se termine par une directive
2111     <code>&lt;/Location&gt;</code>. Les sections <code class="directive">&lt;Location&gt;</code> sont traitées selon l'ordre dans
2112     lequel elles apparaissent dans le fichier de configuration, mais
2113     après les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et la lecture des
2114     fichiers <code>.htaccess</code>, et après les sections <code class="directive"><a href="#files">&lt;Files&gt;</a></code>.</p>
2115
2116     <p>Les sections <code class="directive">&lt;Location&gt;</code>
2117     agissent complètement en dehors du système de fichiers. Ceci a de
2118     nombreuses conséquences. Parmi les plus importantes, on ne doit pas
2119     utiliser les sections <code class="directive">&lt;Location&gt;</code>
2120     pour contrôler l'accès aux répertoires du système de fichiers. Comme
2121     plusieurs URLs peuvent correspondre au même répertoire du système de
2122     fichiers, un tel contrôle d'accès pourrait être contourné.</p>
2123
2124     <div class="note"><h3>Quand utiliser la section <code class="directive">&lt;Location&gt;</code></h3>
2125
2126     <p>Vous pouvez utiliser une section <code class="directive">&lt;Location&gt;</code> pour appliquer des directives à
2127     des contenus situés en dehors du système de fichiers. Pour les
2128     contenus situés à l'intérieur du système de fichiers, utilisez
2129     plutôt les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et <code class="directive"><a href="#files">&lt;Files&gt;</a></code>. <code>&lt;Location
2130     /&gt;</code> constitue une exception et permet d'appliquer aisément
2131     une configuration à l'ensemble du serveur.</p>
2132     </div>
2133
2134     <p>Pour toutes les requêtes originales (non mandatées), l'argument
2135     URL est un chemin d'URL de la forme
2136     <code>/chemin/</code>. <em>Aucun protocole, nom d'hôte, port, ou chaîne
2137     de requête ne doivent apparaître.</em> Pour les requêtes mandatées, l'URL
2138     spécifiée doit être de la forme
2139     <code>protocole://nom_serveur/chemin</code>, et vous devez inclure
2140     le préfixe.</p>
2141
2142     <p>L'URL peut contenir des caractères génériques. Dans une chaîne
2143     avec caractères génériques, <code>?</code> correspond à un caractère
2144     quelconque, et <code>*</code> à toute chaîne de caractères. Les
2145     caractères génériques ne peuvent pas remplacer un / dans le chemin
2146     URL.</p>
2147
2148     <p>On peut aussi utiliser les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions
2149     rationnelles</a>, moyennant l'addition d'un caractère
2150     <code>~</code>. Par exemple :</p>
2151
2152     <div class="example"><p><code>
2153       &lt;Location ~ "/(extra|special)/data"&gt;
2154     </code></p></div>
2155
2156     <p>concernerait les URLs contenant les sous-chaîne
2157     <code>/extra/data</code> ou <code>/special/data</code>. La directive
2158     <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code>
2159     présente un comportement identique à la version avec expressions
2160     rationnelles de la directive <code class="directive">&lt;Location&gt;</code>, et son utilisation est
2161     préférable à l'utilisation de cette dernière pour la simple raison
2162     qu'il est difficile de distinguer <code>~</code> de <code>-</code>
2163     dans la plupart des fontes.</p>
2164
2165     <p>La directive <code class="directive">&lt;Location&gt;</code>
2166     s'utilise principalement avec la directive <code class="directive"><a href="#sethandler">SetHandler</a></code>. Par exemple, pour activer les
2167     requêtes d'état, mais ne les autoriser que depuis des navigateurs
2168     appartenant au domaine <code>example.com</code>, vous pouvez
2169     utiliser :</p>
2170
2171     <div class="example"><p><code>
2172       &lt;Location /status&gt;<br />
2173       <span class="indent">
2174         SetHandler server-status<br />
2175         Order Deny,Allow<br />
2176         Deny from all<br />
2177         Allow from .example.com<br />
2178       </span>
2179       &lt;/Location&gt;
2180     </code></p></div>
2181
2182     <div class="note"><h3>Note à propos du slash (/)</h3>
2183       <p>La signification du caractère slash dépend de l'endroit où il
2184       se trouve dans l'URL. Les utilisateurs peuvent être habitués à
2185       son comportement dans le système de fichiers où plusieurs slashes
2186       successifs sont souvent réduits à un slash unique (en d'autres
2187       termes, <code>/home///foo</code> est identique à
2188       <code>/home/foo</code>). Dans l'espace de nommage des URLs, ce
2189       n'est cependant pas toujours le cas. Pour la directive <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code> et la
2190       version avec expressions rationnelles de la directive <code class="directive">&lt;Location&gt;</code>, vous devez spécifier
2191       explicitement les slashes multiples si telle est votre
2192       intention.</p>
2193
2194       <p>Par exemple, <code>&lt;LocationMatch ^/abc&gt;</code> va
2195       correspondre à l'URL <code>/abc</code> mais pas à l'URL <code>
2196       //abc</code>. La directive <code class="directive">&lt;Location&gt;</code> sans expression rationnelle se comporte de
2197       la même manière lorsqu'elle est utilisée pour des requêtes
2198       mandatées. Par contre, lorsque la directive <code class="directive">&lt;Location&gt;</code> sans expression rationnelle
2199       est utilisée pour des requêtes non mandatées, elle fera
2200       correspondre implicitement les slashes multiples à des slashes
2201       uniques. Par exemple, si vous spécifiez <code>&lt;Location
2202       /abc/def&gt;</code>, une requête de la forme
2203       <code>/abc//def</code> correspondra.</p>
2204     </div>
2205
2206 <h3>Voir aussi</h3>
2207 <ul>
2208 <li><a href="../sections.html">Comment fonctionnent les sections
2209 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
2210 explication de la manière dont ces différentes sections se combinent
2211 entre elles à la réception d'une requête.</li>
2212 </ul>
2213 </div>
2214 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2215 <div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch">&lt;LocationMatch&gt;</a> <a name="locationmatch" id="locationmatch">Directive</a></h2>
2216 <table class="directive">
2217 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'applique les directives contenues qu'aux URLs
2218 correspondant à une expression rationnelle</td></tr>
2219 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;LocationMatch
2220     <var>regex</var>&gt; ... &lt;/LocationMatch&gt;</code></td></tr>
2221 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
2222 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2223 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2224 </table>
2225     <p>La directive <code class="directive">&lt;LocationMatch&gt;</code>
2226     limite la portée des directives contenues à l'URL spécifiée, de
2227     manière identique à la directive <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Mais son argument permettant de
2228     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
2229     chaîne de caractères. Par exemple :</p>
2230
2231     <div class="example"><p><code>
2232       &lt;LocationMatch "/(extra|special)/data"&gt;
2233     </code></p></div>
2234
2235     <p>correspondrait à toute URL contenant les sous-chaînes
2236     <code>/extra/data</code> ou <code>/special/data</code>.</p>
2237
2238 <h3>Voir aussi</h3>
2239 <ul>
2240 <li><a href="../sections.html">Comment fonctionnent les sections
2241 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
2242 explication de la manière dont ces différentes sections se combinent
2243 entre elles à la réception d'une requête.</li>
2244 </ul>
2245 </div>
2246 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2247 <div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">Directive</a></h2>
2248 <table class="directive">
2249 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contrôle la verbosité du journal des erreurs</td></tr>
2250 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogLevel <var>niveau</var></code></td></tr>
2251 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LogLevel warn</code></td></tr>
2252 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
2253 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2254 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2255 </table>
2256     <p>La directive <code class="directive">LogLevel</code> permet d'ajuster la
2257     verbosité des messages enregistrés dans les journaux d'erreur (voir
2258     la directive <code class="directive"><a href="#errorlog">ErrorLog</a></code>
2259     directive). Les <var>niveau</var>x disponibles sont présentés
2260     ci-après, par ordre de criticité décroissante :</p>
2261
2262     <table class="bordered">
2263
2264       <tr>
2265         <th><strong>Niveau</strong> </th>
2266
2267         <th><strong>Description</strong> </th>
2268
2269         <th><strong>Exemple</strong> </th>
2270       </tr>
2271
2272       <tr>
2273         <td><code>emerg</code> </td>
2274
2275         <td>Urgences - le système est inutilisable.</td>
2276
2277         <td>"Child cannot open lock file. Exiting"</td>
2278       </tr>
2279
2280       <tr>
2281         <td><code>alert</code> </td>
2282
2283         <td>Des mesures doivent être prises immédiatement.</td>
2284
2285         <td>"getpwuid: couldn't determine user name from uid"</td>
2286       </tr>
2287
2288       <tr>
2289         <td><code>crit</code> </td>
2290
2291         <td>Conditions critiques.</td>
2292
2293         <td>"socket: Failed to get a socket, exiting child"</td>
2294       </tr>
2295
2296       <tr>
2297         <td><code>error</code> </td>
2298
2299         <td>Erreurs.</td>
2300
2301         <td>"Premature end of script headers"</td>
2302       </tr>
2303
2304       <tr>
2305         <td><code>warn</code> </td>
2306
2307         <td>Avertissements.</td>
2308
2309         <td>"child process 1234 did not exit, sending another
2310         SIGHUP"</td>
2311       </tr>
2312
2313       <tr>
2314         <td><code>notice</code> </td>
2315
2316         <td>Evènement important mais normal.</td>
2317
2318         <td>"httpd: caught SIGBUS, attempting to dump core in
2319         ..."</td>
2320       </tr>
2321
2322       <tr>
2323         <td><code>info</code> </td>
2324
2325         <td>Informations.</td>
2326
2327         <td>"Server seems busy, (you may need to increase
2328         StartServers, or Min/MaxSpareServers)..."</td>
2329       </tr>
2330
2331       <tr>
2332         <td><code>debug</code> </td>
2333
2334         <td>Messages de débogage.</td>
2335
2336         <td>"Opening config file ..."</td>
2337       </tr>
2338     </table>
2339
2340     <p>Lorsqu'un niveau particulier est spécifié, les messages de tous
2341     les autres niveaux de criticité supérieure seront aussi enregistrés.
2342     <em>Par exemple</em>, si <code>LogLevel info</code> est spécifié,
2343     les messages de niveaux <code>notice</code> et <code>warn</code>
2344     seront aussi émis.</p>
2345
2346     <p>Il est recommandé d'utiliser un niveau <code>crit</code> ou
2347     inférieur.</p>
2348
2349     <p>Par exemple :</p>
2350
2351     <div class="example"><p><code>
2352       LogLevel notice
2353     </code></p></div>
2354
2355     <div class="note"><h3>Note</h3>
2356       <p>Si la journalisation s'effectue directement dans un fichier,
2357       les messages de niveau <code>notice</code> ne peuvent pas être
2358       supprimés et sont donc toujours journalisés. Cependant, ceci ne
2359       s'applique pas lorsque la journalisation s'effectue vers
2360       <code>syslog</code>.</p>
2361     </div>
2362
2363 </div>
2364 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2365 <div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a name="maxkeepaliverequests" id="maxkeepaliverequests">Directive</a></h2>
2366 <table class="directive">
2367 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de requêtes permises pour une connexion
2368 persistante</td></tr>
2369 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxKeepAliveRequests <var>nombre</var></code></td></tr>
2370 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
2371 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
2372 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2373 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2374 </table>
2375     <p>La directive <code class="directive">MaxKeepAliveRequests</code> permet
2376     de limiter le nombre de requêtes autorisées par connexion lorsque
2377     <code class="directive"><a href="#keepalive">KeepAlive</a></code> est à "on". Si sa
2378     valeur est <code>0</code>, le nombre de requêtes autorisées est
2379     illimité. Il est recommandé de définir une valeur assez haute pour
2380     des performances du serveur maximales.</p>
2381
2382     <p>Par exemple :</p>
2383
2384     <div class="example"><p><code>
2385       MaxKeepAliveRequests 500
2386     </code></p></div>
2387
2388 </div>
2389 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2390 <div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">Directive</a></h2>
2391 <table class="directive">
2392 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une adresse IP pour les serveurs virtuels à base de
2393 nom</td></tr>
2394 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NameVirtualHost <var>adresse</var>[:<var>port</var>]</code></td></tr>
2395 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
2396 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2397 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2398 </table>
2399
2400 <p>Une seule directive <code class="directive">NameVirtualHost</code> permet
2401 d'identifier un ensemble de serveurs virtuels identiques que le serveur
2402 va sélectionner en fonction du <em>nom d'hôte</em> spécifié par le
2403 client. La directive <code class="directive">NameVirtualHost</code> est
2404 obligatoire si vous souhaitez configurer des <a href="../vhosts/">serveurs virtuels à base de nom</a>.</p>
2405
2406 <p>Cette directive, ainsi que les directives <code class="directive">VirtualHost</code> correspondantes, <em>doit</em> comporter un
2407 numéro de port si le serveur supporte les connexions HTTP et HTTPS.</p>
2408
2409 <p>Bien que <var>adresse</var> puisse contenir un nom d'hôte, il est
2410 recommandé d'utiliser plutôt une adresse IP ou un nom d'hôte avec
2411 caractères génériques. Une directive NameVirtualHost contenant des
2412 caractères génériques ne peut correspondre qu'à des serveurs virtuels
2413 qui contiennent aussi des caractères génériques dans leur argument.</p>
2414
2415 <p>Dans les cas où un pare-feu ou autre mandataire reçoit les requêtes
2416 et les redirige sous une adresse IP différente vers le serveur, vous
2417 devez spécifier l'adresse IP de l'interface physique de la machine qui
2418 va servir les requêtes.</p>
2419
2420 <p>Dans l'exemple ci-dessous, les requêtes reçues sur l'interface
2421 192.0.2.1 et le port 80 ne vont déclencher une sélection que parmi les
2422 deux premiers serveurs virtuels. Les requêtes reçues sur le port 80 et
2423 sur toute interface ne vont déclencher une sélection que parmi les
2424 troisième et quatrième serveurs virtuels. D'une manière générale,
2425 lorsque l'interface ne constitue pas un critère important de sélection,
2426 la valeur "*:80" suffit pour les directives NameVirtualHost et
2427 VirtualHost.</p>
2428
2429 <div class="example"><p><code>
2430       NameVirtualHost 192.0.2.1:80<br />
2431       NameVirtualHost *:80<br /><br />
2432
2433       &lt;VirtualHost 192.0.2.1:80&gt;<br />
2434       &nbsp; ServerName namebased-a.example.com<br />
2435       &lt;/VirtualHost&gt;<br />
2436       <br />
2437       &lt;VirtualHost 192.0.2.1:80&gt;<br />
2438       &nbsp; Servername namebased-b.example.com<br />
2439       &lt;/VirtualHost&gt;<br />
2440       <br />
2441       &lt;VirtualHost *:80&gt;<br />
2442       &nbsp; ServerName namebased-c.example.com <br />
2443       &lt;/VirtualHost&gt;<br />
2444       <br />
2445       &lt;VirtualHost *:80&gt;<br />
2446       &nbsp; ServerName namebased-d.example.com <br />
2447       &lt;/VirtualHost&gt;<br />
2448       <br />
2449
2450    </code></p></div>
2451
2452     <p>Les adresses IPv6 doivent être entourées de crochets, comme dans
2453     l'exemple suivant :</p>
2454
2455     <div class="example"><p><code>
2456       NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
2457     </code></p></div>
2458
2459
2460
2461     <div class="note"><h3>Argument de la directive <code class="directive">&lt;VirtualHost&gt;</code></h3>
2462       <p>Notez que l'argument de la directive <code class="directive">&lt;VirtualHost&gt;</code> doit être identique à
2463        l'argument de la directive <code class="directive">NameVirtualHost</code>.</p>
2464
2465       <div class="example"><p><code>
2466         NameVirtualHost 192.0.2.2:80<br />
2467         &lt;VirtualHost 192.0.2.2:80&gt;<br />
2468         # ...<br />
2469         &lt;/VirtualHost&gt;<br />
2470       </code></p></div>
2471     </div>
2472
2473 <h3>Voir aussi</h3>
2474 <ul>
2475 <li><a href="../vhosts/">Documentation sur les serveurs
2476 virtuels</a></li>
2477 </ul>
2478 </div>
2479 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2480 <div class="directive-section"><h2><a name="Options" id="Options">Options</a> <a name="options" id="options">Directive</a></h2>
2481 <table class="directive">
2482 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les fonctionnalités disponibles pour un répertoire
2483 particulier</td></tr>
2484 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Options
2485     [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr>
2486 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Options All</code></td></tr>
2487 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
2488 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Options</td></tr>
2489 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2490 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2491 </table>
2492     <p>La directive <code class="directive">Options</code> permet de définir
2493     les fonctionnalités de serveur disponibles pour un répertoire
2494     particulier.</p>
2495
2496     <p><var>option</var> peut être défini à <code>None</code>, auquel
2497     cas aucune fonctionnalité spécifique n'est activée, ou comprendre
2498     une ou plusieurs des options suivantes :</p>
2499
2500     <dl>
2501       <dt><code>All</code></dt>
2502
2503       <dd>Toutes les options excepté <code>MultiViews</code>. il s'agit
2504       de la configuration par défaut.</dd>
2505
2506       <dt><code>ExecCGI</code></dt>
2507
2508       <dd>L'exécution de scripts CGI à l'aide du module
2509       <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> est permise.</dd>
2510
2511       <dt><code>FollowSymLinks</code></dt>
2512
2513       <dd>
2514
2515       Le serveur va suivre les liens symboliques dans le répertoire
2516       concerné.
2517       <div class="note">
2518       <p>Bien que le serveur suive les liens symboliques, il ne modifie
2519       <em>pas</em> le nom de chemin concerné défini par la section
2520       <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>.</p>
2521       <p>Notez aussi que cette option <strong>est ignorée</strong> si
2522       elle est définie dans une section <code class="directive"><a href="#location">&lt;Location&gt;</a></code>.</p>
2523       <p>Le fait d'omettre cette option ne doit pas être considéré comme
2524       une mesure de sécurité efficace, car il existe toujours une
2525       situation de compétition (race condition) entre l'instant où l'on
2526       vérifie qu'un chemin n'est pas un lien symbolique, et l'instant où
2527       l'on utilise effectivement ce chemin.</p>
2528       </div></dd>
2529
2530       <dt><code>Includes</code></dt>
2531
2532       <dd>
2533       Les inclusions côté serveur (SSI) à l'aide du module
2534       <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> sont autorisées.</dd>
2535
2536       <dt><code>IncludesNOEXEC</code></dt>
2537
2538       <dd>
2539
2540       Les inclusions côté serveur (SSI) sont permises, mais <code>#exec
2541       cmd</code> et <code>#exec cgi</code> sont désactivés.
2542       L'utilisation de <code>#include virtual</code> pour les scripts
2543       CGI est cependant toujours possible depuis des répertoires
2544       définis par <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>.</dd>
2545
2546       <dt><code>Indexes</code></dt>
2547
2548       <dd>
2549       Si une URL requise correspond au répertoire concerné, et si aucun
2550       <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> (<em>par
2551       exemple</em> <code>index.html</code>) n'est défini pour ce
2552       répertoire, le module <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> va renvoyer
2553       un listing formaté du répertoire.</dd>
2554
2555       <dt><code>MultiViews</code></dt>
2556
2557       <dd>
2558       Les vues multiples ("multiviews") à <a href="../content-negotiation.html">contenu négocié</a> à l'aide du
2559       module <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> sont autorisées.</dd>
2560
2561       <dt><code>SymLinksIfOwnerMatch</code></dt>
2562
2563       <dd>Le serveur ne suivra que les liens symboliques qui renvoient
2564       vers un fichier ou un répertoire dont le propriétaire est le même
2565       que celui du lien.
2566
2567       <div class="note"><h3>Note</h3> <p>Cette option est ignorée si elle est
2568       définie dans une section <code class="directive"><a href="#location">&lt;Location&gt;</a></code>.</p>
2569       <p>Le fait d'omettre cette option ne doit pas être considéré comme
2570       une mesure de sécurité efficace, car il existe toujours une
2571       situation de compétition (race condition) entre l'instant où l'on
2572       vérifie qu'un chemin n'est pas un lien symbolique, et l'instant où
2573       l'on utilise effectivement ce chemin.</p></div>
2574       </dd>
2575     </dl>
2576
2577     <p>Normalement, si plusieurs directives
2578     <code class="directive">Options</code> peuvent s'appliquer à un répertoire,
2579     c'est la plus spécifique qui est utilisée et les autres sont
2580     ignorées ; les options ne sont pas fusionnées (voir <a href="../sections.html#mergin">comment les sections sont
2581     fusionnées</a>). Elles le sont cependant si <em>toutes</em> les
2582     options de la directive <code class="directive">Options</code> sont
2583     précédées d'un symbole <code>+</code> ou <code>-</code>. Toute
2584     option précédée d'un <code>+</code> est ajoutée à la liste des
2585     options courantes de manière forcée et toute option précédée d'un
2586     <code>-</code> est supprimée de la liste des options courantes de la
2587     même manière.</p>
2588
2589     <div class="warning"><h3>Avertissement</h3>
2590     <p>Mélanger des <code class="directive">Options</code> avec <code>+</code>
2591     ou <code>-</code> avec des <code class="directive">Options</code> sans
2592     <code>+</code> ou <code>-</code> constitue une erreur de syntaxe, et
2593     peut résulter en des comportements inattendus.</p>
2594     </div>
2595
2596     <p>Par exemple, sans aucun symbole <code>+</code> et <code>-</code>
2597     :</p>
2598
2599     <div class="example"><p><code>
2600       &lt;Directory /web/docs&gt;<br />
2601       <span class="indent">
2602         Options Indexes FollowSymLinks<br />
2603       </span>
2604       &lt;/Directory&gt;<br />
2605       <br />
2606       &lt;Directory /web/docs/spec&gt;<br />
2607       <span class="indent">
2608         Options Includes<br />
2609       </span>
2610       &lt;/Directory&gt;
2611     </code></p></div>
2612
2613     <p>ici, seule l'option <code>Includes</code> sera prise en compte
2614     pour le répertoire <code>/web/docs/spec</code>. Par contre, si la
2615     seconde directive <code class="directive">Options</code> utilise les
2616     symboles <code>+</code> et <code>-</code> :</p>
2617
2618     <div class="example"><p><code>
2619       &lt;Directory /web/docs&gt;<br />
2620       <span class="indent">
2621         Options Indexes FollowSymLinks<br />
2622       </span>
2623       &lt;/Directory&gt;<br />
2624       <br />
2625       &lt;Directory /web/docs/spec&gt;<br />
2626       <span class="indent">
2627         Options +Includes -Indexes<br />
2628       </span>
2629       &lt;/Directory&gt;
2630     </code></p></div>
2631
2632     <p>alors, les options <code>FollowSymLinks</code> et
2633     <code>Includes</code> seront prises en compte pour le répertoire
2634     <code>/web/docs/spec</code>.</p>
2635
2636     <div class="note"><h3>Note</h3>
2637       <p>L'utilisation de <code>-IncludesNOEXEC</code> ou
2638       <code>-Includes</code> désactive complètement les inclusions côté
2639       serveur sans tenir compte des définitions précédentes.</p>
2640     </div>
2641
2642     <p>En l'absence de toute définition d'options, la valeur par défaut
2643     est <code>All</code>.</p>
2644
2645 </div>
2646 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2647 <div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">Directive</a></h2>
2648 <table class="directive">
2649 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le temps CPU alloué aux processus initiés par les
2650 processus enfants d'Apache</td></tr>
2651 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RLimitCPU <var>secondes</var>|max [<var>secondes</var>|max]</code></td></tr>
2652 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Non défini ; utilise les valeurs par défaut du système
2653 d'exploitation</code></td></tr>
2654 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
2655 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
2656 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2657 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2658 </table>
2659     <p>Prend 1 ou 2 paramètres. Le premier definit la limite de
2660     consommation de ressources pour tous les processus, et le second la
2661     consommation de ressources maximale. Les deux paramètres peuvent
2662     contenir soit un nombre, soit <code>max</code> pour indiquer au
2663     serveur que la limite de consommation correspond à la valeur
2664     maximale autorisée par la configuration du système d'exploitation.
2665     Pour augmenter la consommation maximale de ressources, le serveur
2666     doit s'exécuter en tant que <code>root</code>, ou se trouver dans sa
2667     phase de démarrage.</p>
2668
2669     <p>Cette directive s'applique aux processus initiés par les
2670     processus enfants d'Apache qui traitent les requêtes, et non aux
2671     processus enfants eux-mêmes. Sont concernés les scripts CGI et les
2672     commandes exec des SSI, mais en aucun cas les processus initiés par
2673     le processus parent d'Apache comme les journalisations redirigées
2674     vers un programme.</p>
2675
2676     <p>Les limites de ressources CPU sont exprimées en secondes par
2677     processus.</p>
2678
2679 <h3>Voir aussi</h3>
2680 <ul>
2681 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2682 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2683 </ul>
2684 </div>
2685 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2686 <div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">Directive</a></h2>
2687 <table class="directive">
2688 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite la mémoire allouée aux processus initiés par les
2689 processus enfants d'Apache</td></tr>
2690 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RLimitMEM <var>octets</var>|max [<var>octets</var>|max]</code></td></tr>
2691 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Non défini ; utilise les valeurs par défaut du système
2692 d'exploitation</code></td></tr>
2693 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
2694 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
2695 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2696 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2697 </table>
2698     <p>Prend 1 ou 2 paramètres. Le premier definit la limite de
2699     consommation de ressources pour tous les processus, et le second la
2700     consommation de ressources maximale. Les deux paramètres peuvent
2701     contenir soit un nombre, soit <code>max</code> pour indiquer au
2702     serveur que la limite de consommation correspond à la valeur
2703     maximale autorisée par la configuration du système d'exploitation.
2704     Pour augmenter la consommation maximale de ressources, le serveur
2705     doit s'exécuter en tant que <code>root</code>, ou se trouver dans sa
2706     phase de démarrage.</p>
2707
2708     <p>Cette directive s'applique aux processus initiés par les
2709     processus enfants d'Apache qui traitent les requêtes, et non aux
2710     processus enfants eux-mêmes. Sont concernés les scripts CGI et les
2711     commandes exec des SSI, mais en aucun cas les processus initiés par
2712     le processus parent d'Apache comme les journalisations redirigées
2713     vers un programme.</p>
2714
2715     <p>Les limites de ressources mémoire sont exprimées en octets par
2716     processus.</p>
2717
2718 <h3>Voir aussi</h3>
2719 <ul>
2720 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2721 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
2722 </ul>
2723 </div>
2724 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2725 <div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">Directive</a></h2>
2726 <table class="directive">
2727 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de processus qui peuvent être initiés par
2728 les processus initiés par les processus enfants d'Apache</td></tr>
2729 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RLimitNPROC <var>nombre</var>|max [<var>nombre</var>|max]</code></td></tr>
2730 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
2731 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
2732 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
2733 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2734 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2735 </table>
2736     <p>Prend 1 ou 2 paramètres. Le premier definit la limite de
2737     consommation de ressources pour tous les processus, et le second la
2738     consommation de ressources maximale. Les deux paramètres peuvent
2739     contenir soit un nombre, soit <code>max</code> pour indiquer au
2740     serveur que la limite de consommation correspond à la valeur
2741     maximale autorisée par la configuration du système d'exploitation.
2742     Pour augmenter la consommation maximale de ressources, le serveur
2743     doit s'exécuter en tant que <code>root</code>, ou se trouver dans sa
2744     phase de démarrage.</p>
2745
2746     <p>Cette directive s'applique aux processus initiés par les
2747     processus enfants d'Apache qui traitent les requêtes, et non aux
2748     processus enfants eux-mêmes. Sont concernés les scripts CGI et les
2749     commandes exec des SSI, mais en aucun cas les processus initiés par
2750     le processus parent d'Apache comme les journalisations redirigées
2751     vers un programme.</p>
2752
2753     <p>Les limites des processus contrôlent le nombre de processus par
2754     utilisateur.</p>
2755
2756     <div class="note"><h3>Note</h3>
2757       <p>Si les processus CGI s'exécutent sous le même
2758       utilisateur que celui du serveur web, cette
2759       directive va limiter le nombre de processus que le serveur
2760       pourra lui-même créer. La présence de messages
2761       <strong><code>cannot fork</code></strong> dans le journal des
2762       erreurs indiquera que la limite est atteinte.</p>
2763     </div>
2764
2765 <h3>Voir aussi</h3>
2766 <ul>
2767 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
2768 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
2769 </ul>
2770 </div>
2771 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2772 <div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a></h2>
2773 <table class="directive">
2774 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de localiser l'interpréteur des scripts
2775 CGI</td></tr>
2776 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
2777 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
2778 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
2779 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
2780 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2781 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2782 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Win32 seulement ;
2783 l'option <code>Registry-Strict</code> est disponible dans les versions
2784 2.0 et supérieures d'Apache</td></tr>
2785 </table>
2786     <p>Cette directive permet de contrôler la méthode qu'utilise Apache
2787     pour trouver l'interpréteur destiné à exécuter les scripts CGI. La
2788     définition par défaut est <code>Script</code> : ceci indique à
2789     Apache qu'il doit utiliser l'interpréteur précisé dans la ligne
2790     shebang du script (la première ligne, commençant par
2791     <code>#!</code>). Sur les systèmes Win32, cette ligne ressemble
2792     souvent à ceci :</p>
2793
2794     <div class="example"><p><code>
2795       #!C:/Perl/bin/perl.exe
2796     </code></p></div>
2797
2798     <p>ou simplement, dans le cas où <code>perl</code> est dans le
2799     <code>PATH</code> :</p>
2800
2801     <div class="example"><p><code>
2802       #!perl
2803     </code></p></div>
2804
2805     <p>Avec <code>ScriptInterpreterSource Registry</code>, Windows va
2806     effectuer une recherche dans l'arborescence
2807     <code>HKEY_CLASSES_ROOT</code> de la base de registre avec comme
2808     mot-clé l'extension du fichier contenant le script (par exemple
2809     <code>.pl</code>). C'est la commande définie par la sous-clé de
2810     registre <code>Shell\ExecCGI\Command</code> ou, si elle n'existe
2811     pas, la sous-clé <code>Shell\Open\Command</code> qui est utilisée
2812     pour ouvrir le fichier du script. Si ces clés de registre ne sont
2813     pas trouvées, Apache utilise la méthode de l'option
2814     <code>Script</code>.</p>
2815
2816     <div class="warning"><h3>Sécurité</h3>
2817     <p>Soyez prudent si vous utilisez <code>ScriptInterpreterSource
2818     Registry</code> avec des répertoires faisant l'objet d'un <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>, car Apache va essayer
2819     d'exécuter <strong>tous</strong> les fichiers contenus dans
2820     celui-ci. L'option <code>Registry</code> peut causer des appels de
2821     programmes non voulus sur des fichiers non destinés à être exécutés.
2822     Par exemple, la commande par défaut open sur les fichiers
2823     <code>.htm</code> sur la plupart des systèmes Windows va lancer
2824     Microsoft Internet Explorer ; ainsi, toute requête HTTP pour un
2825     fichier <code>.htm</code> situé dans le répertoire des scripts
2826     va lancer le navigateur en arrière-plan sur le serveur, ce qui a
2827     toutes les chances de crasher votre système dans les minutes qui
2828     suivent.</p>
2829     </div>
2830
2831     <p>L'option <code>Registry-Strict</code>, apparue avec Apache 2.0,
2832     agit de manière identique à <code>Registry</code>, mais n'utilise
2833     que la sous-clé <code>Shell\ExecCGI\Command</code>. La présence de
2834     la clé <code>ExecCGI</code> n'étant pas systématique, Elle doit être
2835     définie manuellement dans le registre Windows et évite ainsi tout
2836     appel de programme accidentel sur votre système.</p>
2837
2838 </div>
2839 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2840 <div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">Directive</a></h2>
2841 <table class="directive">
2842 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'adresse électronique que le serveur inclut dans les
2843 messages d'erreur envoyés au client</td></tr>
2844 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAdmin <var>adresse électronique</var>|<var>URL</var></code></td></tr>
2845 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
2846 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2847 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2848 </table>
2849     <p>La directive <code class="directive">ServerAdmin</code> permet de définir
2850     l'adresse de contact que le serveur va inclure dans tout message
2851     d'erreur qu'il envoie au client. Si le programme <code>httpd</code>
2852     ne reconnait pas l'argument fourni comme une URL, il suppose que
2853     c'est une <var>adresse électronique</var>, et lui ajoute le préfixe
2854     <code>mailto:</code> dans les cibles des hyperliens. Il est
2855     cependant recommandé d'utiliser exclusivement une adresse
2856     électronique, car de nombreux scripts CGI considèrent ceci comme
2857     implicite. Si vous utilisez une URL, elle doit pointer vers un autre
2858     serveur que vous contrôlez. Dans le cas contraire, les utilisateurs
2859     seraient dans l'impossibilité de vous contacter en cas de problème.</p>
2860
2861     <p>Il peut s'avérer utile de définir une adresse dédiée à
2862     l'administration du serveur, par exemple :</p>
2863
2864     <div class="example"><p><code>
2865       ServerAdmin www-admin@foo.example.com
2866     </code></p></div>
2867     <p>car les utilisateurs ne mentionnent pas systématiquement le
2868     serveur dont ils parlent !</p>
2869
2870 </div>
2871 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2872 <div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">Directive</a></h2>
2873 <table class="directive">
2874 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Autres noms d'un serveur utilisables pour atteindre des
2875 serveurs virtuels à base de nom</td></tr>
2876 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAlias <var>nom serveur</var> [<var>nom serveur</var>]
2877 ...</code></td></tr>
2878 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel</td></tr>
2879 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2880 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2881 </table>
2882     <p>La directive <code class="directive">ServerAlias</code> permet de définir
2883     les noms alternatifs d'un serveur utilisables pour atteindre des <a href="../vhosts/name-based.html">serveurs virtuels à base de
2884     nom</a>. La directive <code class="directive">ServerAlias</code> peut
2885     contenir des caractères génériques, si nécessaire.</p>
2886
2887     <div class="example"><p><code>
2888       &lt;VirtualHost *:80&gt;<br />
2889       ServerName serveur.domaine.com<br />
2890       ServerAlias serveur serveur2.domaine.com serveur2<br />
2891       ServerAlias *.example.com<br />
2892       # ...<br />
2893       &lt;/VirtualHost&gt;
2894     </code></p></div>
2895
2896 <h3>Voir aussi</h3>
2897 <ul>
2898 <li><a href="../vhosts/">Documentation sur les serveurs virtuels
2899 d'Apache</a></li>
2900 </ul>
2901 </div>
2902 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2903 <div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">Directive</a></h2>
2904 <table class="directive">
2905 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom d'hôte et port que le serveur utilise pour
2906 s'authentifier lui-même</td></tr>
2907 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerName [<var>protocole</var>://]<var>nom de domaine
2908 entièrement qualifié</var>[:<var>port</var>]</code></td></tr>
2909 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
2910 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2911 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2912 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Dans la version 2.0, cette directive remplace la
2913 fonctionnalité de la directive <code class="directive">Port</code> de la version
2914 1.3.</td></tr>
2915 </table>
2916     <p>La directive <code class="directive">ServerName</code> permet de définir
2917     les protocole, nom d'hôte et port d'une requête que le serveur
2918     utilise pour s'authentifier lui-même. Ceci est utile lors de la
2919     création de redirections d'URLs. Par exemple, si le nom de la
2920     machine hébergeant le serveur web est
2921     <code>simple.example.com</code>, la machine possède l'alias
2922     DNS <code>www.example.com</code>, et si vous voulez que le serveur
2923     web s'identifie avec cet alias, vous devez utilisez la définition
2924     suivante :</p>
2925
2926     <div class="example"><p><code>
2927       ServerName www.example.com:80
2928     </code></p></div>
2929
2930     <p>Si la directive <code class="directive">ServerName</code> n'est pas
2931     définie, le serveur tente de déterminer le nom d'hôte en effectuant
2932     une recherche DNS inverse sur son adresse IP. Si la directive
2933     <code class="directive">ServerName</code> ne précise pas de port, le serveur
2934     utilisera celui de la requête entrante. Il est recommandé de
2935     spécifier un nom d'hôte et un port spécifiques à l'aide de la
2936     directive <code class="directive">ServerName</code> pour une fiabilité
2937     optimale et à titre préventif.</p>
2938
2939     <p>Si vous définissez des <a href="../vhosts/name-based.html">serveurs virtuels à base de
2940     nom</a>, une directive <code class="directive">ServerName</code> située à
2941     l'intérieur d'une section <code class="directive"><a href="#virtualhost">&lt;VirtualHost&gt;</a></code> spécifiera quel nom d'hôte
2942     doit apparaître dans l'en-tête de requête <code>Host:</code> pour
2943     pouvoir atteindre ce serveur virtuel.</p>
2944
2945
2946     <p>Parfois, le serveur s'exécute en amont d'un dispositif qui
2947     implémente SSL, comme un mandataire inverse, un répartiteur de
2948     charge ou un boîtier dédié SSL. Dans ce cas, spécifiez le protocole
2949     <code>https://</code> et le port auquel les clients se connectent
2950     dans la directive <code class="directive">ServerName</code>, afin de
2951     s'assurer que le serveur génère correctement ses URLs
2952     d'auto-identification.
2953     </p>
2954
2955     <p>Voir la description des directives <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> et <code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code> pour les
2956     définitions qui permettent de déterminer si les URLs
2957     auto-identifiantes (par exemple via le module
2958     <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>) vont faire référence au port spécifié, ou
2959     au port indiqué dans la requête du client.
2960     </p>
2961
2962
2963 <h3>Voir aussi</h3>
2964 <ul>
2965 <li><a href="../dns-caveats.html">Problèmes concernant le DNS et
2966 Apache</a></li>
2967 <li><a href="../vhosts/">Documentation sur les serveurs virtuels
2968 d'Apache</a></li>
2969 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
2970 <li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
2971 <li><code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code></li>
2972 <li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
2973 </ul>
2974 </div>
2975 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2976 <div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">Directive</a></h2>
2977 <table class="directive">
2978 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom de chemin d'URL hérité pour un serveur virtuel à base
2979 de nom accédé par un navigateur incompatible</td></tr>
2980 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerPath <var>chemin d'URL</var></code></td></tr>
2981 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel</td></tr>
2982 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
2983 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2984 </table>
2985     <p>La directive <code class="directive">ServerPath</code> permet de définir
2986     le nom de chemin d'URL hérité d'un hôte, à utiliser avec les <a href="../vhosts/">serveurs virtuels à base de nom</a>.</p>
2987
2988 <h3>Voir aussi</h3>
2989 <ul>
2990 <li><a href="../vhosts/">Documentation sur les serveurs virtuels
2991 d'Apache</a></li>
2992 </ul>
2993 </div>
2994 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2995 <div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">Directive</a></h2>
2996 <table class="directive">
2997 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine du répertoire d'installation du
2998 serveur</td></tr>
2999 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerRoot <var>chemin de répertoire</var></code></td></tr>
3000 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
3001 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
3002 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
3003 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3004 </table>
3005     <p>La directive <code class="directive">ServerRoot</code> permet de définir
3006     le répertoire dans lequel le serveur est installé. En particulier,
3007     il contiendra les sous-répertoires <code>conf/</code> et
3008     <code>logs/</code>. Les chemins relatifs indiqués dans les autres
3009     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
3010     rapport à ce répertoire.</p>
3011
3012     <div class="example"><h3>Example</h3><p><code>
3013       ServerRoot /home/httpd
3014     </code></p></div>
3015
3016
3017 <h3>Voir aussi</h3>
3018 <ul>
3019 <li><a href="../invoking.html">the <code>-d</code>
3020     options de <code>httpd</code></a></li>
3021 <li><a href="../misc/security_tips.html#serverroot">les conseils à
3022 propos de sécurité</a> pour des informations sur la manière de définir
3023 correctement les permissions sur le répertoire indiqué par la directive
3024 <code class="directive">ServerRoot</code></li>
3025 </ul>
3026 </div>
3027 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3028 <div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">Directive</a></h2>
3029 <table class="directive">
3030 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit un pied de page pour les documents générés par le
3031 serveur</td></tr>
3032 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
3033 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ServerSignature Off</code></td></tr>
3034 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
3035 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
3036 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
3037 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3038 </table>
3039     <p>La directive <code class="directive">ServerSignature</code> permet de
3040     définir une ligne de pied de page fixe pour les documents générés
3041     par le serveur (messages d'erreur, listings de répertoires ftp de
3042     <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, sorties de <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>,
3043     etc...). Dans le cas d'une chaîne de mandataires, l'utilisateur n'a
3044     souvent aucun moyen de déterminer lequel des mandataires chaînés a
3045     généré un message d'erreur, et c'est une des raisons pour lesquelles
3046     on peut être amené à ajouter un tel pied de page.</p>
3047
3048     <p>La valeur par défaut <code>Off</code> supprime la ligne de pied
3049     de page (et est ainsi compatible avec le comportement des
3050     versions 1.2 et antérieures d'Apache). la valeur <code>On</code>
3051     ajoute simplement une ligne contenant le numéro de version du
3052     serveur ainsi que le nom du serveur virtuel issu de la directive
3053     <code class="directive"><a href="#servername">ServerName</a></code>, alors que la valeur
3054     <code>EMail</code> ajoute en plus une référence "mailto:" à
3055     l'administrateur du document référencé issu la directive
3056     <code class="directive"><a href="#serveradmin">ServerAdmin</a></code>.</p>
3057
3058     <p>Après la version 2.0.44, les détails à propos du numéro de
3059     version du serveur sont contrôlés à l'aide de la directive
3060     <code class="directive"><a href="#servertokens">ServerTokens</a></code>.</p>
3061
3062 <h3>Voir aussi</h3>
3063 <ul>
3064 <li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
3065 </ul>
3066 </div>
3067 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3068 <div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">Directive</a></h2>
3069 <table class="directive">
3070 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure l'en-tête <code>Server</code> de la réponse
3071 HTTP</td></tr>
3072 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</code></td></tr>
3073 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ServerTokens Full</code></td></tr>
3074 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
3075 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
3076 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3077 </table>
3078     <p>Cette directive permet de contrôler le contenu de l'en-tête
3079     <code>Server</code> inclus dans la réponse envoyée au client : cet
3080     en-tête peut contenir le type de système d'exploitation du serveur,
3081     ainsi que des informations à propos des modules compilés avec le
3082     serveur.</p>
3083
3084     <dl>
3085         <dt><code>ServerTokens Off</code></dt>
3086
3087       <dd>Le serveur n'envoie aucun en-tête <code>Server:</code> (et
3088       <code>SERVER_SOFTWARE</code> est vide)</dd>
3089
3090
3091       <dt><code>ServerTokens Prod[uctOnly]</code></dt>
3092
3093       <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
3094       Apache</code></dd>
3095
3096       <dt><code>ServerTokens Major</code></dt>
3097
3098       <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
3099       Apache/2</code></dd>
3100
3101       <dt><code>ServerTokens Minor</code></dt>
3102
3103       <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
3104       Apache/2.0</code></dd>
3105
3106       <dt><code>ServerTokens Min[imal]</code></dt>
3107
3108       <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
3109       Apache/2.0.41</code></dd>
3110
3111       <dt><code>ServerTokens OS</code></dt>
3112
3113       <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
3114       Apache/2.0.41 (Unix)</code></dd>
3115
3116       <dt><code>ServerTokens Set <em>"Chaîne"</em></code></dt>
3117
3118       <dd>Le serveur envoie la chaîne spécifiée au client (par
3119       exemple, <code>Serveur: MonServeurWeb/8.6</code>)<br />
3120       <strong>Note:</strong> La chaîne doit être
3121       entourée de guillemets si elle contient des espaces.
3122       </dd>
3123
3124       <dt><code>ServerTokens Full</code> (valeur par défaut)</dt>
3125
3126       <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
3127       Apache/2.0.41 (Unix) PHP/4.2.2 MyMod/1.2</code></dd>
3128     </dl>
3129
3130     <p>Cette définition s'applique à l'ensemble du serveur et ne peut
3131     être activée ou désactivée pour tel ou tel serveur virtuel.</p>
3132
3133     <p>Dans les versions postérieures à 2.0.44, cette directive contrôle
3134     aussi les informations fournies par la directive <code class="directive"><a href="#serversignature">ServerSignature</a></code>.</p>
3135
3136 <h3>Voir aussi</h3>
3137 <ul>
3138 <li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
3139 </ul>
3140 </div>
3141 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3142 <div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">Directive</a></h2>
3143 <table class="directive">
3144 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force le traitement des fichiers spécifiés par un
3145 gestionnaire particulier</td></tr>
3146 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetHandler <var>nom gestionnaire</var>|None</code></td></tr>
3147 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
3148 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
3149 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
3150 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3151 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Intégré dans le noyau d'Apache depuis la version
3152 2.0</td></tr>
3153 </table>
3154     <p>Lorsqu'elle se situe à l'intérieur d'un fichier
3155     <code>.htaccess</code>, ou d'une section <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> ou <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, cette directive force le
3156     traitement de tous les fichiers spécifiés par le <a href="../handler.html">gestionnaire</a> défini par l'argument
3157     <var>nom gestionnaire</var>. Par exemple, dans le cas d'un
3158     répertoire dont vous voulez interpréter le contenu comme des
3159     fichiers de règles d'images cliquables, sans tenir compte des
3160     extensions, vous pouvez ajouter la ligne suivante dans un fichier
3161     <code>.htaccess</code> de ce répertoire :</p>
3162
3163     <div class="example"><p><code>
3164       SetHandler imap-file
3165     </code></p></div>
3166
3167     <p>Autre exemple : si vous voulez que le serveur affiche un
3168     compte-rendu d'état chaque fois qu'une URL du type <code>http://nom
3169     serveur/status</code> est appelée, vous pouvez ajouter ceci dans
3170     <code>httpd.conf</code> :</p>
3171
3172     <div class="example"><p><code>
3173       &lt;Location /status&gt;<br />
3174       <span class="indent">
3175         SetHandler server-status<br />
3176       </span>
3177       &lt;/Location&gt;
3178     </code></p></div>
3179
3180     <p>Vous pouvez écraser la définition antérieure d'une directive
3181     <code class="directive">SetHandler</code> en utilisant la valeur
3182     <code>None</code>.</p>
3183     <p><strong>Note :</strong> comme SetHandler l'emporte sur la
3184     définition des gestionnaires par défaut, le comportement habituel
3185     consistant à traiter les URLs se terminant par un slash (/) comme
3186     des répertoires ou des fichiers index est désactivé.</p>
3187
3188 <h3>Voir aussi</h3>
3189 <ul>
3190 <li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li>
3191 </ul>
3192 </div>
3193 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3194 <div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">Directive</a></h2>
3195 <table class="directive">
3196 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les filtres par lesquels vont passer les requêtes
3197 client et les données POST</td></tr>
3198 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetInputFilter <var>filtre</var>[;<var>filtre</var>...]</code></td></tr>
3199 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
3200 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
3201 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
3202 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3203 </table>
3204     <p>La directive <code class="directive">SetInputFilter</code> permet de
3205     définir le ou les filtres par lesquels vont passer les requêtes
3206     client et les données POST au moment où le serveur les reçoit. Cette
3207     définition vient en ajout à tout autre filtre défini en
3208     quelqu'endroit que ce soit, y compris via la directive <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>.</p>
3209
3210     <p>Si la directive comporte plusieurs filtres, ils doivent être
3211     séparés par des points-virgules, et spécifiés selon l'ordre dans
3212     lequel vous souhaitez les voir agir sur les contenus.</p>
3213
3214 <h3>Voir aussi</h3>
3215 <ul>
3216 <li>documentation des <a href="../filter.html">Filtres</a></li>
3217 </ul>
3218 </div>
3219 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3220 <div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">Directive</a></h2>
3221 <table class="directive">
3222 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les filtres par lesquels vont passer les réponses
3223 du serveur</td></tr>
3224 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetOutputFilter <var>filtre</var>[;<var>filtre</var>...]</code></td></tr>
3225 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
3226 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
3227 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
3228 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3229 </table>
3230     <p>La directive <code class="directive">SetOutputFilter</code> permet de
3231     définir les filtres par lesquels vont passer les réponses du serveur
3232     avant d'être envoyées au client. Cette définition vient en ajout à
3233     tout autre filtre défini en quelqu'endroit que ce soit, y compris
3234     via la directive <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>.</p>
3235
3236     <p>Par exemple, la configuration suivante va traiter tous les
3237     fichiers du répertoire <code>/www/data/</code> comme des inclusions
3238     côté serveur (SSI) :</p>
3239
3240     <div class="example"><p><code>
3241       &lt;Directory /www/data/&gt;<br />
3242       <span class="indent">
3243         SetOutputFilter INCLUDES<br />
3244       </span>
3245       &lt;/Directory&gt;
3246     </code></p></div>
3247
3248     <p>Si la directive comporte plusieurs filtres, ils doivent être
3249     séparés par des points-virgules, et spécifiés selon l'ordre dans
3250     lequel vous souhaitez les voir agir sur les contenus.</p>
3251
3252 <h3>Voir aussi</h3>
3253 <ul>
3254 <li><a href="../filter.html">Filters</a> documentation</li>
3255 </ul>
3256 </div>
3257 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3258 <div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">Directive</a></h2>
3259 <table class="directive">
3260 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Temps pendant lequel le serveur va attendre certains
3261 évènements avant de considérer qu'une requête a échoué</td></tr>
3262 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TimeOut <var>secondes</var></code></td></tr>
3263 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>TimeOut 300</code></td></tr>
3264 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
3265 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
3266 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3267 </table>
3268     <p>La directive <code class="directive">TimeOut</code> permet de définir le
3269     temps maximum pendant lequel Apache va attendre des entrées/sorties
3270     selon les circonstances :</p>
3271
3272     <ol>
3273       <li>Lors de la lecture de données en provenance du client, le
3274       temps maximum jusqu'à l'arrivée d'un paquet TCP si le tampon est
3275       vide.</li>
3276
3277       <li>Lors de l'écriture de données destinées au client, le temps
3278       maximum jusqu'à l'arrivée de l'accusé-réception d'un paquet si le
3279       tampon d'envoi est plein.</li>
3280
3281       <li>Avec <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, le temps d'attente maximum des
3282       sorties d'un script CGI.</li>
3283
3284       <li>Avec <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>, le temps d'attente
3285       maximum des sorties d'un processus de filtrage.</li>
3286
3287       <li>Avec <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, la valeur du délai par défaut
3288       si <code class="directive"><a href="../mod/mod_proxy.html#proxytimeout">ProxyTimeout</a></code> n'est
3289       pas défini.</li>
3290     </ol>
3291
3292
3293 </div>
3294 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3295 <div class="directive-section"><h2><a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a name="traceenable" id="traceenable">Directive</a></h2>
3296 <table class="directive">
3297 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le comportement des requêtes
3298 <code>TRACE</code></td></tr>
3299 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr>
3300 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>TraceEnable on</code></td></tr>
3301 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
3302 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
3303 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3304 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible dans les versions 1.3.34, 2.0.55 et
3305 supérieures d'Apache</td></tr>
3306 </table>
3307     <p>Cette directive l'emporte sur le comportement de
3308     <code>TRACE</code> pour le noyau du serveur et
3309     <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. La définition par défaut
3310     <code>TraceEnable on</code> permet des requêtes <code>TRACE</code>
3311     selon la RFC 2616, qui interdit d'ajouter tout corps à la requête.
3312     La définition <code>TraceEnable off</code> indique au noyau du
3313     serveur et à <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> de retourner un code
3314     d'erreur <code>405</code> (Méthode non autorisée) au client.</p>
3315
3316     <p>En fait, et à des fins de test et de diagnostic seulement, on
3317     peut autoriser l'ajout d'un corps de requête à l'aide de la
3318     définition non standard <code>TraceEnable extended</code>. Le noyau
3319     du serveur (dans le cas d'un serveur d'origine) va limiter la taille
3320     du corps de requête à 64k (plus 8k pour les en-têtes de
3321     fractionnement si <code>Transfer-Encoding: chunked</code> est
3322     utilisé). Le noyau du serveur va reproduire l'ensemble des en-têtes,
3323     y compris les en-têtes de fractionnement avec le corps de la
3324     réponse. Dans le cas d'un serveur mandataire, la taille du corps de
3325     requête n'est pas limitée à 64k.</p>
3326
3327 </div>
3328 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3329 <div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">Directive</a></h2>
3330 <table class="directive">
3331 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la manière dont le serveur détermine son propre nom
3332 et son port</td></tr>
3333 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
3334 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>UseCanonicalName Off</code></td></tr>
3335 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
3336 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
3337 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3338 </table>
3339     <p>Dans de nombreuses situations, Apache doit construire une URL
3340     <em>auto-identifiante</em> -- c'est à dire une URL qui fait
3341     référence au serveur lui-même. Avec <code>UseCanonicalName
3342     On</code>, Apache va utiliser le nom d'hôte et le port spécifiés par
3343     la directive <code class="directive"><a href="#servername">ServerName</a></code> pour
3344     construire le nom canonique du serveur. Ce nom est utilisé dans
3345     toutes les URLs auto-identifiantes, et affecté aux variables
3346     <code>SERVER_NAME</code> et <code>SERVER_PORT</code> dans les
3347     programmes CGI.</p>
3348
3349     <p>Avec <code>UseCanonicalName Off</code>, Apache va construire ses
3350     URLs auto-identifiantes à l'aide du nom d'hôte et du port fournis
3351     par le client, si ce dernier en a fourni un (dans la négative,
3352     Apache utilisera le nom canonique, de la même manière que
3353     ci-dessus). Ces valeurs sont les mêmes que celles qui sont utilisées
3354     pour implémenter les <a href="../vhosts/name-based.html">serveurs virtuels à base de
3355     nom</a>, et sont disponibles avec les mêmes clients. De même, les
3356     variables CGI <code>SERVER_NAME</code> et <code>SERVER_PORT</code>
3357     seront affectées des valeurs fournies par le client.</p>
3358
3359     <p>Cette directive peut s'avérer utile, par exemple, sur un serveur
3360     intranet auquel les utilisateurs se connectent en utilisant des noms
3361     courts tels que <code>www</code>. Si les utilisateurs tapent un nom
3362     court suivi d'une URL qui fait référence à un répertoire, comme
3363     <code>http://www/splat</code>, <em>sans le slash terminal</em>, vous
3364     remarquerez qu'Apache va les rediriger vers
3365     <code>http://www.domain.com/splat/</code>. Si vous avez activé
3366     l'authentification, ceci va obliger l'utilisateur à s'authentifier
3367     deux fois (une première fois pour <code>www</code> et une seconde
3368     fois pour <code>www.domain.com</code> -- voir <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">la
3369     foire aux questions sur ce sujet pour plus d'informations</a>). Par
3370     contre, si <code class="directive">UseCanonicalName</code> est définie à
3371     <code>Off</code>, Apache redirigera l'utilisateur vers
3372     <code>http://www/splat/</code>.</p>
3373
3374     <p>Pour l'hébergement virtuel en masse à base d'adresse IP, on
3375     utilise une troisième option, <code>UseCanonicalName
3376     DNS</code>, pour supporter les clients anciens qui ne
3377     fournissent pas d'en-tête <code>Host:</code>. Apache effectue alors
3378     une recherche DNS inverse sur l'adresse IP du serveur auquel le
3379     client s'est connecté afin de construire ses URLs
3380     auto-identifiantes.</p>
3381
3382     <div class="warning"><h3>Avertissement</h3>
3383     <p>Les programmes CGI risquent d'être perturbés par cette option
3384     s'ils tiennent compte de la variable <code>SERVER_NAME</code>. Le
3385     client est pratiquement libre de fournir la valeur qu'il veut comme
3386     nom d'hôte. Mais si le programme CGI n'utilise
3387     <code>SERVER_NAME</code> que pour construire des URLs
3388     auto-identifiantes, il ne devrait pas y avoir de problème.</p>
3389     </div>
3390
3391 <h3>Voir aussi</h3>
3392 <ul>
3393 <li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
3394 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
3395 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
3396 </ul>
3397 </div>
3398 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3399 <div class="directive-section"><h2><a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a> <a name="usecanonicalphysicalport" id="usecanonicalphysicalport">Directive</a></h2>
3400 <table class="directive">
3401 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la manière dont le serveur détermine son propre nom
3402 et son port</td></tr>
3403 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr>
3404 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr>
3405 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
3406 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
3407 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3408 </table>
3409     <p>Dans de nombreuses situations, Apache doit construire une URL
3410     <em>auto-identifiante</em> -- c'est à dire une URL qui fait
3411     référence au serveur lui-même. Avec <code>UseCanonicalPhysicalPort
3412     On</code>, Apache va fournir le numéro de port physique réel utilisé
3413     par la requête en tant que port potentiel, pour construire le port
3414     canonique afin que le serveur puisse alimenter la directive
3415     <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>. Avec
3416     <code>UseCanonicalPhysicalPort Off</code>, Apache n'utilisera pas le
3417     numéro de port physique réel, mais au contraire se référera aux
3418     informations de configuration pour construire un numéro de port
3419     valide.</p>
3420
3421     <div class="note"><h3>Note</h3>
3422     <p>L'ordre dans lequel s'effectue la recherche du port est le
3423     suivant :<br /><br />
3424      <code>UseCanonicalName On</code></p>
3425      <ul>
3426       <li>Port spécifié par <code>Servername</code></li>
3427       <li>Port physique</li>
3428       <li>Port par défaut</li>
3429      </ul>
3430      <code>UseCanonicalName Off | DNS</code>
3431      <ul>
3432       <li>Port spécifié dans l'en-tête <code>Host:</code></li>
3433       <li>Port physique</li>
3434       <li>Port spécifié par <code>Servername</code></li>
3435       <li>Port par défaut</li>
3436      </ul>
3437
3438     <p>Avec <code>UseCanonicalPhysicalPort Off</code>, on reprend
3439     l'ordre ci-dessus en supprimant "Port physique".</p>
3440     </div>
3441
3442
3443 <h3>Voir aussi</h3>
3444 <ul>
3445 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
3446 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
3447 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
3448 </ul>
3449 </div>
3450 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3451 <div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost">&lt;VirtualHost&gt;</a> <a name="virtualhost" id="virtualhost">Directive</a></h2>
3452 <table class="directive">
3453 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent qu'à un nom
3454 d'hôte spécifique ou à une adresse IP</td></tr>
3455 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;VirtualHost
3456     <var>adresse IP</var>[:<var>port</var>] [<var>adresse
3457     IP</var>[:<var>port</var>]] ...&gt; ...
3458     &lt;/VirtualHost&gt;</code></td></tr>
3459 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
3460 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
3461 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3462 </table>
3463     <p>Les balises <code class="directive">&lt;VirtualHost&gt;</code> et
3464     <code>&lt;/VirtualHost&gt;</code> permettent de rassembler un groupe
3465     de directives qui ne s'appliquent qu'à un serveur virtuel
3466     particulier. Toute directive autorisée dans un contexte de serveur
3467     virtuel peut être utilisée. Lorsque le serveur reçoit un requête
3468     pour un document hébergé par un serveur virtuel particulier, il
3469     applique les directives de configuration rassemblées dans la section
3470     <code class="directive">&lt;VirtualHost&gt;</code>. <var>adresse
3471     IP</var> peut être :</p>
3472
3473     <ul>
3474       <li>L'adresse IP du serveur virtuel ;</li>
3475
3476       <li>Un nom de domaine entièrement qualifié correspondant à
3477       l'adresse IP du serveur virtuel (non recommandé) ;</li>
3478
3479       <li>Le caractère <code>*</code>, qui n'est utilisé qu'en
3480       combinaison avec <code>NameVirtualHost *</code> pour intercepter
3481       toutes les adresses IP ; ou</li>
3482
3483       <li>La chaîne de caractères <code>_default_</code>, qui n'est
3484       utilisée qu'avec l'hébergement virtuel à base d'adresse IP pour
3485       intercepter les adresses IP qui ne correspondent à aucun serveur
3486       virtuel.</li>
3487     </ul>
3488
3489     <div class="example"><h3>Exemple</h3><p><code>
3490       &lt;VirtualHost 10.1.2.3&gt;<br />
3491       <span class="indent">
3492         ServerAdmin webmaster@host.example.com<br />
3493         DocumentRoot /www/docs/host.example.com<br />
3494         ServerName host.example.com<br />
3495         ErrorLog logs/host.example.com-error_log<br />
3496         TransferLog logs/host.example.com-access_log<br />
3497       </span>
3498       &lt;/VirtualHost&gt;
3499     </code></p></div>
3500
3501
3502     <p>Les adresses IPv6 doivent être entourées de crochets car dans le
3503     cas contraire, un éventuel port optionnel ne pourrait pas être
3504     déterminé. Voici un exemple de serveur virtuel avec adresse IPv6
3505     :</p>
3506
3507     <div class="example"><p><code>
3508       &lt;VirtualHost [2001:db8::a00:20ff:fea7:ccea]&gt;<br />
3509       <span class="indent">
3510         ServerAdmin webmaster@host.example.com<br />
3511         DocumentRoot /www/docs/host.example.com<br />
3512         ServerName host.example.com<br />
3513         ErrorLog logs/host.example.com-error_log<br />
3514         TransferLog logs/host.example.com-access_log<br />
3515       </span>
3516       &lt;/VirtualHost&gt;
3517     </code></p></div>
3518
3519     <p>Chaque serveur virtuel doit correspondre à une adresse IP, un
3520     port ou un nom d'hôte spécifique ; dans le premier cas, le serveur
3521     doit être configuré pour recevoir les paquets IP de plusieurs
3522     adresses (si le serveur n'a qu'une interface réseau, on peut
3523     utiliser à cet effet la commande <code>ifconfig alias</code> -- si
3524     votre système d'exploitation le permet).</p>
3525
3526     <div class="note"><h3>Note</h3>
3527     <p>L'utilisation de la directive <code class="directive">&lt;VirtualHost&gt;</code> n'affecte en rien les
3528     adresses IP sur lesquelles Apache est en écoute. Vous devez vous
3529     assurer que les adresses des serveurs virtuels sont bien incluses
3530     dans la liste des adresses précisées par la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p>
3531     </div>
3532
3533     <p>Avec l'hébergement virtuel à base d'adresse IP, on peut utiliser
3534     le nom spécial <code>_default_</code>, auquel cas le serveur virtuel
3535     considéré interceptera toute adresse IP qui n'est pas explicitement
3536     associée à un autre serveur virtuel. En l'absence de serveur virtuel
3537     associé à <code>_default_</code>, et si l'adresse IP demandée ne
3538     correspond à aucun serveur virtuel, c'est la configuration du
3539     serveur "principal" qui sera utilisée, c'est à dire l'ensemble des
3540     définitions situées en dehors de toute section VirtualHost.</p>
3541
3542     <p>Vous pouvez spécifier <code>:port</code> pour modifier le port du
3543     serveur virtuel. S'il n'est pas spécifié, sa valeur par défaut
3544     correspond à celle qui est définie par la dernière directive
3545     <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> du serveur
3546     principal. Vous pouvez aussi spécifier <code>:*</code> pour accepter
3547     tous les ports associés à l'adresse du serveur virtuel (c'est une
3548     configuration recommandée lorsqu'on utilise
3549     <code>_default_</code>).</p>
3550
3551     <p>Tout bloc <code class="directive">&lt;VirtualHost&gt;</code> doit comporter une directive
3552     <code class="directive"><a href="#servername">ServerName</a></code>. Dans le cas
3553     contraire, le serveur virtuel héritera de la valeur de la directive
3554     <code class="directive"><a href="#servername">ServerName</a></code> issue de la
3555     configuration du serveur principal.</p>
3556
3557     <div class="warning"><h3>Sécurité</h3>
3558     <p>Voir le document sur les <a href="../misc/security_tips.html">conseils à propos de sécurité</a>
3559     pour une description détaillée des raisons pour lesquelles la
3560     sécurité de votre serveur pourrait être compromise, si le répertoire
3561     contenant les fichiers journaux est inscriptible par tout autre
3562     utilisateur que celui qui démarre le serveur.</p>
3563     </div>
3564
3565 <h3>Voir aussi</h3>
3566 <ul>
3567 <li><a href="../vhosts/">Documentation des serveurs virtuels
3568 d'Apache</a></li>
3569 <li><a href="../dns-caveats.html">Problèmes concernant DNS et
3570 Apache</a></li>
3571 <li><a href="../bind.html">Définition des adresses et ports
3572 qu'utilise Apache</a></li>
3573 <li><a href="../sections.html">Comment fonctionnent les sections
3574 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
3575 explication de la manière dont ces différentes sections se combinent
3576 entre elles à la réception d'une requête</li>
3577 </ul>
3578 </div>
3579 </div>
3580 <div class="bottomlang">
3581 <p><span>Langues Disponibles: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
3582 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
3583 <a href="../fr/mod/core.html" title="Français">&nbsp;fr&nbsp;</a> |
3584 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
3585 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
3586 </div><div id="footer">
3587 <p class="apache">Copyright 2010 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
3588 <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>
3589 </body></html>