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

   1 <?xml version="1.0" encoding="UTF-8"?>
   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 <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>core - Serveur HTTP Apache Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body>
  19 <div id="page-header">
  20 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
  21 <p class="apache">Serveur HTTP Apache Version 2.5</p>
  22 <img alt="" src="../images/feather.png" /></div>
  23 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  24 <div id="path">
  25 <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.5</a> &gt; <a href="./">Modules</a></div>
  26 <div id="page-content">
  27 <div id="preamble"><h1>Fonctionalités de Base Apache</h1>
  28 <div class="toplang">
  29 <p><span>Langues Disponibles: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
  30 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  31 <a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
  32 <a href="../fr/mod/core.html" title="Français">&nbsp;fr&nbsp;</a> |
  33 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  34 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  35 </div>
  36 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fonctionnalités de base du serveur HTTP Apache toujours
  37 disponibles</td></tr>
  38 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr></table>
  39 </div>
  40 <div id="quickview"><h3 class="directives">Directives</h3>
  41 <ul id="toc">
  42 <li><img alt="" src="../images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li>
  43 <li><img alt="" src="../images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
  44 <li><img alt="" src="../images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
  45 <li><img alt="" src="../images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
  46 <li><img alt="" src="../images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
  47 <li><img alt="" src="../images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
  48 <li><img alt="" src="../images/down.gif" /> <a href="#allowoverridelist">AllowOverrideList</a></li>
  49 <li><img alt="" src="../images/down.gif" /> <a href="#asyncfilter">AsyncFilter</a></li>
  50 <li><img alt="" src="../images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
  51 <li><img alt="" src="../images/down.gif" /> <a href="#cgipassauth">CGIPassAuth</a></li>
  52 <li><img alt="" src="../images/down.gif" /> <a href="#cgivar">CGIVar</a></li>
  53 <li><img alt="" src="../images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
  54 <li><img alt="" src="../images/down.gif" /> <a href="#defaultruntimedir">DefaultRuntimeDir</a></li>
  55 <li><img alt="" src="../images/down.gif" /> <a href="#defaultstatedir">DefaultStateDir</a></li>
  56 <li><img alt="" src="../images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
  57 <li><img alt="" src="../images/down.gif" /> <a href="#define">Define</a></li>
  58 <li><img alt="" src="../images/down.gif" /> <a href="#directory">&lt;Directory&gt;</a></li>
  59 <li><img alt="" src="../images/down.gif" /> <a href="#directorymatch">&lt;DirectoryMatch&gt;</a></li>
  60 <li><img alt="" src="../images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
  61 <li><img alt="" src="../images/down.gif" /> <a href="#else">&lt;Else&gt;</a></li>
  62 <li><img alt="" src="../images/down.gif" /> <a href="#elseif">&lt;ElseIf&gt;</a></li>
  63 <li><img alt="" src="../images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
  64 <li><img alt="" src="../images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
  65 <li><img alt="" src="../images/down.gif" /> <a href="#error">Error</a></li>
  66 <li><img alt="" src="../images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
  67 <li><img alt="" src="../images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
  68 <li><img alt="" src="../images/down.gif" /> <a href="#errorlogformat">ErrorLogFormat</a></li>
  69 <li><img alt="" src="../images/down.gif" /> <a href="#extendedstatus">ExtendedStatus</a></li>
  70 <li><img alt="" src="../images/down.gif" /> <a href="#fileetag">FileETag</a></li>
  71 <li><img alt="" src="../images/down.gif" /> <a href="#files">&lt;Files&gt;</a></li>
  72 <li><img alt="" src="../images/down.gif" /> <a href="#filesmatch">&lt;FilesMatch&gt;</a></li>
  73 <li><img alt="" src="../images/down.gif" /> <a href="#forcetype">ForceType</a></li>
  74 <li><img alt="" src="../images/down.gif" /> <a href="#gprofdir">GprofDir</a></li>
  75 <li><img alt="" src="../images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
  76 <li><img alt="" src="../images/down.gif" /> <a href="#httpprotocoloptions">HttpProtocolOptions</a></li>
  77 <li><img alt="" src="../images/down.gif" /> <a href="#if">&lt;If&gt;</a></li>
  78 <li><img alt="" src="../images/down.gif" /> <a href="#ifdefine">&lt;IfDefine&gt;</a></li>
  79 <li><img alt="" src="../images/down.gif" /> <a href="#ifdirective">&lt;IfDirective&gt;</a></li>
  80 <li><img alt="" src="../images/down.gif" /> <a href="#iffile">&lt;IfFile&gt;</a></li>
  81 <li><img alt="" src="../images/down.gif" /> <a href="#ifmodule">&lt;IfModule&gt;</a></li>
  82 <li><img alt="" src="../images/down.gif" /> <a href="#ifsection">&lt;IfSection&gt;</a></li>
  83 <li><img alt="" src="../images/down.gif" /> <a href="#include">Include</a></li>
  84 <li><img alt="" src="../images/down.gif" /> <a href="#includeoptional">IncludeOptional</a></li>
  85 <li><img alt="" src="../images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
  86 <li><img alt="" src="../images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
  87 <li><img alt="" src="../images/down.gif" /> <a href="#limit">&lt;Limit&gt;</a></li>
  88 <li><img alt="" src="../images/down.gif" /> <a href="#limitexcept">&lt;LimitExcept&gt;</a></li>
  89 <li><img alt="" src="../images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
  90 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
  91 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
  92 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
  93 <li><img alt="" src="../images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
  94 <li><img alt="" src="../images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
  95 <li><img alt="" src="../images/down.gif" /> <a href="#location">&lt;Location&gt;</a></li>
  96 <li><img alt="" src="../images/down.gif" /> <a href="#locationmatch">&lt;LocationMatch&gt;</a></li>
  97 <li><img alt="" src="../images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
  98 <li><img alt="" src="../images/down.gif" /> <a href="#logleveloverride">LogLevelOverride</a></li>
  99 <li><img alt="" src="../images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
 100 <li><img alt="" src="../images/down.gif" /> <a href="#maxrangeoverlaps">MaxRangeOverlaps</a></li>
 101 <li><img alt="" src="../images/down.gif" /> <a href="#maxrangereversals">MaxRangeReversals</a></li>
 102 <li><img alt="" src="../images/down.gif" /> <a href="#maxranges">MaxRanges</a></li>
 103 <li><img alt="" src="../images/down.gif" /> <a href="#mergetrailers">MergeTrailers</a></li>
 104 <li><img alt="" src="../images/down.gif" /> <a href="#mutex">Mutex</a></li>
 105 <li><img alt="" src="../images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
 106 <li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
 107 <li><img alt="" src="../images/down.gif" /> <a href="#protocol">Protocol</a></li>
 108 <li><img alt="" src="../images/down.gif" /> <a href="#protocols">Protocols</a></li>
 109 <li><img alt="" src="../images/down.gif" /> <a href="#protocolshonororder">ProtocolsHonorOrder</a></li>
 110 <li><img alt="" src="../images/down.gif" /> <a href="#qualifyredirecturl">QualifyRedirectURL</a></li>
 111 <li><img alt="" src="../images/down.gif" /> <a href="#regexdefaultoptions">RegexDefaultOptions</a></li>
 112 <li><img alt="" src="../images/down.gif" /> <a href="#registerhttpmethod">RegisterHttpMethod</a></li>
 113 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
 114 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
 115 <li><img alt="" src="../images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
 116 <li><img alt="" src="../images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
 117 <li><img alt="" src="../images/down.gif" /> <a href="#seerequesttail">SeeRequestTail</a></li>
 118 <li><img alt="" src="../images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
 119 <li><img alt="" src="../images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
 120 <li><img alt="" src="../images/down.gif" /> <a href="#servername">ServerName</a></li>
 121 <li><img alt="" src="../images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
 122 <li><img alt="" src="../images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
 123 <li><img alt="" src="../images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
 124 <li><img alt="" src="../images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
 125 <li><img alt="" src="../images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
 126 <li><img alt="" src="../images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
 127 <li><img alt="" src="../images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
 128 <li><img alt="" src="../images/down.gif" /> <a href="#stricthostcheck">StrictHostCheck</a></li>
 129 <li><img alt="" src="../images/down.gif" /> <a href="#timeout">TimeOut</a></li>
 130 <li><img alt="" src="../images/down.gif" /> <a href="#traceenable">TraceEnable</a></li>
 131 <li><img alt="" src="../images/down.gif" /> <a href="#undefine">UnDefine</a></li>
 132 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
 133 <li><img alt="" src="../images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li>
 134 <li><img alt="" src="../images/down.gif" /> <a href="#virtualhost">&lt;VirtualHost&gt;</a></li>
 135 <li><img alt="" src="../images/down.gif" /> <a href="#warning">Warning</a></li>
 136 </ul>
 137 <h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=core">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=core">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
 138 <ul class="seealso">
 139 <li><a href="#comments_section">Commentaires</a></li></ul></div>
 140
 141 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 142 <div class="directive-section"><h2><a name="acceptfilter" id="acceptfilter">Directive</a> <a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a title="Lien permanent" href="#acceptfilter" class="permalink">&para;</a></h2>
 143 <table class="directive">
 144 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'optimiser la configuration d'une socket pour
 145 l'écoute d'un protocole</td></tr>
 146 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptFilter <var>protocole</var> <var>filtre
 147 d'acceptation</var></code></td></tr>
 148 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
 149 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 150 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 151 </table>
 152     <p>Cette directive permet d'effectuer une optimisation de la socket
 153     d'écoute d'un type de protocole en fonction du système
 154     d'exploitation. Le but premier est de faire en sorte que le noyau
 155     n'envoie pas de socket au processus du serveur jusqu'à ce que
 156     des données soient reçues, ou qu'une requête HTTP complète soit mise
 157     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
 158     primitif <code>TCP_DEFER_ACCEPT</code> sous Linux, et la version
 159     optimisée d'AcceptEx() de Windows sont actuellement supportés.</p>
 160
 161     <p>L'utilisation de l'argument <code>none</code> va désactiver tout
 162     filtre d'acceptation pour ce protocole. Ceci s'avère utile pour les
 163     protocoles qui nécessitent l'envoi de données par le serveur en
 164     premier, comme <code>ftp:</code> ou <code>nntp</code>:</p>
 165     <pre class="prettyprint lang-config">AcceptFilter nntp none</pre>
 166
 167
 168     <p>Les noms de protocoles par défaut sont <code>https</code> pour le
 169     port 443 et <code>http</code> pour tous les autres ports. Pour
 170     spécifier un autre protocole à utiliser avec un port en écoute,
 171     ajoutez l'argument <var>protocol</var> à la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p>
 172
 173     <p>Sous FreeBSD, les valeurs par défaut sont :</p>
 174     <pre class="prettyprint lang-config">AcceptFilter http httpready
 175 AcceptFilter https dataready</pre>
 176
 177
 178     <p>Le filtre d'acceptation <code>httpready</code> met en tampon des
 179     requêtes HTTP entières au niveau du noyau. Quand une requête
 180     entière a été reçue, le noyau l'envoie au serveur. Voir la page de
 181     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
 182     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>
 183
 184     <p>Sous Linux, les valeurs par défaut sont :</p>
 185     <pre class="prettyprint lang-config">AcceptFilter http data
 186 AcceptFilter https data</pre>
 187
 188
 189     <p>Le filtre <code>TCP_DEFER_ACCEPT</code> de Linux ne supporte pas
 190     la mise en tampon des requêtes http. Toute valeur autre que
 191     <code>none</code> active le filtre <code>TCP_DEFER_ACCEPT</code>
 192     pour ce protocole. Pour plus de détails, voir la page de
 193     manuel Linux de <a href="http://man7.org/linux/man-pages/man7/tcp.7.html">tcp(7)</a>.</p>
 194
 195     <p>Sous Windows, les valeurs par défaut sont :</p>
 196     <pre class="prettyprint lang-config">AcceptFilter http connect
 197 AcceptFilter https connect</pre>
 198
 199
 200     <p>Le module MPM pour Windows mpm_winnt utilise la directive
 201     AcceptFilter comme commutateur de l'API AcceptEx(), et ne supporte
 202     pas la mise en tampon du protocole http. <code>connect</code>
 203     utilise l'API AcceptEx(), extrait aussi les adresses réseau finales,
 204     mais à l'instar de <code>none</code>, la valeur <code>connect</code>
 205     n'attend pas la transmission des données initiales.</p>
 206
 207     <p>Sous Windows, <code>none</code> utilise accept() au lieu
 208     d'AcceptEx(), et ne recycle pas les sockets entre les connexions.
 209     Ceci s'avère utile pour les interfaces réseau dont le pilote est
 210     défectueux, ainsi que pour certains fournisseurs de réseau comme les
 211     pilotes vpn, ou les filtres anti-spam, anti-virus ou
 212     anti-spyware.</p>
 213
 214     <div class="warning">
 215       <h3>L'AcceptFilter <code>data</code> (Windows)</h3>
 216
 217       <p>Jusqu'à la version 2.4.23, le filtre d'acceptation <code>data</code>
 218       attendait que des données aient été transmises et que le tampon de données
 219       initial et l'adresse réseau finale aient été déterminés par l'invocation
 220       AcceptEx(). Cette implémentation étant vulnérable à une attaque de type
 221       denial of service, elle a été désactivée.</p>
 222
 223       <p>La version actuelle de httpd prend par défaut le filtre
 224       <code>connect</code> sous Windows, et reprendra la valeur
 225       <code>data</code> si <code>data</code> est spécifié. Il est fortement
 226       conseillé aux utilisateurs des versions plus anciennes de définir
 227       explicitement le filtre <code>connect</code> pour leurs AcceptFilter
 228       comme indiqué plus haut.</p>
 229     </div>
 230
 231
 232 <h3>Voir aussi</h3>
 233 <ul>
 234 <li><code class="directive"><a href="#protocol">Protocol</a></code></li>
 235 </ul>
 236 </div>
 237 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 238 <div class="directive-section"><h2><a name="acceptpathinfo" id="acceptpathinfo">Directive</a> <a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a title="Lien permanent" href="#acceptpathinfo" class="permalink">&para;</a></h2>
 239 <table class="directive">
 240 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les ressources acceptent des informations sous forme d'un
 241 nom de chemin en fin de requête.</td></tr>
 242 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
 243 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
 244 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
 245 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
 246 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 247 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 248 </table>
 249
 250     <p>Cette directive permet de définir si les requêtes contenant des
 251     informations sous forme d'un nom de chemin suivant le nom d'un
 252     fichier réel (ou un fichier qui n'existe pas dans un répertoire qui
 253     existe) doivent être acceptées ou rejetées. Les scripts peuvent
 254     accéder à cette information via la variable d'environnement
 255     <code>PATH_INFO</code>.</p>
 256
 257     <p>Supposons par exemple que <code>/test/</code> pointe vers un
 258     répertoire qui ne contient que le fichier <code>here.html</code>.
 259     Les requêtes pour <code>/test/here.html/more</code> et
 260     <code>/test/nothere.html/more</code> vont affecter la valeur
 261     <code>/more</code> à la variable d'environnement
 262     <code>PATH_INFO</code>.</p>
 263
 264     <p>L'argument de la directive <code class="directive">AcceptPathInfo</code>
 265     possède trois valeurs possibles :</p>
 266     <dl>
 267     <dt><code>Off</code></dt><dd>Une requête ne sera acceptée que si
 268     elle correspond à un chemin qui existe. Par conséquent, une requête
 269     contenant une information de chemin après le nom de fichier réel
 270     comme <code>/test/here.html/more</code> dans l'exemple ci-dessus
 271     renverra une erreur "404 NOT FOUND".</dd>
 272
 273     <dt><code>On</code></dt><dd>Une requête sera acceptée si la partie
 274     principale du chemin correspond à un fichier existant. Dans
 275     l'exemple ci-dessus <code>/test/here.html/more</code>, la requête
 276     sera acceptée si <code>/test/here.html</code> correspond à un nom de
 277     fichier valide.</dd>
 278
 279     <dt><code>Default</code></dt><dd>Le traitement des requêtes est
 280     déterminé par le <a href="../handler.html">gestionnaire</a> responsable de la requête.
 281     Le gestionnaire de base pour les fichiers normaux rejette par défaut
 282     les requêtes avec <code>PATH_INFO</code>. Les gestionnaires qui
 283     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
 284     défaut les requêtes avec <code>PATH_INFO</code>.</dd>
 285     </dl>
 286
 287     <p>Le but premier de la directive <code>AcceptPathInfo</code> est de
 288     vous permettre de remplacer le choix du gestionnaire d'accepter ou
 289     de rejeter <code>PATH_INFO</code>. Ce remplacement est nécessaire
 290     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é
 291     sur <code>PATH_INFO</code>. Le gestionnaire de base va en général
 292     rejeter la requête, et vous pouvez utiliser la configuration
 293     suivante pour utiliser un tel script :</p>
 294 <pre class="prettyprint lang-config">&lt;Files "mypaths.shtml"&gt;
 295   Options +Includes
 296   SetOutputFilter INCLUDES
 297   AcceptPathInfo On
 298 &lt;/Files&gt;</pre>
 299
 300
 301
 302
 303 </div>
 304 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 305 <div class="directive-section"><h2><a name="accessfilename" id="accessfilename">Directive</a> <a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a title="Lien permanent" href="#accessfilename" class="permalink">&para;</a></h2>
 306 <table class="directive">
 307 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du fichier de configuration distribué</td></tr>
 308 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AccessFileName <var>nom-du-fichier</var>
 309 [<var>nom-du-fichier</var>] ...</code></td></tr>
 310 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
 311 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
 312 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 313 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 314 </table>
 315     <p>Au cours du traitement d'une requête, le serveur recherche le
 316     premier fichier de configuration existant à partir de la liste
 317     de noms dans chaque répertoire composant le chemin du document, à
 318     partir du moment où les fichiers de configuration distribués sont <a href="#allowoverride">activés pour ce répertoire</a>. Par exemple
 319     :</p>
 320
 321     <pre class="prettyprint lang-config">AccessFileName .acl</pre>
 322
 323
 324     <p>avant de renvoyer le document
 325     <code>/usr/local/web/index.html</code>, le serveur va rechercher les
 326     fichiers <code>/.acl</code>, <code>/usr/.acl</code>,
 327     <code>/usr/local/.acl</code> et <code>/usr/local/web/.acl</code>
 328     pour y lire d'éventuelles directives, à moins quelles n'aient été
 329     désactivées avec</p>
 330
 331     <pre class="prettyprint lang-config">&lt;Directory "/"&gt;
 332     AllowOverride None
 333 &lt;/Directory&gt;</pre>
 334
 335
 336 <h3>Voir aussi</h3>
 337 <ul>
 338 <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
 339 <li><a href="../configuring.html">Fichiers de configuration</a></li>
 340 <li><a href="../howto/htaccess.html">Fichiers .htaccess</a></li>
 341 </ul>
 342 </div>
 343 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 344 <div class="directive-section"><h2><a name="adddefaultcharset" id="adddefaultcharset">Directive</a> <a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a title="Lien permanent" href="#adddefaultcharset" class="permalink">&para;</a></h2>
 345 <table class="directive">
 346 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Paramètre jeu de caractères par défaut à ajouter quand le
 347 type de contenu d'une réponse est <code>text/plain</code> ou
 348 <code>text/html</code></td></tr>
 349 <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>
 350 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
 351 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
 352 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
 353 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 354 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 355 </table>
 356     <p>Cette directive spécifie une valeur par défaut pour le paramètre
 357     jeu de caractères du type de média (le nom d'un codage de
 358     caractères) à ajouter à une réponse, si et seulement si le type de
 359     contenu de la réponse est soit <code>text/plain</code>, soit
 360     <code>text/html</code>. Ceci va remplacer
 361     tout jeu de caractères spécifié dans le corps de la réponse via un
 362     élément <code>META</code>, bien que cet effet dépende en fait
 363     souvent de la configuration du client de l'utilisateur. La
 364     définition de <code>AddDefaultCharset Off</code> désactive cette
 365     fonctionnalité. <code>AddDefaultCharset On</code> ajoute un jeu de
 366     caractères par défaut de <code>iso-8859-1</code>. Toute autre valeur
 367     peut être définie via le paramètre <var>jeu de caractères</var>, qui
 368     doit appartenir à la liste des <a href="http://www.iana.org/assignments/character-sets">valeurs de
 369     jeux de caractères enregistrés par l'IANA</a> à utiliser dans les
 370     types de média Internet (types MIME).
 371     Par exemple :</p>
 372
 373     <pre class="prettyprint lang-config">AddDefaultCharset utf-8</pre>
 374
 375
 376     <p>La directive <code class="directive">AddDefaultCharset</code> ne doit
 377     être utilisée que lorsque toutes les ressources textes auxquelles
 378     elle s'applique possèdent le jeu de caractère spécifié, et qu'il est
 379     trop contraignant de définir leur jeu de caractères
 380     individuellement. Un exemple de ce type est l'ajout du paramètre jeu
 381     de caractères aux ressources comportant un contenu généré, comme les
 382     scripts CGI hérités qui peuvent être vulnérables à des attaques de
 383     type cross-site scripting à cause des données utilisateurs incluses
 384     dans leur sortie. Notez cependant qu'une meilleur solution consiste
 385     à corriger (ou supprimer) ces scripts, car la définition d'un jeu de
 386     caractères par défaut ne protège pas les utilisateurs qui ont activé
 387     la fonctionnalité "Détection automatique de l'encodage des
 388     caractères" dans leur navigateur.</p>
 389
 390 <h3>Voir aussi</h3>
 391 <ul>
 392 <li><code class="directive"><a href="../mod/mod_mime.html#addcharset">AddCharset</a></code></li>
 393 </ul>
 394 </div>
 395 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 396 <div class="directive-section"><h2><a name="allowencodedslashes" id="allowencodedslashes">Directive</a> <a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a title="Lien permanent" href="#allowencodedslashes" class="permalink">&para;</a></h2>
 397 <table class="directive">
 398 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si les séparateurs de chemin encodés sont
 399 autorisés à transiter dans les URLs tels quels</td></tr>
 400 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowEncodedSlashes On|Off|NoDecode</code></td></tr>
 401 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
 402 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
 403 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 404 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 405 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>L'option NoDecode est disponible depuis la version
 406 2.3.12.</td></tr>
 407 </table>
 408     <p>La directive <code class="directive">AllowEncodedSlashes</code> permet
 409     l'utilisation des URLs contenant des séparateurs de chemin
 410     encodés dans la partie chemin
 411     (<code>%2F</code> pour <code>/</code> et même <code>%5C</code> pour
 412     <code>\</code> sur les systèmes concernés).</p>
 413
 414     <p>Avec la valeur par défaut, <code>Off</code>, de telles URLs sont
 415     refusées et provoquent le renvoi d'une erreur 404 (Not found).</p>
 416
 417     <p>Avec la valeur <code>On</code>, ces URLs sont acceptées, et les
 418     slashes encodés sont décodés comme tout autre caractère codé.</p>
 419
 420     <p>Avec la valeur <code>NoDecode</code>, ces URLs sont acceptées,
 421     mais les slashes codés ne sont pas décodés et laissés dans leur état
 422     codé.</p>
 423
 424     <p>Définir <code class="directive">AllowEncodedSlashes</code> à
 425     <code>On</code> est surtout utile en association avec
 426     <code>PATH_INFO</code>.</p>
 427
 428     <div class="note"><h3>Note</h3>
 429       <p>Si le codage des slashes dans la partie chemin est nécessaire,
 430       l'utilisation de l'option <code>NoDecode</code> est fortement
 431       recommandée par mesure de sécurité. Permettre le décodage des
 432       slashes pourrait éventuellement induire l'autorisation de chemins
 433       non sûrs.</p>
 434     </div>
 435
 436 <h3>Voir aussi</h3>
 437 <ul>
 438 <li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
 439 </ul>
 440 </div>
 441 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 442 <div class="directive-section"><h2><a name="allowoverride" id="allowoverride">Directive</a> <a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a title="Lien permanent" href="#allowoverride" class="permalink">&para;</a></h2>
 443 <table class="directive">
 444 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types de directives autorisées dans les fichiers
 445 <code>.htaccess</code></td></tr>
 446 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowOverride All|None|<var>directive-type</var>
 447 [<var>directive-type</var>] ...</code></td></tr>
 448 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowOverride None à partir de la version 2.3.9, AllowOverride
 449 All pour les versions antérieures</code></td></tr>
 450 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 451 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 452 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 453 </table>
 454     <p>Lorsque le serveur trouve un fichier <code>.htaccess</code> (dont
 455     le nom est défini par la directive <code class="directive"><a href="#accessfilename">AccessFileName</a></code>), il doit savoir lesquelles
 456     des directives placées dans ce fichier sont autorisées à modifier la
 457     configuration préexistante.</p>
 458
 459     <div class="note"><h3>Valable seulement dans les sections
 460     &lt;Directory&gt;</h3>
 461     La directive <code class="directive">AllowOverride</code> ne peut être
 462     utilisée que dans les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> définies sans expressions
 463     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
 464     <code class="directive"><a href="#files">&lt;Files&gt;</a></code>.
 465     </div>
 466
 467     <p>Lorsque cette directive et la directive <code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code> sont définies à <code>None</code>, les
 468     fichiers <a href="#accessfilename">.htaccess</a> sont totalement
 469     ignorés. Dans ce cas, le serveur n'essaiera même pas de lire les
 470     fichiers <code>.htaccess</code> du système de fichiers.</p>
 471
 472     <p>Lorsque cette directive est définie à <code>All</code>, toute
 473     directive valable dans le <a href="directive-dict.html#Context">Contexte</a> .htaccess sera
 474     autorisée dans les fichiers <code>.htaccess</code>.</p>
 475
 476     <p>L'argument <var>directive-type</var> peut contenir les
 477     groupements de directives suivants (Voir l'<a href="overrides.html">index de la class override</a> pour obtenir une liste mise à
 478     jour des directives activées par chaque argument <var>directive-type</var>) :</p>
 479
 480     <dl>
 481       <dt><a href="overrides.html#override-authconfig">AuthConfig</a></dt>
 482
 483       <dd>
 484
 485       Permet l'utilisation des directives d'autorisation (<code class="directive"><a href="../mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
 486       <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
 487       <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
 488       <code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code>,
 489       <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>
 490
 491       <dt><a href="overrides.html#override-fileinfo">FileInfo</a></dt>
 492
 493       <dd>
 494       Permet l'utilisation des directives qui contrôlent les types de
 495       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>,
 496       <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
 497       module <code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> Add* et Remove*), des metadonnées
 498       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
 499       module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> directives (<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>), des directives du
 500       module <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> directives (<code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirecttemp">RedirectTemp</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirectpermanent">RedirectPermanent</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code>), et de la directive
 501       <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> du module
 502       <code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code>.
 503       </dd>
 504
 505       <dt><a href="overrides.html#override-indexes">Indexes</a></dt>
 506
 507       <dd>
 508       Permet l'utilisation des directives qui contrôlent l'indexation
 509       des répertoires (<code class="directive"><a href="../mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
 510       <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>,
 511       <code class="directive"><a href="../mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
 512       <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_dir.html#fallbackresource">FallbackResource</a></code>, <a href="mod_autoindex.html#indexoptions.fancyindexing"><code>FancyIndexing</code></a>,
 513       <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>,
 514       <em>etc...</em>).</dd>
 515
 516       <dt><a href="overrides.html#override-limit">Limit</a></dt>
 517
 518       <dd>
 519       Permet l'utilisation des directives contrôlant l'accès au serveur
 520       (<code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code>, <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> et <code class="directive"><a href="../mod/mod_access_compat.html#order">Order</a></code>).</dd>
 521
 522
 523
 524
 525
 526
 527       <dt>Nonfatal=[Override|Unknown|All]</dt>
 528
 529       <dd>Permet d'utiliser l'option AllowOverride pour rendre non fatales les
 530       directives invalides (non reconnues ou non permises) dans les fichiers
 531       .htaccess : au lieu de causer une Internal Server Error, les directives
 532       non autorisées ou non reconnues seront ignorées et un avertissement
 533       enregistré dans le journal :
 534       <ul>
 535           <li><strong>Nonfatal=Override</strong> rend les directives
 536           interdite par AllowOverride non fatales.</li>
 537           <li><strong>Nonfatal=Unknown</strong> rend les directives
 538           inconnues non fatales. Sont concernées les erreurs de frappe
 539           et les directives implémentées par un module non chargé.</li>
 540           <li><strong>Nonfatal=All</strong> rend toutes les directives
 541           précédentes non fatales.</li>
 542       </ul>
 543       <p>Notez qu'une erreur de syntaxe dans une directive valide
 544       causera toujours une Internal Server Error.</p>
 545       <div class="warning"><h3>Sécurité</h3>
 546           Les erreurs non fatales peuvent être à l'origine de problèmes
 547           de sécurité pour les utilisateurs de fichiers .htaccess. Par
 548           exemple, si AllowOverride interdit AuthConfig, toute
 549           configuration utilisateur destinée à restreindre l'accès à un
 550           site ne sera pas prise en compte.
 551       </div>
 552       </dd>
 553
 554       <dt><a href="overrides.html#override-options">Options</a>[=<var>Option</var>,...]</dt>
 555
 556       <dd>
 557       Permet l'utilisation des directives contrôlant les fonctionnalités
 558       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
 559       suivi d'un signe "égal", puis d'une liste d'options séparées par des
 560       virgules (pas d'espaces) ; ces options doivent être définies à
 561       l'aide de la commande <code class="directive"><a href="#options">Options</a></code>.
 562
 563       <div class="note"><h3>Désactivation implicite des options</h3>
 564       <p>Bien que la liste des options disponibles dans les fichiers
 565       .htaccess puisse être limitée par cette directive, tant qu'un
 566       directive <code class="directive"><a href="#options">Options</a></code> est
 567       autorisée, toute autre option héritée peut être désactivée en
 568       utilisant la syntaxe non-relative. En d'autres termes, ce
 569       mécanisme ne peut pas forcer une option spécifique à rester
 570       <em>activée</em> tout en permettant à toute autre option d'être
 571       activée.
 572       </p></div>
 573
 574       <div class="example"><p><code>
 575       AllowOverride Options=Indexes,MultiViews
 576       </code></p></div>
 577
 578       </dd>
 579     </dl>
 580
 581     <p>Exemple :</p>
 582
 583     <pre class="prettyprint lang-config">AllowOverride AuthConfig Indexes</pre>
 584
 585
 586     <p>Dans l'exemple ci-dessus, toutes les directives qui ne font
 587     partie ni du groupe <code>AuthConfig</code>, ni du groupe
 588     <code>Indexes</code>, provoquent une erreur "Internal
 589     Server Error".</p>
 590
 591     <div class="note"><p>Pour des raisons de sécurité et de performance, ne
 592     définissez pas <code>AllowOverride</code> à autre chose que
 593     <code>None</code> dans votre bloc <code>&lt;Directory "/"&gt;</code>.
 594     Recherchez plutôt (ou créez) le bloc <code>&lt;Directory&gt;</code>
 595     qui se réfère au répertoire où vous allez précisément placer un
 596     fichier <code>.htaccess</code>.</p>
 597     </div>
 598
 599 <h3>Voir aussi</h3>
 600 <ul>
 601 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
 602 <li><code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code></li>
 603 <li><a href="../configuring.html">Fichiers de configuration</a></li>
 604 <li><a href="../howto/htaccess.html">Fichiers .htaccess</a></li>
 605 <li><a href="overrides.html">Index de la class Override pour .htaccess</a></li>
 606 </ul>
 607 </div>
 608 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 609 <div class="directive-section"><h2><a name="allowoverridelist" id="allowoverridelist">Directive</a> <a name="AllowOverrideList" id="AllowOverrideList">AllowOverrideList</a> <a title="Lien permanent" href="#allowoverridelist" class="permalink">&para;</a></h2>
 610 <table class="directive">
 611 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directives autorisées dans les fichiers <code>.htaccess</code></td></tr>
 612 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowOverrideList None|<var>directive</var>
 613 [<var>directive-type</var>] ...</code></td></tr>
 614 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowOverrideList None</code></td></tr>
 615 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 616 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 617 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 618 </table>
 619     <p>Lorsque le serveur trouve un fichier <code>.htaccess</code>
 620     (comme spécifié par la directive <code class="directive"><a href="#accessfilename">AccessFileName</a></code>), il doit savoir lesquelles
 621     des directives déclarées dans ce fichier peuvent remplacer des
 622     directives des fichiers de configuration du serveur.</p>
 623
 624     <div class="note"><h3>Seulement disponible dans les sections &lt;Directory&gt;</h3>
 625     La directive <code class="directive">AllowOverrideList</code> n'est
 626     disponible que dans les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> spécifiées sans expressions
 627     rationnelles.
 628     </div>
 629
 630     <p>Lorsque cette directive et la directive <code class="directive"><a href="#allowoverride">AllowOverride</a></code> sont définies à
 631     <code>None</code>, les fichiers <a href="#accessfilename">.htaccess</a> sont totalement ignorés. Dans
 632     ce cas, le serveur ne cherchera même pas à lire des fichiers
 633     <code>.htaccess</code> dans le système de fichiers.</p>
 634
 635     <p>Example:</p>
 636
 637     <pre class="prettyprint lang-config">AllowOverride None
 638 AllowOverrideList Redirect RedirectMatch</pre>
 639
 640
 641     <p>Dans l'exemple ci-dessus, seules les directives
 642     <code>Redirect</code> et <code>RedirectMatch</code> sont autorisées.
 643     Toutes les autres provoqueront une erreur interne du serveur.</p>
 644
 645     <p>Example:</p>
 646
 647     <pre class="prettyprint lang-config">AllowOverride AuthConfig
 648 AllowOverrideList CookieTracking CookieName</pre>
 649
 650
 651     <p>Dans l'exemple ci-dessus, la directive <code class="directive"><a href="#allowoverride">AllowOverride</a></code> autorise les directives du
 652     groupement <code>AuthConfig</code>, et
 653     <code class="directive">AllowOverrideList</code> n'autorise que deux
 654     directives du groupement <code>FileInfo</code>. Toutes les autres
 655     provoqueront une erreur interne du serveur.</p>
 656
 657 <h3>Voir aussi</h3>
 658 <ul>
 659 <li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
 660 <li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
 661 <li><a href="../configuring.html">Fichiers de configuration</a></li>
 662 <li><a href="../howto/htaccess.html">Fichiers .htaccess</a></li>
 663 </ul>
 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="asyncfilter" id="asyncfilter">Directive</a> <a name="AsyncFilter" id="AsyncFilter">AsyncFilter</a> <a title="Lien permanent" href="#asyncfilter" class="permalink">&para;</a></h2>
 667 <table class="directive">
 668 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le type de filtrage minimal disponible pour le
 669     traitement asynchrone</td></tr>
 670 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AsyncFilter request|connection|network</code></td></tr>
 671 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AsyncFilter request</code></td></tr>
 672 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
 673 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 674 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 675 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.5.0 du serveur
 676     HTTP Apache</td></tr>
 677 </table>
 678         <p>Cette directive permet de définir les niveaux minimaux de
 679         filtrage disponibles pour le traitement asynchrone. Son
 680         utilisation s'avère nécessaire pour le support des filtres
 681         externes anciens qui ne géraient pas les meta-conteneurs
 682         correctement.</p>
 683
 684         <p>Si elle est définie à "network", le traitement asynchrone se
 685         limitera aux filtrages réseau. Si elle est définie à
 686         "connection", tous les filtres de réseau et de connexion seront
 687         disponibles pour le traitement asynchrone, y compris
 688         <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>. Si elle est définie à  "request", tous
 689         les filtres seront disponibles pour le traitement asynchrone.</p>
 690
 691 </div>
 692 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 693 <div class="directive-section"><h2><a name="cgimapextension" id="cgimapextension">Directive</a> <a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a title="Lien permanent" href="#cgimapextension" class="permalink">&para;</a></h2>
 694 <table class="directive">
 695 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique permettant de localiser l'interpréteur des
 696 scripts CGI</td></tr>
 697 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIMapExtension <var>chemin CGI</var> <var>.extension</var></code></td></tr>
 698 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
 699 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
 700 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 701 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 702 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>NetWare uniquement</td></tr>
 703 </table>
 704     <p>Cette directive permet de contrôler la manière dont Apache httpd trouve
 705     l'interpréteur servant à exécuter les scripts CGI. Par exemple, avec
 706     la définition <code>CGIMapExtension sys:\foo.nlm .foo</code>, tous
 707     les fichiers scripts CGI possédant une extension <code>.foo</code>
 708     seront passés à l'interpréteur FOO.</p>
 709
 710 </div>
 711 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 712 <div class="directive-section"><h2><a name="cgipassauth" id="cgipassauth">Directive</a> <a name="CGIPassAuth" id="CGIPassAuth">CGIPassAuth</a> <a title="Lien permanent" href="#cgipassauth" class="permalink">&para;</a></h2>
 713 <table class="directive">
 714 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la transmission d'en-têtes d'autorisation HTTP aux scripts en
 715 tant que variables CGI</td></tr>
 716 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIPassAuth On|Off</code></td></tr>
 717 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CGIPassAuth Off</code></td></tr>
 718 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
 719 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>AuthConfig</td></tr>
 720 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 721 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 722 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.13 du serveur HTTP
 723 Apache</td></tr>
 724 </table>
 725     <p>La directive <code class="directive">CGIPassAuth</code> permet aux
 726     scripts d'accéder aux en-têtes d'autorisation HTTP tels que
 727     <code>Authorization</code>, en-tête nécessaire aux scripts qui
 728     implémente une authentification HTTP de base. Normalement, ces
 729     en-têtes HTTP sont invisibles pour les scripts car ils leurs
 730     permettraient de voir les identifiants et mots de passe
 731     utilisés pour accéder au serveur lorsque l'authentification HTTP de
 732     base est activée au niveau du serveur web. Cette directive doit être
 733     définie à "On" lorsque des scripts sont autorisés à implémenter une
 734     authentification HTTP de base.</p>
 735
 736     <p>Cette directive constitue une alternative à l'option de
 737     compilation <code>SECURITY_HOLE_PASS_AUTHORIZATION</code> qui était
 738     déjà disponible dans les versions précédentes du serveur HTTP
 739     Apache.</p>
 740
 741     <p>Cette option est prise en compte par tout module qui utilise
 742     <code>ap_add_common_vars()</code>, comme <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>,
 743     <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code>, <code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>,
 744     <code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code>, etc... En particulier, elle affecte
 745     les modules qui ne traitent pas à proprement parler les requêtes,
 746     mais utilisent quand-même cette API, comme
 747     <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> ou <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>. Les
 748     modules tiers qui n'utilisent pas <code>ap_add_common_vars()</code>
 749     peuvent aussi choisir de prendre en compte cette option.</p>
 750
 751 </div>
 752 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 753 <div class="directive-section"><h2><a name="cgivar" id="cgivar">Directive</a> <a name="CGIVar" id="CGIVar">CGIVar</a> <a title="Lien permanent" href="#cgivar" class="permalink">&para;</a></h2>
 754 <table class="directive">
 755 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contrôle la manière dont certaines variables CGI sont définies</td></tr>
 756 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIVar <var>variable</var> <var>rule</var></code></td></tr>
 757 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
 758 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
 759 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 760 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 761 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.21 du serveur HTTP Apache</td></tr>
 762 </table>
 763   <p>Cette directive permet de contrôler la manière dont certaines variables CGI
 764   sont définies.</p>
 765
 766   <p>règles <strong>REQUEST_URI</strong> :</p>
 767   <dl>
 768     <dt><code>original-uri</code> (valeur par défaut)</dt>
 769     <dd>La valeur est extraite de la requête originale, et ne tient pas compte
 770     des redirections internes ou des sous-requêtes qui pourraient modifier la
 771     ressource demandée.</dd>
 772     <dt><code>current-uri</code></dt>
 773     <dd>La valeur reflète la ressource en cours de traitement ; elle peut être
 774     différente de la ressource demandée dans la requête initiale du client suite à
 775     d'éventuelles redirections internes ou sous-requêtes.</dd>
 776   </dl>
 777
 778 </div>
 779 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 780 <div class="directive-section"><h2><a name="contentdigest" id="contentdigest">Directive</a> <a name="ContentDigest" id="ContentDigest">ContentDigest</a> <a title="Lien permanent" href="#contentdigest" class="permalink">&para;</a></h2>
 781 <table class="directive">
 782 <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>
 783 dans la réponse HTTP</td></tr>
 784 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ContentDigest On|Off</code></td></tr>
 785 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ContentDigest Off</code></td></tr>
 786 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
 787 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>Options</td></tr>
 788 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 789 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 790 </table>
 791     <p>Cette directive active la génération d'un en-tête
 792     <code>Content-MD5</code> selon les définitions des RFC 1864 et
 793     2616.</p>
 794
 795     <p>MD5 est un algorithme permettant de générer un condensé (parfois
 796     appelé "empreinte") à partir de données d'une taille aléatoire ; le
 797     degré de précision est tel que la moindre altération des données
 798     d'origine entraîne une altération de l'empreinte.</p>
 799
 800     <p>L'en-tête <code>Content-MD5</code> permet de vérifier
 801     l'intégrité de la réponse HTTP dans son ensemble. Un serveur mandataire
 802     ou un client peut utiliser cet en-tête pour rechercher une
 803     éventuelle modification accidentelle de la réponse au cours de sa
 804     transmission. Exemple d'en-tête :</p>
 805
 806     <div class="example"><p><code>
 807       Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
 808     </code></p></div>
 809
 810     <p>Notez que des problèmes de performances peuvent affecter votre
 811     serveur, car l'empreinte est générée pour chaque requête (il n'y a
 812     pas de mise en cache).</p>
 813
 814     <p>L'en-tête <code>Content-MD5</code> n'est envoyé qu'avec les
 815     documents servis par le module <code class="module"><a href="../mod/core.html">core</a></code>, à l'exclusion
 816     de tout autre module. Ainsi, les documents SSI, les sorties de
 817     scripts CGI, et les réponses à des requêtes partielles (byte range)
 818     ne comportent pas cet en-tête.</p>
 819
 820 </div>
 821 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 822 <div class="directive-section"><h2><a name="defaultruntimedir" id="defaultruntimedir">Directive</a> <a name="DefaultRuntimeDir" id="DefaultRuntimeDir">DefaultRuntimeDir</a> <a title="Lien permanent" href="#defaultruntimedir" class="permalink">&para;</a></h2>
 823 <table class="directive">
 824 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire de base des fichiers créés au cours de l'exécution du serveur</td></tr>
 825 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultRuntimeDir <var>chemin-répertoire</var></code></td></tr>
 826 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/)</code></td></tr>
 827 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
 828 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 829 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 830 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis de la version 2.4.2 du serveur HTTP
 831 Apache</td></tr>
 832 </table>
 833     <p>La directive <code class="directive">DefaultRuntimeDir</code> permet de
 834     définir le répertoire dans lequel le serveur va créer les différents
 835     fichiers relatifs à son exécution (mémoire partagée, verrous,
 836     etc...). Si le chemin spécifié est relatif, le chemin absolu sera
 837     généré relativement à la valeur de la directive
 838     <code class="directive">ServerRoot</code>.</p>
 839
 840     <p><strong>Example</strong></p>
 841    <pre class="prettyprint lang-config">DefaultRuntimeDir scratch/</pre>
 842
 843
 844     <p>La valeur par défaut de la directive
 845     <code class="directive">DefaultRuntimeDir</code> peut être modifiée en
 846     changeant la valeur de la macro <code>DEFAULT_REL_RUNTIMEDIR</code>
 847     définie à la compilation.</p>
 848
 849    <p>Note: si la valeur de <code class="directive">ServerRoot</code> n'a pas
 850    été spécifiée avant d'utiliser cette directive, c'est la valeur par
 851    défaut de <code class="directive">ServerRoot</code> qui sera utilisée pour
 852    définir la base du répertoire.</p>
 853
 854
 855 <h3>Voir aussi</h3>
 856 <ul>
 857 <li>Voir les <a href="../misc/security_tips.html#serverroot">conseils à propos de
 858 sésurité</a> pour plus d'informations en vue de définir correctement les
 859 permissions sur la racine du serveur <code class="directive">ServerRoot</code></li>
 860 </ul>
 861 </div>
 862 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 863 <div class="directive-section"><h2><a name="defaultstatedir" id="defaultstatedir">Directive</a> <a name="DefaultStateDir" id="DefaultStateDir">DefaultStateDir</a> <a title="Lien permanent" href="#defaultstatedir" class="permalink">&para;</a></h2>
 864 <table class="directive">
 865 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire racine des fichiers d'état persistants</td></tr>
 866 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultStateDir <var>directory-path</var></code></td></tr>
 867 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DefaultRuntimeDir DEFAULT_REL_STATEDIR (state/)</code></td></tr>
 868 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
 869 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 870 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 871 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.5.1. du serveur HTTP Apache.</td></tr>
 872 </table>
 873     <p>La directive <code class="directive">DefaultStateDir</code> permet de définir le
 874     répertoire dans lequel le serveur va créer divers fichiers d'état
 875     persistants (bases de données, caches de longue durée, etc...). Si elle est
 876     définie avec un chemin relatif, ce dernier sera accolé à la valeur de la
 877     directive <code class="directive">ServerRoot</code>.</p>
 878
 879     <p><strong>Exemple</strong></p>
 880    <pre class="prettyprint lang-config">DefaultStateDir state/</pre>
 881
 882
 883     <p>La valeur par défaut de <code class="directive">DefaultStateDir</code> peut être
 884     modifiée en changeant la valeur de <code>DEFAULT_REL_STATEDIR</code>
 885     #définie à la compilation.</p>
 886
 887    <p>Note: si la valeur de <code class="directive">ServerRoot</code> n'a pas
 888    été spécifiée avant d'utiliser cette directive, c'est la valeur par
 889    défaut de <code class="directive">ServerRoot</code> qui sera utilisée pour
 890    définir la base du répertoire.</p>
 891
 892
 893 <h3>Voir aussi</h3>
 894 <ul>
 895 <li>Voir les <a href="../misc/security_tips.html#serverroot">conseils à propos de
 896 sésurité</a> pour plus d'informations en vue de définir correctement les
 897 permissions sur la racine du serveur <code class="directive">ServerRoot</code></li>
 898 </ul>
 899 </div>
 900 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 901 <div class="directive-section"><h2><a name="defaulttype" id="defaulttype">Directive</a> <a name="DefaultType" id="DefaultType">DefaultType</a> <a title="Lien permanent" href="#defaulttype" class="permalink">&para;</a></h2>
 902 <table class="directive">
 903 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les seuls effets de cette directive sont des émissions
 904 d'avertissements si sa valeur est différente de <code>none</code>. Dans
 905 les versions précédentes, DefaultType permettait de spécifier un type de
 906 média à assigner par défaut au contenu d'une réponse pour lequel aucun
 907 autre type de média n'avait été trouvé.
 908 </td></tr>
 909 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultType <var>type média|none</var></code></td></tr>
 910 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DefaultType none</code></td></tr>
 911 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
 912 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
 913 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 914 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 915 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Tous les arguments, excepté <code>none</code>, sont
 916 DESACTIVÉS à partir de la version 2.3.0.</td></tr>
 917 </table>
 918     <p>Cette directive a été désactivée. Pour la compatibilité
 919     ascendante avec les anciens fichiers de configuration, elle peut
 920     être spécifiée avec la valeur <code>none</code>, c'est à dire sans
 921     type de médium par défaut. Par exemple :</p>
 922
 923     <pre class="prettyprint lang-config">DefaultType None</pre>
 924
 925
 926     <p><code>DefaultType None</code> n'est disponible que dans les
 927     versions d'Apache 2.2.7 et supérieures.</p>
 928
 929     <p>Utilisez le fichier de configuration mime.types et la directive
 930     <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code> pour configurer
 931     l'assignement d'un type de médium via les extensions de fichiers, ou
 932     la directive <code class="directive"><a href="#forcetype">ForceType</a></code> pour
 933     attribuer un type de médium à des ressources spécifiques. Dans le
 934     cas contraire, le serveur enverra sa réponse sans champ d'en-tête
 935     Content-Type, et le destinataire devra déterminer lui-même le type
 936     de médium.</p>
 937
 938 <h3>Voir aussi</h3>
 939 <ul>
 940 <li><code class="directive"><a href="#undefine">UnDefine</a></code></li>
 941 <li><code class="directive"><a href="#ifdefine">IfDefine</a></code></li>
 942 </ul>
 943 </div>
 944 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 945 <div class="directive-section"><h2><a name="define" id="define">Directive</a> <a name="Define" id="Define">Define</a> <a title="Lien permanent" href="#define" class="permalink">&para;</a></h2>
 946 <table class="directive">
 947 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de définir une variable</td></tr>
 948 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Define <var>nom-paramètre</var> [<var>valeur-paramètre</var>]</code></td></tr>
 949 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
 950 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 951 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 952 </table>
 953     <p>Avec un seul paramètre, l'effet de la directive
 954     <code class="directive">Define</code> est identique à celui de l'argument
 955     <code>-D</code> du programme <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Il permet de
 956     modifier le comportement des sections <code class="directive"><a href="#ifdefine">&lt;IfDefine&gt;</a></code> sans avoir à ajouter d'argument
 957     <code>-D</code> au sein des scripts de démarrage.</p>
 958
 959     <p>De plus, le second paramètre permet d'affecter une valeur à la
 960     variable définie par le premier. Cette variable peut être référencée
 961     dans le fichier de configuration via la syntaxe <code>${VAR}</code>.
 962     La portée de la variable est toujours globale, et n'est jamais
 963     limitée à la section de configuration courante.</p>
 964
 965     <pre class="prettyprint lang-config">&lt;IfDefine TEST&gt;
 966   Define servername test.example.com
 967 &lt;/IfDefine&gt;
 968 &lt;IfDefine !TEST&gt;
 969   Define servername www.example.com
 970   Define SSL
 971 &lt;/IfDefine&gt;
 972
 973     DocumentRoot "/var/www/${servername}/htdocs"</pre>
 974
 975
 976     <p>Le caractère ":" est interdit dans les noms de variables afin
 977     d'éviter les conflits avec la syntaxe de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p>
 978
 979     <div class="note"><h3>Portée de la directive et pièges à éviter</h3>
 980     <p>Si cette directive est définie au sein d'un bloc VirtualHost, les
 981     changements qu'elle induit sont visibles de toute directive
 982     ultérieure, au delà de tout bloc VirtualHost.</p>
 983     </div>
 984
 985 </div>
 986 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 987 <div class="directive-section"><h2><a name="directory" id="directory">Directive</a> <a name="Directory" id="Directory">&lt;Directory&gt;</a> <a title="Lien permanent" href="#directory" class="permalink">&para;</a></h2>
 988 <table class="directive">
 989 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe un ensemble de directives qui ne s'appliquent
 990 qu'au répertoire concerné du système de fichiers, à ses
 991 sous-répertoires, et à leur contenu.</td></tr>
 992 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Directory <var>chemin répertoire</var>&gt;
 993 ... &lt;/Directory&gt;</code></td></tr>
 994 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
 995 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
 996 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
 997 </table>
 998     <p>Les balises <code class="directive">&lt;Directory&gt;</code> et
 999     <code>&lt;/Directory&gt;</code> permettent de regrouper un ensemble
1000     de directives qui ne s'appliquent qu'au répertoire précisé,
1001     à ses sous-répertoires, et aux fichiers situés dans ces
1002     sous-répertoires. Toute directive
1003     autorisée dans un contexte de répertoire peut être utilisée.
1004     <var>chemin répertoire</var> est soit le chemin absolu d'un
1005     répertoire, soit une chaîne de caractères avec caractères génériques
1006     utilisant la comparaison Unix de style shell. Dans une chaîne de
1007     caractères avec caractères génériques, <code>?</code> correspond à
1008     un caractère quelconque, et <code>*</code> à toute chaîne de
1009     caractères. Les intervalles de caractères <code>[]</code> sont aussi
1010     autorisés. Aucun caractère générique ne peut remplacer le caractère
1011     `/', si bien que l'expression <code>&lt;Directory
1012     "/*/public_html"&gt;</code> ne conviendra pas pour le chemin
1013      * <code>/home/user/public_html</code>, alors que <code>&lt;Directory
1014     "/home/*/public_html"&gt;</code> conviendra. Exemple :</p>
1015
1016     <pre class="prettyprint lang-config">&lt;Directory "/usr/local/httpd/htdocs"&gt;
1017   Options Indexes FollowSymLinks
1018 &lt;/Directory&gt;</pre>
1019
1020
1021     <p>Les chemins de répertoires contenant des espaces <em>doivent</em> être
1022     entourés de guillemets afin d'empêcher l'interprétation de ces
1023     espaces comme fins d'arguments.</p>
1024
1025     <div class="note">
1026       <p>Soyez prudent avec l'argument <var>chemin répertoire</var> : il
1027       doit correspondre exactement au chemin du système de fichier
1028       qu'Apache httpd utilise pour accéder aux fichiers. Les directives
1029       comprises dans une section <code>&lt;Directory&gt;</code> ne
1030       s'appliqueront pas aux fichiers du même répertoire auxquels on
1031       aura accédé via un chemin différent, per exemple via un lien
1032       symbolique.</p>
1033     </div>
1034
1035     <p> Les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a>
1036     peuvent aussi être utilisées en ajoutant le caractère
1037     <code>~</code>. Par exemple :</p>
1038
1039     <pre class="prettyprint lang-config">&lt;Directory ~ "^/www/[0-9]{3}"&gt;
1040
1041 &lt;/Directory&gt;</pre>
1042
1043
1044     <p>pourra correspondre à tout répertoire situé dans /www/ et dont le
1045     nom se compose de trois chiffres.</p>
1046
1047     <p>Si plusieurs sections <code class="directive">&lt;Directory&gt;</code> (sans expression rationnelle)
1048     correspondent au répertoire (ou à un de ses parents) qui contient le
1049     document, les directives de la section <code class="directive">&lt;Directory&gt;</code> dont le chemin est le plus
1050     court sont appliquées en premier, en s'intercalant avec les
1051     directives des fichiers <a href="#accessfilename">.htaccess</a>. Par
1052     exemple, avec</p>
1053
1054     <pre class="prettyprint lang-config">&lt;Directory "/"&gt;
1055   AllowOverride None
1056 &lt;/Directory&gt;
1057
1058 &lt;Directory "/home"&gt;
1059   AllowOverride FileInfo
1060 &lt;/Directory&gt;</pre>
1061
1062
1063     <p>l'accès au document <code>/home/web/dir/doc.html</code> emprunte
1064     le chemin suivant :</p>
1065
1066     <ul>
1067       <li>Aplication de la directive <code>AllowOverride None</code>
1068       (qui désactive les fichiers <code>.htaccess</code>).</li>
1069
1070       <li>Application de la directive <code>AllowOverride
1071       FileInfo</code> (pour le répertoire <code>/home</code>).</li>
1072
1073       <li>Application de toute directive <code>FileInfo</code> qui se
1074       trouverait dans d'éventuels fichiers <code>/home/.htaccess</code>,
1075       <code>/home/web/.htaccess</code> ou
1076       <code>/home/web/dir/.htaccess</code>, dans cet ordre.</li>
1077     </ul>
1078
1079     <p>Les directives associées aux répertoires sous forme d'expressions
1080     rationnelles ne sont prises en compte qu'une fois toutes les
1081     directives des sections sans expressions rationnelles appliquées.
1082     Alors, tous les répertoires avec expressions rationnelles sont
1083     testés selon l'ordre dans lequel ils apparaissent dans le fichier de
1084     configuration. Par exemple, avec</p>
1085
1086     <pre class="prettyprint lang-config">&lt;Directory ~ "abc$"&gt;
1087   # ... directives ici ...
1088 &lt;/Directory&gt;</pre>
1089
1090
1091     <p>la section avec expression rationnelle ne sera prise en compte
1092     qu'après les sections <code class="directive">&lt;Directory&gt;</code> sans expression rationnelle
1093     et les fichiers <code>.htaccess</code>. Alors, l'expression
1094     rationnelle conviendra pour <code>/home/abc/public_html/abc</code>
1095     et la section <code class="directive">&lt;Directory&gt;</code>
1096     correspondante s'appliquera.</p>
1097
1098    <p><strong>Notez que la politique d'accès par défaut
1099    dans les sections <code>&lt;Directory "/"&gt;</code> consiste à
1100    autoriser tout accès sans restriction. Ceci signifie qu'Apache httpd va servir tout fichier
1101    correspondant à une URL. Il est recommandé de modifier cette
1102    situation à l'aide d'un bloc du style</strong></p>
1103
1104     <pre class="prettyprint lang-config">&lt;Directory "/"&gt;
1105   Require all denied
1106 &lt;/Directory&gt;</pre>
1107
1108
1109     <p><strong>puis d'affiner la configuration pour les répertoires que vous
1110     voulez rendre accessibles. Voir la page <a href="../misc/security_tips.html">Conseils à propos de sécurité</a>
1111     pour plus de détails.</strong></p>
1112
1113     <p>Les sections <code class="directive">&lt;Directory&gt;</code> se situent
1114     dans le fichier <code>httpd.conf</code>. Les directives <code class="directive">&lt;Directory&gt;</code> ne peuvent pas être imbriquées
1115     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>
1116
1117 <h3>Voir aussi</h3>
1118 <ul>
1119 <li><a href="../sections.html">Comment fonctionnent les sections
1120 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour des
1121 explications à propos de la manière dont ces différentes sections se
1122 combinent entre elles à la réception d'une requête</li>
1123 </ul>
1124 </div>
1125 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1126 <div class="directive-section"><h2><a name="directorymatch" id="directorymatch">Directive</a> <a name="DirectoryMatch" id="DirectoryMatch">&lt;DirectoryMatch&gt;</a> <a title="Lien permanent" href="#directorymatch" class="permalink">&para;</a></h2>
1127 <table class="directive">
1128 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives qui s'appliquent au contenu de répertoires
1129 du système de fichiers correspondant à une expression rationnelle</td></tr>
1130 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;DirectoryMatch <var>regex</var>&gt;
1131 ... &lt;/DirectoryMatch&gt;</code></td></tr>
1132 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
1133 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1134 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1135 </table>
1136     <p>Les balises <code class="directive">&lt;DirectoryMatch&gt;</code>
1137     et <code>&lt;/DirectoryMatch&gt;</code> permettent de regrouper un
1138     ensemble de directives qui ne s'appliqueront qu'au répertoire
1139     précisé (et aux fichiers qu'il contient), comme pour la section <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>. Cependant, le
1140     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>
1141
1142     <pre class="prettyprint lang-config">&lt;DirectoryMatch "^/www/(.+/)?[0-9]{3}/"&gt;
1143     # ...
1144 &lt;/DirectoryMatch&gt;</pre>
1145
1146
1147     <p>convient pour les sous-répertoires de <code>/www/</code> dont
1148     le nom se compose de trois chiffres.</p>
1149
1150     <div class="note"><h3>Compatibilité</h3>
1151       Avant la version 2.3.9, cette directive s'appliquait aussi aux
1152       sous-répertoires (comme la directive <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>), et ne tenait pas compte du
1153       symbole de fin de ligne ($). Depuis la version 2.3.9, seuls les
1154       répertoires qui correspondent à l'expression sont affectés par les
1155       directives contenues dans la section.
1156     </div>
1157
1158     <div class="note"><h3>slash de fin</h3>
1159       Cette directive s'applique aux requêtes pour des répertoires avec
1160       ou sans slash de fin ; les expressions contenant un symbole de fin
1161       de ligne ($) doivent donc faire l'objet d'une attention
1162       particulière.
1163     </div>
1164
1165     <p>A partir de la version 2.4.8, les groupes nommés et les
1166     références arrières sont extraits et enregistrés dans
1167     l'environnement avec leur nom en majuscules et préfixé
1168     par "MATCH_". Ceci permet
1169     de référencer des URLs dans des <a href="../expr.html">expressions</a>
1170     ou au sein de modules comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Pour
1171     éviter toute confusion, les références arrières numérotées (non
1172     nommées) sont ignorées. Vous devez utiliser à la place des groupes
1173     nommés.</p>
1174
1175 <pre class="prettyprint lang-config">&lt;DirectoryMatch "^/var/www/combined/(?&lt;sitename&gt;[^/]+)"&gt;
1176     Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
1177 &lt;/DirectoryMatch&gt;</pre>
1178
1179
1180 <h3>Voir aussi</h3>
1181 <ul>
1182 <li><code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>
1183 pour une description de la manière dont les expressions rationnelles
1184 sont traitées en présence d'autres sections <code class="directive">&lt;Directory&gt;</code> sans expressions rationnelles</li>
1185 <li><a href="../sections.html">Comment fonctionnent les sections
1186 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
1187 explication à propos de la manière dont ces différentes sections se
1188 combinent entre elles à la réception d'une requête</li>
1189 </ul>
1190 </div>
1191 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1192 <div class="directive-section"><h2><a name="documentroot" id="documentroot">Directive</a> <a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a title="Lien permanent" href="#documentroot" class="permalink">&para;</a></h2>
1193 <table class="directive">
1194 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine principale de l'arborescence des documents visible
1195 depuis Internet</td></tr>
1196 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DocumentRoot <var>chemin répertoire</var></code></td></tr>
1197 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DocumentRoot "/usr/local/apache/htdocs"</code></td></tr>
1198 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
1199 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1200 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1201 </table>
1202     <p>Cette directive permet de définir le répertoire à partir duquel
1203     <code class="program"><a href="../programs/httpd.html">httpd</a></code> va servir les fichiers. S'il ne correspond
1204     pas à un <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, le chemin
1205     de l'URL sera ajouté par le serveur à la racine des documents afin
1206     de construire le chemin du document recherché. Exemple :</p>
1207
1208     <pre class="prettyprint lang-config">DocumentRoot "/usr/web"</pre>
1209
1210
1211     <p>un accès à <code>http://my.example.com/index.html</code> se
1212     réfère alors à <code>/usr/web/index.html</code>. Si <var>chemin
1213     répertoire</var> n'est pas un chemin absolu, il est considéré comme
1214     relatif au chemin défini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
1215
1216     <p>Le répertoire défini par la directive
1217     <code class="directive">DocumentRoot</code> ne doit pas comporter de slash
1218     final.</p>
1219
1220 <h3>Voir aussi</h3>
1221 <ul>
1222 <li><a href="../urlmapping.html#documentroot">Mise en
1223 correspondance des URLs avec le système de fichiers</a></li>
1224 </ul>
1225 </div>
1226 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1227 <div class="directive-section"><h2><a name="else" id="else">Directive</a> <a name="Else" id="Else">&lt;Else&gt;</a> <a title="Lien permanent" href="#else" class="permalink">&para;</a></h2>
1228 <table class="directive">
1229 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si la
1230 condition correspondant à la section <code class="directive"><a href="#if">&lt;If&gt;</a></code> ou <code class="directive"><a href="#elseif">&lt;ElseIf&gt;</a></code> précédente n'est pas satisfaite par la
1231 requête à l'exécution</td></tr>
1232 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Else&gt; ... &lt;/Else&gt;</code></td></tr>
1233 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
1234 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
1235 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1236 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1237 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les conditions imbriquées sont supportées à partir de la version
1238 2.4.26 du serveur HTTP Apache</td></tr>
1239 </table>
1240     <p>La section <code class="directive">&lt;Else&gt;</code> applique
1241     les directives qu'elle contient si et seulement si les conditions
1242     correspondant à la section <code class="directive">&lt;If&gt;</code>
1243     ou <code class="directive">&lt;ElseIf&gt;</code> immédiatement
1244     supérieure et dans la même portée n'ont pas été satisfaites. Par
1245     exemple, dans :</p>
1246
1247     <pre class="prettyprint lang-config">&lt;If "-z req('Host')"&gt;
1248   # ...
1249 &lt;/If&gt;
1250 &lt;Else&gt;
1251   # ...
1252 &lt;/Else&gt;</pre>
1253
1254
1255     <p>La condition de la section <code class="directive">&lt;If&gt;</code> serait satisfaite pour les requêtes
1256     HTTP/1.0 sans en-tête <var>Host:</var>, alors que celle de la section
1257     <code class="directive">&lt;Else&gt;</code> le serait pour les
1258     requêtes comportant un en-tête <var>Host:</var>.</p>
1259
1260
1261 <h3>Voir aussi</h3>
1262 <ul>
1263 <li><code class="directive"><a href="#if">&lt;If&gt;</a></code></li>
1264 <li><code class="directive"><a href="#elseif">&lt;ElseIf&gt;</a></code></li>
1265 <li><a href="../sections.html">Fonctionnement des sections &lt;Directory&gt;, &lt;Location&gt;,
1266     &lt;Files&gt;</a> pour une explication de la manière dont ces
1267     différentes section se combinent entre elles lorsqu'une requête est
1268     reçue. Les directives <code class="directive">&lt;If&gt;</code>,
1269     <code class="directive">&lt;ElseIf&gt;</code>, et <code class="directive">&lt;Else&gt;</code> s'appliquent en dernier.</li>
1270 </ul>
1271 </div>
1272 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1273 <div class="directive-section"><h2><a name="elseif" id="elseif">Directive</a> <a name="ElseIf" id="ElseIf">&lt;ElseIf&gt;</a> <a title="Lien permanent" href="#elseif" class="permalink">&para;</a></h2>
1274 <table class="directive">
1275 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si la
1276 condition correspondante est satisfaite par une requête à l'exécution,
1277 alors que la condition correspondant à la section <code class="directive"><a href="#if">&lt;If&gt;</a></code> ou <code class="directive">&lt;ElseIf&gt;</code> précédente ne l'était pas.</td></tr>
1278 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;ElseIf <var>expression</var>&gt; ... &lt;/ElseIf&gt;</code></td></tr>
1279 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
1280 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
1281 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1282 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1283 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les conditions imbriquées sont supportées à partir de la version
1284 2.4.26 du serveur HTTP Apache</td></tr>
1285 </table>
1286     <p>La section <code class="directive">&lt;ElseIf&gt;</code> applique
1287     les directives qu'elle contient si et seulement si d'une part la
1288     condition correspondante est satisfaite, et d'autre part la condition
1289     correspondant à la section <code class="directive">&lt;If&gt;</code>
1290     ou <code class="directive">&lt;ElseIf&gt;</code> de la même portée ne
1291     l'est pas. Par exemple, dans :</p>
1292
1293     <pre class="prettyprint lang-config">&lt;If "-R '10.1.0.0/16'"&gt;
1294   #...
1295 &lt;/If&gt;
1296 &lt;ElseIf "-R '10.0.0.0/8'"&gt;
1297   #...
1298 &lt;/ElseIf&gt;
1299 &lt;Else&gt;
1300   #...
1301 &lt;/Else&gt;</pre>
1302
1303
1304     <p>La condition correspondant à la section <code class="directive">&lt;ElseIf&gt;</code> est satisfaite si l'adresse
1305     distante de la requête appartient au sous-réseau 10.0.0.0/8, mais
1306     pas si elle appartient au sous-réseau 10.1.0.0/16.</p>
1307
1308
1309 <h3>Voir aussi</h3>
1310 <ul>
1311 <li><a href="../expr.html">Les expressions dans le serveur HTTP
1312 Apache</a>, pour une référence complète et d'autres exemples.</li>
1313 <li><code class="directive"><a href="#if">&lt;If&gt;</a></code></li>
1314 <li><code class="directive"><a href="#else">&lt;Else&gt;</a></code></li>
1315 <li><a href="../sections.html">Fonctionnement des sections &lt;Directory&gt;, &lt;Location&gt;,
1316     &lt;Files&gt;</a> pour une explication de la manière dont ces
1317     différentes section se combinent entre elles lorsqu'une requête est
1318     reçue. Les directives <code class="directive">&lt;If&gt;</code>,
1319     <code class="directive">&lt;ElseIf&gt;</code>, et <code class="directive">&lt;Else&gt;</code> s'appliquent en dernier.</li>
1320 </ul>
1321 </div>
1322 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1323 <div class="directive-section"><h2><a name="enablemmap" id="enablemmap">Directive</a> <a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a title="Lien permanent" href="#enablemmap" class="permalink">&para;</a></h2>
1324 <table class="directive">
1325 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise la projection en mémoire (Memory-Mapping) pour
1326 lire les fichiers pendant qu'ils sont servis</td></tr>
1327 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
1328 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>EnableMMAP On</code></td></tr>
1329 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
1330 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
1331 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1332 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1333 </table>
1334     <p>Cette directive définit si <code class="program"><a href="../programs/httpd.html">httpd</a></code> peut utiliser
1335     la projection en mémoire (Memory-Mapping) quand il doit lire le contenu
1336     d'un fichier pendant qu'il est servi. Par défaut, lorsque le
1337     traitement d'une requête requiert l'accès aux données contenues dans
1338     un fichier -- par exemple, pour servir un fichier interprété par le
1339     serveur à l'aide de <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> -- Apache httpd projette
1340     le fichier en mémoire si le système d'exploitation le permet.</p>
1341
1342     <p>Cette projection en mémoire induit parfois une amélioration des
1343     performances. Sur certains systèmes cependant, il est préférable de
1344     désactiver la projection en mémoire afin d'éviter certains problèmes
1345     opérationnels :</p>
1346
1347     <ul>
1348     <li>Sur certains systèmes multi-processeurs, la projection en
1349     mémoire peut dégrader les performances du programme
1350     <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</li>
1351     <li>S'il fait l'objet d'une projection en mémoire par
1352     <code class="program"><a href="../programs/httpd.html">httpd</a></code>, la suppression ou la troncature d'un
1353     fichier peut provoquer un crash de <code class="program"><a href="../programs/httpd.html">httpd</a></code> avec une
1354     erreur de segmentation.</li>
1355     </ul>
1356
1357     <p>Pour les configurations de serveur sujettes à ce genre de
1358     problème, il est préférable de désactiver la projection en mémoire
1359     des fichiers servis en spécifiant :</p>
1360
1361     <pre class="prettyprint lang-config">EnableMMAP Off</pre>
1362
1363
1364     <p>Pour les montages NFS, cette fonctionnalité peut être
1365     explicitement désactivée pour les fichiers concernés en spécifiant
1366     :</p>
1367
1368     <pre class="prettyprint lang-config">&lt;Directory "/path-to-nfs-files"&gt;
1369   EnableMMAP Off
1370 &lt;/Directory&gt;</pre>
1371
1372
1373 </div>
1374 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1375 <div class="directive-section"><h2><a name="enablesendfile" id="enablesendfile">Directive</a> <a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a title="Lien permanent" href="#enablesendfile" class="permalink">&para;</a></h2>
1376 <table class="directive">
1377 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise le support sendfile du noyau pour servir les
1378 fichiers aux clients</td></tr>
1379 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
1380 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>EnableSendfile Off</code></td></tr>
1381 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
1382 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
1383 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1384 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1385 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Par défaut à Off depuis la version 2.3.9.</td></tr>
1386 </table>
1387     <p>Cette directive définit si le programme <code class="program"><a href="../programs/httpd.html">httpd</a></code>
1388     peut utiliser le support sendfile du noyau pour transmettre le
1389     contenu des fichiers aux clients. Par défaut, lorsque le traitement
1390     d'une requête ne requiert pas l'accès aux données contenues dans un
1391     fichier -- par exemple, pour la transmission d'un fichier statique
1392     -- Apache httpd utilise sendfile pour transmettre le contenu du fichier
1393     sans même lire ce dernier, si le système d'exploitation le
1394     permet.</p>
1395
1396     <p>Ce mécanisme sendfile évite la séparation des opérations de
1397     lecture et d'envoi, ainsi que les réservations de tampons. sur
1398     certains systèmes cependant, ou sous certains systèmes de fichiers,
1399     il est préférable de désactiver cette fonctionnalité afin d'éviter
1400     certains problèmes opérationnels :</p>
1401
1402     <ul>
1403     <li>Certains systèmes peuvent présenter un support sendfile
1404     défectueux que le système de compilation n'a pas détecté, en
1405     particulier si les exécutables ont été compilés sur une autre
1406     machine, puis copiés sur la première avec un support sendfile
1407     défectueux.</li>
1408     <li>Sous Linux, l'utilisation de sendfile induit des bogues lors de
1409     la récupération des paquets de vérification TCP (TCP-checksum) avec
1410     certaines cartes réseau lorsqu'on utilise IPv6.</li>
1411     <li>Sous Linux sur Itanium, <code>sendfile</code> peut s'avérer incapable de
1412     traiter les fichiers de plus de 2 Go.</li>
1413     <li>Avec un montage réseau de <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (par exemple NFS, SMB, CIFS,
1414     FUSE), le
1415     noyau peut s'avérer incapable de servir un fichier de ce montage
1416     réseau en passant par son propre cache.</li>
1417     </ul>
1418
1419     <p>Pour les configurations de serveur non sujettes à ce genre de
1420     problème, vous pouvez activer cette fonctionnalité en
1421     spécifiant :</p>
1422
1423     <pre class="prettyprint lang-config">EnableSendfile On</pre>
1424
1425
1426     <p>Pour les montages réseau, cette fonctionnalité peut être
1427     explicitement désactivée pour les fichiers concernés en spécifiant
1428     :</p>
1429
1430     <pre class="prettyprint lang-config">&lt;Directory "/path-to-nfs-files"&gt;
1431   EnableSendfile Off
1432 &lt;/Directory&gt;</pre>
1433
1434     <p>Veuillez noter que la configuration de la directive
1435     <code class="directive">EnableSendfile</code> dans un contexte de répertoire
1436     ou de fichier .htaccess n'est pas supportée par
1437     <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>. Le module ne prend en compte la
1438     définition de <code class="directive">EnableSendfile</code> que dans un
1439     contexte global.
1440     </p>
1441
1442 </div>
1443 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1444 <div class="directive-section"><h2><a name="error" id="error">Directive</a> <a name="Error" id="Error">Error</a> <a title="Lien permanent" href="#error" class="permalink">&para;</a></h2>
1445 <table class="directive">
1446 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interrompt la lecture de la configuration avec un message
1447 d'erreur personnalisé</td></tr>
1448 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Error <var>message</var></code></td></tr>
1449 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
1450 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
1451 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1452 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1453 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>à partir de la version 2.3.9</td></tr>
1454 </table>
1455     <p>Si une erreur peut être détectée dans la configuration, souvent
1456     un module manquant, cette
1457     directive peut être utilisée pour générer un message d'erreur
1458     personnalisé, et interrompre la lecture de la configuration. </p>
1459
1460     <pre class="prettyprint lang-config"># Exemple
1461 # vérification du chargement de mod_include
1462 &lt;IfModule !include_module&gt;
1463   Error "mod_include is required by mod_foo.  Load it with LoadModule."
1464 &lt;/IfModule&gt;
1465
1466 # vérification de la définition de SSL ou (exclusif) NOSSL
1467 &lt;IfDefine SSL&gt;
1468 &lt;IfDefine NOSSL&gt;
1469   Error "Both SSL and NOSSL are defined.  Define only one of them."
1470 &lt;/IfDefine&gt;
1471 &lt;/IfDefine&gt;
1472 &lt;IfDefine !SSL&gt;
1473 &lt;IfDefine !NOSSL&gt;
1474   Error "Either SSL or NOSSL must be defined."
1475 &lt;/IfDefine&gt;
1476 &lt;/IfDefine&gt;</pre>
1477
1478
1479
1480 </div>
1481 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1482 <div class="directive-section"><h2><a name="errordocument" id="errordocument">Directive</a> <a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a title="Lien permanent" href="#errordocument" class="permalink">&para;</a></h2>
1483 <table class="directive">
1484 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Document que le serveur renvoie au client en cas
1485 d'erreur</td></tr>
1486 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ErrorDocument <var>code erreur</var> <var>document</var></code></td></tr>
1487 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
1488 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
1489 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1490 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1491 </table>
1492     <p>Apache httpd peut traiter les problèmes et les erreurs de quatre
1493     manières,</p>
1494
1495     <ol>
1496       <li>afficher un simple message d'erreur au contenu fixe</li>
1497
1498       <li>afficher un message personnalisé</li>
1499
1500       <li>rediriger en interne vers un <var>chemin d'URL</var> local pour traiter
1501       le problème ou l'erreur</li>
1502
1503       <li>rediriger vers une <var>URL</var> externe pour traiter
1504       le problème ou l'erreur</li>
1505     </ol>
1506
1507     <p>La première option constitue le comportement par défaut; pour
1508     choisir une des trois autres options, il faut configurer Apache à
1509     l'aide de la directive <code class="directive">ErrorDocument</code>, suivie
1510     du code de la réponse HTTP et d'une URL ou d'un message. Apache
1511     httpd fournit parfois des informations supplémentaires à propos du
1512     problème ou de l'erreur.</p>
1513
1514     <p>A partir de la version 2.4.13, cette directive peut utiliser la
1515     <a href="../expr.html">syntaxe des expressions</a> pour générer des
1516     chaînes de caractères et des URLs dynamiques.</p>
1517
1518     <p>Les URLs peuvent commencer par un slash (/) pour les chemins web
1519     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
1520     forme d'une URL complète que le client pourra résoudre.
1521     Alternativement, un message à afficher par le navigateur pourra être
1522     fourni. Notez que la décision à propos de la nature du paramètre, à
1523     savoir une URL, un chemin ou un message, est prise avant
1524     l'interprétation de toute expression. Exemples :</p>
1525
1526     <pre class="prettyprint lang-config">ErrorDocument 500 http://example.com/cgi-bin/server-error.cgi
1527 ErrorDocument 404 /errors/bad_urls.php
1528 ErrorDocument 401 /subscription_info.html
1529 ErrorDocument 403 "Désolé, nous ne pouvons pas vous accorder l'accès aujourd'hui"
1530 ErrorDocument 403 Forbidden!
1531 ErrorDocument 403 /errors/forbidden.py?referrer=%{escape:%{HTTP_REFERER}}</pre>
1532
1533
1534     <p>De plus, on peut spécifier la valeur spéciale <code>default</code>
1535     pour indiquer l'utilisation d'un simple message d'Apache httpd codé en
1536     dur. Bien que non nécessaire dans des circonstances normales, la
1537     spécification de la valeur <code>default</code> va permettre de
1538     rétablir l'utilisation du simple message d'Apache httpd codé en dur pour
1539     les configurations qui sans cela, hériteraient d'une directive
1540     <code class="directive">ErrorDocument</code> existante.</p>
1541
1542     <pre class="prettyprint lang-config">ErrorDocument 404 /cgi-bin/bad_urls.pl
1543
1544 &lt;Directory "/web/docs"&gt;
1545   ErrorDocument 404 default
1546 &lt;/Directory&gt;</pre>
1547
1548
1549     <p>Notez que lorsque vous spécifiez une directive
1550     <code class="directive">ErrorDocument</code> pointant vers une URL distante
1551     (c'est à dire tout ce qui commence par le préfixe http), le serveur
1552     HTTP Apache va
1553     envoyer une redirection au client afin de lui indiquer où trouver le
1554     document, même dans le cas où ce document se trouve sur le serveur
1555     local. Ceci a de nombreuses conséquences dont la plus importante
1556     réside dans le fait que le client ne recevra pas le code d'erreur
1557     original, mais au contraire un code de statut de redirection. Ceci
1558     peut en retour semer la confusion chez les robots web et divers
1559     clients qui tentent de déterminer la validité d'une URL en examinant
1560     le code de statut. De plus, si vous utilisez une URL distante avec
1561     <code>ErrorDocument 401</code>, le client ne saura pas qu'il doit
1562     demander un mot de passe à l'utilisateur car il ne recevra pas le
1563     code de statut 401. C'est pourquoi, <strong>si vous utilisez une
1564     directive <code>ErrorDocument 401</code>, elle devra faire référence
1565     à un document par le biais d'un chemin local.</strong></p>
1566
1567     <p>Microsoft Internet Explorer (MSIE) ignore par défaut les messages
1568     d'erreur générés par le serveur lorsqu'ils sont trop courts et
1569     remplacent ses propres messages d'erreur "amicaux". Le seuil de
1570     taille varie en fonction du type d'erreur, mais en général, si la
1571     taille de votre message d'erreur est supérieure à 512 octets, il y a
1572     peu de chances pour que MSIE l'occulte, et il sera affiché par ce
1573     dernier. Vous trouverez d'avantage d'informations dans l'article de
1574     la base de connaissances Microsoft <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>
1575
1576     <p>Bien que la plupart des messages d'erreur internes originaux
1577     puissent être remplacés, ceux-ci sont cependant conservés dans
1578     certaines circonstances sans tenir compte de la définition de la
1579     directive <code class="directive"><a href="#errordocument">ErrorDocument</a></code>. En
1580     particulier, en cas de détection d'une requête mal formée, le
1581     processus de traitement normal des requêtes est immédiatement
1582     interrompu, et un message d'erreur interne est renvoyé, ceci afin de
1583     se prémunir contre les problèmes de sécurité liés aux requêtes mal
1584     formées.</p>
1585
1586     <p>Si vous utilisez mod_proxy, il est en général préférable
1587     d'activer <code class="directive"><a href="../mod/mod_proxy.html#proxyerroroverride">ProxyErrorOverride</a></code> afin d'être en
1588     mesure de produire des messages d'erreur personnalisés pour le
1589     compte de votre serveur d'origine. Si vous n'activez pas
1590     ProxyErrorOverride, Apache httpd ne générera pas de messages d'erreur
1591     personnalisés pour le contenu mandaté.</p>
1592
1593
1594 <h3>Voir aussi</h3>
1595 <ul>
1596 <li><a href="../custom-error.html">documentation sur la
1597 personnalisation des réponses</a></li>
1598 </ul>
1599 </div>
1600 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1601 <div class="directive-section"><h2><a name="errorlog" id="errorlog">Directive</a> <a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a title="Lien permanent" href="#errorlog" class="permalink">&para;</a></h2>
1602 <table class="directive">
1603 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définition du chemin du journal des erreurs</td></tr>
1604 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> ErrorLog <var>file-path</var>|syslog[:[<var>facility</var>][:<var>tag</var>]]</code></td></tr>
1605 <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>
1606 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
1607 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1608 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1609 </table>
1610     <p>La directive <code class="directive">ErrorLog</code> permet de définir le
1611     nom du fichier dans lequel le serveur va journaliser toutes les
1612     erreurs qu'il rencontre. Si le <var>file-path</var> n'est pas
1613     absolu, il est considéré comme relatif au chemin défini par la
1614     directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
1615
1616     <pre class="prettyprint lang-config">ErrorLog "/var/log/httpd/error_log"</pre>
1617
1618
1619     <p>Si le <var>file-path</var> commence par une barre verticale
1620     "<code>(|)</code>", il est considéré comme une commande à lancer pour traiter la
1621     journalisation de l'erreur.</p>
1622
1623     <pre class="prettyprint lang-config">ErrorLog "|/usr/local/bin/httpd_errors"</pre>
1624
1625
1626     <p>Voir les notes à propos des <a href="../logs.html#piped">journaux
1627     redirigés</a> pour plus d'informations.</p>
1628
1629     <p>L'utilisation de <code>syslog</code> à la place d'un nom de
1630     fichier active la journalisation via syslogd(8) si le système le
1631     supporte et si <code class="module"><a href="../mod/mod_syslog.html">mod_syslog</a></code> a été chargé. Le
1632     dispositif syslog par défaut est <code>local7</code>,
1633     mais vous pouvez le modifier à l'aide de la syntaxe
1634     <code>syslog:<var>facility</var></code>, où <var>facility</var> peut
1635     être remplacé par un des noms habituellement documentés dans la page
1636     de man syslog(1). Le dispositif syslog <code>local7</code> est
1637     global, et si il est modifié dans un serveur virtuel, le dispositif
1638     final spécifié affecte l'ensemble du serveur. La même règle s'applique au
1639     tag syslog qui utilise par défaut le nom du binaire du serveur HTTP Apache
1640     <code>httpd</code> dans la plupart des cas. Vous pouvez aussi modifier cette
1641     valeur en utilisant la syntaxe <code>syslog::<var>tag</var></code>.</p>
1642
1643     <pre class="prettyprint lang-config"> ErrorLog syslog:user
1644  ErrorLog syslog:user:httpd.srv1
1645 ErrorLog syslog::httpd.srv2</pre>
1646
1647
1648     <p>Des modules additionnels peuvent implémenter leur propre
1649     fournisseur ErrorLog. La syntaxe est similaire à l'exemple
1650     <code>syslog</code> ci-dessus.</p>
1651
1652     <p>SECURITE : Voir le document <a href="../misc/security_tips.html#serverroot">conseils à propos de
1653     sécurité</a> pour des détails sur les raisons pour lesquelles votre
1654     sécurité peut être compromise si le répertoire contenant les
1655     fichiers journaux présente des droits en écriture pour tout autre
1656     utilisateur que celui sous lequel le serveur est démarré.</p>
1657     <div class="warning"><h3>Note</h3>
1658       <p>Lors de la spécification d'un chemin de fichier sur les
1659       plates-formes non-Unix, on doit veiller à n'utiliser que des
1660       slashes (/), même si la plate-forme autorise l'utilisation des
1661       anti-slashes (\). Et d'une manière générale, il est recommandé de
1662       n'utiliser que des slashes (/) dans les fichiers de
1663       configuration.</p>
1664     </div>
1665
1666 <h3>Voir aussi</h3>
1667 <ul>
1668 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1669 <li><a href="../logs.html">Fichiers journaux du serveur HTTP Apache</a></li>
1670 </ul>
1671 </div>
1672 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1673 <div class="directive-section"><h2><a name="errorlogformat" id="errorlogformat">Directive</a> <a name="ErrorLogFormat" id="ErrorLogFormat">ErrorLogFormat</a> <a title="Lien permanent" href="#errorlogformat" class="permalink">&para;</a></h2>
1674 <table class="directive">
1675 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spécification du format des entrées du journal des erreurs</td></tr>
1676 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> ErrorLogFormat [connection|request] <var>format</var></code></td></tr>
1677 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
1678 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1679 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1680 </table>
1681     <p>La directive <code class="directive">ErrorLogFormat</code> permet de
1682     spécifier quelles informations supplémentaires vont être enregistrées
1683     dans le journal des erreurs en plus du message habituel.</p>
1684
1685     <pre class="prettyprint lang-config"># Exemple simple
1686 ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"</pre>
1687
1688
1689     <p>La spécification de <code>connection</code> ou
1690     <code>request</code> comme premier paramètre permet de définir des
1691     formats supplémentaires, ce qui a pour effet de journaliser des
1692     informations additionnelles lorsque le premier message est
1693     enregistré respectivement pour une connexion ou une requête
1694     spécifique. Ces informations additionnelles ne sont enregistrées
1695     qu'une seule fois par connexion/requête. Si le traitement d'une
1696     connexion ou d'une requête ne génère aucun message dans le journal,
1697     alors aucune information additionnelle n'est enregistrée.</p>
1698
1699     <p>Il peut arriver que certains items de la chaîne de format ne
1700     produisent aucune sortie. Par exemple, l'en-tête Referer n'est
1701     présent que si le message du journal est associé à une requête et s'il
1702     est généré à un moment où l'en-tête Referer a déjà été lu par le
1703     client. Si aucune sortie n'est générée, le comportement par défaut
1704     consiste à supprimer tout ce qui se trouve entre l'espace précédent
1705     et le suivant. Ceci implique que la ligne de journalisation est
1706     divisée en champs ne contenant pas d'espace séparés par des espaces.
1707     Si un item de la chaîne de format ne génère aucune sortie,
1708     l'ensemble du champ est omis. Par exemple, si l'adresse distante
1709     <code>%a</code> du format <code>[%t] [%l] [%a] %M&nbsp;</code> n'est
1710     pas disponible, les crochets qui l'entourent ne seront eux-mêmes pas
1711     enregistrés. Il est possible d'échapper les espaces par un anti-slash
1712     afin qu'ils ne soient pas considérés comme séparateurs de champs.
1713     La combinaison '%&nbsp;' (pourcentage espace) est un délimiteur de
1714     champ de taille nulle qui ne génère aucune sortie.</p>
1715
1716     <p>Ce comportement peut être changé en ajoutant des modificateurs à
1717     l'item de la chaîne de format. Le modificateur <code>-</code>
1718     (moins) provoque l'enregistrement d'un signe moins si l'item
1719     considéré ne génère aucune sortie. Pour les formats à enregistrement
1720     unique par connexion/requête, il est aussi possible d'utiliser le
1721     modificateur <code>+</code> (plus). Si un item ne générant aucune
1722     sortie possède le modificateur plus, la ligne dans son ensemble est
1723     omise.</p>
1724
1725     <p>Un modificateur de type entier permet d'assigner un niveau de
1726     sévérité à un item de format. L'item considéré ne
1727     sera journalisé que si la sévérité du message n'est pas
1728     plus haute que le niveau de sévérité spécifié. Les
1729     valeurs possibles vont de 1 (alert) à 15 (trace8), en passant par 4
1730     (warn) ou 7 (debug).</p>
1731
1732     <p>Par exemple, voici ce qui arriverait si vous ajoutiez des
1733     modificateurs à l'item <code>%{Referer}i</code> qui enregistre le
1734     contenu de l'en-tête <code>Referer</code>.</p>
1735
1736     <table class="bordered"><tr class="header"><th>Item modifié</th><th>Signification</th></tr>
1737 <tr>
1738     <td><code>%-{Referer}i</code></td>
1739     <td>Enregistre le caractère <code>-</code> si l'en-tête
1740     <code>Referer</code> n'est pas défini.</td>
1741     </tr>
1742 <tr class="odd">
1743     <td><code>%+{Referer}i</code></td>
1744     <td>N'enregistre rien si l'en-tête
1745     <code>Referer</code> n'est pas défini.</td>
1746     </tr>
1747 <tr>
1748     <td><code>%4{Referer}i</code></td>
1749     <td>N'enregistre le contenu de l'en-tête <code>Referer</code> que si
1750     la sévérité du message de journalisation est supérieure à 4.</td>
1751     </tr>
1752 </table>
1753
1754     <p>Certains items de format acceptent des paramètres supplémentaires
1755     entre accolades.</p>
1756
1757     <table class="bordered"><tr class="header"><th>Chaîne&nbsp;de&nbsp;format</th> <th>Description</th></tr>
1758 <tr><td><code>%%</code></td>
1759         <td>Le signe pourcentage</td></tr>
1760 <tr class="odd"><td><code>%a</code></td>
1761         <td>Adresse IP et port clients</td></tr>
1762 <tr><td><code>%{c}a</code></td>
1763         <td>Port et adresse IP sous-jacents du correspondant pour la
1764         connexion (voir le module
1765         <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>)</td></tr>
1766 <tr class="odd"><td><code>%A</code></td>
1767         <td>Adresse IP et port locaux</td></tr>
1768 <tr><td><code>%{<em>name</em>}e</code></td>
1769         <td>Variable d'environnement de requête <em>name</em></td></tr>
1770 <tr class="odd"><td><code>%E</code></td>
1771         <td>Etat d'erreur APR/OS et chaîne</td></tr>
1772 <tr><td><code>%F</code></td>
1773         <td>Nom du fichier source et numéro de ligne de l'appel du
1774         journal</td></tr>
1775 <tr class="odd"><td><code>%{<em>name</em>}i</code></td>
1776         <td>En-tête de requête <em>name</em></td></tr>
1777 <tr><td><code>%k</code></td>
1778         <td>Nombre de requêtes persistantes pour cette connexion</td></tr>
1779 <tr class="odd"><td><code>%l</code></td>
1780         <td>Sévérité du message</td></tr>
1781 <tr><td><code>%L</code></td>
1782         <td>Identifiant journal de la requête</td></tr>
1783 <tr class="odd"><td><code>%{c}L</code></td>
1784         <td>Identifiant journal de la connexion</td></tr>
1785 <tr><td><code>%{C}L</code></td>
1786         <td>Identifiant journal de la connexion si utilisé dans la
1787         portée de la connexion, vide sinon</td></tr>
1788 <tr class="odd"><td><code>%m</code></td>
1789         <td>Nom du module qui effectue la journalisation du message</td></tr>
1790 <tr><td><code>%M</code></td>
1791         <td>Le message effectif</td></tr>
1792 <tr class="odd"><td><code>%{<em>name</em>}n</code></td>
1793         <td>Note de requête <em>name</em></td></tr>
1794 <tr><td><code>%P</code></td>
1795         <td>Identifiant du processus courant</td></tr>
1796 <tr class="odd"><td><code>%T</code></td>
1797         <td>Identifiant du thread courant</td></tr>
1798 <tr><td><code>%{g}T</code></td>
1799         <td>Identifiant unique de thread système du thread courant
1800         (l'identifiant affiché par la commande <code>top</code> par
1801         exemple ; seulement sous Linux pour l'instant)</td></tr>
1802 <tr class="odd"><td><code>%t</code></td>
1803         <td>L'heure courante</td></tr>
1804 <tr><td><code>%{u}t</code></td>
1805         <td>L'heure courante avec les microsecondes</td></tr>
1806 <tr class="odd"><td><code>%{cu}t</code></td>
1807         <td>L'heure courante au format compact ISO 8601, avec les
1808         microsecondes</td></tr>
1809 <tr><td><code>%v</code></td>
1810         <td>Le nom de serveur canonique <code class="directive"><a href="#servername">ServerName</a></code> du serveur courant.</td></tr>
1811 <tr class="odd"><td><code>%V</code></td>
1812         <td>Le nom de serveur du serveur qui sert la requête en accord
1813         avec la définition de la directive <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>.</td></tr>
1814 <tr><td><code>\&nbsp;</code> (anti-slash espace)</td>
1815         <td>Espace non délimiteur</td></tr>
1816 <tr class="odd"><td><code>%&nbsp;</code> (pourcentage espace)</td>
1817         <td>Délimiteur de champ (aucune sortie)</td></tr>
1818 </table>
1819
1820     <p>L'item de format identifiant journal <code>%L</code> génère un
1821     identifiant unique pour une connexion ou une requête. Il peut servir
1822     à déterminer quelles lignes correspondent à la même connexion ou
1823     requête ou quelle requête est associée à tel connexion. Un item de
1824     format <code>%L</code> est aussi disponible dans le module
1825     <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code>, mais il permet dans ce contexte de
1826     corréler les entrées du journal des accès avec celles du journal des
1827     erreurs. Si le module <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code> est chargé,
1828     c'est son identifiant unique qui sera utilisé comme identifiant de
1829     journal pour les requêtes.</p>
1830
1831     <pre class="prettyprint lang-config"># Exemple (format par défaut pour les MPMs threadés)
1832 ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"</pre>
1833
1834
1835     <p>Cet exemple renverrait un message d'erreur du style :</p>
1836
1837     <div class="example"><p><code>
1838     [Thu May 12 08:28:57.652118 2011] [core:error] [pid 8777:tid 4326490112] [client ::1:58619] File does not exist: /usr/local/apache2/htdocs/favicon.ico
1839     </code></p></div>
1840
1841     <p>Notez que, comme indiqué plus haut, certains champs sont
1842     totalement supprimés s'ils n'ont pas été définis.</p>
1843
1844     <pre class="prettyprint lang-config"># Exemple (similaire au format 2.2.x)
1845 ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M% ,\ referer\ %{Referer}i"</pre>
1846
1847
1848     <pre class="prettyprint lang-config"># Exemple avancé avec identifiants journal de requête/connexion
1849 ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"
1850 ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"
1851 ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"
1852 ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"
1853 ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"</pre>
1854
1855
1856
1857 <h3>Voir aussi</h3>
1858 <ul>
1859 <li><code class="directive"><a href="#errorlog">ErrorLog</a></code></li>
1860 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
1861 <li><a href="../logs.html">Fichiers journaux du serveur HTTP Apache</a></li>
1862 </ul>
1863 </div>
1864 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1865 <div class="directive-section"><h2><a name="extendedstatus" id="extendedstatus">Directive</a> <a name="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a> <a title="Lien permanent" href="#extendedstatus" class="permalink">&para;</a></h2>
1866 <table class="directive">
1867 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Extrait des informations d'état étendues pour chaque
1868 requête</td></tr>
1869 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExtendedStatus On|Off</code></td></tr>
1870 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ExtendedStatus Off</code></td></tr>
1871 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
1872 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1873 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1874 </table>
1875
1876         <p>Cette option permet d'extraire des données supplémentaires
1877         concernant la requête en cours de traitement pour un processus
1878         donné, ainsi qu'un résumé d'utilisation ; vous pouvez accéder à
1879         ces variables pendant l'exécution en configurant
1880         <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>. Notez que d'autres modules sont
1881         susceptibles de s'appuyer sur ce tableau de bord.</p>
1882
1883     <p>Cette directive s'applique au serveur dans son ensemble, et ne
1884     peut pas être activée/désactivée pour un serveur virtuel
1885     particulier. Notez que l'extraction des informations d'état étendues
1886     peut ralentir le serveur. Notez aussi que cette définition ne peut
1887     pas être modifiée au cours d'un redémarrage graceful.</p>
1888
1889     <div class="note">
1890     <p>Notez que le chargement de <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> définit
1891     automatiquement ExtendedStatus à On, et que d'autres modules tiers
1892     sont susceptibles d'en faire de même. De tels modules ont besoin
1893     d'informations détaillées à propos de l'état de tous les processus.
1894     Depuis la version 2.3.6, <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> a définit la
1895     valeur par défaut à On, alors qu'elle était à Off dans les versions
1896     antérieures.</p>
1897     </div>
1898
1899
1900 </div>
1901 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1902 <div class="directive-section"><h2><a name="fileetag" id="fileetag">Directive</a> <a name="FileETag" id="FileETag">FileETag</a> <a title="Lien permanent" href="#fileetag" class="permalink">&para;</a></h2>
1903 <table class="directive">
1904 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Caractéristiques de fichier utilisées lors de la génération
1905 de l'en-tête de réponse HTTP ETag pour les fichiers statiques</td></tr>
1906 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FileETag <var>composant</var> ...</code></td></tr>
1907 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>FileETag MTime Size</code></td></tr>
1908 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
1909 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
1910 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1911 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1912 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>La valeur par défaut était "INode&nbsp;MTime&nbsp;Size"
1913 dans les versions 2.3.14 et antérieures.</td></tr>
1914 </table>
1915     <p>
1916     La directive <code class="directive">FileETag</code> définit les
1917     caractéristiques de fichier utilisées lors de la génération de
1918     l'en-tête de réponse HTTP <code>ETag</code> (entity tag) quand le
1919     document est contenu dans un fichier statique(la valeur de
1920     <code>ETag</code>
1921     est utilisée dans le cadre de la gestion du cache pour préserver la
1922     bande passante réseau). La directive
1923     <code class="directive">FileETag</code> vous permet maintenant de choisir
1924     quelles caractéristiques du fichier vont être utilisées, le cas
1925     échéant. Les mots-clés reconnus sont :
1926     </p>
1927
1928     <dl>
1929      <dt><strong>INode</strong></dt>
1930      <dd>Le numéro d'i-node du fichier sera inclus dans le processus de
1931      génération</dd>
1932      <dt><strong>MTime</strong></dt>
1933      <dd>La date et l'heure auxquelles le fichier a été modifié la
1934      dernière fois seront incluses</dd>
1935      <dt><strong>Size</strong></dt>
1936      <dd>La taille du fichier en octets sera incluse</dd>
1937      <dt><strong>All</strong></dt>
1938      <dd>Tous les champs disponibles seront utilisés. Cette définition
1939      est équivalente à :
1940      <pre class="prettyprint lang-config">FileETag INode MTime Size</pre>
1941 </dd>
1942      <dt><strong>None</strong></dt>
1943      <dd>Si le document se compose d'un fichier, aucun champ
1944      <code>ETag</code> ne sera inclus dans la réponse</dd>
1945     </dl>
1946
1947     <p>Les mots-clés <code>INode</code>, <code>MTime</code>, et
1948     <code>Size</code> peuvent être préfixés par <code>+</code> ou
1949     <code>-</code>, ce qui permet de modifier les valeurs par défaut
1950     héritées d'un niveau de configuration plus général. Tout mot-clé
1951     apparaissant sans aucun préfixe annule entièrement et immédiatement
1952     les configurations héritées.</p>
1953
1954     <p>Si la configuration d'un répertoire contient
1955     <code>FileETag&nbsp;INode&nbsp;MTime&nbsp;Size</code>, et si un de
1956     ses sous-répertoires contient <code>FileETag&nbsp;-INode</code>, la
1957     configuration de ce sous-répertoire (qui sera propagée vers tout
1958     sous-répertoire qui ne la supplante pas), sera équivalente à
1959     <code>FileETag&nbsp;MTime&nbsp;Size</code>.</p>
1960     <div class="warning"><h3>Avertissement</h3>
1961     Ne modifiez pas les valeurs par défaut pour les répertoires ou
1962     localisations où WebDAV est activé et qui utilisent
1963     <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> comme fournisseur de stockage.
1964     <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> utilise
1965     <code>MTime&nbsp;Size</code> comme format fixe pour les
1966     comparaisons de champs <code>ETag</code> dans les requêtes
1967     conditionnelles. Ces requêtes conditionnelles échoueront si le
1968     format <code>ETag</code> est modifié via la directive
1969     <code class="directive">FileETag</code>.
1970     </div>
1971     <div class="note"><h3>Inclusions côté serveur</h3>
1972     Aucun champ ETag n'est généré pour les réponses interprétées par
1973     <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>, car l'entité de la réponse peut
1974     changer sans modification de l'INode, du MTime, ou de la taille du
1975     fichier statique contenant les directives SSI.
1976     </div>
1977
1978
1979
1980 </div>
1981 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1982 <div class="directive-section"><h2><a name="files" id="files">Directive</a> <a name="Files" id="Files">&lt;Files&gt;</a> <a title="Lien permanent" href="#files" class="permalink">&para;</a></h2>
1983 <table class="directive">
1984 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent aux fichiers
1985 précisés</td></tr>
1986 <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>
1987 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
1988 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
1989 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
1990 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
1991 </table>
1992     <p>La directive <code class="directive">&lt;Files&gt;</code> limite
1993     la portée des directives qu'elle contient aux fichiers précisés.
1994     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
1995     balise <code>&lt;/Files&gt;</code>. Les directives contenues dans
1996     cette section s'appliqueront à tout objet dont le nom de base (la
1997     dernière partie du nom de fichier) correspond au fichier spécifié.
1998     Les sections <code class="directive">&lt;Files&gt;</code> sont
1999     traitées selon l'ordre dans lequel elles apparaissent dans le
2000     fichier de configuration, après les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et la lecture des fichiers
2001     <code>.htaccess</code>, mais avant les sections <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Notez que les
2002     sections <code class="directive">&lt;Files&gt;</code> peuvent être
2003     imbriquées dans les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> afin de restreindre la portion
2004     du système de fichiers à laquelle ces dernières vont
2005     s'appliquer.</p>
2006
2007     <p>L'argument <var>filename</var> peut contenir un nom de fichier
2008     ou une chaîne de caractères avec caractères génériques, où
2009     <code>?</code> remplace un caractère, et <code>*</code> toute chaîne
2010     de caractères.</p>
2011     <pre class="prettyprint lang-config">&lt;Files "cat.html"&gt;
2012     # Insérer ici des directives qui s'appliquent au fichier cat.html
2013 &lt;/Files&gt;
2014
2015 &lt;Files "?at.*"&gt;
2016     # Les directives insérées ici s'appliqueront aux fichiers
2017     # cat.html, bat.html, hat.php, et ainsi de suite.
2018 &lt;/Files&gt;</pre>
2019
2020
2021     <p>On peut aussi utiliser les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> en ajoutant la
2022     caractère <code>~</code>. Par exemple :</p>
2023
2024     <pre class="prettyprint lang-config">&lt;Files ~ "\.(gif|jpe?g|png)$"&gt;
2025     #...
2026 &lt;/Files&gt;</pre>
2027
2028
2029     <p>correspondrait à la plupart des formats graphiques de l'Internet.
2030     Il est cependant préférable d'utiliser la directive <code class="directive"><a href="#filesmatch">&lt;FilesMatch&gt;</a></code>.</p>
2031
2032     <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
2033     fichiers <code>.htaccess</code>. Ceci permet aux utilisateurs de
2034     contrôler l'accès à leurs propres ressources, fichier par
2035     fichier.</p>
2036
2037
2038 <h3>Voir aussi</h3>
2039 <ul>
2040 <li><a href="../sections.html">Comment fonctionnent les sections
2041 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
2042 explication de la manière dont ces différentes sections se combinent
2043 entre elles à la réception d'une requête</li>
2044 </ul>
2045 </div>
2046 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2047 <div class="directive-section"><h2><a name="filesmatch" id="filesmatch">Directive</a> <a name="FilesMatch" id="FilesMatch">&lt;FilesMatch&gt;</a> <a title="Lien permanent" href="#filesmatch" class="permalink">&para;</a></h2>
2048 <table class="directive">
2049 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent à des fichiers
2050 spécifiés sous la forme d'expressions rationnelles</td></tr>
2051 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;FilesMatch <var>expression rationnelle</var>&gt; ...
2052 &lt;/FilesMatch&gt;</code></td></tr>
2053 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
2054 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
2055 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2056 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2057 </table>
2058     <p>La section <code class="directive">&lt;FilesMatch&gt;</code>
2059     limite la portée des directives qu'elle contient aux fichiers
2060     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
2061     <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>. Par
2062     exemple :</p>
2063
2064     <pre class="prettyprint lang-config">&lt;FilesMatch ".+\.(gif|jpe?g|png)$"&gt;
2065     # ...
2066 &lt;/FilesMatch&gt;</pre>
2067
2068
2069     <p>correspondrait à la plupart des formats graphiques de
2070     l'Internet.</p>
2071
2072     <div class="note">Les caractères <code>.+</code> au début de l'expression
2073     rationnelle permettent de s'assurer que les fichiers de nom
2074     <code>.png</code>, ou <code>.gif</code>, par exemple, ne seront pas
2075     pris en compte.</div>
2076
2077     <p>A partir de la version 2.4.8, les groupes nommés et les
2078     références arrières sont extraits et enregistrés dans
2079     l'environnement avec leur nom en majuscules et préfixé
2080     par "MATCH_". Ceci permet
2081     de référencer des URLs dans des <a href="../expr.html">expressions</a>
2082     ou au sein de modules comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Pour
2083     éviter toute confusion, les références arrières numérotées (non
2084     nommées) sont ignorées. Vous devez utiliser à la place des groupes
2085     nommés.</p>
2086
2087 <pre class="prettyprint lang-config">&lt;FilesMatch "^(?&lt;sitename&gt;[^/]+)"&gt;
2088     Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
2089 &lt;/FilesMatch&gt;</pre>
2090
2091
2092 <h3>Voir aussi</h3>
2093 <ul>
2094 <li><a href="../sections.html">Comment fonctionnent les sections
2095 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
2096 explication de la manière dont ces différentes sections se combinent
2097 entre elles à la réception d'une requête</li>
2098 </ul>
2099 </div>
2100 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2101 <div class="directive-section"><h2><a name="forcetype" id="forcetype">Directive</a> <a name="ForceType" id="ForceType">ForceType</a> <a title="Lien permanent" href="#forcetype" class="permalink">&para;</a></h2>
2102 <table class="directive">
2103 <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
2104 HTTP Content-Type pour les fichiers correspondants</td></tr>
2105 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForceType <var>type médium</var>|None</code></td></tr>
2106 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
2107 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
2108 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2109 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2110 </table>
2111     <p>Lorsqu'elle est placée dans un fichier <code>.htaccess</code> ou
2112     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
2113     l'identification du type MIME des fichiers spécifiés à la valeur de
2114     l'argument <var>type médium</var>. Par exemple, si vous possédez un
2115     répertoire ne contenant que des fichiers GIF, et si vous ne voulez
2116     pas leur ajouter l'extension <code>.gif</code>, vous pouvez utiliser
2117     :</p>
2118
2119     <pre class="prettyprint lang-config">ForceType image/gif</pre>
2120
2121
2122     <p>Notez que cette directive l'emporte sur d'autres associations de
2123     type de médium indirectes définies dans mime.types ou via la
2124     directive <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code>.</p>
2125
2126     <p>Vous pouvez aussi annuler toute définition plus générale de
2127     <code class="directive">ForceType</code> en affectant la valeur
2128     <code>None</code> à l'argument <var>type médium</var> :</p>
2129
2130     <pre class="prettyprint lang-config"># force le type MIME de tous les fichiers à image/gif:
2131 &lt;Location "/images"&gt;
2132   ForceType image/gif
2133 &lt;/Location&gt;
2134
2135 # mais utilise les méthodes classiques d'attribution du type MIME
2136 # dans le sous-répertoire suivant :
2137 &lt;Location "/images/mixed"&gt;
2138   ForceType None
2139 &lt;/Location&gt;</pre>
2140
2141
2142     <p>A la base, cette directive écrase le type de contenu généré pour
2143     les fichiers statiques servis à partir du sytème de fichiers. Pour
2144     les ressources autres que les fichiers statiques pour lesquels le
2145     générateur de réponse spécifie en général un type de contenu, cette
2146     directive est ignorée.</p>
2147
2148     <div class="note"><h3>Note</h3>
2149     <p>Si aucun gestionnaire n'est explicitement défini pour une
2150     requête, le type de contenu spécifié sera aussi utilisé comme nom de
2151     gestionnaire.</p>
2152
2153     <p>Lorsque des directives explicites comme <code class="directive"><a href="#sethandler">SetHandler</a></code> ou
2154     <code class="directive">module="mod_mime"&gt;AddHandler</code> ne s'appliquent
2155     pas à la requête courante, le nom du gestionnaire interne
2156     normalement défini par ces directives correspondra alors au type de
2157     contenu spécifié par cette directive.
2158     </p>
2159     <p>Il s'agit d'un comportement historique que certains modules
2160     tiers, comme mod_php, peuvent interpréter comme un type de contenu
2161     artificiel ne servant qu'à indiquer le module qui doit prendre en
2162     compte la requête considérée.
2163     </p>
2164
2165     <p>Dans la mesure du possible, il est conseillé d'éviter les
2166     configurations qui comportent de tels types artificiels. En outre,
2167     les configurations qui restreignent l'accès aux directives
2168     <code class="directive"><a href="#sethandler">SetHandler</a></code> ou <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> doivent aussi restreindre
2169     l'accès à cette directive.</p>
2170     </div>
2171
2172
2173 </div>
2174 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2175 <div class="directive-section"><h2><a name="gprofdir" id="gprofdir">Directive</a> <a name="GprofDir" id="GprofDir">GprofDir</a> <a title="Lien permanent" href="#gprofdir" class="permalink">&para;</a></h2>
2176 <table class="directive">
2177 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Répertoire dans lequel écrire les données de profiling
2178 gmon.out.</td></tr>
2179 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>GprofDir <var>/tmp/gprof/</var>|<var>/tmp/gprof/</var>%</code></td></tr>
2180 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
2181 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2182 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2183 </table>
2184     <p>Lorsque le serveur a été compilé avec le support du profiling
2185     gprof, la directive <code class="directive">GprofDir</code> permet de
2186     spécifier dans quel répertoire les fichiers <code>gmon.out</code>
2187     doivent être écrits lorsque le processus s'arrête. Si l'argument se
2188     termine par un caractère pourcentage ('%'), des sous-répertoires
2189     sont créés pour chaque identifiant de processus.</p>
2190
2191     <p>Cette directive ne fonctionne actuellement qu'avec le MPM
2192     <code class="module"><a href="../mod/prefork.html">prefork</a></code>.</p>
2193
2194 </div>
2195 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2196 <div class="directive-section"><h2><a name="hostnamelookups" id="hostnamelookups">Directive</a> <a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a title="Lien permanent" href="#hostnamelookups" class="permalink">&para;</a></h2>
2197 <table class="directive">
2198 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la recherche DNS sur les adresses IP des
2199 clients</td></tr>
2200 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
2201 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>HostnameLookups Off</code></td></tr>
2202 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
2203 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2204 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2205 </table>
2206     <p>Cette directive active la recherche DNS afin de pouvoir
2207     journaliser les nom d'hôtes (et les passer aux programmes CGI et aux
2208     inclusions SSI via la variable <code>REMOTE_HOST</code>). La valeur
2209     <code>Double</code> déclenche une double recherche DNS inverse. En
2210     d'autres termes, une fois la recherche inverse effectuée, on lance
2211     une recherche directe sur le résultat de cette dernière. Au moins
2212     une des adresses IP fournies par la recherche directe doit
2213     correspondre à l'adresse originale (ce que l'on nomme
2214     <code>PARANOID</code> dans la terminologie "tcpwrappers").</p>
2215
2216     <p>Quelle que soit la configuration, lorsqu'on utilise
2217     <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> pour contrôler l'accès en fonction
2218     du nom d'hôte, une double recherche DNS inverse est effectuée,
2219     sécurité oblige. Notez cependant que le résultat de cette double
2220     recherche n'est en général pas accessible, à moins que vous n'ayez
2221     spécifié <code>HostnameLookups Double</code>. Par exemple, si vous
2222     n'avez spécifié que <code>HostnameLookups On</code>, et si une
2223     requête concerne un objet protégé par des restrictions en fonction
2224     du nom d'hôte, quel que soit le résultat de la double recherche
2225     inverse, les programmes CGI ne recevront que le résultat de la
2226     recherche inverse simple dans la variable
2227     <code>REMOTE_HOST</code>.</p>
2228
2229     <p>La valeur par défaut est <code>Off</code> afin de préserver le
2230     traffic réseau des sites pour lesquels la recherche inverse n'est
2231     pas vraiment nécessaire. Cette valeur par défaut est aussi bénéfique
2232     pour les utilisateurs finaux car il n'ont ainsi pas à subir de temps
2233     d'attente supplémentaires dus aux recherches DNS. Les sites
2234     fortement chargés devraient laisser cette directive à
2235     <code>Off</code>, car les recherches DNS peuvent prendre des temps
2236     très longs. Vous pouvez éventuellement utiliser hors ligne
2237     l'utilitaire <code class="program"><a href="../programs/logresolve.html">logresolve</a></code>, compilé par défaut dans
2238     le sous-répertoire <code>bin</code> de votre répertoire
2239     d'installation, afin de déterminer les noms d'hôtes associés aux
2240     adresses IP journalisées.</p>
2241
2242     <p>Enfin, si vous avez des <a href="mod_authz_host.html#reqhost">directives Require à base de
2243     nom</a>, une recherche de nom d'hôte sera effectuée quelle que soit
2244     la définition de la directive <code>HostnameLookups</code>.</p>
2245
2246 </div>
2247 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2248 <div class="directive-section"><h2><a name="httpprotocoloptions" id="httpprotocoloptions">Directive</a> <a name="HttpProtocolOptions" id="HttpProtocolOptions">HttpProtocolOptions</a> <a title="Lien permanent" href="#httpprotocoloptions" class="permalink">&para;</a></h2>
2249 <table class="directive">
2250 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Modifie les contraintes sur le format des requêtes HTTP</td></tr>
2251 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HttpProtocolOptions [Strict|Unsafe] [RegisteredMethods|LenientMethods]
2252  [Allow0.9|Require1.0]</code></td></tr>
2253 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>HttpProtocolOptions Strict LenientMethods Allow0.9</code></td></tr>
2254 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
2255 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2256 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2257 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir des versions 2.2.32 et 2.4.24 du serveur HTTP
2258 Apache</td></tr>
2259 </table>
2260     <p>Cette directive permet de modifier les règles qui s'appliquent à la ligne
2261     de requête HTTP (<a href="https://tools.ietf.org/html/rfc7230#section-3.1.1">RFC 7230
2262     §3.1.1</a>) et aux champs des en-têtes des requêtes HTTP (<a href="https://tools.ietf.org/html/rfc7230#section-3.2">RFC 7230
2263     §3.2</a>), qui s'appliquent maintenant par défaut ou en utilisant
2264     l'option <code>Strict</code>. L'option <code>Unsafe</code>
2265     a été ajoutée pour pouvoir restaurer les anciens
2266     comportements nécessaires aux anciens modules et applications et aux agents
2267     utilisateurs personnalisés considérés comme obsolètes.</p>
2268
2269     <p>Ces règles
2270     s'appliquant avant le traitement de la requête, elles doivent, pour être prises en
2271     compte, être définies
2272     au niveau global ou dans la première section par défaut du serveur virtuel
2273     qui correspond à la requête considérée, par interface IP/port et non par
2274     nom.</p>
2275
2276     <p>Cette directive accepte trois paramètres issus de la liste suivante, ceux
2277     qui ne sont pas spécifiés prenant leur valeur par défaut :</p>
2278
2279     <dl>
2280     <dt>Strict|Unsafe</dt>
2281     <dd>
2282     <p>Avant l'introduction de cette directive, les interpréteurs de requêtes du
2283     serveur HTTP Apache toléraient un grand nombre de formats en entrée qui
2284     n'étaient pas forcément conformes au protocole. <a href="https://tools.ietf.org/html/rfc7230#section-9.4">RFC 7230 §9.4
2285     Request Splitting</a> et <a href="https://tools.ietf.org/html/rfc7230#section-9.5">§9.5 Response
2286     Smuggling</a> ne rappellent que deux des risques potentiels induits par des
2287     requêtes non conformes, alors que <a href="https://tools.ietf.org/html/rfc7230#section-3.5">RFC 7230
2288     §3.5</a> signale les risques encourus par l'acceptation de blancs non
2289     conformes dans les lignes de requête. Avec l'introduction de cette
2290     directive, toutes les règles de grammaire de la spécification doivent être
2291     respectées dans le mode d'opérations par défaut <code>Strict</code>.</p>
2292
2293     <div class="warning"><h3>Risques de sécurité liés au mode Unsafe</h3>
2294     <p>Il est fortement déconseillé aux utilisateurs d'utiliser le mode
2295     d'opération <code>Unsafe</code>, ou
2296     <code>UnsafeWhitespace</code>, en particulier pour les déploiements de
2297     serveurs ouverts sur l'extérieur et/ou accessibles au public. Si un moniteur
2298     défectueux ou autre logiciel spécialisé ne s'exécutant que sur un intranet
2299     nécessite une interface, les utilisateurs ne doivent utiliser les options de
2300     type UnSafe qu'en cas de nécessité et uniquement au sein d'un serveur
2301     virtuel bien spécifique et sur un réseau privé.</p>
2302     </div>
2303
2304     <div class="example"><h3>Exemple de requête provoquant l'envoi d'un message HTTP 400 en
2305         mode Strict</h3><p><code>
2306
2307         # Missing CRLF<br />
2308         GET / HTTP/1.0\n\n
2309       </code></p></div>
2310       <div class="warning"><h3>Utilitaires en ligne de commande et CRLF</h3>
2311         <p>Il peut s'avérer nécessaire de forcer certains utilitaires à utiliser
2312         CRLF ; si ce n'est pas le cas, httpd reverra une réponse HTTP 400 comme
2313         dans le cas précédent. Par exemple, le <strong>client OpenSSL s_client
2314         doit utiliser le paramètre -crlf pour fonctionner correctement</strong>.</p>
2315         <p>Pour détecter des problèmes tels que l'absence de CRLF, vous pouvez
2316         utiliser la directive <code class="directive"><a href="../mod/mod_dumpio.html#dumpioinput">DumpIOInput</a></code> qui permet de décortiquer
2317         les requêtes HTTP.</p>
2318       </div>
2319     </dd>
2320     <dt>RegisteredMethods|LenientMethods</dt>
2321     <dd>
2322     <p>La section de la <a href="https://tools.ietf.org/html/rfc7231#section-4.1">RFC 7231
2323     §4.1</a> "Request Methods" "Overview" indique que les serveurs doivent
2324     renvoyer un message d'erreur lorsque la ligne de requête comporte une
2325     méthode non supportée. C'est déjà le cas lorsque l'option
2326     <code>LenientMethods</code> est utilisée, mais les administrateurs ont la
2327     possibilité de limiter les méthodes utilisées via l'option
2328     <code>RegisteredMethods</code> en enregistrant toute méthode non standard
2329     via la directive <code class="directive">RegisterHttpMethod</code>, en particulier
2330     si l'option <code>Unsafe</code> est utilisée.</p>
2331
2332     <div class="warning"><h3>Compatibilité avec le mandat direct</h3>
2333     <p>L'option
2334     <code>RegisteredMethods</code> <strong>ne doit pas</strong> être utilisée
2335     pour les serveurs mandataires car ces derniers ne connaissent pas les
2336     méthodes supportées par les serveurs originaux.</p>
2337     </div>
2338
2339     <div class="example"><h3>Exemple de requête provoquant l'envoi d'un message HTTP 501 en
2340         mode LenientMethods</h3><p><code>
2341
2342         # Méthode HTTP inconnue<br />
2343         WOW / HTTP/1.0\r\n\r\n<br /><br />
2344         # Méthode HTTP spécifiée en minuscules<br />
2345         get / HTTP/1.0\r\n\r\n<br />
2346       </code></p></div>
2347       </dd>
2348       <dt>Allow0.9|Require1.0</dt>
2349       <dd>
2350     <p>La section de la <a href="https://tools.ietf.org/html/rfc2616#section-19.6">RFC 2616
2351     §19.6</a> "Compatibility With Previous Versions" encouragait les
2352     serveurs HTTP à supporter les anciennes requêtes HTTP/0.9. La RFC 7230 va
2353     cependant à son encontre via sa préconisation "Le souhait de supporter les
2354     requêtes HTTP/0.9 a été supprimé" et y adjoint des commentaires dans <a href="https://tools.ietf.org/html/rfc7230#appendix-A">RFC 7230 Appendix
2355     A</a>. A ce titre, l'option <code>Require1.0</code> permet à l'utilisateur
2356     d'inhiber le comportement induit par l'option par défaut
2357     <code>Allow0.9</code>.</p>
2358
2359     <div class="example"><h3>Exemple de requête provoquant l'envoi d'un message HTTP 400 en
2360         mode Require1.0</h3><p><code>
2361
2362         # Version HTTP non supportée<br />
2363         GET /\r\n\r\n
2364       </code></p></div>
2365     </dd>
2366     </dl>
2367
2368     <p>La consultation des messages enregistrés dans le journal
2369     <code class="directive">ErrorLog</code>, configuré via la directive
2370     <code class="directive">LogLevel</code> avec un niveau <code>info</code>, pourra
2371     vous aider à identifier de telles requêtes non conformes ainsi que leur
2372     provenance. Les utilisateurs devront accorder une attention particulière aux
2373     messages d'erreur de type 400 dans le journal access pour détecter les
2374     requêtes apparemment valides mais rejetées.</p>
2375
2376 </div>
2377 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2378 <div class="directive-section"><h2><a name="if" id="if">Directive</a> <a name="If" id="If">&lt;If&gt;</a> <a title="Lien permanent" href="#if" class="permalink">&para;</a></h2>
2379 <table class="directive">
2380 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si une
2381 condition est satisfaite au cours du traitement d'une
2382 requête</td></tr>
2383 <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>
2384 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
2385 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
2386 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2387 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2388 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Les conditions imbriquées sont supportées à partir de la version
2389 2.4.26 du serveur HTTP Apache</td></tr>
2390 </table>
2391     <p>La directive <code class="directive">&lt;If&gt;</code> évalue une
2392     expression à la volée, et applique les directives qu'elle contient
2393     si et seulement si l'expression renvoie la valeur "vrai". Par
2394     exemple :</p>
2395
2396     <pre class="prettyprint lang-config">&lt;If "-z req('Host')"&gt;</pre>
2397
2398
2399     <p>serait satisfaite pour les requêtes HTTP/1.0 sans en-tête
2400     <var>Host:</var>. Les expressions peuvent contenir différents
2401     opérateurs de type shell pour la comparaison de chaînes
2402     (<code>==</code>, <code>!=</code>, <code>&lt;</code>, ...), la
2403     comparaison d'entiers (<code>-eq</code>, <code>-ne</code>, ...), ou
2404     à usages divers (<code>-n</code>, <code>-z</code>, <code>-f</code>,
2405     ...). Les expressions rationnelles sont aussi supportées,</p>
2406
2407     <pre class="prettyprint lang-config">&lt;If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/"&gt;</pre>
2408
2409
2410     <p>ainsi que les comparaison de modèles de type shell et de
2411     nombreuses autres opérations. Ces opérations peuvent être effectuées
2412     sur les en-têtes de requêtes (<code>req</code>), les variables
2413     d'environnement (<code>env</code>), et un grand nombre d'autres
2414     propriétés. La documentation complète est disponible dans <a href="../expr.html">Les expressions dans le serveur HTTP Apache</a>.</p>
2415
2416     <p>Cette section de configuration ne peut contenir que des
2417     directives qui supportent le <a href="directive-dict.html#Context">contexte de répertoire</a>.</p>
2418
2419     <div class="warning">
2420     Certaines variables comme <code>CONTENT_TYPE</code> ainsi que
2421     d'autres en-têtes de réponse ne seront pas disponibles dans ce bloc,
2422     car elle sont définies après l'évaluation des conditions &lt;If&gt;.
2423     </div>
2424
2425
2426 <h3>Voir aussi</h3>
2427 <ul>
2428 <li><a href="../expr.html">Les expressions dans le serveur HTTP
2429 Apache</a>, pour une référence complète et d'autres exemples.</li>
2430 <li><code class="directive"><a href="#elseif">&lt;ElseIf&gt;</a></code></li>
2431 <li><code class="directive"><a href="#else">&lt;Else&gt;</a></code></li>
2432 <li><a href="../sections.html">Comment fonctionnent les sections
2433 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
2434 explication de la manière dont ces différentes sections se combinent
2435 entre elles à la réception d'une requête. Les
2436 directives <code class="directive">&lt;If&gt;</code>, <code class="directive">&lt;ElseIf&gt;</code>, et <code class="directive">&lt;Else&gt;</code> s'appliquent en dernier.</li>
2437 </ul>
2438 </div>
2439 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2440 <div class="directive-section"><h2><a name="ifdefine" id="ifdefine">Directive</a> <a name="IfDefine" id="IfDefine">&lt;IfDefine&gt;</a> <a title="Lien permanent" href="#ifdefine" class="permalink">&para;</a></h2>
2441 <table class="directive">
2442 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliqueront que si un
2443 test retourne "vrai" au démarrage du serveur</td></tr>
2444 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;IfDefine [!]<var>paramètre</var>&gt; ...
2445     &lt;/IfDefine&gt;</code></td></tr>
2446 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
2447 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
2448 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2449 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2450 </table>
2451     <p>La section <code>&lt;IfDefine
2452     <var>test</var>&gt;...&lt;/IfDefine&gt;</code> permet de
2453     conférer un caractère conditionnel à un ensemble de directives. Les
2454     directives situées à l'intérieur d'une section <code class="directive">&lt;IfDefine&gt;</code> ne s'appliquent que si
2455     <var>test</var> est vrai. Si <var>test</var> est faux, tout ce qui
2456     se trouve entre les balises de début et de fin est ignoré.</p>
2457
2458     <p><var>test</var> peut se présenter sous deux formes :</p>
2459
2460     <ul>
2461       <li><var>nom paramètre</var></li>
2462
2463       <li><code>!</code><var>nom paramètre</var></li>
2464     </ul>
2465
2466     <p>Dans le premier cas, les directives situées entre les balises de
2467     début et de fin ne s'appliqueront que si le paramètre nommé <var>nom
2468     paramètre</var> est défini. Le second format inverse le test, et
2469     dans ce cas, les directives ne s'appliqueront que si <var>nom
2470     paramètre</var> n'est <strong>pas</strong> défini.</p>
2471
2472     <p>L'argument <var>nom paramètre</var> est une définition qui peut
2473     être effectuée par la ligne de commande
2474     <code class="program"><a href="../programs/httpd.html">httpd</a></code> via le paramètre
2475     <code>-D<var>paramètre</var></code> au démarrage du serveur, ou via la
2476     directive <code class="directive"><a href="#define">Define</a></code>.</p>
2477
2478     <p>Les sections <code class="directive">&lt;IfDefine&gt;</code>
2479     peuvent être imbriquées, ce qui permet d'implémenter un test
2480     multi-paramètres simple. Exemple :</p>
2481
2482     <div class="example"><p><code>httpd -DReverseProxy -DUseCache -DMemCache ...</code></p></div>
2483     <pre class="prettyprint lang-config">&lt;IfDefine ReverseProxy&gt;
2484   LoadModule proxy_module   modules/mod_proxy.so
2485   LoadModule proxy_http_module   modules/mod_proxy_http.so
2486   &lt;IfDefine UseCache&gt;
2487     LoadModule cache_module   modules/mod_cache.so
2488     &lt;IfDefine MemCache&gt;
2489       LoadModule mem_cache_module   modules/mod_mem_cache.so
2490     &lt;/IfDefine&gt;
2491     &lt;IfDefine !MemCache&gt;
2492       LoadModule cache_disk_module   modules/mod_cache_disk.so
2493     &lt;/IfDefine&gt;
2494   &lt;/IfDefine&gt;
2495 &lt;/IfDefine&gt;</pre>
2496
2497
2498 </div>
2499 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2500 <div class="directive-section"><h2><a name="ifdirective" id="ifdirective">Directive</a> <a name="IfDirective" id="IfDirective">&lt;IfDirective&gt;</a> <a title="Lien permanent" href="#ifdirective" class="permalink">&para;</a></h2>
2501 <table class="directive">
2502 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives dont le traitement est conditionné par la
2503 présence ou l'absence d'une directive particulière</td></tr>
2504 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;IfDirective [!]<var>directive-name</var>&gt; ...
2505     &lt;/IfDirective&gt;</code></td></tr>
2506 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
2507 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
2508 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2509 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2510 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.34 du serveur HTTP Apache</td></tr>
2511 </table>
2512     <p>La section <code>&lt;IfDirective
2513     <var>test</var>&gt;...&lt;/IfDirective&gt;</code> permet de regrouper des
2514     directives dont le traitement n'est effectué que si une directive
2515     particulière est présente, autrement dit si l'expression <var>test</var> est
2516     évaluée à true. Si l'expression <var>test</var> est évaluée à false, toutes
2517     les lignes qui se trouvent entre les balises de début et de fin de la
2518     section sont ignorées.</p>
2519
2520     <p>L'expression <var>test</var> de la section <code class="directive">&lt;IfDirective&gt;</code> peut prendre les deux formes
2521     suivantes :</p>
2522
2523     <ul>
2524       <li><var>directive-name</var></li>
2525
2526       <li>!<var>directive-name</var></li>
2527     </ul>
2528
2529     <p>Dans le premier cas, les directives qui se situent entre les balises de
2530     début et de fin de la section ne sont traitées que si une directive de nom
2531     directive-name est disponible à cet instant. Dans le second cas, la condition est
2532     inversée, et les directives ne sont traitées que si
2533     <var>directive-name</var> n'est <strong>pas</strong> disponible.</p>
2534
2535     <div class="note">Cette section ne doit être utilisée que si vous devez partager le même
2536     fichier de configuration entre plusieurs versions de
2537     <code class="program"><a href="../programs/httpd.html">httpd</a></code>, sans tenir compte de la disponibilité de telle ou
2538     telle directive. Dans une configuration standard, il est inutile de placer
2539     les directives dans des sections <code class="directive">&lt;IfDirective&gt;</code>.</div>
2540
2541 <h3>Voir aussi</h3>
2542 <ul>
2543 <li><code class="directive"><a href="#ifsection">&lt;IfSection&gt;</a></code></li>
2544 </ul>
2545 </div>
2546 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2547 <div class="directive-section"><h2><a name="iffile" id="iffile">Directive</a> <a name="IfFile" id="IfFile">&lt;IfFile&gt;</a> <a title="Lien permanent" href="#iffile" class="permalink">&para;</a></h2>
2548 <table class="directive">
2549 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives qui ne seront traitées que si un fichier
2550 existe au démarrage</td></tr>
2551 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;IfFile [!]<var>parameter-name</var>&gt; ...
2552     &lt;/IfFile&gt;</code></td></tr>
2553 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
2554 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
2555 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2556 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2557 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.34 du serveur HTTP Apache</td></tr>
2558 </table>
2559     <p>La section <code>&lt;IfFile <var>filename</var>&gt;...&lt;/IfFile&gt;</code>
2560     permet de conditionner le traitement de directives à
2561     l'existence d'un fichier sur disque. Ainsi, les directives définies au sein
2562     d'une section <code class="directive">&lt;IfFile&gt;</code> ne seront
2563     traitées que si le fichier <var>filename</var> existe. Si le fichier
2564     <var>filename</var> n'existe pas, tout ce qui se trouve entre les marqueurs
2565     start et end sera ignoré. <var>filename</var> peut être un chemin absolu ou
2566     relatif au chemin défini par la directive ServerRoot.</p>
2567
2568     <p>Le paramètre <var>filename</var> de l'en-tête d'une section <code class="directive">&lt;IfFile&gt;</code> peut prendre la même forme que la variable
2569     <var>test</var> de la section <code class="directive"><a href="#ifdefine">&lt;IfDefine&gt;</a></code> ; à ce titre, le résultat du test peut
2570     être inversé en plaçant le caractère <code>!</code> juste avant
2571     <var>filename</var>.
2572     </p>
2573
2574     <p>Si <var>filename</var> est un chemin relatif, il sera généré par rapport
2575     au chemin défini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>. Lorsque la directive <code class="directive">&lt;IfFile&gt;</code> intervient avant la définition de la
2576     directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>,
2577     <var>filename</var> sera relatif au répertoire racine par défaut du serveur
2578     ou au répertoire racine passé dans la ligne de commande via l'option
2579     <code>-d</code>.</p>
2580
2581     <div class="warning"><h3>Avertissement</h3>
2582     Avec la version 2.4.34, il est interdit de spécifier un <var>filename</var>
2583     entouré de guillemets. Ceci provoquerait une erreur de syntaxe au démarrage.
2584     Il est donc impossible de spécifier des noms de fichiers contenant des
2585     espaces, mais ce défaut a été corrigé à partir de la version 2.4.35.</div>
2586
2587
2588 </div>
2589 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2590 <div class="directive-section"><h2><a name="ifmodule" id="ifmodule">Directive</a> <a name="IfModule" id="IfModule">&lt;IfModule&gt;</a> <a title="Lien permanent" href="#ifmodule" class="permalink">&para;</a></h2>
2591 <table class="directive">
2592 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent qu'en fonction
2593 de la présence ou de l'absence d'un module spécifique</td></tr>
2594 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;IfModule [!]<var>fichier module</var>|<var>identificateur
2595 module</var>&gt; ... &lt;/IfModule&gt;</code></td></tr>
2596 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
2597 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
2598 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2599 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2600 </table>
2601     <p>La section <code>&lt;IfModule
2602     <var>test</var>&gt;...&lt;/IfModule&gt;</code> permet de conférer à
2603     des directives un caractère conditionnel basé sur la présence d'un
2604     module spécifique. Les directives situées dans une section
2605     <code class="directive">&lt;IfModule&gt;</code> ne s'appliquent que
2606     si <var>test</var> est vrai. Si <var>test</var> est faux, tout ce
2607     qui se trouve entre les balises de début et de fin est ignoré.</p>
2608
2609     <p><var>test</var> peut se présenter sous deux formes :</p>
2610
2611     <ul>
2612       <li><var>module</var></li>
2613
2614       <li>!<var>module</var></li>
2615     </ul>
2616
2617     <p>Dans le premier cas, les directives situées entre les balises de
2618     début et de fin ne s'appliquent que si le module <var>module</var>
2619     est présent -- soit compilé avec le binaire Apache httpd, soit chargé
2620     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
2621     ce cas, les directives ne s'appliquent que si <var>module</var>
2622     n'est <strong>pas</strong> présent.</p>
2623
2624     <p>L'argument <var>module</var> peut contenir soit l'identificateur
2625     du module, soit le nom du fichier source du module. Par exemple,
2626     <code>rewrite_module</code> est un identificateur et
2627     <code>mod_rewrite.c</code> le nom du fichier source
2628     correspondant. Si un module comporte plusieurs fichiers sources,
2629     utilisez le nom du fichier qui contient la chaîne de caractères
2630     <code>STANDARD20_MODULE_STUFF</code>.</p>
2631
2632     <p>Les sections <code class="directive">&lt;IfModule&gt;</code>
2633     peuvent être imbriquées, ce qui permet d'implémenter des tests
2634     multi-modules simples.</p>
2635
2636     <div class="note">Cette section ne doit être utilisée que si votre fichier de
2637     configuration ne fonctionne qu'en fonction de la présence ou de
2638     l'absence d'un module spécifique. D'une manière générale, il n'est
2639     pas nécessaire de placer les directives à l'intérieur de sections
2640     <code class="directive">&lt;IfModule&gt;</code>.</div>
2641
2642 </div>
2643 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2644 <div class="directive-section"><h2><a name="ifsection" id="ifsection">Directive</a> <a name="IfSection" id="IfSection">&lt;IfSection&gt;</a> <a title="Lien permanent" href="#ifsection" class="permalink">&para;</a></h2>
2645 <table class="directive">
2646 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives dont le traitement est conditionné par la
2647 présence ou l'absence d'une section particulière</td></tr>
2648 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;IfSection [!]<var>section-name</var>&gt; ...
2649     &lt;/IfSection&gt;</code></td></tr>
2650 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
2651 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
2652 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2653 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2654 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.34 du serveur HTTP Apache</td></tr>
2655 </table>
2656     <p>La section <code>&lt;IfSection
2657     <var>test</var>&gt;...&lt;/IfSection&gt;</code> permet de regrouper des
2658     directives dont le traitement n'est effectué que si une section de
2659     configuration particulière est présente. Une section, par exemple <code class="directive">&lt;VirtualHost&gt;</code>, permet de regrouper des directives
2660     et possède un nom précédé du caractère "&lt;".</p>
2661
2662     <p>Les directives situées à l'intérieur d'une section <code class="directive">&lt;IfSection&gt;</code> ne sont traitées que si l'expression
2663     <var>test</var> est évaluée à true. Si l'expression <var>test</var> est
2664     évaluée à false, toutes les lignes situées entre les balises de début et de
2665     fin de la section sont ignorées.</p>
2666
2667     <p><var>section-name</var> doit être spécifié sans les caractères de début
2668     "&lt;" ou fin "&gt;". L'expression <var>test</var> de la section <code class="directive">&lt;IfSection&gt;</code> peut prendre deux formes :</p>
2669
2670     <ul>
2671       <li><var>section-name</var></li>
2672       <li>!<var>section-name</var></li>
2673     </ul>
2674
2675     <p>Dans le premier cas, les directives qui se situent entre les balises de
2676     début et de fin de la section ne sont traitées que si une section de nom
2677     section-name est disponible à cet instant. Dans le second cas, la condition est
2678     inversée, et les directives ne sont traitées que si
2679     <var>section-name</var> n'est <strong>pas</strong> disponible.</p>
2680
2681     <p>Par exemple :</p>
2682
2683     <pre class="prettyprint lang-config">&lt;IfSection VirtualHost&gt;
2684    ...
2685 &lt;/IfSection&gt;</pre>
2686
2687
2688     <div class="note">Cette section ne doit être utilisée que si vous devez partager le même
2689     fichier de configuration entre plusieurs versions de
2690     <code class="program"><a href="../programs/httpd.html">httpd</a></code>, sans tenir compte de la disponibilité de telle ou
2691     telle section. Dans une configuration standard, il est inutile de placer
2692     les directives dans des sections <code class="directive">&lt;IfSection&gt;</code>.</div>
2693
2694 <h3>Voir aussi</h3>
2695 <ul>
2696 <li><code class="directive"><a href="#ifdirective">&lt;IfDirective&gt;</a></code></li>
2697 </ul>
2698 </div>
2699 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2700 <div class="directive-section"><h2><a name="include" id="include">Directive</a> <a name="Include" id="Include">Include</a> <a title="Lien permanent" href="#include" class="permalink">&para;</a></h2>
2701 <table class="directive">
2702 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inclut d'autres fichiers de configuration dans un des
2703 fichiers de configuration du serveur</td></tr>
2704 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Include <var>chemin-fichier</var>|<var>chemin-répertoire</var>|<var>wildcard</var></code></td></tr>
2705 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
2706 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2707 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2708 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Utilisation des caractères
2709 génériques dans la partie chemin depuis la version 2.3.6</td></tr>
2710 </table>
2711     <p>Cette directive permet l'inclusion d'autres fichiers de
2712     configuration dans un des fichiers de configuration du serveur.</p>
2713
2714     <p>On peut utiliser des caractères génériques de style Shell
2715     (<code>fnmatch()</code>) aussi bien dans la partie nom de fichier du
2716     chemin que dans la partie répertoires pour inclure plusieurs
2717     fichiers en une
2718     seule fois, selon leur ordre alphabétique. De plus, si la directive
2719     <code class="directive">Include</code> pointe vers un répertoire, Apache
2720     httpd inclura tous les fichiers de ce répertoire et de tous ces
2721     sous-répertoires. L'inclusion de répertoires entiers est cependant
2722     déconseillée, car il est fréquent d'oublier des fichiers
2723     temporaires dans un répertoire, ce qui causerait une erreur
2724     <code class="program"><a href="../programs/httpd.html">httpd</a></code> en cas d'inclusion. Pour inclure des
2725     fichiers qui correspondent à un certain modèle, comme *.conf par
2726     exemple, nous vous recommandons d'utiliser plutôt la syntaxe avec
2727     caractères génériques comme ci-dessous.</p>
2728
2729     <p>La directive <code class="directive"><a href="#include">Include</a></code>
2730     <strong>échouera avec un code d'erreur</strong> si une expression
2731    contenant des caractères génériques ne correspond à aucun fichier.
2732    Pour ignorer les expressions contenant des caractères génériques ne
2733    correspondant à aucun fichier, utilisez la directive <code class="directive"><a href="#includeoptional">IncludeOptional</a></code>.</p>
2734
2735     <p>Le chemin fichier spécifié peut être soit un chemin absolu, soit
2736     un chemin relatif au répertoire défini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
2737
2738     <p>Exemples :</p>
2739
2740     <pre class="prettyprint lang-config">Include /usr/local/apache2/conf/ssl.conf
2741 Include /usr/local/apache2/conf/vhosts/*.conf</pre>
2742
2743
2744     <p>ou encore, avec des chemins relatifs au répertoire défini par la
2745     directive <code class="directive"><a href="#serverroot">ServerRoot</a></code> :</p>
2746
2747     <pre class="prettyprint lang-config">Include conf/ssl.conf
2748 Include conf/vhosts/*.conf</pre>
2749
2750
2751     <p>On peut aussi insérer des caractères génériques dans la partie
2752     répertoires du chemin. Dans l'exemple suivant, la directive
2753     échouera si aucun sous-répertoire de conf/vhosts ne contient au
2754     moins un fichier *.conf :</p>
2755
2756     <pre class="prettyprint lang-config">Include conf/vhosts/*/*.conf</pre>
2757
2758
2759     <p>Par contre, dans l'exemple suivant, la directive sera simplement
2760     ignorée si aucun sous-répertoire de conf/vhosts ne contient au
2761     moins un fichier *.conf :</p>
2762
2763     <pre class="prettyprint lang-config">IncludeOptional conf/vhosts/*/*.conf</pre>
2764
2765
2766
2767 <h3>Voir aussi</h3>
2768 <ul>
2769 <li><code class="directive"><a href="#includeoptional">IncludeOptional</a></code></li>
2770 <li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
2771 </ul>
2772 </div>
2773 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2774 <div class="directive-section"><h2><a name="includeoptional" id="includeoptional">Directive</a> <a name="IncludeOptional" id="IncludeOptional">IncludeOptional</a> <a title="Lien permanent" href="#includeoptional" class="permalink">&para;</a></h2>
2775 <table class="directive">
2776 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inclusion de fichiers dans le fichier de configuration</td></tr>
2777 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IncludeOptional
2778 <var>chemin-fichier</var>|<var>chemin-répertoire</var>|<var>wildcard</var></code></td></tr>
2779 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
2780 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</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>Disponible à partir de la version 2.3.6 du serveur HTTP
2783 Apache. Les chemins de fichier inexistants sans caractère générique ne
2784 provoquent plus d'erreur de syntaxe après de la version 2.4.30</td></tr>
2785 </table>
2786     <p>Cette directive permet d'inclure des fichiers dans les fichiers de
2787     configuration du serveur. Elle fonctionne de manière identique à la
2788     directive <code class="directive"><a href="#include">Include</a></code>, à l'exception du
2789     fait que si l'expression avec ou sans caractères génériques wilcard ne
2790     correspond à aucun fichier ou répertoire, elle sera ignorée silencieusement
2791     au lieu de causer une erreur.</p>
2792
2793
2794 <h3>Voir aussi</h3>
2795 <ul>
2796 <li><code class="directive"><a href="#include">Include</a></code></li>
2797 <li><code class="program"><a href="../programs/apachectl.html">apachectl</a></code></li>
2798 </ul>
2799 </div>
2800 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2801 <div class="directive-section"><h2><a name="keepalive" id="keepalive">Directive</a> <a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a title="Lien permanent" href="#keepalive" class="permalink">&para;</a></h2>
2802 <table class="directive">
2803 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active les connexions HTTP persistantes</td></tr>
2804 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeepAlive On|Off</code></td></tr>
2805 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>KeepAlive On</code></td></tr>
2806 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
2807 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2808 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2809 </table>
2810     <p>L'extension Keep-Alive de HTTP/1.0 et l'implémentation des
2811     connexions persistantes dans HTTP/1.1 ont rendu possibles des
2812     sessions HTTP de longue durée, ce qui permet de transmettre
2813     plusieurs requêtes via la même connexion TCP. Dans certains cas, le
2814     gain en rapidité pour des documents comportant de nombreuses images
2815     peut atteindre 50%. Pour activer les connexions persistantes,
2816     définissez <code>KeepAlive On</code>.</p>
2817
2818     <p>Pour les clients HTTP/1.0, les connexions persistantes ne seront
2819     mises en oeuvre que si elles ont été spécialement demandées par un
2820     client. De plus, une connexion persistante avec un client HTTP/1.0
2821     ne peut être utilisée que si la taille du contenu est connue
2822     d'avance. Ceci implique que les contenus dynamiques comme les
2823     sorties CGI, les pages SSI, et les listings de répertoires générés
2824     par le serveur n'utiliseront en général pas les connexions
2825     persistantes avec les clients HTTP/1.0. Avec les clients HTTP/1.1,
2826     les connexions persistantes sont utilisées par défaut, sauf
2827     instructions contraires. Si le client le demande, le transfert par
2828     tronçons de taille fixe (chunked encoding) sera utilisé afin de
2829     transmettre un contenu de longueur inconnue via une connexion
2830     persistante.</p>
2831
2832     <p>Lorsqu'un client utilise une connexion persistante, elle comptera
2833     pour une seule requête pour la directive <code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>, quel
2834     que soit le nombre de requêtes transmises via cette connexion.</p>
2835
2836 <h3>Voir aussi</h3>
2837 <ul>
2838 <li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li>
2839 </ul>
2840 </div>
2841 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2842 <div class="directive-section"><h2><a name="keepalivetimeout" id="keepalivetimeout">Directive</a> <a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a title="Lien permanent" href="#keepalivetimeout" class="permalink">&para;</a></h2>
2843 <table class="directive">
2844 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée pendant laquelle le serveur va attendre une requête
2845 avant de fermer une connexion persistante</td></tr>
2846 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeepAliveTimeout <var>num</var>[ms]</code></td></tr>
2847 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
2848 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
2849 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2850 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2851 </table>
2852     <p>Le nombre de secondes pendant lesquelles Apache httpd va attendre une
2853     requête avant de fermer la connexion. Le délai peut être défini en
2854     millisecondes en suffixant sa valeur par ms. La valeur du délai
2855     spécifiée par la directive <code class="directive"><a href="#timeout">Timeout</a></code> s'applique dès qu'une requête a
2856     été reçue.</p>
2857
2858     <p>Donner une valeur trop élévée à
2859     <code class="directive">KeepAliveTimeout</code> peut induire des problèmes
2860     de performances sur les serveurs fortement chargés. Plus le délai
2861     est élévé, plus nombreux seront les processus serveur en attente de
2862     requêtes de la part de clients inactifs.</p>
2863
2864     <p>Si la directive <code class="directive">KeepAliveTimeout</code>
2865     <strong>n'est pas</strong> définie pour un des serveurs virtuels
2866     à base de nom, c'est le serveur virtuel dont la paire adresse
2867     IP/port correspond le mieux qui sera utilisée.</p>
2868
2869 </div>
2870 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2871 <div class="directive-section"><h2><a name="limit" id="limit">Directive</a> <a name="Limit" id="Limit">&lt;Limit&gt;</a> <a title="Lien permanent" href="#limit" class="permalink">&para;</a></h2>
2872 <table class="directive">
2873 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite les contrôles d'accès que la section contient à
2874 certaines méthodes HTTP</td></tr>
2875 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Limit <var>méthode</var> [<var>méthode</var>] ... &gt; ...
2876     &lt;/Limit&gt;</code></td></tr>
2877 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
2878 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>AuthConfig, Limit</td></tr>
2879 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2880 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2881 </table>
2882     <p>Les contrôles d'accès s'appliquent normalement à
2883     <strong>toutes</strong> les méthodes d'accès, et c'est en général le
2884     comportement souhaité. <strong>Dans le cas général, les directives
2885     de contrôle d'accès n'ont pas à être placées dans une section
2886     <code class="directive">&lt;Limit&gt;</code>.</strong></p>
2887
2888     <p>La directive <code class="directive">&lt;Limit&gt;</code> a pour
2889     but de limiter les effets des contrôles d'accès aux méthodes HTTP
2890     spécifiées. Pour toutes les autres méthodes, les restrictions
2891     d'accès contenues dans la section <code class="directive">&lt;Limit&gt;</code> <strong>n'auront aucun
2892     effet</strong>. L'exemple suivant n'applique les contrôles d'accès
2893     qu'aux méthodes <code>POST</code>, <code>PUT</code>, et
2894     <code>DELETE</code>, en laissant les autres méthodes sans protection
2895     :</p>
2896
2897     <pre class="prettyprint lang-config">&lt;Limit POST PUT DELETE&gt;
2898   Require valid-user
2899 &lt;/Limit&gt;</pre>
2900
2901
2902     <p>La liste des noms de méthodes peut contenir une ou plusieurs
2903     valeurs parmi les suivantes : <code>GET</code>, <code>POST</code>,
2904     <code>PUT</code>, <code>DELETE</code>, <code>CONNECT</code>,
2905     <code>OPTIONS</code>, <code>PATCH</code>, <code>PROPFIND</code>,
2906     <code>PROPPATCH</code>, <code>MKCOL</code>, <code>COPY</code>,
2907     <code>MOVE</code>, <code>LOCK</code>, et <code>UNLOCK</code>.
2908     <strong>Le nom de méthode est sensible à la casse.</strong> Si la
2909     valeur <code>GET</code> est présente, les requêtes <code>HEAD</code>
2910     seront aussi concernées. La méthode <code>TRACE</code> ne peut pas
2911     être limitée (voir la directive <code class="directive"><a href="#traceenable">TraceEnable</a></code>).</p>
2912
2913     <div class="warning">Une section <code class="directive">&lt;LimitExcept&gt;</code> doit toujours être préférée à
2914     une section <code class="directive">&lt;Limit&gt;</code> pour la
2915     restriction d'accès, car une section <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code> fournit une protection contre
2916     les méthodes arbitraires.</div>
2917
2918     <p>Les directives <code class="directive">&lt;Limit&gt;</code> et
2919     <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>
2920     peuvent être imbriquées. Dans ce cas, pour chaque niveau des
2921     directives <code class="directive">&lt;Limit&gt;</code> ou  <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>, ces dernières
2922     doivent restreindre l'accès pour les méthodes auxquelles les
2923     contrôles d'accès s'appliquent.</p>
2924
2925     <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
2926     <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> dont la
2927     condition est satisfaite autorise la requête, sans tenir compte de
2928     la présence d'autres directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>.</div>
2929
2930     <p>Par exemple, avec la configuration suivante, tous les
2931     utilisateurs seront autorisés à effectuer des requêtes
2932     <code>POST</code>, et la directive <code>Require group
2933     editors</code> sera ignorée dans tous les cas :</p>
2934
2935     <pre class="prettyprint lang-config">&lt;LimitExcept GET&gt;
2936   Require valid-user
2937 &lt;/LimitExcept&gt;
2938 &lt;Limit POST&gt;
2939   Require group editors
2940 &lt;/Limit&gt;</pre>
2941
2942
2943 </div>
2944 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2945 <div class="directive-section"><h2><a name="limitexcept" id="limitexcept">Directive</a> <a name="LimitExcept" id="LimitExcept">&lt;LimitExcept&gt;</a> <a title="Lien permanent" href="#limitexcept" class="permalink">&para;</a></h2>
2946 <table class="directive">
2947 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applique les contrôles d'accès à toutes les méthodes HTTP,
2948 sauf celles qui sont spécifiées</td></tr>
2949 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;LimitExcept <var>méthode</var> [<var>méthode</var>] ... &gt; ...
2950     &lt;/LimitExcept&gt;</code></td></tr>
2951 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
2952 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>AuthConfig, Limit</td></tr>
2953 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2954 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2955 </table>
2956     <p><code class="directive">&lt;LimitExcept&gt;</code> et
2957     <code>&lt;/LimitExcept&gt;</code> permettent de regrouper des
2958     directives de contrôle d'accès qui s'appliqueront à toutes les
2959     méthodes d'accès HTTP qui ne font <strong>pas</strong> partie de la
2960     liste des arguments ; en d'autres termes, elles ont un comportement
2961     opposé à celui de la section <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code>, et on peut les utiliser pour
2962     contrôler aussi bien les méthodes standards que les méthodes non
2963     standards ou non reconnues. Voir la documentation de la section
2964     <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> pour plus
2965     de détails.</p>
2966
2967     <p>Par exemple :</p>
2968
2969     <pre class="prettyprint lang-config">&lt;LimitExcept POST GET&gt;
2970   Require valid-user
2971 &lt;/LimitExcept&gt;</pre>
2972
2973
2974
2975 </div>
2976 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
2977 <div class="directive-section"><h2><a name="limitinternalrecursion" id="limitinternalrecursion">Directive</a> <a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a title="Lien permanent" href="#limitinternalrecursion" class="permalink">&para;</a></h2>
2978 <table class="directive">
2979 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le nombre maximal de redirections internes et de
2980 sous-requêtes imbriquées</td></tr>
2981 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitInternalRecursion <var>nombre</var> [<var>nombre</var>]</code></td></tr>
2982 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
2983 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
2984 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
2985 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
2986 </table>
2987     <p>Une redirection interne survient, par exemple, quand on utilise
2988     la directive <code class="directive"><a href="../mod/mod_actions.html#action">Action</a></code> qui
2989     redirige en interne la requête d'origine vers un script CGI. Une
2990     sous-requête est le mécanisme qu'utilise Apache httpd pour déterminer ce
2991     qui se passerait pour un URI s'il faisait l'objet d'une requête. Par
2992     exemple, <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> utilise les sous-requêtes pour
2993     rechercher les fichiers listés dans la directive <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>.</p>
2994
2995     <p>La directive <code class="directive">LimitInternalRecursion</code> permet
2996     d'éviter un crash du serveur dû à un bouclage infini de redirections
2997     internes ou de sous-requêtes. De tels bouclages sont dus en général
2998     à des erreurs de configuration.</p>
2999
3000     <p>La directive accepte, comme arguments, deux limites qui sont
3001     évaluées à chaque requête. Le premier <var>nombre</var> est le
3002     nombre maximum de redirections internes qui peuvent se succéder. Le
3003     second <var>nombre</var> détermine la profondeur d'imbrication
3004     maximum des sous-requêtes. Si vous ne spécifiez qu'un seul
3005     <var>nombre</var>, il sera affecté aux deux limites.</p>
3006
3007     <pre class="prettyprint lang-config">LimitInternalRecursion 5</pre>
3008
3009
3010 </div>
3011 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3012 <div class="directive-section"><h2><a name="limitrequestbody" id="limitrequestbody">Directive</a> <a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a title="Lien permanent" href="#limitrequestbody" class="permalink">&para;</a></h2>
3013 <table class="directive">
3014 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>limite la taille maximale du corps de la requête HTTP
3015 envoyée par le client</td></tr>
3016 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestBody <var>octets</var></code></td></tr>
3017 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestBody 0</code></td></tr>
3018 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
3019 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
3020 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3021 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3022 </table>
3023     <p>Cette directive spécifie la taille maximale autorisée pour le
3024     corps d'une requête ; la valeur de l'argument <var>octets</var> va
3025     de 0 (pour une taille illimitée), à 2147483647 (2Go). Voir la note
3026     ci-dessous pour la limite d'applicabilité aux requêtes mandatées.</p>
3027
3028     <p>La directive <code class="directive">LimitRequestBody</code> permet de
3029     définir une limite pour la taille maximale autorisée du corps d'une
3030     requête HTTP en tenant compte du contexte dans lequel la directive
3031     a été placée (c'est à dire au niveau du serveur, d'un répertoire,
3032     d'un fichier ou d'une localisation). Si la requête du client dépasse
3033     cette limite, le serveur répondra par un message d'erreur et ne
3034     traitera pas la requête. La taille du corps d'une requête normale va
3035     varier de manière importante en fonction de la nature de la
3036     ressource et des méthodes autorisées pour cette dernière. Les
3037     scripts CGI utilisent souvent le corps du message pour extraire les
3038     informations d'un formulaire. Les implémentations de la méthode
3039     <code>PUT</code> nécessitent une valeur au moins aussi élevée que la
3040     taille maximale des représentations que le serveur désire accepter
3041     pour cette ressource.</p>
3042
3043     <p>L'administrateur du serveur peut utiliser cette directive pour
3044     contrôler plus efficacement les comportements anormaux des requêtes
3045     des clients, ce qui lui permettra de prévenir certaines formes
3046     d'attaques par déni de service.</p>
3047
3048     <p>Si par exemple, vous autorisez le chargement de fichiers vers une
3049     localisation particulière, et souhaitez limiter la taille des
3050     fichiers chargés à 100Ko, vous pouvez utiliser la directive suivante
3051     :</p>
3052
3053     <pre class="prettyprint lang-config">LimitRequestBody 102400</pre>
3054
3055
3056     <div class="note"><p>Pour une description détaillée de la manière dont cette
3057     directive est interprétée par les requêtes mandatées, voir la
3058     documentation du module <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>.</p>
3059     </div>
3060
3061
3062 </div>
3063 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3064 <div class="directive-section"><h2><a name="limitrequestfields" id="limitrequestfields">Directive</a> <a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a title="Lien permanent" href="#limitrequestfields" class="permalink">&para;</a></h2>
3065 <table class="directive">
3066 <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
3067 requête HTTP</td></tr>
3068 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFields <var>nombre</var></code></td></tr>
3069 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestFields 100</code></td></tr>
3070 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
3071 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3072 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3073 </table>
3074     <p><var>nombre</var> est un entier de 0 (nombre de champs illimité)
3075     à 32767. La valeur par défaut est définie à la compilation par la
3076     constante <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (100 selon la
3077     distribution).</p>
3078
3079     <p>La directive <code class="directive">LimitRequestFields</code> permet à
3080     l'administrateur du serveur de modifier le nombre maximum de champs
3081     d'en-tête autorisés dans une requête HTTP. Pour un serveur, cette
3082     valeur doit être supérieure au nombre de champs qu'une requête
3083     client normale peut contenir. Le nombre de champs d'en-tête d'une
3084     requête qu'un client utilise dépasse rarement 20, mais ce nombre
3085     peut varier selon les implémentations des clients, et souvent en
3086     fonction des extensions que les utilisateurs configurent dans leurs
3087     navigateurs pour supporter la négociation de contenu détaillée. Les
3088     extensions HTTP optionnelles utilisent souvent les
3089     champs d'en-tête des requêtes.</p>
3090
3091     <p>L'administrateur du serveur peut utiliser cette directive pour
3092     contrôler plus efficacement les comportements anormaux des requêtes
3093     des clients, ce qui lui permettra de prévenir certaines formes
3094     d'attaques par déni de service. La valeur spécifiée doit être
3095     augmentée si les clients standards reçoivent une erreur du serveur
3096     indiquant que la requête comportait un nombre d'en-têtes trop
3097     important.</p>
3098
3099     <p>Par exemple :</p>
3100
3101     <pre class="prettyprint lang-config">LimitRequestFields 50</pre>
3102
3103
3104     <div class="warning"><h3>Avertissement</h3>
3105      <p>Dans le cas des serveurs virtuels à base de noms, la valeur de
3106      cette directive est extraite du serveur virtuel par défaut (le
3107      premier de la liste) pour la paire adresse IP/port.</p>
3108     </div>
3109
3110
3111 </div>
3112 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3113 <div class="directive-section"><h2><a name="limitrequestfieldsize" id="limitrequestfieldsize">Directive</a> <a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a title="Lien permanent" href="#limitrequestfieldsize" class="permalink">&para;</a></h2>
3114 <table class="directive">
3115 <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
3116 requête HTTP</td></tr>
3117 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFieldSize <var>octets</var></code></td></tr>
3118 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestFieldSize 8190</code></td></tr>
3119 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
3120 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3121 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3122 </table>
3123     <p>Cette directive permet de définir le nombre maximum
3124     d'<var>octets</var> autorisés dans un en-tête de requête HTTP.</p>
3125
3126     <p>La directive <code class="directive">LimitRequestFieldSize</code> permet
3127     à l'administrateur du serveur de définir la taille
3128     maximale autorisée d'un en-tête de requête HTTP. Pour un serveur,
3129     cette valeur doit être suffisamment grande pour contenir tout
3130     en-tête d'une requête client normale. La taille d'un champ d'en-tête
3131     de requête normal va varier selon les implémentations des clients,
3132     et en fonction des extensions que les utilisateurs
3133     configurent dans leurs navigateurs pour supporter la négociation de
3134     contenu détaillée. Les en-têtes d'authentification SPNEGO peuvent
3135     atteindre une taille de 12392 octets.</p>
3136
3137     <p>&gt;L'administrateur du serveur peut utiliser cette directive pour
3138     contrôler plus efficacement les comportements anormaux des requêtes
3139     des clients, ce qui lui permettra de prévenir certaines formes
3140     d'attaques par déni de service.</p>
3141
3142     <p>Par exemple ::</p>
3143
3144     <pre class="prettyprint lang-config">LimitRequestFieldSize 4094</pre>
3145
3146
3147     <div class="note">Dans des conditions normales, la valeur par défaut de cette
3148     directive ne doit pas être modifiée.</div>
3149
3150     <div class="warning"><h3>Avertissement</h3>
3151      <p>Dans le cas des serveurs virtuels à base de noms, la valeur de
3152      cette directive est extraite du serveur virtuel par défaut (le
3153      premier de la liste) pour lequel la paire adresse IP/port
3154      correspond le mieux.</p>
3155     </div>
3156
3157 </div>
3158 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3159 <div class="directive-section"><h2><a name="limitrequestline" id="limitrequestline">Directive</a> <a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a title="Lien permanent" href="#limitrequestline" class="permalink">&para;</a></h2>
3160 <table class="directive">
3161 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la taille maximale d'une ligne de requête
3162 HTTP</td></tr>
3163 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestLine <var>octets</var></code></td></tr>
3164 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
3165 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
3166 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3167 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3168 </table>
3169     <p>Cette directive permet de définir la taille maximale autorisée
3170     pour une ligne de requête HTTP en <var>octets</var>.</p>
3171
3172     <p>La directive <code class="directive">LimitRequestLine</code> permet à
3173     l'administrateur du serveur de définir la taille
3174     maximale autorisée d'une ligne de requête HTTP client. Comme une
3175     requête comporte une méthode HTTP, un URI, et une version de
3176     protocole, la directive <code class="directive">LimitRequestLine</code>
3177     impose une restriction sur la longueur maximale autorisée pour un
3178     URI dans une requête au niveau du serveur. Pour un serveur, cette
3179     valeur doit être suffisamment grande pour référencer les noms de
3180     toutes ses ressources, y compris toutes informations pouvant être
3181     ajoutées dans la partie requête d'une méthode <code>GET</code>.</p>
3182
3183     <p>L'administrateur du serveur peut utiliser cette directive pour
3184     contrôler plus efficacement les comportements anormaux des requêtes
3185     des clients, ce qui lui permettra de prévenir certaines formes
3186     d'attaques par déni de service.</p>
3187
3188     <p>Par exemple :</p>
3189
3190     <pre class="prettyprint lang-config">LimitRequestLine 4094</pre>
3191
3192
3193     <div class="note">Dans des conditions normales, cette directive doit conserver
3194     sa valeur par défaut.</div>
3195
3196     <div class="warning"><h3>Avertissement</h3>
3197      <p>Dans le cas des serveurs virtuels à base de noms, la valeur de
3198      cette directive est extraite du serveur virtuel par défaut (le
3199      premier de la liste) pour lequel la paire adresse IP/port
3200      correspond le mieux.</p>
3201     </div>
3202
3203
3204 </div>
3205 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3206 <div class="directive-section"><h2><a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a> <a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a title="Lien permanent" href="#limitxmlrequestbody" class="permalink">&para;</a></h2>
3207 <table class="directive">
3208 <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
3209 XML</td></tr>
3210 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitXMLRequestBody <var>octets</var></code></td></tr>
3211 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
3212 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
3213 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
3214 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3215 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3216 </table>
3217     <p>Taille maximale (en octets) du corps d'une requête au format XML.
3218     Une valeur de <code>0</code> signifie qu'aucune limite n'est
3219     imposée.</p>
3220
3221     <p>Exemple :</p>
3222
3223     <pre class="prettyprint lang-config">LimitXMLRequestBody 0</pre>
3224
3225
3226
3227 </div>
3228 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3229 <div class="directive-section"><h2><a name="location" id="location">Directive</a> <a name="Location" id="Location">&lt;Location&gt;</a> <a title="Lien permanent" href="#location" class="permalink">&para;</a></h2>
3230 <table class="directive">
3231 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'applique les directives contenues qu'aux URLs
3232 spécifiées</td></tr>
3233 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Location
3234     <var>chemin URL</var>|<var>URL</var>&gt; ... &lt;/Location&gt;</code></td></tr>
3235 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
3236 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3237 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3238 </table>
3239     <p>La directive <code class="directive">&lt;Location&gt;</code>
3240     limite la portée des directives contenues aux URLs définies par
3241     l'argument URL. Elle est similaire à la directive <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>, et marque le
3242     début d'une section qui se termine par une directive
3243     <code>&lt;/Location&gt;</code>. Les sections <code class="directive">&lt;Location&gt;</code> sont traitées selon l'ordre dans
3244     lequel elles apparaissent dans le fichier de configuration, mais
3245     après les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et la lecture des
3246     fichiers <code>.htaccess</code>, et après les sections <code class="directive"><a href="#files">&lt;Files&gt;</a></code>.</p>
3247
3248     <p>Les sections <code class="directive">&lt;Location&gt;</code>
3249     agissent complètement en dehors du système de fichiers. Ceci a de
3250     nombreuses conséquences. Parmi les plus importantes, on ne doit pas
3251     utiliser les sections <code class="directive">&lt;Location&gt;</code>
3252     pour contrôler l'accès aux répertoires du système de fichiers. Comme
3253     plusieurs URLs peuvent correspondre au même répertoire du système de
3254     fichiers, un tel contrôle d'accès pourrait être contourné.</p>
3255
3256     <p>Les directives que contient cette section seront appliquées aux
3257     requêtes si la partie chemin de l'URL satisfait à l'un au moins de
3258     ces critères :
3259     </p>
3260     <ul>
3261       <li>Le chemin spécifié correspond exactement à la partie chemin de
3262       l'URL.
3263       </li>
3264       <li>Le chemin spécifié, qui se termine par un slash, est un
3265       préfixe de la partie chemin de l'URL (traité comme une racine du
3266       contexte).
3267       </li>
3268       <li>Le chemin spécifié, si on lui ajoute un slash de fin, est un
3269       préfixe de la partie chemin de l'URL (aussi traité comme une racine du
3270       contexte).
3271       </li>
3272     </ul>
3273     <p>
3274     Dans l'exemple ci-dessous, où aucun slash de fin n'est utilisé, les
3275     directives contenues dans la section s'appliqueront à /private1,
3276     /private1/ et /private1/file.txt, mais pas à /private1other.
3277     </p>
3278     <pre class="prettyprint lang-config">&lt;Location "/private1"&gt;
3279     #  ...
3280 &lt;/Location&gt;</pre>
3281
3282     <p>
3283     De même, dans l'exemple ci-dessous, où l'on utilise un slash de fin, les
3284     directives contenues dans la section s'appliqueront à /private2/ et
3285     à /private2/file.txt, mais pas à /private2other.
3286     </p>
3287     <pre class="prettyprint lang-config">&lt;Location "/private2<em>/</em>"&gt;
3288     # ...
3289 &lt;/Location&gt;</pre>
3290
3291
3292     <div class="note"><h3>Quand utiliser la section <code class="directive">&lt;Location&gt;</code></h3>
3293
3294     <p>Vous pouvez utiliser une section <code class="directive">&lt;Location&gt;</code> pour appliquer des directives à
3295     des contenus situés en dehors du système de fichiers. Pour les
3296     contenus situés à l'intérieur du système de fichiers, utilisez
3297     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
3298     "/"&gt;</code> constitue une exception et permet d'appliquer aisément
3299     une configuration à l'ensemble du serveur.</p>
3300     </div>
3301
3302     <p>Pour toutes les requêtes originales (non mandatées), l'argument
3303     URL est un chemin d'URL de la forme
3304     <code>/chemin/</code>. <em>Aucun protocole, nom d'hôte, port, ou chaîne
3305     de requête ne doivent apparaître.</em> Pour les requêtes mandatées, l'URL
3306     spécifiée doit être de la forme
3307     <code>protocole://nom_serveur/chemin</code>, et vous devez inclure
3308     le préfixe.</p>
3309
3310     <p>L'URL peut contenir des caractères génériques. Dans une chaîne
3311     avec caractères génériques, <code>?</code> correspond à un caractère
3312     quelconque, et <code>*</code> à toute chaîne de caractères. Les
3313     caractères génériques ne peuvent pas remplacer un / dans le chemin
3314     URL.</p>
3315
3316     <p>On peut aussi utiliser les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions
3317     rationnelles</a>, moyennant l'addition d'un caractère
3318     <code>~</code>. Par exemple :</p>
3319
3320     <pre class="prettyprint lang-config">&lt;Location ~ "/(extra|special)/data"&gt;
3321     #...
3322 &lt;/Location&gt;</pre>
3323
3324
3325     <p>concernerait les URLs contenant les sous-chaîne
3326     <code>/extra/data</code> ou <code>/special/data</code>. La directive
3327     <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code>
3328     présente un comportement identique à la version avec expressions
3329     rationnelles de la directive <code class="directive">&lt;Location&gt;</code>, et son utilisation est
3330     préférable à l'utilisation de cette dernière pour la simple raison
3331     qu'il est difficile de distinguer <code>~</code> de <code>-</code>
3332     dans la plupart des fontes.</p>
3333
3334     <p>La directive <code class="directive">&lt;Location&gt;</code>
3335     s'utilise principalement avec la directive <code class="directive"><a href="#sethandler">SetHandler</a></code>. Par exemple, pour activer les
3336     requêtes d'état, mais ne les autoriser que depuis des navigateurs
3337     appartenant au domaine <code>example.com</code>, vous pouvez
3338     utiliser :</p>
3339
3340     <pre class="prettyprint lang-config">&lt;Location "/status"&gt;
3341   SetHandler server-status
3342   Require host example.com
3343 &lt;/Location&gt;</pre>
3344
3345
3346     <div class="note"><h3>Note à propos du slash (/)</h3>
3347       <p>La signification du caractère slash dépend de l'endroit où il
3348       se trouve dans l'URL. Les utilisateurs peuvent être habitués à
3349       son comportement dans le système de fichiers où plusieurs slashes
3350       successifs sont souvent réduits à un slash unique (en d'autres
3351       termes, <code>/home///foo</code> est identique à
3352       <code>/home/foo</code>). Dans l'espace de nommage des URLs, ce
3353       n'est cependant pas toujours le cas. Pour la directive <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code> et la
3354       version avec expressions rationnelles de la directive <code class="directive">&lt;Location&gt;</code>, vous devez spécifier
3355       explicitement les slashes multiples si telle est votre
3356       intention.</p>
3357
3358       <p>Par exemple, <code>&lt;LocationMatch "^/abc"&gt;</code> va
3359       correspondre à l'URL <code>/abc</code> mais pas à l'URL <code>
3360       //abc</code>. La directive <code class="directive">&lt;Location&gt;</code> sans expression rationnelle se comporte de
3361       la même manière lorsqu'elle est utilisée pour des requêtes
3362       mandatées. Par contre, lorsque la directive <code class="directive">&lt;Location&gt;</code> sans expression rationnelle
3363       est utilisée pour des requêtes non mandatées, elle fera
3364       correspondre implicitement les slashes multiples à des slashes
3365       uniques. Par exemple, si vous spécifiez <code>&lt;Location
3366       "/abc/def"&gt;</code>, une requête de la forme
3367       <code>/abc//def</code> correspondra.</p>
3368     </div>
3369
3370 <h3>Voir aussi</h3>
3371 <ul>
3372 <li><a href="../sections.html">Comment fonctionnent les sections
3373 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
3374 explication de la manière dont ces différentes sections se combinent
3375 entre elles à la réception d'une requête.</li>
3376 </ul>
3377 </div>
3378 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3379 <div class="directive-section"><h2><a name="locationmatch" id="locationmatch">Directive</a> <a name="LocationMatch" id="LocationMatch">&lt;LocationMatch&gt;</a> <a title="Lien permanent" href="#locationmatch" class="permalink">&para;</a></h2>
3380 <table class="directive">
3381 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'applique les directives contenues qu'aux URLs
3382 correspondant à une expression rationnelle</td></tr>
3383 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;LocationMatch
3384     <var>regex</var>&gt; ... &lt;/LocationMatch&gt;</code></td></tr>
3385 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
3386 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3387 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3388 </table>
3389     <p>La directive <code class="directive">&lt;LocationMatch&gt;</code>
3390     limite la portée des directives contenues à l'URL spécifiée, de
3391     manière identique à la directive <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Mais son argument permettant de
3392     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
3393     chaîne de caractères. Par exemple :</p>
3394
3395     <pre class="prettyprint lang-config">&lt;LocationMatch "/(extra|special)/data"&gt;
3396     # ...
3397 &lt;/LocationMatch&gt;</pre>
3398
3399
3400     <p>correspondrait à toute URL contenant les sous-chaînes
3401     <code>/extra/data</code> ou <code>/special/data</code>.</p>
3402
3403     <div class="note"><p>Si vous recherchez une URL <strong>commençant par</strong>
3404     plutôt que seulement contenant <code>/extra/data</code>, préfixez
3405     l'expression rationnelle avec un <code>^</code>.</p>
3406
3407     <pre class="prettyprint lang-config">&lt;LocationMatch "^/(extra|special)/data"&gt;</pre>
3408
3409     </div>
3410
3411     <p>A partir de la version 2.4.8, les groupes nommés et les
3412     références arrières sont extraits et enregistrés dans
3413     l'environnement avec leur nom en majuscules et préfixé
3414     par "MATCH_". Ceci permet
3415     de référencer des URLs dans des <a href="../expr.html">expressions</a>
3416     ou au sein de modules comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Pour
3417     éviter toute confusion, les références arrières numérotées (non
3418     nommées) sont ignorées. Vous devez utiliser à la place des groupes
3419     nommés.</p>
3420
3421 <pre class="prettyprint lang-config">&lt;LocationMatch "^/combined/(?&lt;sitename&gt;[^/]+)"&gt;
3422     Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
3423 &lt;/LocationMatch&gt;</pre>
3424
3425
3426     <div class="note"><h3>Note à propos du slash '/'</h3>
3427       <p>La signification du caractère slash '/' dépend de l'endroit où il
3428       apparaît dans une URL. Les utilisateurs sont habitués à voir de multiples
3429       slashes adjacents réduits à un seul au sein du système de fichiers (par
3430       exemple, <code>/home///foo</code> est équivalent à
3431       <code>/home/foo</code>). Ce n'est n'est cependant pas toujours le cas au
3432       sein des URLs. En effet, si vous souhaitez spécifier plusieurs slashes,
3433       vous devez le faire explicitement au sein de la directive <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code> et de la version
3434       regex de la directive <code class="directive">&lt;Location&gt;</code>.</p>
3435
3436       <p>Par exemple, <code>&lt;LocationMatch "^/abc"&gt;</code> correspondra à
3437       l'URL <code>/abc</code>, mais pas à l'URL <code>//abc</code>. La directive
3438       (non-regex) <code class="directive">&lt;Location&gt;</code> se comporte de
3439       la même manière lorsqu'elle est utilisée dans les requêtes de mandataire.
3440       Par contre, pour les autres types de requêtes, la directive <code class="directive">&lt;Location&gt;</code> considérera plusieurs slashes
3441       adjacents comme équivalents à un seul slash. Par exemple, si vous
3442       spécifiez <code>&lt;Location "/abc/def"&gt;</code>, une requête pour
3443       <code>/abc//def</code> correspondra.</p>
3444     </div>
3445
3446 <h3>Voir aussi</h3>
3447 <ul>
3448 <li><a href="../sections.html">Comment fonctionnent les sections
3449 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
3450 explication de la manière dont ces différentes sections se combinent
3451 entre elles à la réception d'une requête.</li>
3452 </ul>
3453 </div>
3454 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3455 <div class="directive-section"><h2><a name="loglevel" id="loglevel">Directive</a> <a name="LogLevel" id="LogLevel">LogLevel</a> <a title="Lien permanent" href="#loglevel" class="permalink">&para;</a></h2>
3456 <table class="directive">
3457 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contrôle la verbosité du journal des erreurs</td></tr>
3458 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogLevel [<var>module</var>:]<var>niveau</var>
3459     [<var>module</var>:<var>niveau</var>] ...
3460 </code></td></tr>
3461 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>LogLevel warn</code></td></tr>
3462 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
3463 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3464 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3465 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>La configuration du niveau de journalisation par module
3466 et par répertoire est disponible depuis la version 2.3.6 du serveur HTTP
3467 Apache</td></tr>
3468 </table>
3469     <p>La directive <code class="directive">LogLevel</code> permet d'ajuster la
3470     verbosité des messages enregistrés dans les journaux d'erreur (voir
3471     la directive <code class="directive"><a href="#errorlog">ErrorLog</a></code>
3472     directive). Les <var>niveau</var>x disponibles sont présentés
3473     ci-après, par ordre de criticité décroissante :</p>
3474
3475     <table class="bordered">
3476
3477       <tr>
3478         <th><strong>Niveau</strong> </th>
3479
3480         <th><strong>Description</strong> </th>
3481
3482         <th><strong>Exemple</strong> </th>
3483       </tr>
3484
3485       <tr>
3486         <td><code>emerg</code> </td>
3487
3488         <td>Urgences - le système est inutilisable.</td>
3489
3490         <td>"Child cannot open lock file. Exiting"</td>
3491       </tr>
3492
3493       <tr>
3494         <td><code>alert</code> </td>
3495
3496         <td>Des mesures doivent être prises immédiatement.</td>
3497
3498         <td>"getpwuid: couldn't determine user name from uid"</td>
3499       </tr>
3500
3501       <tr>
3502         <td><code>crit</code> </td>
3503
3504         <td>Conditions critiques.</td>
3505
3506         <td>"socket: Failed to get a socket, exiting child"</td>
3507       </tr>
3508
3509       <tr>
3510         <td><code>error</code> </td>
3511
3512         <td>Erreurs.</td>
3513
3514         <td>"Premature end of script headers"</td>
3515       </tr>
3516
3517       <tr>
3518         <td><code>warn</code> </td>
3519
3520         <td>Avertissements.</td>
3521
3522         <td>"child process 1234 did not exit, sending another
3523         SIGHUP"</td>
3524       </tr>
3525
3526       <tr>
3527         <td><code>notice</code> </td>
3528
3529         <td>Evènement important mais normal.</td>
3530
3531         <td>"httpd: caught SIGBUS, attempting to dump core in
3532         ..."</td>
3533       </tr>
3534
3535       <tr>
3536         <td><code>info</code> </td>
3537
3538         <td>Informations.</td>
3539
3540         <td>"Server seems busy, (you may need to increase
3541         StartServers, or Min/MaxSpareServers)..."</td>
3542       </tr>
3543
3544       <tr>
3545         <td><code>debug</code> </td>
3546
3547         <td>Messages de débogage.</td>
3548
3549         <td>"Opening config file ..."</td>
3550       </tr>
3551       <tr>
3552         <td><code>trace1</code> </td>
3553
3554         <td>Messages de traces</td>
3555
3556         <td>"proxy: FTP: control connection complete"</td>
3557       </tr>
3558       <tr>
3559         <td><code>trace2</code> </td>
3560
3561         <td>Messages de traces</td>
3562
3563         <td>"proxy: CONNECT: sending the CONNECT request to the remote proxy"</td>
3564       </tr>
3565       <tr>
3566         <td><code>trace3</code> </td>
3567
3568         <td>Messages de traces</td>
3569
3570         <td>"openssl: Handshake: start"</td>
3571       </tr>
3572       <tr>
3573         <td><code>trace4</code> </td>
3574
3575         <td>Messages de traces</td>
3576
3577         <td>"read from buffered SSL brigade, mode 0, 17 bytes"</td>
3578       </tr>
3579       <tr>
3580         <td><code>trace5</code> </td>
3581
3582         <td>Messages de traces</td>
3583
3584         <td>"map lookup FAILED: map=rewritemap key=keyname"</td>
3585       </tr>
3586       <tr>
3587         <td><code>trace6</code> </td>
3588
3589         <td>Messages de traces</td>
3590
3591         <td>"cache lookup FAILED, forcing new map lookup"</td>
3592       </tr>
3593       <tr>
3594         <td><code>trace7</code> </td>
3595
3596         <td>Messages de traces, enregistrement d'une grande quantité de
3597         données</td>
3598
3599         <td>"| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |"</td>
3600       </tr>
3601       <tr>
3602         <td><code>trace8</code> </td>
3603
3604         <td>Messages de traces, enregistrement d'une grande quantité de
3605         données</td>
3606
3607         <td>"| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |"</td>
3608       </tr>
3609     </table>
3610
3611     <p>Lorsqu'un niveau particulier est spécifié, les messages de tous
3612     les autres niveaux de criticité supérieure seront aussi enregistrés.
3613     <em>Par exemple</em>, si <code>LogLevel info</code> est spécifié,
3614     les messages de niveaux <code>notice</code> et <code>warn</code>
3615     seront aussi émis.</p>
3616
3617     <p>Il est recommandé d'utiliser un niveau <code>crit</code> ou
3618     inférieur.</p>
3619
3620     <p>Par exemple :</p>
3621
3622     <pre class="prettyprint lang-config">LogLevel notice</pre>
3623
3624
3625     <div class="note"><h3>Note</h3>
3626       <p>Si la journalisation s'effectue directement dans un fichier,
3627       les messages de niveau <code>notice</code> ne peuvent pas être
3628       supprimés et sont donc toujours journalisés. Cependant, ceci ne
3629       s'applique pas lorsque la journalisation s'effectue vers
3630       <code>syslog</code>.</p>
3631     </div>
3632
3633     <p>Spécifier un niveau sans nom de module va attribuer ce niveau à
3634     tous les modules. Spécifier un niveau avec nom de module va
3635     attribuer ce niveau à ce module seulement. Il est possible de
3636     spécifier un module par le nom de son fichier source ou par son
3637     identificateur, avec ou sans le suffixe <code>_module</code>. Les
3638     trois spécifications suivantes sont donc équivalentes :</p>
3639
3640     <pre class="prettyprint lang-config">LogLevel info ssl:warn
3641 LogLevel info mod_ssl.c:warn
3642 LogLevel info ssl_module:warn</pre>
3643
3644
3645     <p>Il est aussi possible d'attribuer un niveau de journalisation par
3646     répertoire :</p>
3647
3648     <pre class="prettyprint lang-config">LogLevel info
3649 &lt;Directory "/usr/local/apache/htdocs/app"&gt;
3650   LogLevel debug
3651 &lt;/Directory&gt;</pre>
3652
3653
3654     <div class="note">
3655         La configuration du niveau de journalisation par répertoire
3656         n'affecte que les messages journalisés après l'interprétation de
3657         la requête et qui sont associés à cette dernière. Les messages
3658         de journalisation associés au serveur ou à la connexion ne sont
3659         pas affectés. Il est cependant possible d'agir sur ces
3660         derniers à l'aide de la directive <code class="directive"><a href="#logleveloverride">LogLevelOverride</a></code>.
3661     </div>
3662
3663 <h3>Voir aussi</h3>
3664 <ul>
3665 <li><code class="directive"><a href="#errorlog">ErrorLog</a></code></li>
3666 <li><code class="directive"><a href="#errorlogformat">ErrorLogFormat</a></code></li>
3667 <li><code class="directive"><a href="#logleveloverride">LogLevelOverride</a></code></li>
3668 <li><a href="../logs.html">Journaux du serveur HTTP Apache</a></li>
3669 </ul>
3670 </div>
3671 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3672 <div class="directive-section"><h2><a name="logleveloverride" id="logleveloverride">Directive</a> <a name="LogLevelOverride" id="LogLevelOverride">LogLevelOverride</a> <a title="Lien permanent" href="#logleveloverride" class="permalink">&para;</a></h2>
3673 <table class="directive">
3674 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Surcharge la verbosité du journal des erreurs pour certains
3675 clients</td></tr>
3676 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogLevel <var>ipaddress</var>[/<var>prefixlen</var>]
3677     [<var>module</var>:]<var>level</var> [<var>module</var>:<var>level</var>] ...
3678 </code></td></tr>
3679 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>non définie</code></td></tr>
3680 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
3681 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3682 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3683 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.5.0 du serveur HTTP
3684 Apache.</td></tr>
3685 </table>
3686     <p>La directive <code class="directive">LogLevelOverride</code> permet
3687     d'affiner la définition de la directive <code class="directive"><a href="#loglevel">LogLevel</a></code> pour les requêtes en provenance
3688     de certaines adresses IP. Il est ainsi possible d'activer une
3689     journalisation détaillée seulement pour certains clients à des fins
3690     de test. Les adresses IP sont vérifiées à un stade très précoce du
3691     processus de connexion. Ainsi, la directive
3692     <code class="directive">LogLevelOverride</code> permet de modifier le niveau
3693     de journalisation pour des processus comme la négociation SSL qui
3694     intervient avant l'évaluation d'une éventuelle directive <code class="directive"><a href="#loglevel">LogLevel</a></code> au sein d'un conteneur <code class="directive"><a href="#if">&lt;If&gt;</a></code>.</p>
3695
3696     <p>La directive <code class="directive">LogLevelOverride</code> accepte soit
3697     une adresse IP simple, soit une spécification de sous-réseau CIDR de
3698     la forme adresse-IP/masque. Pour la syntaxe de la spécification du
3699     niveau de journalisation, voir la directive <code class="directive"><a href="#loglevel">LogLevel</a></code> directive.</p>
3700
3701     <p>Pour les requêtes concernées par une directive
3702     <code class="directive">LogLevelOverride</code>, les spécifications de
3703     niveau répertoire de la directive <code class="directive"><a href="#loglevel">LogLevel</a></code> sont ignorées.</p>
3704
3705     <p>Exemples:</p>
3706
3707     <pre class="prettyprint lang-config">        LogLevelOverride 192.0.2.0/24 ssl:trace6
3708         LogLevelOverride 192.0.2.7 ssl:trace8</pre>
3709
3710
3711     <div class="note">
3712         La directive <code class="directive">LogLevelOverride</code> n'affecte que les
3713         messages associés à la requête ou à la connexion. Les messages
3714         associés au serveur ne sont pas affectés.
3715     </div>
3716
3717
3718 <h3>Voir aussi</h3>
3719 <ul>
3720 <li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
3721 </ul>
3722 </div>
3723 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3724 <div class="directive-section"><h2><a name="maxkeepaliverequests" id="maxkeepaliverequests">Directive</a> <a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a title="Lien permanent" href="#maxkeepaliverequests" class="permalink">&para;</a></h2>
3725 <table class="directive">
3726 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de requêtes permises pour une connexion
3727 persistante</td></tr>
3728 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxKeepAliveRequests <var>nombre</var></code></td></tr>
3729 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
3730 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
3731 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3732 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3733 </table>
3734     <p>La directive <code class="directive">MaxKeepAliveRequests</code> permet
3735     de limiter le nombre de requêtes autorisées par connexion lorsque
3736     <code class="directive"><a href="#keepalive">KeepAlive</a></code> est à "on". Si sa
3737     valeur est <code>0</code>, le nombre de requêtes autorisées est
3738     illimité. Il est recommandé de définir une valeur assez haute pour
3739     des performances du serveur maximales.</p>
3740
3741     <p>Par exemple :</p>
3742
3743     <pre class="prettyprint lang-config">MaxKeepAliveRequests 500</pre>
3744
3745
3746 </div>
3747 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3748 <div class="directive-section"><h2><a name="maxrangeoverlaps" id="maxrangeoverlaps">Directive</a> <a name="MaxRangeOverlaps" id="MaxRangeOverlaps">MaxRangeOverlaps</a> <a title="Lien permanent" href="#maxrangeoverlaps" class="permalink">&para;</a></h2>
3749 <table class="directive">
3750 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de chevauchements de segments de données autorisé
3751     (par exemple <code>100-200,150-300</code>) avant le renvoi de la
3752     ressource complète</td></tr>
3753 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRangeOverlaps default | unlimited | none | <var>nombre de
3754     chevauchements</var></code></td></tr>
3755 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxRangeOverlaps 20</code></td></tr>
3756 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
3757 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3758 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3759 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.15 du serveur HTTP
3760     Apache</td></tr>
3761 </table>
3762         <p>La directive <code class="directive">MaxRangeOverlaps</code> permet
3763         de limiter le nombre de chevauchements de segments de données HTTP
3764         autorisé par le serveur. Si le nombre de
3765         chevauchements de segments demandé est supérieur au nombre maximal
3766         autorisé, la ressource sera renvoyée dans son intégralité.</p>
3767
3768         <dl>
3769             <dt><strong>default</strong></dt>
3770             <dd>Limite le nombre de chevauchements de segments à la valeur
3771             par défaut 20 définie à la compilation.</dd>
3772
3773             <dt><strong>none</strong></dt>
3774             <dd>Aucun chevauchement de segment n'est autorisé.</dd>
3775
3776             <dt><strong>unlimited</strong></dt>
3777             <dd>Le nombre de chevauchements de segments est illimité.</dd>
3778
3779             <dt><var>number-of-ranges</var></dt>
3780             <dd>Un nombre positif représente le nombre maximal de
3781             chevauchements de segments autorisé par le serveur.</dd>
3782         </dl>
3783
3784 </div>
3785 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3786 <div class="directive-section"><h2><a name="maxrangereversals" id="maxrangereversals">Directive</a> <a name="MaxRangeReversals" id="MaxRangeReversals">MaxRangeReversals</a> <a title="Lien permanent" href="#maxrangereversals" class="permalink">&para;</a></h2>
3787 <table class="directive">
3788 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre d'inversions d'ordre autorisé dans la spécification des
3789     segments de données (par exemple <code>100-200,50-70</code>) avant le renvoi de la
3790     ressource complète</td></tr>
3791 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRangeReversals default | unlimited | none | <var>nombre
3792     d'inversions</var></code></td></tr>
3793 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxRangeReversals 20</code></td></tr>
3794 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
3795 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3796 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3797 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.15 du serveur HTTP
3798     Apache</td></tr>
3799 </table>
3800         <p>La directive <code class="directive">MaxRangeReversals</code> permet
3801         de limiter le nombre d'inversions d'ordre dans la spécification
3802         des segments de données HTTP
3803         autorisé par le serveur. Si le nombre
3804         d'inversions demandé est supérieur au nombre maximal
3805         autorisé, la ressource sera renvoyée dans son intégralité.</p>
3806
3807         <dl>
3808             <dt><strong>default</strong></dt>
3809             <dd>Limite le nombre d'inversions à la valeur
3810             par défaut 20 définie à la compilation.</dd>
3811
3812             <dt><strong>none</strong></dt>
3813             <dd>Aucune inversion n'est autorisée.</dd>
3814
3815             <dt><strong>unlimited</strong></dt>
3816             <dd>Le nombre d'inversions est illimité.</dd>
3817
3818             <dt><var>number-of-ranges</var></dt>
3819             <dd>Un nombre positif représente le nombre maximal
3820             d'inversions autorisé par le serveur.</dd>
3821         </dl>
3822
3823 </div>
3824 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3825 <div class="directive-section"><h2><a name="maxranges" id="maxranges">Directive</a> <a name="MaxRanges" id="MaxRanges">MaxRanges</a> <a title="Lien permanent" href="#maxranges" class="permalink">&para;</a></h2>
3826 <table class="directive">
3827 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de segments de données autorisé avant le renvoi de
3828 l'intégralité de la ressource</td></tr>
3829 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRanges default | unlimited | none | <var>nombre de segments</var></code></td></tr>
3830 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MaxRanges 200</code></td></tr>
3831 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
3832 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3833 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3834 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.15 du serveur HTTP
3835 Apache</td></tr>
3836 </table>
3837     <p>La directive <code class="directive">MaxRanges</code> permet de limiter
3838     le nombre de segments de données que le serveur va renvoyer au
3839     client. Si un nombre de segments plus important est demandé, la
3840     ressource sera renvoyée dans son intégralité.</p>
3841
3842     <dl>
3843       <dt><strong>default</strong></dt>
3844       <dd>Limite le nombre de segments de données à 200 (valeur par
3845       défaut définie à la compilation).</dd>
3846
3847       <dt><strong>none</strong></dt>
3848       <dd>Les en-têtes Range sont ignorés.</dd>
3849
3850       <dt><strong>unlimited</strong></dt>
3851       <dd>Le nombre de segments de données est illimité.</dd>
3852
3853       <dt><var>nombre de segments</var></dt>
3854       <dd>Un nombre positif représentera la nombre de segments de
3855       données maximal que le serveur renverra au client.</dd>
3856     </dl>
3857
3858 </div>
3859 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3860 <div class="directive-section"><h2><a name="mergetrailers" id="mergetrailers">Directive</a> <a name="MergeTrailers" id="MergeTrailers">MergeTrailers</a> <a title="Lien permanent" href="#mergetrailers" class="permalink">&para;</a></h2>
3861 <table class="directive">
3862 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si les données supplémentaires (trailers) sont
3863 fusionnées avec les en-têtes</td></tr>
3864 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MergeTrailers [on|off]</code></td></tr>
3865 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MergeTrailers off</code></td></tr>
3866 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
3867 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3868 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3869 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.11 du serveur HTTP
3870 Apache</td></tr>
3871 </table>
3872     <p>Cette directive permet de contrôler la fusion des données HTTP
3873     supplémentaires (trailers) avec la représentation interne des
3874     en-têtes. Cette fusion intervient lorsque le corps de la requête a
3875     été entièrement reçu, bien longtemps après que la majeure partie du
3876     traitement des en-têtes ait une chance de pouvoir examiner ou
3877     modifier les en-têtes de la requête.</p>
3878     <p>Cette option a été introduite dans un souci de compatibilité avec
3879     les versions antérieures à 2.4.11, où les données supplémentaires
3880     étaient systématiquement fusionnées avec les en-têtes de la requête.</p>
3881
3882 </div>
3883 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
3884 <div class="directive-section"><h2><a name="mutex" id="mutex">Directive</a> <a name="Mutex" id="Mutex">Mutex</a> <a title="Lien permanent" href="#mutex" class="permalink">&para;</a></h2>
3885 <table class="directive">
3886 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les mécanismes de mutex et le repertoire du fichier
3887 verrou pour tous les mutex ou seulement les mutex spécifiés</td></tr>
3888 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Mutex <var>mécanisme</var> [default|<var>nom-mutex</var>] ... [OmitPID]</code></td></tr>
3889 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Mutex default</code></td></tr>
3890 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
3891 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
3892 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
3893 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.4 du serveur HTTP Apache</td></tr>
3894 </table>
3895     <p>La directive <code class="directive">Mutex</code> permet de définir le
3896     mécanisme de mutex, et éventuellement le répertoire du fichier
3897     verrou que les modules et httpd utilisent pour sérialiser l'accès aux
3898     ressources. Spécifiez <code>default</code> comme second argument
3899     pour modifier la configuration de tous les mutex ; spécifiez un nom
3900     de mutex (voir la table ci-dessous) comme premier argument pour
3901     ne modifier que la configuration de ce mutex.</p>
3902
3903     <p>La directive <code class="directive">Mutex</code> est typiquement
3904     utilisée dans les situations exceptionnelles suivantes :</p>
3905
3906     <ul>
3907         <li>choix d'un autre mécanisme de mutex lorsque le mécanisme par
3908         défaut sélectionné par <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> présente un
3909         problème de fonctionnement ou de performances.</li>
3910
3911         <li>choix d'un autre répertoire utilisé par les mutex à base de
3912         fichier lorsque le répertoire par défaut ne supporte pas le
3913         verrouillage</li>
3914     </ul>
3915
3916     <div class="note"><h3>Modules supportés</h3>
3917     <p>Cette directive ne configure que les mutex qui ont été
3918     enregistrés avec le serveur de base via l'API
3919     <code>ap_mutex_register()</code>. Tous les modules fournis avec
3920     httpd supportent la directive <code class="directive">Mutex</code>, mais il
3921     n'en sera pas forcément de même pour les modules tiers.
3922     Reportez-vous à la documentation du module tiers considéré afin de
3923     déterminer le(s) nom(s) de mutex qui pourront être définis si la
3924     directive est supportée.</p>
3925     </div>
3926
3927
3928
3929     <p>Les <em>mécanismes</em> de mutex disponibles sont les suivants :</p>
3930     <ul>
3931         <li><code>default | yes</code>
3932         <p>C'est l'implémentation du verrouillage par défaut, telle
3933         qu'elle est définie par <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a>. On peut
3934         afficher l'implémentation du verrouillage par défaut via la
3935         commande <code class="program"><a href="../programs/httpd.html">httpd</a></code> avec l'option <code>-V</code>.</p></li>
3936
3937         <li><code>none | no</code>
3938         <p>Le mutex est désactivé, et cette valeur n'est permise pour un
3939         mutex que si le module indique qu'il s'agit d'un choix valide.
3940         Consultez la documentation du module pour plus d'informations.</p></li>
3941
3942         <li><code>posixsem</code>
3943         <p>Une variante de mutex basée sur un sémaphore Posix.</p>
3944
3945         <div class="warning"><h3>Avertissement</h3>
3946         <p>La propriété du sémaphore n'est pas restituée si un thread du
3947         processus gérant le mutex provoque une erreur de segmentation,
3948         ce qui provoquera un blocage du serveur web.</p>
3949         </div>
3950         </li>
3951
3952         <li><code>sysvsem</code>
3953         <p>Une variante de mutex basée sur un sémaphore IPC SystemV.</p>
3954
3955         <div class="warning"><h3>Avertissement</h3>
3956         <p>Il peut arriver que les sémaphores SysV soient conservés si le
3957         processus se crashe avant que le sémaphore ne soit supprimé.</p>
3958         </div>
3959
3960         <div class="warning"><h3>Sécurité</h3>
3961         <p>L'API des sémaphores permet les attaques par déni de service
3962         par tout programme CGI s'exécutant sous le même uid que le
3963         serveur web (autrement dit tous les programmes CGI, à moins que
3964         vous n'utilisiez un programme du style <code class="program"><a href="../programs/suexec.html">suexec</a></code>
3965         ou <code>cgiwrapper</code>).</p>
3966         </div>
3967         </li>
3968
3969         <li><code>sem</code>
3970         <p>Sélection de la "meilleure" implémentation des sémaphores
3971         disponible ; le choix s'effectue entre les sémaphores posix et
3972         IPC SystemV, dans cet ordre.</p></li>
3973
3974         <li><code>pthread</code>
3975         <p>Une variante de mutex à base de mutex de thread Posix
3976         inter-processus.</p>
3977
3978         <div class="warning"><h3>Avertissement</h3>
3979         <p>Sur la plupart des systèmes, si un processus enfant se
3980         termine anormalement alors qu'il détenait un mutex qui utilise
3981         cette implémentation, le serveur va se bloquer et cesser de
3982         répondre aux requêtes. Dans ce cas, un redémarrage manuel est
3983         nécessaire pour récupérer le mutex.</p>
3984         <p>Solaris constitue une exception notable, en ceci qu'il fournit
3985         un mécanisme qui permet en général de récupérer le mutex après
3986         l'arrêt anormal d'un processus enfant qui détenait le mutex.</p>
3987         <p>Si votre système implémente la fonction
3988         <code>pthread_mutexattr_setrobust_np()</code>, vous devriez
3989         pouvoir utiliser l'option <code>pthread</code> sans problème.</p>
3990         </div>
3991         </li>
3992
3993         <li><code>fcntl:/chemin/vers/mutex</code>
3994         <p>Une variante de mutex utilisant un fichier verrou physique et
3995         la fonction <code>fcntl()</code>.</p>
3996
3997         <div class="warning"><h3>Avertissement</h3>
3998         <p>Lorsqu'on utilise plusieurs mutex basés sur ce mécanisme dans
3999         un environnement multi-processus, multi-thread, des erreurs de
4000         blocage (EDEADLK) peuvent être rapportées pour des opérations de
4001         mutex valides si la fonction <code>fcntl()</code> ne gère pas
4002         les threads, comme sous Solaris.</p>
4003         </div>
4004         </li>
4005
4006         <li><code>flock:/chemin/vers/mutex</code>
4007         <p>Méthode similaire à <code>fcntl:/chemin/vers/mutex</code>,
4008         mais c'est la fonction <code>flock()</code> qui est utilisée
4009         pour gérer le verrouillage par fichier.</p></li>
4010
4011         <li><code>file:/chemin/vers/mutex</code>
4012         <p>Sélection de la "meilleure" implémentation de verrouillage
4013         par fichier disponible ; le choix s'effectue entre
4014         <code>fcntl</code> et <code>flock</code>, dans cet ordre.</p></li>
4015     </ul>
4016
4017     <p>La plupart des mécanismes ne sont disponibles que sur les
4018     plate-formes où ces dernières et <a class="glossarylink" href="../glossary.html#apr" title="voir glossaire">APR</a> les
4019     supportent. Les mécanismes qui ne sont pas disponibles sur toutes
4020     les plate-formes sont <em>posixsem</em>,
4021     <em>sysvsem</em>, <em>sem</em>, <em>pthread</em>, <em>fcntl</em>,
4022     <em>flock</em>, et <em>file</em>.</p>
4023
4024     <p>Avec les mécanismes à base de fichier <em>fcntl</em> et
4025     <em>flock</em>, le chemin, s'il est fourni, est un répertoire dans
4026     lequel le fichier verrou sera créé. Le répertoire par défaut est le
4027     répertoire d'exécution httpd défini par la directive <code class="directive"><a href="#defaultruntimedir">DefaultRuntimeDir</a></code>. Si le répertoire
4028     spécifié est un chemin relatif, il est relatif au chemin défini par
4029     la directive <code class="directive"><a href="#defaultruntimedir">DefaultRuntimeDir</a></code>.
4030     Utilisez toujours un système
4031     de fichiers local sur disque pour <code>/chemin/vers/mutex</code> et
4032     jamais un répertoire se trouvant dans un système de fichiers NFS ou
4033     AFS. Le nom de base du fichier se composera du type de mutex, d'une
4034     chaîne optionnelle correspondant à l'instance et fournie par le
4035     module ; et, sauf si le mot-clé <code>OmitPID</code> a été spécifié,
4036     l'identificateur du processus parent httpd sera ajouté afin de
4037     rendre le nom du fichier unique, évitant ainsi tout conflit lorsque
4038     plusieurs instances d'httpd partagent le même répertoire de
4039     verrouillage. Par exemple, si le nom de mutex est
4040     <code>mpm-accept</code>, et si le répertoire de verrouillage est
4041     <code>/var/httpd/locks</code>, le nom du fichier verrou pour
4042     l'instance httpd dont le processus parent a pour identifiant 12345
4043     sera <code>/var/httpd/locks/mpm-accept.12345</code>.</p>
4044
4045     <div class="warning"><h3>Sécurité</h3>
4046     <p>Il est conseillé d'<em>éviter</em> de placer les fichiers mutex
4047     dans un répertoire où tout le monde peut écrire comme
4048     <code>/var/tmp</code>, car quelqu'un pourrait initier une attaque
4049     par déni de service et empêcher le serveur de démarrer en créant un
4050     fichier verrou possédant un nom identique à celui que le serveur va
4051     tenter de créer.</p>
4052     </div>
4053
4054     <p>La table suivante décrit les noms de mutex utilisés par httpd et
4055     ses modules associés.</p>
4056
4057     <table class="bordered"><tr class="header">
4058             <th>Nom mutex</th>
4059             <th>Module(s)</th>
4060             <th>Ressource protégée</th>
4061         </tr>
4062 <tr>
4063             <td><code>mpm-accept</code></td>
4064             <td>modules MPM <code class="module"><a href="../mod/prefork.html">prefork</a></code> et <code class="module"><a href="../mod/worker.html">worker</a></code></td>
4065             <td>connexions entrantes, afin d'éviter le problème de
4066             l'afflux de requêtes ; pour plus d'informations, voir la
4067             documentation <a href="../misc/perf-tuning.html">Amélioration des
4068             performances</a></td>
4069         </tr>
4070 <tr class="odd">
4071             <td><code>authdigest-client</code></td>
4072             <td><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></td>
4073             <td>liste de clients en mémoire partagée</td>
4074         </tr>
4075 <tr>
4076             <td><code>authdigest-opaque</code></td>
4077             <td><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></td>
4078             <td>compteur en mémoire partagée</td>
4079         </tr>
4080 <tr class="odd">
4081             <td><code>ldap-cache</code></td>
4082             <td><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code></td>
4083             <td>cache de résultat de recherche LDAP</td>
4084         </tr>
4085 <tr>
4086             <td><code>rewrite-map</code></td>
4087             <td><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></td>
4088             <td>communication avec des programmes externes
4089             d'associations de valeurs, afin d'éviter les interférences
4090             d'entrées/sorties entre plusieurs requêtes</td>
4091         </tr>
4092 <tr class="odd">
4093             <td><code>ssl-cache</code></td>
4094             <td><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></td>
4095             <td>cache de session SSL</td>
4096         </tr>
4097 <tr>
4098             <td><code>ssl-stapling</code></td>
4099             <td><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></td>
4100             <td>cache de l'étiquetage OCSP ("OCSP stapling")</td>
4101         </tr>
4102 <tr class="odd">
4103             <td><code>watchdog-callback</code></td>
4104             <td><code class="module"><a href="../mod/mod_watchdog.html">mod_watchdog</a></code></td>
4105             <td>fonction de rappel d'un module client particulier</td>
4106         </tr>
4107 </table>
4108
4109     <p>Le mot-clé <code>OmitPID</code> permet d'empêcher l'addition de
4110     l'identifiant du processus httpd parent au nom du fichier verrou.</p>
4111
4112
4113     <p>Dans l'exemple suivant, le mécanisme de mutex pour le mutex
4114     mpm-accept est modifié pour passer du mécanisme par défaut au
4115     mécanisme <code>fcntl</code>, avec le fichier verrou associé créé
4116     dans le répertoire <code>/var/httpd/locks</code>. Le mécanisme de
4117     mutex par défaut pour tous les autres mutex deviendra
4118     <code>sysvsem</code>.</p>
4119
4120     <pre class="prettyprint lang-config">Mutex sysvsem default
4121 Mutex fcntl:/var/httpd/locks mpm-accept</pre>
4122
4123
4124 </div>
4125 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4126 <div class="directive-section"><h2><a name="namevirtualhost" id="namevirtualhost">Directive</a> <a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a title="Lien permanent" href="#namevirtualhost" class="permalink">&para;</a></h2>
4127 <table class="directive">
4128 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>OBSOLETE : Définit une adresse IP pour les serveurs virtuels à base de
4129 nom</td></tr>
4130 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NameVirtualHost <var>adresse</var>[:<var>port</var>]</code></td></tr>
4131 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
4132 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4133 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4134 </table>
4135
4136     <p>Avant la version 2.3.11, il était nécessaire de définir une
4137     directive <code class="directive">NameVirtualHost</code> pour indiquer au
4138     serveur qu'une paire adresse IP/port particulière pouvait être
4139     utilisée comme serveur virtuel à base de nom. Depuis la version
4140     2.3.11, chaque fois qu'une paire adresse IP/port est utilisée dans
4141     plusieurs serveurs virtuels, l'hébergement virtuel à base de nom est
4142     automatiquement activé pour cette adresse.</p>
4143
4144     <p>Cette directive n'a actuellement plus aucun effet.</p>
4145
4146 <h3>Voir aussi</h3>
4147 <ul>
4148 <li><a href="../vhosts/">Documentation sur les serveurs
4149 virtuels</a></li>
4150 </ul>
4151 </div>
4152 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4153 <div class="directive-section"><h2><a name="options" id="options">Directive</a> <a name="Options" id="Options">Options</a> <a title="Lien permanent" href="#options" class="permalink">&para;</a></h2>
4154 <table class="directive">
4155 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les fonctionnalités disponibles pour un répertoire
4156 particulier</td></tr>
4157 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Options
4158     [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr>
4159 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Options FollowSymlinks</code></td></tr>
4160 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
4161 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>Options</td></tr>
4162 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4163 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4164 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Avec la version 2.3.11, la valeur par défaut passe de All
4165 à FollowSymlinks</td></tr>
4166 </table>
4167     <p>La directive <code class="directive">Options</code> permet de définir
4168     les fonctionnalités de serveur disponibles pour un répertoire
4169     particulier.</p>
4170
4171     <p><var>option</var> peut être défini à <code>None</code>, auquel
4172     cas aucune fonctionnalité spécifique n'est activée, ou comprendre
4173     une ou plusieurs des options suivantes :</p>
4174
4175     <dl>
4176       <dt><code>All</code></dt>
4177
4178       <dd>Toutes les options excepté <code>MultiViews</code>.</dd>
4179
4180       <dt><code>ExecCGI</code></dt>
4181
4182       <dd>L'exécution de scripts CGI à l'aide du module
4183       <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> est permise.</dd>
4184
4185       <dt><code>FollowSymLinks</code></dt>
4186
4187       <dd>
4188
4189       Le serveur va suivre les liens symboliques dans le répertoire
4190       concerné. Il s'agit de la valeur par défaut.
4191       <div class="note">
4192       <p>Bien que le serveur suive les liens symboliques, il ne modifie
4193       <em>pas</em> le nom de chemin concerné défini par la section
4194       <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>.</p>
4195
4196       <p>Les options <code>FollowSymLinks</code> et
4197       <code>SymLinksIfOwnerMatch</code> ne fonctionnent que dans les
4198       sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> ou les fichiers
4199       <code>.htaccess</code>.</p>
4200
4201       <p>Le fait d'omettre cette option ne doit pas être considéré comme
4202       une mesure de sécurité efficace, car il existe toujours une
4203       situation de compétition (race condition) entre l'instant où l'on
4204       vérifie qu'un chemin n'est pas un lien symbolique, et l'instant où
4205       l'on utilise effectivement ce chemin.</p>
4206       </div></dd>
4207
4208       <dt><code>Includes</code></dt>
4209
4210       <dd>
4211       Les inclusions côté serveur (SSI) à l'aide du module
4212       <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> sont autorisées.</dd>
4213
4214       <dt><code>IncludesNOEXEC</code></dt>
4215
4216       <dd>
4217
4218       Les inclusions côté serveur (SSI) sont permises, mais <code>#exec
4219       cmd</code> et <code>#exec cgi</code> sont désactivés.
4220       L'utilisation de <code>#include virtual</code> pour les scripts
4221       CGI est cependant toujours possible depuis des répertoires
4222       définis par <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>.</dd>
4223
4224       <dt><code>Indexes</code></dt>
4225
4226       <dd>
4227       Si une URL requise correspond au répertoire concerné, et si aucun
4228       <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> (<em>par
4229       exemple</em> <code>index.html</code>) n'est défini pour ce
4230       répertoire, le module <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> va renvoyer
4231       un listing formaté du répertoire.</dd>
4232
4233       <dt><code>MultiViews</code></dt>
4234
4235       <dd>
4236       Les vues multiples ("multiviews") à <a href="../content-negotiation.html">contenu négocié</a> à l'aide du
4237       module <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> sont autorisées.
4238       <div class="note"><h3>Note</h3> <p>Cette option est ignorée si elle est
4239       définie en tout autre endroit qu'une section <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>, car
4240       <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code> a besoin de ressources réelles
4241       pour effectuer ses comparaisons et ses évaluations.</p></div>
4242
4243       </dd>
4244
4245       <dt><code>SymLinksIfOwnerMatch</code></dt>
4246
4247       <dd>Le serveur ne suivra que les liens symboliques qui renvoient
4248       vers un fichier ou un répertoire dont le propriétaire est le même
4249       que celui du lien.
4250
4251       <div class="note"><h3>Note</h3>
4252       <p>Les options <code>FollowSymLinks</code> et
4253       <code>SymLinksIfOwnerMatch</code> ne fonctionnent que dans les
4254       sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> ou les fichiers
4255       <code>.htaccess</code>.</p>
4256
4257       <p>Le fait d'omettre cette option ne doit pas être considéré comme
4258       une mesure de sécurité efficace, car il existe toujours une
4259       situation de compétition (race condition) entre l'instant où l'on
4260       vérifie qu'un chemin n'est pas un lien symbolique, et l'instant où
4261       l'on utilise effectivement ce chemin.</p>
4262       </div> </dd>
4263     </dl>
4264
4265     <p>Normalement, si plusieurs directives
4266     <code class="directive">Options</code> peuvent s'appliquer à un répertoire,
4267     c'est la plus spécifique qui est utilisée et les autres sont
4268     ignorées ; les options ne sont pas fusionnées (voir <a href="../sections.html#merging">comment les sections sont
4269     fusionnées</a>). Elles le sont cependant si <em>toutes</em> les
4270     options de la directive <code class="directive">Options</code> sont
4271     précédées d'un symbole <code>+</code> ou <code>-</code>. Toute
4272     option précédée d'un <code>+</code> est ajoutée à la liste des
4273     options courantes de manière forcée et toute option précédée d'un
4274     <code>-</code> est supprimée de la liste des options courantes de la
4275     même manière.</p>
4276
4277     <div class="note"><h3>Note</h3>
4278     <p>Mélanger des <code class="directive">Options</code> avec <code>+</code>
4279     ou <code>-</code> avec des <code class="directive">Options</code> sans
4280     <code>+</code> ou <code>-</code> constitue une erreur de syntaxe, et
4281     la vérification de la syntaxe au cours du démarrage du serveur fera
4282     échouer ce dernier.</p>
4283     </div>
4284
4285     <p>Par exemple, sans aucun symbole <code>+</code> et <code>-</code>
4286     :</p>
4287
4288     <pre class="prettyprint lang-config">&lt;Directory "/web/docs"&gt;
4289   Options Indexes FollowSymLinks
4290 &lt;/Directory&gt;
4291
4292 &lt;Directory "/web/docs/spec"&gt;
4293   Options Includes
4294 &lt;/Directory&gt;</pre>
4295
4296
4297     <p>ici, seule l'option <code>Includes</code> sera prise en compte
4298     pour le répertoire <code>/web/docs/spec</code>. Par contre, si la
4299     seconde directive <code class="directive">Options</code> utilise les
4300     symboles <code>+</code> et <code>-</code> :</p>
4301
4302     <pre class="prettyprint lang-config">&lt;Directory "/web/docs"&gt;
4303   Options Indexes FollowSymLinks
4304 &lt;/Directory&gt;
4305
4306 &lt;Directory "/web/docs/spec"&gt;
4307   Options +Includes -Indexes
4308 &lt;/Directory&gt;</pre>
4309
4310
4311     <p>alors, les options <code>FollowSymLinks</code> et
4312     <code>Includes</code> seront prises en compte pour le répertoire
4313     <code>/web/docs/spec</code>.</p>
4314
4315     <div class="note"><h3>Note</h3>
4316       <p>L'utilisation de <code>-IncludesNOEXEC</code> ou
4317       <code>-Includes</code> désactive complètement les inclusions côté
4318       serveur sans tenir compte des définitions précédentes.</p>
4319     </div>
4320
4321     <p>En l'absence de toute définition d'options, la valeur par défaut
4322     est <code>FollowSymlinks</code>.</p>
4323
4324 </div>
4325 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4326 <div class="directive-section"><h2><a name="protocol" id="protocol">Directive</a> <a name="Protocol" id="Protocol">Protocol</a> <a title="Lien permanent" href="#protocol" class="permalink">&para;</a></h2>
4327 <table class="directive">
4328 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Protocole pour une socket d'écoute</td></tr>
4329 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Protocol <var>protocole</var></code></td></tr>
4330 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
4331 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4332 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4333 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Sous Windows, disponible à partir de la version 2.3.3 du
4334 serveur HTTP Apache.</td></tr>
4335 </table>
4336     <p>Cette directive permet de spécifier le protocole utilisé pour une
4337     socket d'écoute particulière. Le protocole sert à déterminer quel
4338     module doit traiter une requête, et d'appliquer les optimisations
4339     spécifiques au protocole via la directive
4340     <code class="directive">AcceptFilter</code>.</p>
4341
4342     <p>Vous ne devez définir le protocole que si vous travaillez avec
4343     des ports non standards ; dans le cas général, le protocole
4344     <code>http</code> est associé au port 80 et le protocole
4345     <code>https</code> au port 443.</p>
4346
4347     <p>Par exemple, si vous travaillez avec le protocole
4348     <code>https</code> sur un port non standard, spécifiez le protocole
4349     de manière explicite :</p>
4350
4351     <pre class="prettyprint lang-config">Protocol https</pre>
4352
4353
4354     <p>Vous pouvez aussi spécifier le protocole via la directive
4355     <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p>
4356
4357 <h3>Voir aussi</h3>
4358 <ul>
4359 <li><code class="directive"><a href="#acceptfilter">AcceptFilter</a></code></li>
4360 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
4361 </ul>
4362 </div>
4363 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4364 <div class="directive-section"><h2><a name="protocols" id="protocols">Directive</a> <a name="Protocols" id="Protocols">Protocols</a> <a title="Lien permanent" href="#protocols" class="permalink">&para;</a></h2>
4365 <table class="directive">
4366 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Protocoles disponibles pour un serveur virtuel ou non</td></tr>
4367 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Protocols <var>protocole</var> ...</code></td></tr>
4368 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Protocols http/1.1</code></td></tr>
4369 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
4370 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4371 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4372 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.17 du serveur
4373     HTTP Apache.</td></tr>
4374 </table>
4375         <p>Cette directive permet de spécifier la liste des protocoles
4376         supportés par un serveur virtuel ou non. Cette liste énumère les
4377         protocoles qu'un client sera autorisé à négocier avec ce
4378         serveur.</p>
4379
4380         <p>Par défaut,
4381         seul le protocole http/1.1 est disponible (compatible avec les
4382         clients http/1.0 et http/0.9). Par conséquent, vous devez
4383         fournir cette liste si vous voulez étendre les protocoles
4384         disponibles pour le serveur.</p>
4385
4386         <p>Par exemple, si vous voulez autoriser le protocole
4387         HTTP/2 pour un serveur avec TLS, utilisez
4388         cette directive comme suit :</p>
4389
4390         <pre class="prettyprint lang-config">Protocols h2 http/1.1</pre>
4391
4392
4393         <p>Les protocoles valides sont <code>http/1.1</code> pour les
4394         connexions http et https, <code>h2</code> pour les connections
4395         https et <code>h2c</code> pour les connexions http. D'autres
4396         modules peuvent fournir d'autres protocoles.</p>
4397
4398         <p>Spécifier des protocoles non disponibles ou désactivés n'aura
4399         aucun effet, et ceux-ci seront simplement ignorés.</p>
4400
4401         <p>Si un serveur virtuel ne possède pas de directive Protocols
4402         propre, il hérite des protocoles spécifiés pour le serveur
4403         principal. Autrement dit, les directives Protocols définies au
4404         niveau d'un serveur virtuel remplacent celles définies au niveau
4405         du serveur principal.
4406         </p>
4407
4408
4409 <h3>Voir aussi</h3>
4410 <ul>
4411 <li><code class="directive"><a href="#protocolshonororder">ProtocolsHonorOrder</a></code></li>
4412 </ul>
4413 </div>
4414 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4415 <div class="directive-section"><h2><a name="protocolshonororder" id="protocolshonororder">Directive</a> <a name="ProtocolsHonorOrder" id="ProtocolsHonorOrder">ProtocolsHonorOrder</a> <a title="Lien permanent" href="#protocolshonororder" class="permalink">&para;</a></h2>
4416 <table class="directive">
4417 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine qui du client ou du serveur détermine l'ordre
4418     des protocoles au cours de la négociation de la connexion</td></tr>
4419 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProtocolsHonorOrder On|Off</code></td></tr>
4420 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProtocolsHonorOrder On</code></td></tr>
4421 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
4422 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4423 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4424 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.17 du serveur
4425     HTTP Apache.</td></tr>
4426 </table>
4427         <p>Cette directive permet de définir si le serveur doit tenir
4428         compte de l'ordre des protocoles définis par la directive
4429         <code class="directive">Protocols</code>.</p>
4430
4431         <p>Si cette directive est définie à Off, l'ordre de la liste des
4432         protocoles fournie par le client l'emporte sur l'ordre défini
4433         dans la configuration du serveur.</p>
4434
4435         <p>Si la directive <code class="directive">ProtocolsHonorOrder</code>
4436         est définie à <code>on</code> (valeur par défaut),
4437         il n'est pas tenu compte de l'ordre de la liste des protocoles
4438         fournie par le client, et seul l'ordre de la liste des protocles
4439         définie au niveau du serveur influera la
4440         négociation du protocole.</p>
4441
4442
4443 <h3>Voir aussi</h3>
4444 <ul>
4445 <li><code class="directive"><a href="#protocols">Protocols</a></code></li>
4446 </ul>
4447 </div>
4448 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4449 <div class="directive-section"><h2><a name="qualifyredirecturl" id="qualifyredirecturl">Directive</a> <a name="QualifyRedirectURL" id="QualifyRedirectURL">QualifyRedirectURL</a> <a title="Lien permanent" href="#qualifyredirecturl" class="permalink">&para;</a></h2>
4450 <table class="directive">
4451 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vérifie si la variable d'environnement REDIRECT_URL est
4452 pleinement qualifiée</td></tr>
4453 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>QualifyRedirectURL ON|OFF</code></td></tr>
4454 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>QualifyRedirectURL OFF</code></td></tr>
4455 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
4456 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
4457 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4458 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4459 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Directive supportée à partir de la version 2.4.18 du
4460 serveur HTTP Apache. Jusqu'à la version 2.4.17, le serveur se comportait
4461 comme si la directive QualifyRedirectURL était définie à ON.</td></tr>
4462 </table>
4463     <p>Cette directive permet de s'assurer que le serveur vérifiera que
4464     la variable d'environnement REDIRECT_URL est bien pleinement
4465     qualifiée. Par défaut, cette variable contient l'URL textuellement
4466     demandée par le client, par exemple "/index.html". Avec <code class="directive"><a href="#qualifyredirecturl on">QualifyRedirectURL ON</a></code>, la même requête
4467     affectera à la variable REDIRECT_URL une valeur du style
4468     "http://www.example.com/index.html".</p>
4469     <p>Même si cette directive n'est pas définie, lorsqu'une requête est
4470     soumise avec une URL pleinement qualifiée, la variable REDIRECT_URL
4471     contiendra quand-même une URL pleinement qualifiée.
4472     </p>
4473
4474 </div>
4475 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4476 <div class="directive-section"><h2><a name="regexdefaultoptions" id="regexdefaultoptions">Directive</a> <a name="RegexDefaultOptions" id="RegexDefaultOptions">RegexDefaultOptions</a> <a title="Lien permanent" href="#regexdefaultoptions" class="permalink">&para;</a></h2>
4477 <table class="directive">
4478 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configuration des options globales par défaut pour les
4479     expressions rationnelles</td></tr>
4480 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RegexDefaultOptions [none] [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr>
4481 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>RegexDefaultOptions DOLLAR_ENDONLY</code></td></tr>
4482 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
4483 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4484 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4485 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.30 du serveur HTTP
4486     Apache.</td></tr>
4487 </table>
4488         <p>Cette directive permet d'ajouter certains comportements par défaut à
4489         TOUTES les expressions rationnelles utilisées ultérieurement.</p>
4490
4491         <p>Toute option précédée d'un '+' est ajoutée aux options déjà définies.<br />
4492         Toute option précédée d'un '-' est enlevée des options déjà définies.<br />
4493         Toute option non suffixée par '+' ou '-' sera définie et remplacera
4494         l'option correspondante éventuellement déjà définie.<br />
4495         Le mot-clé <code>none</code> annule toutes les options déjà définies.</p>
4496
4497         <p><var>option</var> peut être :</p>
4498         <dl>
4499             <dt><code>ICASE</code></dt>
4500             <dd>Utilise une recherche de correspondance insensible à la casse.</dd>
4501
4502             <dt><code>DOTALL</code></dt>
4503             <dd>Le drapeau Perl /s.</dd>
4504
4505             <dt><code>DOLLAR_ENDONLY</code></dt>
4506             <dd>'$' n'est actif qu'à la fin de la chaîne de référence.</dd>
4507             <dd>.</dd>
4508         </dl>
4509         <pre class="prettyprint lang-config">#
4510 RegexDefaultOptions +ICASE +DOLLAR_ENDONLY
4511 ...
4512 # Supprime l'option ICASE, tout en conservant toutes les autres options
4513 # préexistantes
4514 RegexDefaultOptions -ICASE
4515 ...
4516 # Définit l'option par défaut à DOTALL et annule toutes les autres options
4517 RegexDefaultOptions DOTALL
4518 ...
4519 # Annule toutes les options définies
4520 RegexDefaultOptions none
4521 ...</pre>
4522
4523
4524 </div>
4525 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4526 <div class="directive-section"><h2><a name="registerhttpmethod" id="registerhttpmethod">Directive</a> <a name="RegisterHttpMethod" id="RegisterHttpMethod">RegisterHttpMethod</a> <a title="Lien permanent" href="#registerhttpmethod" class="permalink">&para;</a></h2>
4527 <table class="directive">
4528 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistrement de méthodes HTTP non standards</td></tr>
4529 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RegisterHttpMethod <var>method</var> [<var>method</var> [...]]</code></td></tr>
4530 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
4531 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4532 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4533 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.24 du serveur HTTP Apache</td></tr>
4534 </table>
4535 <p>Cette directive permet d'enregistrer des méthodes HTTP supplémentaires. Ceci
4536 s'avérera nécessaire si l'on doit utiliser des méthodes non standards avec des
4537 directives qui acceptent des noms de méthodes en paramètres, ou pour permettre
4538 l'utilisation de méthodes particulières non standards en passant par un serveur
4539 mandataire ou au sein de scripts CGI, et ceci alors que le serveur a été
4540 configuré pour ne transmettre que des méthodes reconnues aux modules.</p>
4541
4542 <h3>Voir aussi</h3>
4543 <ul>
4544 <li><code class="directive"><a href="#httpprotocoloptions">HTTPProtocolOptions</a></code></li>
4545 <li><code class="directive"><a href="../mod/mod_allowmethods.html#allowmethods">AllowMethods</a></code></li>
4546 </ul>
4547 </div>
4548 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4549 <div class="directive-section"><h2><a name="rlimitcpu" id="rlimitcpu">Directive</a> <a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a title="Lien permanent" href="#rlimitcpu" class="permalink">&para;</a></h2>
4550 <table class="directive">
4551 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le temps CPU alloué aux processus initiés par les
4552 processus enfants d'Apache httpd</td></tr>
4553 <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>
4554 <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
4555 d'exploitation</code></td></tr>
4556 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
4557 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
4558 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4559 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4560 </table>
4561     <p>Prend 1 ou 2 paramètres. Le premier definit la limite de
4562     consommation de ressources pour tous les processus, et le second la
4563     consommation de ressources maximale. Les deux paramètres peuvent
4564     contenir soit un nombre, soit <code>max</code> pour indiquer au
4565     serveur que la limite de consommation correspond à la valeur
4566     maximale autorisée par la configuration du système d'exploitation.
4567     Pour augmenter la consommation maximale de ressources, le serveur
4568     doit s'exécuter en tant que <code>root</code>, ou se trouver dans sa
4569     phase de démarrage.</p>
4570
4571     <p>Cette directive s'applique aux processus initiés par les
4572     processus enfants d'Apache httpd qui traitent les requêtes, et non aux
4573     processus enfants eux-mêmes. Sont concernés les scripts CGI et les
4574     commandes exec des SSI, mais en aucun cas les processus initiés par
4575     le processus parent d'Apache httpd comme les journalisations redirigées
4576     vers un programme.</p>
4577
4578     <p>Les limites de ressources CPU sont exprimées en secondes par
4579     processus.</p>
4580
4581 <h3>Voir aussi</h3>
4582 <ul>
4583 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
4584 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
4585 </ul>
4586 </div>
4587 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4588 <div class="directive-section"><h2><a name="rlimitmem" id="rlimitmem">Directive</a> <a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a title="Lien permanent" href="#rlimitmem" class="permalink">&para;</a></h2>
4589 <table class="directive">
4590 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite la mémoire allouée aux processus initiés par les
4591 processus enfants d'Apache httpd</td></tr>
4592 <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>
4593 <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
4594 d'exploitation</code></td></tr>
4595 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
4596 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
4597 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4598 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4599 </table>
4600     <p>Prend 1 ou 2 paramètres. Le premier definit la limite de
4601     consommation de ressources pour tous les processus, et le second la
4602     consommation de ressources maximale. Les deux paramètres peuvent
4603     contenir soit un nombre, soit <code>max</code> pour indiquer au
4604     serveur que la limite de consommation correspond à la valeur
4605     maximale autorisée par la configuration du système d'exploitation.
4606     Pour augmenter la consommation maximale de ressources, le serveur
4607     doit s'exécuter en tant que <code>root</code>, ou se trouver dans sa
4608     phase de démarrage.</p>
4609
4610     <p>Cette directive s'applique aux processus initiés par les
4611     processus enfants d'Apache httpd qui traitent les requêtes, et non aux
4612     processus enfants eux-mêmes. Sont concernés les scripts CGI et les
4613     commandes exec des SSI, mais en aucun cas les processus initiés par
4614     le processus parent d'Apache httpd comme les journalisations redirigées
4615     vers un programme.</p>
4616
4617     <p>Les limites de ressources mémoire sont exprimées en octets par
4618     processus.</p>
4619
4620 <h3>Voir aussi</h3>
4621 <ul>
4622 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
4623 <li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
4624 </ul>
4625 </div>
4626 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4627 <div class="directive-section"><h2><a name="rlimitnproc" id="rlimitnproc">Directive</a> <a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a title="Lien permanent" href="#rlimitnproc" class="permalink">&para;</a></h2>
4628 <table class="directive">
4629 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de processus qui peuvent être initiés par
4630 les processus initiés par les processus enfants d'Apache httpd</td></tr>
4631 <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>
4632 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
4633 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
4634 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
4635 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4636 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4637 </table>
4638     <p>Prend 1 ou 2 paramètres. Le premier definit la limite de
4639     consommation de ressources pour tous les processus, et le second la
4640     consommation de ressources maximale. Les deux paramètres peuvent
4641     contenir soit un nombre, soit <code>max</code> pour indiquer au
4642     serveur que la limite de consommation correspond à la valeur
4643     maximale autorisée par la configuration du système d'exploitation.
4644     Pour augmenter la consommation maximale de ressources, le serveur
4645     doit s'exécuter en tant que <code>root</code>, ou se trouver dans sa
4646     phase de démarrage.</p>
4647
4648     <p>Cette directive s'applique aux processus initiés par les
4649     processus enfants d'Apache httpd qui traitent les requêtes, et non aux
4650     processus enfants eux-mêmes. Sont concernés les scripts CGI et les
4651     commandes exec des SSI, mais en aucun cas les processus initiés par
4652     le processus parent d'Apache httpd comme les journalisations redirigées
4653     vers un programme.</p>
4654
4655     <p>Les limites des processus contrôlent le nombre de processus par
4656     utilisateur.</p>
4657
4658     <div class="note"><h3>Note</h3>
4659       <p>Si les processus CGI s'exécutent sous le même
4660       utilisateur que celui du serveur web, cette
4661       directive va limiter le nombre de processus que le serveur
4662       pourra lui-même créer. La présence de messages
4663       <strong><code>cannot fork</code></strong> dans le journal des
4664       erreurs indiquera que la limite est atteinte.</p>
4665     </div>
4666
4667 <h3>Voir aussi</h3>
4668 <ul>
4669 <li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
4670 <li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
4671 </ul>
4672 </div>
4673 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4674 <div class="directive-section"><h2><a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a> <a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a title="Lien permanent" href="#scriptinterpretersource" class="permalink">&para;</a></h2>
4675 <table class="directive">
4676 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de localiser l'interpréteur des scripts
4677 CGI</td></tr>
4678 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
4679 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
4680 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
4681 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
4682 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4683 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4684 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Win32 seulement</td></tr>
4685 </table>
4686     <p>Cette directive permet de contrôler la méthode qu'utilise Apache
4687     httpd pour trouver l'interpréteur destiné à exécuter les scripts CGI. La
4688     définition par défaut est <code>Script</code> : ceci indique à
4689     Apache httpd qu'il doit utiliser l'interpréteur précisé dans la ligne
4690     shebang du script (la première ligne, commençant par
4691     <code>#!</code>). Sur les systèmes Win32, cette ligne ressemble
4692     souvent à ceci :</p>
4693
4694     <pre class="prettyprint lang-perl">#!C:/Perl/bin/perl.exe</pre>
4695
4696
4697     <p>ou simplement, dans le cas où <code>perl</code> est dans le
4698     <code>PATH</code> :</p>
4699
4700     <pre class="prettyprint lang-perl">#!perl</pre>
4701
4702
4703     <p>Avec <code>ScriptInterpreterSource Registry</code>, Windows va
4704     effectuer une recherche dans l'arborescence
4705     <code>HKEY_CLASSES_ROOT</code> de la base de registre avec comme
4706     mot-clé l'extension du fichier contenant le script (par exemple
4707     <code>.pl</code>). C'est la commande définie par la sous-clé de
4708     registre <code>Shell\ExecCGI\Command</code> ou, si elle n'existe
4709     pas, la sous-clé <code>Shell\Open\Command</code> qui est utilisée
4710     pour ouvrir le fichier du script. Si ces clés de registre ne sont
4711     pas trouvées, Apache httpd utilise la méthode de l'option
4712     <code>Script</code>.</p>
4713
4714     <div class="warning"><h3>Sécurité</h3>
4715     <p>Soyez prudent si vous utilisez <code>ScriptInterpreterSource
4716     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 httpd va essayer
4717     d'exécuter <strong>tous</strong> les fichiers contenus dans
4718     celui-ci. L'option <code>Registry</code> peut causer des appels de
4719     programmes non voulus sur des fichiers non destinés à être exécutés.
4720     Par exemple, la commande par défaut open sur les fichiers
4721     <code>.htm</code> sur la plupart des systèmes Windows va lancer
4722     Microsoft Internet Explorer ; ainsi, toute requête HTTP pour un
4723     fichier <code>.htm</code> situé dans le répertoire des scripts
4724     va lancer le navigateur en arrière-plan sur le serveur, ce qui a
4725     toutes les chances de crasher votre système dans les minutes qui
4726     suivent.</p>
4727     </div>
4728
4729     <p>L'option <code>Registry-Strict</code>, apparue avec la version
4730     2.0 du serveur HTTP Apache,
4731     agit de manière identique à <code>Registry</code>, mais n'utilise
4732     que la sous-clé <code>Shell\ExecCGI\Command</code>. La présence de
4733     la clé <code>ExecCGI</code> n'étant pas systématique, Elle doit être
4734     définie manuellement dans le registre Windows et évite ainsi tout
4735     appel de programme accidentel sur votre système.</p>
4736
4737 </div>
4738 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4739 <div class="directive-section"><h2><a name="seerequesttail" id="seerequesttail">Directive</a> <a name="SeeRequestTail" id="SeeRequestTail">SeeRequestTail</a> <a title="Lien permanent" href="#seerequesttail" class="permalink">&para;</a></h2>
4740 <table class="directive">
4741 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si mod_status affiche les 63 premiers caractères
4742 d'une requête ou les 63 derniers, en supposant que la requête
4743 elle-même possède plus de 63 caractères.</td></tr>
4744 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SeeRequestTail On|Off</code></td></tr>
4745 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SeeRequestTail Off</code></td></tr>
4746 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
4747 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4748 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4749 </table>
4750     <p>Avec <code>ExtendedStatus On</code>, mod_status affiche la
4751     véritable requête en cours de traitement. Pour des raisons
4752     historiques, seuls 63 caractères de la requête sont réellement
4753     stockés à des fins d'affichage. Cette directive permet de déterminer
4754     si ce sont les 63 premiers caractères qui seront stockés (c'est le
4755     comportement par défaut),
4756     ou si ce sont les 63 derniers. Ceci ne s'applique bien entendu que
4757     si la taille de la requête est de 64 caractères ou plus.</p>
4758
4759     <p>Si Apache httpd traite la requête <code>GET&nbsp;/disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg&nbsp;HTTP/1.1</code>
4760     , l'affichage de la requête par mod_status se présentera comme suit :
4761     </p>
4762
4763     <table class="bordered">
4764       <tr>
4765         <th>Off (défaut)</th>
4766         <td>GET&nbsp;/disque1/stockage/apache/htdocs/images/rep-images1/nourritu</td>
4767       </tr>
4768       <tr>
4769         <th>On</th>
4770         <td>apache/htdocs/images/rep-images1/nourriture/pommes.jpg&nbsp;HTTP/1.1</td>
4771       </tr>
4772     </table>
4773
4774
4775 </div>
4776 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4777 <div class="directive-section"><h2><a name="serveradmin" id="serveradmin">Directive</a> <a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a title="Lien permanent" href="#serveradmin" class="permalink">&para;</a></h2>
4778 <table class="directive">
4779 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'adresse électronique que le serveur inclut dans les
4780 messages d'erreur envoyés au client</td></tr>
4781 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAdmin <var>adresse électronique</var>|<var>URL</var></code></td></tr>
4782 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
4783 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4784 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4785 </table>
4786     <p>La directive <code class="directive">ServerAdmin</code> permet de définir
4787     l'adresse de contact que le serveur va inclure dans tout message
4788     d'erreur qu'il envoie au client. Si le programme <code>httpd</code>
4789     ne reconnait pas l'argument fourni comme une URL, il suppose que
4790     c'est une <var>adresse électronique</var>, et lui ajoute le préfixe
4791     <code>mailto:</code> dans les cibles des hyperliens. Il est
4792     cependant recommandé d'utiliser exclusivement une adresse
4793     électronique, car de nombreux scripts CGI considèrent ceci comme
4794     implicite. Si vous utilisez une URL, elle doit pointer vers un autre
4795     serveur que vous contrôlez. Dans le cas contraire, les utilisateurs
4796     seraient dans l'impossibilité de vous contacter en cas de problème.</p>
4797
4798     <p>Il peut s'avérer utile de définir une adresse dédiée à
4799     l'administration du serveur, par exemple :</p>
4800
4801     <pre class="prettyprint lang-config">ServerAdmin www-admin@foo.example.com</pre>
4802
4803     <p>car les utilisateurs ne mentionnent pas systématiquement le
4804     serveur dont ils parlent !</p>
4805
4806 </div>
4807 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4808 <div class="directive-section"><h2><a name="serveralias" id="serveralias">Directive</a> <a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a title="Lien permanent" href="#serveralias" class="permalink">&para;</a></h2>
4809 <table class="directive">
4810 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Autres noms d'un serveur utilisables pour atteindre des
4811 serveurs virtuels à base de nom</td></tr>
4812 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAlias <var>nom serveur</var> [<var>nom serveur</var>]
4813 ...</code></td></tr>
4814 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel</td></tr>
4815 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4816 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4817 </table>
4818     <p>La directive <code class="directive">ServerAlias</code> permet de définir
4819     les noms alternatifs d'un serveur utilisables pour atteindre des <a href="../vhosts/name-based.html">serveurs virtuels à base de
4820     nom</a>. La directive <code class="directive">ServerAlias</code> peut
4821     contenir des caractères génériques, si nécessaire.</p>
4822
4823     <pre class="prettyprint lang-config">&lt;VirtualHost *:80&gt;
4824   ServerName server.example.com
4825   ServerAlias server server2.example.com server2
4826   ServerAlias *.example.com
4827   UseCanonicalName Off
4828   # ...
4829 &lt;/VirtualHost&gt;</pre>
4830
4831     <p>La recherche du serveur virtuel à base de nom correspondant au
4832     plus près à la requête s'effectue selon l'ordre d'apparition des
4833     directives <code class="directive"><a href="#virtualhost">&lt;virtualhost&gt;</a></code> dans le fichier de
4834     configuration. Le premier serveur virtuel dont le <code class="directive"><a href="#servername">ServerName</a></code> ou le <code class="directive"><a href="#serveralias">ServerAlias</a></code> correspond est choisi, sans
4835     priorité particulière si le nom contient des caractères génériques
4836     (que ce soit pour ServerName ou ServerAlias).</p>
4837
4838     <p>Tous les noms spécifiés au sein d'une section
4839     <code class="directive"><a href="#virtualhost">&lt;VirtualHost&gt;</a></code> sont traités comme un
4840     <code class="directive"><a href="#serveralias">&lt;ServerAlias&gt;</a></code>
4841     (sans caractères génériques).</p>
4842
4843
4844 <h3>Voir aussi</h3>
4845 <ul>
4846 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
4847 <li><a href="../vhosts/">Documentation sur les serveurs virtuels
4848 du serveur HTTP Apache</a></li>
4849 </ul>
4850 </div>
4851 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4852 <div class="directive-section"><h2><a name="servername" id="servername">Directive</a> <a name="ServerName" id="ServerName">ServerName</a> <a title="Lien permanent" href="#servername" class="permalink">&para;</a></h2>
4853 <table class="directive">
4854 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom d'hôte et port que le serveur utilise pour
4855 s'authentifier lui-même</td></tr>
4856 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerName
4857 [<var>protocole</var>://]<var>nom-de-domaine</var>|<var>adresse-ip</var>[:<var>port</var>]</code></td></tr>
4858 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
4859 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4860 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4861 </table>
4862     <p>La directive <code class="directive">ServerName</code> permet de définir
4863     les protocole, nom d'hôte et port d'une requête que le serveur
4864     utilise pour s'authentifier lui-même.</p>
4865
4866     <p>La directive <code class="directive">ServerName</code> permet
4867     (éventuellement en conjonction avec la directive
4868     <code class="directive"><a href="#serveralias">ServerAlias</a></code>) d'identifier de manière unique
4869     un serveur virtuel, lorsqu'elle est utilisée dans un contexte de <a href="../vhosts/name-based.html">serveurs virtuels à base de
4870     noms</a>.</p>
4871
4872     <p>Cette directive est aussi utilisée lors de la création d'URLs de
4873     redirection relatives quand la directive
4874     <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code> est définie à une valeur autre que
4875     la valeur par défaut.</p>
4876
4877     <p>Par exemple, si le nom de la
4878     machine hébergeant le serveur web est
4879     <code>simple.example.com</code>, la machine possède l'alias
4880     DNS <code>www.example.com</code>, et si vous voulez que le serveur
4881     web s'identifie avec cet alias, vous devez utilisez la définition
4882     suivante :</p>
4883
4884     <pre class="prettyprint lang-config">ServerName www.example.com</pre>
4885
4886
4887     <p>La directive <code class="directive">ServerName</code> peut apparaître à
4888     toutes les étapes de la définition du serveur. Toute occurrence
4889     annule cependant la précédente (pour ce serveur).</p>
4890
4891     <p>Si la directive <code class="directive">ServerName</code> n'est pas
4892     définie, le serveur tente de déterminer le nom
4893     d'hôte visible du point de vue du client en demandant tout d'abord au
4894     système d'exploitation le nom d'hôte système, et en cas d'échec, en effectuant
4895     une recherche DNS inverse sur une adresse IP présente sur le système.</p>
4896
4897     <p>Si la directive
4898     <code class="directive">ServerName</code> ne précise pas de port, le serveur
4899     utilisera celui de la requête entrante. Il est recommandé de
4900     spécifier un nom d'hôte et un port spécifiques à l'aide de la
4901     directive <code class="directive">ServerName</code> pour une fiabilité
4902     optimale et à titre préventif.</p>
4903
4904     <p>Si vous définissez des <a href="../vhosts/name-based.html">serveurs virtuels à base de
4905     nom</a>, une directive <code class="directive">ServerName</code> située à
4906     l'intérieur d'une section <code class="directive"><a href="#virtualhost">&lt;VirtualHost&gt;</a></code> spécifiera quel nom d'hôte
4907     doit apparaître dans l'en-tête de requête <code>Host:</code> pour
4908     pouvoir atteindre ce serveur virtuel.</p>
4909
4910
4911     <p>Parfois, le serveur s'exécute en amont d'un dispositif qui
4912     implémente SSL, comme un mandataire inverse, un répartiteur de
4913     charge ou un boîtier dédié SSL. Dans ce cas, spécifiez le protocole
4914     <code>https://</code> et le port auquel les clients se connectent
4915     dans la directive <code class="directive">ServerName</code>, afin de
4916     s'assurer que le serveur génère correctement ses URLs
4917     d'auto-identification.
4918     </p>
4919
4920     <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
4921     définitions qui permettent de déterminer si les URLs
4922     auto-identifiantes (par exemple via le module
4923     <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>) vont faire référence au port spécifié, ou
4924     au port indiqué dans la requête du client.
4925     </p>
4926
4927     <div class="warning">
4928     <p>Si la valeur de la directive <code class="directive">ServerName</code> ne
4929     peut pas être résolue en adresse IP, le démarrage du serveur
4930     provoquera un avertissement. <code>httpd</code> va alors utiliser le
4931     résultat de la commande système <code>hostname</code> pour
4932     déterminer le nom du serveur, ce qui ne correspondra pratiquement
4933     jamais au nom de serveur que vous souhaitez réellement.</p>
4934     <div class="example"><p><code>
4935     httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName
4936     </code></p></div>
4937     </div>
4938
4939
4940 <h3>Voir aussi</h3>
4941 <ul>
4942 <li><a href="../dns-caveats.html">Problèmes concernant le DNS et
4943 le serveur HTTP Apache</a></li>
4944 <li><a href="../vhosts/">Documentation sur les serveurs virtuels
4945 du serveur HTTP Apache</a></li>
4946 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
4947 <li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
4948 <li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
4949 </ul>
4950 </div>
4951 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4952 <div class="directive-section"><h2><a name="serverpath" id="serverpath">Directive</a> <a name="ServerPath" id="ServerPath">ServerPath</a> <a title="Lien permanent" href="#serverpath" class="permalink">&para;</a></h2>
4953 <table class="directive">
4954 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom de chemin d'URL hérité pour un serveur virtuel à base
4955 de nom accédé par un navigateur incompatible</td></tr>
4956 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerPath <var>chemin d'URL</var></code></td></tr>
4957 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel</td></tr>
4958 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4959 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4960 </table>
4961     <p>La directive <code class="directive">ServerPath</code> permet de définir
4962     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>
4963
4964 <h3>Voir aussi</h3>
4965 <ul>
4966 <li><a href="../vhosts/">Documentation sur les serveurs virtuels
4967 du serveur HTTP Apache</a></li>
4968 </ul>
4969 </div>
4970 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
4971 <div class="directive-section"><h2><a name="serverroot" id="serverroot">Directive</a> <a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a title="Lien permanent" href="#serverroot" class="permalink">&para;</a></h2>
4972 <table class="directive">
4973 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine du répertoire d'installation du
4974 serveur</td></tr>
4975 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerRoot <var>chemin de répertoire</var></code></td></tr>
4976 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
4977 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
4978 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
4979 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
4980 </table>
4981     <p>La directive <code class="directive">ServerRoot</code> permet de définir
4982     le répertoire dans lequel le serveur est installé. En particulier,
4983     il contiendra les sous-répertoires <code>conf/</code> et
4984     <code>logs/</code>. Les chemins relatifs indiqués dans les autres
4985     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
4986     rapport à ce répertoire.</p>
4987
4988     <pre class="prettyprint lang-config">ServerRoot "/home/httpd"</pre>
4989
4990
4991     <p>La valeur par défaut de <code class="directive">ServerRoot</code> peut
4992     être modifiée via l'argument <code>--prefix</code> de la commande <a href="../programs/configure.html"><code>configure</code></a>, et de
4993     nombreuses distributions tierces du serveur proposent une valeur
4994     différente de celles listées ci-dessus.</p>
4995
4996
4997 <h3>Voir aussi</h3>
4998 <ul>
4999 <li><a href="../invoking.html">the <code>-d</code>
5000     options de <code>httpd</code></a></li>
5001 <li><a href="../misc/security_tips.html#serverroot">les conseils à
5002 propos de sécurité</a> pour des informations sur la manière de définir
5003 correctement les permissions sur le répertoire indiqué par la directive
5004 <code class="directive">ServerRoot</code></li>
5005 </ul>
5006 </div>
5007 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5008 <div class="directive-section"><h2><a name="serversignature" id="serversignature">Directive</a> <a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a title="Lien permanent" href="#serversignature" class="permalink">&para;</a></h2>
5009 <table class="directive">
5010 <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
5011 serveur</td></tr>
5012 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
5013 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ServerSignature Off</code></td></tr>
5014 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
5015 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
5016 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5017 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5018 </table>
5019     <p>La directive <code class="directive">ServerSignature</code> permet de
5020     définir une ligne de pied de page fixe pour les documents générés
5021     par le serveur (messages d'erreur, listings de répertoires ftp de
5022     <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>,
5023     etc...). Dans le cas d'une chaîne de mandataires, l'utilisateur n'a
5024     souvent aucun moyen de déterminer lequel des mandataires chaînés a
5025     généré un message d'erreur, et c'est une des raisons pour lesquelles
5026     on peut être amené à ajouter un tel pied de page.</p>
5027
5028     <p>La valeur par défaut <code>Off</code> supprime la ligne de pied
5029     de page (et est ainsi compatible avec le comportement des
5030     versions 1.2 et antérieures d'Apache). la valeur <code>On</code>
5031     ajoute simplement une ligne contenant le numéro de version du
5032     serveur ainsi que le nom du serveur virtuel issu de la directive
5033     <code class="directive"><a href="#servername">ServerName</a></code>, alors que la valeur
5034     <code>EMail</code> ajoute en plus une référence "mailto:" à
5035     l'administrateur du document référencé issu la directive
5036     <code class="directive"><a href="#serveradmin">ServerAdmin</a></code>.</p>
5037
5038     <p>Après la version 2.0.44, les détails à propos du numéro de
5039     version du serveur sont contrôlés à l'aide de la directive
5040     <code class="directive"><a href="#servertokens">ServerTokens</a></code>.</p>
5041
5042 <h3>Voir aussi</h3>
5043 <ul>
5044 <li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
5045 </ul>
5046 </div>
5047 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5048 <div class="directive-section"><h2><a name="servertokens" id="servertokens">Directive</a> <a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a title="Lien permanent" href="#servertokens" class="permalink">&para;</a></h2>
5049 <table class="directive">
5050 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure l'en-tête <code>Server</code> de la réponse
5051 HTTP</td></tr>
5052 <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>
5053 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ServerTokens Full</code></td></tr>
5054 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
5055 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5056 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5057 </table>
5058     <p>Cette directive permet de contrôler le contenu de l'en-tête
5059     <code>Server</code> inclus dans la réponse envoyée au client : cet
5060     en-tête peut contenir le type de système d'exploitation du serveur,
5061     ainsi que des informations à propos des modules compilés avec le
5062     serveur.</p>
5063
5064     <dl>
5065         <dt><code>ServerTokens Full</code> (ou non spécifié)</dt>
5066
5067         <dd>Le serveur envoie par exemple : <code>Server: Apache/2.4.2
5068         (Unix) PHP/4.2.2 MyMod/1.2</code></dd>
5069
5070         <dt><code>ServerTokens Prod[uctOnly]</code></dt>
5071
5072       <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
5073       Apache</code></dd>
5074
5075       <dt><code>ServerTokens Major</code></dt>
5076
5077       <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
5078       Apache/2</code></dd>
5079
5080       <dt><code>ServerTokens Minor</code></dt>
5081
5082       <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
5083       Apache/2.4</code></dd>
5084
5085       <dt><code>ServerTokens Min[imal]</code></dt>
5086
5087       <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
5088       Apache/2.4.2</code></dd>
5089
5090       <dt><code>ServerTokens OS</code></dt>
5091
5092       <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
5093       Apache/2.4.2 (Unix)</code></dd>
5094
5095
5096
5097     </dl>
5098
5099     <p>Cette définition s'applique à l'ensemble du serveur et ne peut
5100     être activée ou désactivée pour tel ou tel serveur virtuel.</p>
5101
5102     <p>Dans les versions postérieures à 2.0.44, cette directive contrôle
5103     aussi les informations fournies par la directive <code class="directive"><a href="#serversignature">ServerSignature</a></code>.</p>
5104
5105     <div class="note">Définir <code class="directive">ServerTokens</code> à une
5106     valeur inférieure à <code>minimal</code> n'est pas
5107     recommandé car le débogage des problèmes
5108     interopérationnels n'en sera alors que plus difficile. Notez
5109     aussi que la désactivation de l'en-tête Server:
5110     n'améliore en rien la sécurité de votre
5111     serveur ; le concept de "sécurité par
5112     l'obscurité" est un mythe et conduit à
5113     une mauvaise perception de ce qu'est la sécurité.</div>
5114
5115
5116
5117 <h3>Voir aussi</h3>
5118 <ul>
5119 <li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
5120 </ul>
5121 </div>
5122 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5123 <div class="directive-section"><h2><a name="sethandler" id="sethandler">Directive</a> <a name="SetHandler" id="SetHandler">SetHandler</a> <a title="Lien permanent" href="#sethandler" class="permalink">&para;</a></h2>
5124 <table class="directive">
5125 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force le traitement des fichiers spécifiés par un
5126 gestionnaire particulier</td></tr>
5127 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetHandler <var>handler-name</var>|none|<var>expression</var></code></td></tr>
5128 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
5129 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
5130 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5131 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5132 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.5 du serveur HTTP Apache</td></tr>
5133 </table>
5134     <p>Lorsqu'elle se situe à l'intérieur d'un fichier
5135     <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
5136     traitement de tous les fichiers spécifiés par le <a href="../handler.html">gestionnaire</a> défini par l'argument
5137     <var>nom gestionnaire</var>. Par exemple, dans le cas d'un
5138     répertoire dont vous voulez interpréter le contenu comme des
5139     fichiers de règles d'images cliquables, sans tenir compte des
5140     extensions, vous pouvez ajouter la ligne suivante dans un fichier
5141     <code>.htaccess</code> de ce répertoire :</p>
5142
5143     <pre class="prettyprint lang-config">SetHandler imap-file</pre>
5144
5145
5146     <p>Autre exemple : si vous voulez que le serveur affiche un
5147     compte-rendu d'état chaque fois qu'une URL du type <code>http://nom
5148     serveur/status</code> est appelée, vous pouvez ajouter ceci dans
5149     <code>httpd.conf</code> :</p>
5150
5151     <pre class="prettyprint lang-config">&lt;Location "/status"&gt;
5152   SetHandler server-status
5153 &lt;/Location&gt;</pre>
5154
5155
5156     <p>Vous pouvez aussi utiliser cette directive pour associer un
5157     gestionnaire à des fichiers possèdant une extension de nom de
5158     fichier particulière. Par exemple :</p>
5159
5160     <pre class="prettyprint lang-config">&lt;FilesMatch "\.php$"&gt;
5161     SetHandler application/x-httpd-php
5162 &lt;/FilesMatch&gt;</pre>
5163
5164
5165     <p>On peut utiliser des expressions ayant pour valeur des chaînes pour
5166     référencer des variables spécifiques à une requête, y compris les
5167     références arrières vers des expressions rationnelles nommées :</p>
5168
5169     <pre class="prettyprint lang-config">&lt;LocationMatch ^/app/(?&lt;sub&gt;[^/]+)/&gt;
5170      SetHandler "proxy:unix:/var/run/app_%{env:MATCH_sub}.sock|fcgi://localhost:8080"
5171 &lt;/LocationMatch&gt;</pre>
5172
5173
5174     <p>Vous pouvez écraser la définition antérieure d'une directive
5175     <code class="directive">SetHandler</code> en utilisant la valeur
5176     <code>None</code>.</p>
5177
5178     <div class="note"><h3>Note</h3>
5179     <p>Comme <code class="directive">SetHandler</code> l'emporte sur la
5180     définition des gestionnaires par défaut, le comportement habituel
5181     consistant à traiter les URLs se terminant par un slash (/) comme
5182     des répertoires ou des fichiers index est désactivé.</p></div>
5183
5184 <h3>Voir aussi</h3>
5185 <ul>
5186 <li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li>
5187 </ul>
5188 </div>
5189 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5190 <div class="directive-section"><h2><a name="setinputfilter" id="setinputfilter">Directive</a> <a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a title="Lien permanent" href="#setinputfilter" class="permalink">&para;</a></h2>
5191 <table class="directive">
5192 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les filtres par lesquels vont passer les requêtes
5193 client et les données POST</td></tr>
5194 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetInputFilter <var>filtre</var>[;<var>filtre</var>...]</code></td></tr>
5195 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
5196 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
5197 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5198 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5199 </table>
5200     <p>La directive <code class="directive">SetInputFilter</code> permet de
5201     définir le ou les filtres par lesquels vont passer les requêtes
5202     client et les données POST au moment où le serveur les reçoit. Cette
5203     définition vient en ajout à tout autre filtre défini en
5204     quelqu'endroit que ce soit, y compris via la directive <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>.</p>
5205
5206     <p>Si la directive comporte plusieurs filtres, ils doivent être
5207     séparés par des points-virgules, et spécifiés selon l'ordre dans
5208     lequel vous souhaitez les voir agir sur les contenus.</p>
5209
5210 <h3>Voir aussi</h3>
5211 <ul>
5212 <li>documentation des <a href="../filter.html">Filtres</a></li>
5213 </ul>
5214 </div>
5215 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5216 <div class="directive-section"><h2><a name="setoutputfilter" id="setoutputfilter">Directive</a> <a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a title="Lien permanent" href="#setoutputfilter" class="permalink">&para;</a></h2>
5217 <table class="directive">
5218 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit les filtres par lesquels vont passer les réponses
5219 du serveur</td></tr>
5220 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetOutputFilter <var>filtre</var>[;<var>filtre</var>...]</code></td></tr>
5221 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
5222 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>FileInfo</td></tr>
5223 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5224 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5225 </table>
5226     <p>La directive <code class="directive">SetOutputFilter</code> permet de
5227     définir les filtres par lesquels vont passer les réponses du serveur
5228     avant d'être envoyées au client. Cette définition vient en ajout à
5229     tout autre filtre défini en quelqu'endroit que ce soit, y compris
5230     via la directive <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>.</p>
5231
5232     <p>Par exemple, la configuration suivante va traiter tous les
5233     fichiers du répertoire <code>/www/data/</code> comme des inclusions
5234     côté serveur (SSI) :</p>
5235
5236     <pre class="prettyprint lang-config">&lt;Directory "/www/data/"&gt;
5237   SetOutputFilter INCLUDES
5238 &lt;/Directory&gt;</pre>
5239
5240
5241     <p>Si la directive comporte plusieurs filtres, ils doivent être
5242     séparés par des points-virgules, et spécifiés selon l'ordre dans
5243     lequel vous souhaitez les voir agir sur les contenus.</p>
5244
5245 <h3>Voir aussi</h3>
5246 <ul>
5247 <li><a href="../filter.html">Filters</a> documentation</li>
5248 </ul>
5249 </div>
5250 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5251 <div class="directive-section"><h2><a name="stricthostcheck" id="stricthostcheck">Directive</a> <a name="StrictHostCheck" id="StrictHostCheck">StrictHostCheck</a> <a title="Lien permanent" href="#stricthostcheck" class="permalink">&para;</a></h2>
5252 <table class="directive">
5253 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si le nom d'hôte contenu dans une requête doit être
5254 explicitement spécifié au niveau du serveur virtuel qui a pris en compte cette
5255 dernière.
5256              </td></tr>
5257 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>StrictHostCheck ON|OFF</code></td></tr>
5258 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>StrictHostCheck OFF</code></td></tr>
5259 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
5260 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5261 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5262 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.5.1 du serveur HTTP Apache.</td></tr>
5263 </table>
5264     <p>Par défaut, le serveur répond aux requêtes quel que soit le nom d'hôte
5265     qu'elles contiennent, y compris un nom d'hôte non prévu dans la
5266     configuration. Bien que cela soit pratique, il peut s'avérer souhaitable de
5267     restreindre les noms d'hôte qu'une application sous-jacente devra prendre en
5268     compte car elle va souvent générer des réponses en se référençant elle-même.</p>
5269
5270     <p>Si la directive <code class="directive">StrictHostCheck</code> est définie à
5271     <em>ON</em>, le serveur générera une erreur HTTP 400 si le nom d'hôte que
5272     contient la requête n'a pas été explicitement spécifié par une directive
5273     <code class="directive"><a href="#servername">ServerName</a></code> ou <code class="directive"><a href="#serveralias">ServerAlias</a></code> au niveau du serveur virtuel qui
5274     correspond le mieux aux caractéristiques de la connexion entrante.</p>
5275
5276    <p>Cette directive permet aussi de rechercher une correspondance entre le nom
5277    d'hôte de la requête et les noms d'hôte spécifiés au sein de la balise
5278    ouvrante <code class="directive"><a href="#virtualhost">VirtualHost</a></code>. Il s'agit
5279    cependant d'un mécanisme de configuration relativement obscur qui agit comme
5280    une directive <code class="directive"><a href="#serveralias">ServerAlias</a></code>
5281    supplémentaire.</p>
5282
5283    <p>Cette directive n'a aucun effet dans les serveurs virtuels qui ne sont pas
5284    des serveurs par défaut. La valeur héritée de la configuration globale du
5285    serveur ou le serveur virtuel par défaut pour l'adresse IP/port de la
5286    connexion sous-jacente déterminent la valeur effective.</p>
5287
5288 </div>
5289 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5290 <div class="directive-section"><h2><a name="timeout" id="timeout">Directive</a> <a name="TimeOut" id="TimeOut">TimeOut</a> <a title="Lien permanent" href="#timeout" class="permalink">&para;</a></h2>
5291 <table class="directive">
5292 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Temps pendant lequel le serveur va attendre certains
5293 évènements avant de considérer qu'une requête a échoué</td></tr>
5294 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TimeOut <var>time-interval</var>[s]</code></td></tr>
5295 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>TimeOut 60</code></td></tr>
5296 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
5297 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5298 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5299 </table>
5300     <p>La directive <code class="directive">TimeOut</code> permet de définir le
5301     temps maximum pendant lequel Apache httpd va attendre des entrées/sorties
5302     selon les circonstances :</p>
5303
5304     <ul>
5305       <li><p>Lors de la lecture de données en provenance du client, le
5306       temps maximum jusqu'à l'arrivée d'un paquet TCP si le tampon est
5307       vide.</p>
5308       <p>Pour les données initiales d'une nouvelle connexion, et tant qu'une
5309       directive <code class="directive"><a href="#acceptfilter">AcceptFilter</a></code> n'aura pas
5310       transmis cette nouvelle connexion au serveur, cette directive n'aura aucun
5311       effet.</p>
5312       </li>
5313
5314       <li>Lors de l'écriture de données destinées au client, le temps
5315       maximum jusqu'à l'arrivée de l'accusé-réception d'un paquet si le
5316       tampon d'envoi est plein.</li>
5317
5318       <li>Avec <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> et <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code>, le temps
5319       d'attente maximum pour un bloc individuel en sortie d'un script CGI.</li>
5320
5321       <li>Avec <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>, le temps d'attente
5322       maximum des sorties d'un processus de filtrage.</li>
5323
5324       <li>Avec <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, la valeur du délai par défaut
5325       si <code class="directive"><a href="../mod/mod_proxy.html#proxytimeout">ProxyTimeout</a></code> n'est
5326       pas défini.</li>
5327     </ul>
5328
5329
5330 </div>
5331 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5332 <div class="directive-section"><h2><a name="traceenable" id="traceenable">Directive</a> <a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a title="Lien permanent" href="#traceenable" class="permalink">&para;</a></h2>
5333 <table class="directive">
5334 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le comportement des requêtes
5335 <code>TRACE</code></td></tr>
5336 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr>
5337 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>TraceEnable on</code></td></tr>
5338 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
5339 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5340 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5341 </table>
5342     <p>Cette directive l'emporte sur le comportement de
5343     <code>TRACE</code> pour le noyau du serveur et
5344     <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. La définition par défaut
5345     <code>TraceEnable on</code> permet des requêtes <code>TRACE</code>
5346     selon la RFC 2616, qui interdit d'ajouter tout corps à la requête.
5347     La définition <code>TraceEnable off</code> indique au noyau du
5348     serveur et à <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> de retourner un code
5349     d'erreur <code>405</code> (Méthode non autorisée) au client.</p>
5350
5351     <p>En fait, et à des fins de test et de diagnostic seulement, on
5352     peut autoriser l'ajout d'un corps de requête à l'aide de la
5353     définition non standard <code>TraceEnable extended</code>. Le noyau
5354     du serveur (dans le cas d'un serveur d'origine) va limiter la taille
5355     du corps de requête à 64Kb (plus 8Kb pour les en-têtes de
5356     fractionnement si <code>Transfer-Encoding: chunked</code> est
5357     utilisé). Le noyau du serveur va reproduire l'ensemble des en-têtes,
5358     y compris les en-têtes de fractionnement avec le corps de la
5359     réponse. Dans le cas d'un serveur mandataire, la taille du corps de
5360     requête n'est pas limitée à 64Kb.</p>
5361
5362     <div class="note"><h3>Note</h3>
5363     <p>Bien que certains prétendent le contraire, activer la méthode
5364     <code>TRACE</code> ne constitue pas un problème de sécurité dans Apache
5365     httpd. La méthode <code>TRACE</code> est définie par la spécification
5366     HTTP/1.1 et les différentes implémentations sont censées la supporter.</p>
5367     </div>
5368
5369 </div>
5370 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5371 <div class="directive-section"><h2><a name="undefine" id="undefine">Directive</a> <a name="UnDefine" id="UnDefine">UnDefine</a> <a title="Lien permanent" href="#undefine" class="permalink">&para;</a></h2>
5372 <table class="directive">
5373 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Invalide la définition d'une variable</td></tr>
5374 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UnDefine <var>nom-variable</var></code></td></tr>
5375 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel</td></tr>
5376 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5377 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5378 </table>
5379     <p>Annule l'effet d'une directive <code class="directive"><a href="#define">Define</a></code> ou d'un argument <code>-D</code> de
5380     <code class="program"><a href="../programs/httpd.html">httpd</a></code> en invalidant l'existence de la variable
5381     correspondante.</p>
5382     <p>On peut utiliser cette directive pour inverser l'effet d'une
5383     section <code class="directive"><a href="#ifdefine">&lt;IfDefine&gt;</a></code>
5384     sans avoir à modifier les arguments <code>-D</code> dans les scripts
5385     de démarrage.</p>
5386     <p>Si cette directive est définie au sein d'un bloc VirtualHost, les
5387     changements qu'elle induit sont visibles de toute directive
5388     ultérieure, au delà de tout bloc VirtualHost.</p>
5389
5390 <h3>Voir aussi</h3>
5391 <ul>
5392 <li><code class="directive"><a href="#define">Define</a></code></li>
5393 <li><code class="directive"><a href="#ifdefine">IfDefine</a></code></li>
5394 </ul>
5395 </div>
5396 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5397 <div class="directive-section"><h2><a name="usecanonicalname" id="usecanonicalname">Directive</a> <a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a title="Lien permanent" href="#usecanonicalname" class="permalink">&para;</a></h2>
5398 <table class="directive">
5399 <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
5400 et son port</td></tr>
5401 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
5402 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>UseCanonicalName Off</code></td></tr>
5403 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
5404 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5405 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5406 </table>
5407     <p>Dans de nombreuses situations, Apache httpd doit construire une URL
5408     <em>auto-identifiante</em> -- c'est à dire une URL qui fait
5409     référence au serveur lui-même. Avec <code>UseCanonicalName
5410     On</code>, Apache httpd va utiliser le nom d'hôte et le port spécifiés par
5411     la directive <code class="directive"><a href="#servername">ServerName</a></code> pour
5412     construire le nom canonique du serveur. Ce nom est utilisé dans
5413     toutes les URLs auto-identifiantes, et affecté aux variables
5414     <code>SERVER_NAME</code> et <code>SERVER_PORT</code> dans les
5415     programmes CGI.</p>
5416
5417     <p>Avec <code>UseCanonicalName Off</code>, Apache httpd va construire ses
5418     URLs auto-identifiantes à l'aide du nom d'hôte et du port fournis
5419     par le client, si ce dernier en a fourni un (dans la négative,
5420     Apache utilisera le nom canonique, de la même manière que
5421     ci-dessus). Ces valeurs sont les mêmes que celles qui sont utilisées
5422     pour implémenter les <a href="../vhosts/name-based.html">serveurs virtuels à base de
5423     nom</a>, et sont disponibles avec les mêmes clients. De même, les
5424     variables CGI <code>SERVER_NAME</code> et <code>SERVER_PORT</code>
5425     seront affectées des valeurs fournies par le client.</p>
5426
5427     <p>Cette directive peut s'avérer utile, par exemple, sur un serveur
5428     intranet auquel les utilisateurs se connectent en utilisant des noms
5429     courts tels que <code>www</code>. Si les utilisateurs tapent un nom
5430     court suivi d'une URL qui fait référence à un répertoire, comme
5431     <code>http://www/splat</code>, <em>sans le slash terminal</em>, vous
5432     remarquerez qu'Apache httpd va les rediriger vers
5433     <code>http://www.example.com/splat/</code>. Si vous avez activé
5434     l'authentification, ceci va obliger l'utilisateur à s'authentifier
5435     deux fois (une première fois pour <code>www</code> et une seconde
5436     fois pour <code>www.example.com</code> -- voir <a href="http://wiki.apache.org/httpd/FAQ#Why_does_Apache_ask_for_my_password_twice_before_serving_a_file.3F">la
5437     foire aux questions sur ce sujet pour plus d'informations</a>).
5438     Par contre, si <code class="directive">UseCanonicalName</code> est définie à
5439     <code>Off</code>, Apache httpd redirigera l'utilisateur vers
5440     <code>http://www/splat/</code>.</p>
5441
5442     <p>Pour l'hébergement virtuel en masse à base d'adresse IP, on
5443     utilise une troisième option, <code>UseCanonicalName
5444     DNS</code>, pour supporter les clients anciens qui ne
5445     fournissent pas d'en-tête <code>Host:</code>. Apache httpd effectue alors
5446     une recherche DNS inverse sur l'adresse IP du serveur auquel le
5447     client s'est connecté afin de construire ses URLs
5448     auto-identifiantes.</p>
5449
5450     <div class="warning"><h3>Avertissement</h3>
5451     <p>Les programmes CGI risquent d'être perturbés par cette option
5452     s'ils tiennent compte de la variable <code>SERVER_NAME</code>. Le
5453     client est pratiquement libre de fournir la valeur qu'il veut comme
5454     nom d'hôte. Mais si le programme CGI n'utilise
5455     <code>SERVER_NAME</code> que pour construire des URLs
5456     auto-identifiantes, il ne devrait pas y avoir de problème.</p>
5457     </div>
5458
5459 <h3>Voir aussi</h3>
5460 <ul>
5461 <li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
5462 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
5463 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
5464 </ul>
5465 </div>
5466 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5467 <div class="directive-section"><h2><a name="usecanonicalphysicalport" id="usecanonicalphysicalport">Directive</a> <a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a> <a title="Lien permanent" href="#usecanonicalphysicalport" class="permalink">&para;</a></h2>
5468 <table class="directive">
5469 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la manière dont le serveur
5470 détermine son propre port</td></tr>
5471 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr>
5472 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr>
5473 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire</td></tr>
5474 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5475 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5476 </table>
5477     <p>Dans de nombreuses situations, Apache httpd doit construire une URL
5478     <em>auto-identifiante</em> -- c'est à dire une URL qui fait
5479     référence au serveur lui-même. Avec <code>UseCanonicalPhysicalPort
5480     On</code>, Apache httpd va fournir le numéro de port physique réel utilisé
5481     par la requête en tant que port potentiel, pour construire le port
5482     canonique afin que le serveur puisse alimenter la directive
5483     <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>. Avec
5484     <code>UseCanonicalPhysicalPort Off</code>, Apache httpd n'utilisera pas le
5485     numéro de port physique réel, mais au contraire se référera aux
5486     informations de configuration pour construire un numéro de port
5487     valide.</p>
5488
5489     <div class="note"><h3>Note</h3>
5490     <p>L'ordre dans lequel s'effectue la recherche quand on utilise le
5491     port physique est le suivant :</p>
5492      <dl>
5493      <dt><code>UseCanonicalName Off | DNS</code></dt>
5494      <dd>
5495      <ol>
5496       <li>Port extrait de l'en-tête <code>Host:</code></li>
5497       <li>Port physique (seulement avec
5498       <code class="directive">UseCanonicalPhysicalPort</code> ON)</li>
5499       <li>Port indiqué dans <code class="directive"><a href="#servername">Servername</a></code></li>
5500       <li>Port par défaut</li>
5501      </ol>
5502      </dd>
5503      <dt><code>UseCanonicalName On</code></dt>
5504      <dd>
5505      <ol>
5506       <li>Port spécifié par <code class="directive"><a href="#servername">Servername</a></code></li>
5507       <li>Port physique (seulement avec
5508       <code class="directive">UseCanonicalPhysicalPort</code> ON)</li>
5509       <li>Port par défaut</li>
5510      </ol>
5511      </dd>
5512     </dl>
5513
5514     <p>Les ports physiques ne sont inclus dans la recherche qu'avec
5515     <code class="directive">UseCanonicalPhysicalPort</code> ON</p>
5516     </div>
5517
5518
5519 <h3>Voir aussi</h3>
5520 <ul>
5521 <li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
5522 <li><code class="directive"><a href="#servername">ServerName</a></code></li>
5523 <li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
5524 </ul>
5525 </div>
5526 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5527 <div class="directive-section"><h2><a name="virtualhost" id="virtualhost">Directive</a> <a name="VirtualHost" id="VirtualHost">&lt;VirtualHost&gt;</a> <a title="Lien permanent" href="#virtualhost" class="permalink">&para;</a></h2>
5528 <table class="directive">
5529 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent qu'à un nom
5530 d'hôte spécifique ou à une adresse IP</td></tr>
5531 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;VirtualHost
5532     <var>adresse IP</var>[:<var>port</var>] [<var>adresse
5533     IP</var>[:<var>port</var>]] ...&gt; ...
5534     &lt;/VirtualHost&gt;</code></td></tr>
5535 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
5536 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5537 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5538 </table>
5539     <p>Les balises <code class="directive">&lt;VirtualHost&gt;</code> et
5540     <code>&lt;/VirtualHost&gt;</code> permettent de rassembler un groupe
5541     de directives qui ne s'appliquent qu'à un serveur virtuel
5542     particulier. Toute directive autorisée dans un contexte de serveur
5543     virtuel peut être utilisée. Lorsque le serveur reçoit un requête
5544     pour un document hébergé par un serveur virtuel particulier, il
5545     applique les directives de configuration rassemblées dans la section
5546     <code class="directive">&lt;VirtualHost&gt;</code>. <var>adresse
5547     IP</var> peut être une des entités suivantes, éventuellement suivies
5548     d'un caractère ':' et d'un numéro de port (ou *) :</p>
5549
5550     <ul>
5551       <li>L'adresse IP du serveur virtuel ;</li>
5552
5553       <li>Un nom de domaine entièrement qualifié correspondant à
5554       l'adresse IP du serveur virtuel (non recommandé) ;</li>
5555
5556       <li>Le caractère <code>*</code>, qui agit comme un
5557       caractère générique, et correspond à toute adresse IP.</li>
5558
5559       <li>La chaîne <code>_default_</code>, dont la signification est
5560       identique à celle du caractère <code>*</code></li>
5561
5562     </ul>
5563
5564     <pre class="prettyprint lang-config">&lt;VirtualHost 10.1.2.3:80&gt;
5565   ServerAdmin webmaster@host.example.com
5566   DocumentRoot "/www/docs/host.example.com"
5567   ServerName host.example.com
5568   ErrorLog "logs/host.example.com-error_log"
5569   TransferLog "logs/host.example.com-access_log"
5570 &lt;/VirtualHost&gt;</pre>
5571
5572
5573
5574     <p>Les adresses IPv6 doivent être entourées de crochets car dans le
5575     cas contraire, un éventuel port optionnel ne pourrait pas être
5576     déterminé. Voici un exemple de serveur virtuel avec adresse IPv6
5577     :</p>
5578
5579     <pre class="prettyprint lang-config">&lt;VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80&gt;
5580   ServerAdmin webmaster@host.example.com
5581   DocumentRoot "/www/docs/host.example.com"
5582   ServerName host.example.com
5583   ErrorLog "logs/host.example.com-error_log"
5584   TransferLog "logs/host.example.com-access_log"
5585 &lt;/VirtualHost&gt;</pre>
5586
5587
5588     <p>Chaque serveur virtuel doit correspondre à une adresse IP, un
5589     port ou un nom d'hôte spécifique ; dans le premier cas, le serveur
5590     doit être configuré pour recevoir les paquets IP de plusieurs
5591     adresses (si le serveur n'a qu'une interface réseau, on peut
5592     utiliser à cet effet la commande <code>ifconfig alias</code> -- si
5593     votre système d'exploitation le permet).</p>
5594
5595     <div class="note"><h3>Note</h3>
5596     <p>L'utilisation de la directive <code class="directive">&lt;VirtualHost&gt;</code> n'affecte en rien les
5597     adresses IP sur lesquelles Apache httpd est en écoute. Vous devez vous
5598     assurer que les adresses des serveurs virtuels sont bien incluses
5599     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>
5600     </div>
5601
5602     <p>Tout bloc <code class="directive">&lt;VirtualHost&gt;</code> doit comporter une directive
5603     <code class="directive"><a href="#servername">ServerName</a></code>. Dans le cas
5604     contraire, le serveur virtuel héritera de la valeur de la directive
5605     <code class="directive"><a href="#servername">ServerName</a></code> issue de la
5606     configuration du serveur principal.</p>
5607
5608     <p>A l'arrivée d'une requête, le serveur tente de la
5609     faire prendre en compte par la section <code class="directive">&lt;VirtualHost&gt;</code> qui correspond le mieux en ne
5610     se basant que sur la paire adresse IP/port. Les chaînes sans
5611     caractères génériques l'emportent sur celles qui en contiennent. Si
5612     aucune correspondance du point de vue de l'adresse IP/port n'est
5613     trouvée, c'est la configuration du serveur "principal" qui sera
5614     utilisée.</p>
5615
5616     <p>Si plusieurs serveurs virtuels correspondent du point de vue de
5617     l'adresse IP/port, le serveur sélectionne celui qui correspond le
5618     mieux du point de vue du nom d'hôte de la requête. Si aucune
5619     correspondance du point de vue du nom d'hôte n'est trouvée, c'est le
5620     premier serveur virtuel dont l'adresse IP/port correspond qui sera
5621     utilisé. Par voie de conséquence, le premier serveur virtuel
5622     comportant une certaine paire adresse IP/port est le serveur virtuel
5623     par défaut pour cette paire adresse IP/port.</p>
5624
5625     <div class="warning"><h3>Sécurité</h3>
5626     <p>Voir le document sur les <a href="../misc/security_tips.html">conseils à propos de sécurité</a>
5627     pour une description détaillée des raisons pour lesquelles la
5628     sécurité de votre serveur pourrait être compromise, si le répertoire
5629     contenant les fichiers journaux est inscriptible par tout autre
5630     utilisateur que celui qui démarre le serveur.</p>
5631     </div>
5632
5633 <h3>Voir aussi</h3>
5634 <ul>
5635 <li><a href="../vhosts/">Documentation des serveurs virtuels
5636 du serveur HTTP Apache</a></li>
5637 <li><a href="../dns-caveats.html">Problèmes concernant le DNS et
5638 le serveur HTTP Apache</a></li>
5639 <li><a href="../bind.html">Définition des adresses et ports
5640 qu'utilise le serveur HTTP Apache</a></li>
5641 <li><a href="../sections.html">Comment fonctionnent les sections
5642 &lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
5643 explication de la manière dont ces différentes sections se combinent
5644 entre elles à la réception d'une requête</li>
5645 </ul>
5646 </div>
5647 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
5648 <div class="directive-section"><h2><a name="warning" id="warning">Directive</a> <a name="Warning" id="Warning">Warning</a> <a title="Lien permanent" href="#warning" class="permalink">&para;</a></h2>
5649 <table class="directive">
5650 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Message d'avertissement personnalisable en provenance de
5651 l'interprétation du fichier de configuration</td></tr>
5652 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Warning <var>message</var></code></td></tr>
5653 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
5654 <tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</a></th><td>All</td></tr>
5655 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Noyau httpd</td></tr>
5656 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
5657 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.5 du serveur HTTP
5658 Apache.</td></tr>
5659 </table>
5660     <p>Cette directive permet de signaler la détection d'un problème de
5661     configuration en générant un message d'avertissement
5662     personnalisable. L'interprétation du fichier de configuration n'est
5663     pas interrompue. Un exemple typique d'utilisation est la
5664     vérification de la définition de certaines options définies par
5665     l'utilisateur, et l'envoi d'un avertissement éventuel.</p>
5666
5667     <pre class="prettyprint lang-config"># Exemple
5668 # signale que ReverseProxy n'est pas défini
5669 &lt;IfDefine !ReverseProxy&gt;
5670   Warning "le mandataire inverse n'a pas été spécifié, veuillez corriger
5671   si nécessaire"
5672 &lt;/IfDefine&gt;
5673
5674 &lt;IfDefine ReverseProxy&gt;
5675   # définition de la configuration personnalisée du mandataire
5676 &lt;/IfDefine&gt;</pre>
5677
5678
5679
5680 </div>
5681 </div>
5682 <div class="bottomlang">
5683 <p><span>Langues Disponibles: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
5684 <a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
5685 <a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a> |
5686 <a href="../fr/mod/core.html" title="Français">&nbsp;fr&nbsp;</a> |
5687 <a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
5688 <a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
5689 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
5690 <script type="text/javascript"><!--//--><![CDATA[//><!--
5691 var comments_shortname = 'httpd';
5692 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/core.html';
5693 (function(w, d) {
5694     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
5695         d.write('<div id="comments_thread"><\/div>');
5696         var s = d.createElement('script');
5697         s.type = 'text/javascript';
5698         s.async = true;
5699         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
5700         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
5701     }
5702     else {
5703         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
5704     }
5705 })(window, document);
5706 //--><!]]></script></div><div id="footer">
5707 <p class="apache">Copyright 2019 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
5708 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
5709 if (typeof(prettyPrint) !== 'undefined') {
5710     prettyPrint();
5711 }
5712 //--><!]]></script>
5713 </body></html>