1<?xml version="1.0" encoding="ISO-8859-1"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- 4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>core - Serveur Apache HTTP</title> 9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" /> 12<script src="/style/scripts/prettify.min.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p> 19<p class="apache">Serveur Apache HTTP Version 2.4</p> 20<img alt="" src="/images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Modules</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Fonctionalit�s de Base Apache</h1> 26<div class="toplang"> 27<p><span>Langues Disponibles: </span><a href="/de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | 28<a href="/en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> | 29<a href="/es/mod/core.html" hreflang="es" rel="alternate" title="Espa�ol"> es </a> | 30<a href="/fr/mod/core.html" title="Fran�ais"> fr </a> | 31<a href="/ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 32<a href="/tr/mod/core.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 33</div> 34<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fonctionnalit�s de base du serveur HTTP Apache toujours 35disponibles</td></tr> 36<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Core</td></tr></table> 37</div> 38<div id="quickview"><h3 class="directives">Directives</h3> 39<ul id="toc"> 40<li><img alt="" src="/images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li> 41<li><img alt="" src="/images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li> 42<li><img alt="" src="/images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li> 43<li><img alt="" src="/images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li> 44<li><img alt="" src="/images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li> 45<li><img alt="" src="/images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li> 46<li><img alt="" src="/images/down.gif" /> <a href="#allowoverridelist">AllowOverrideList</a></li> 47<li><img alt="" src="/images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li> 48<li><img alt="" src="/images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li> 49<li><img alt="" src="/images/down.gif" /> <a href="#defaultruntimedir">DefaultRuntimeDir</a></li> 50<li><img alt="" src="/images/down.gif" /> <a href="#defaulttype">DefaultType</a></li> 51<li><img alt="" src="/images/down.gif" /> <a href="#define">Define</a></li> 52<li><img alt="" src="/images/down.gif" /> <a href="#directory"><Directory></a></li> 53<li><img alt="" src="/images/down.gif" /> <a href="#directorymatch"><DirectoryMatch></a></li> 54<li><img alt="" src="/images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li> 55<li><img alt="" src="/images/down.gif" /> <a href="#else"><Else></a></li> 56<li><img alt="" src="/images/down.gif" /> <a href="#elseif"><ElseIf></a></li> 57<li><img alt="" src="/images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li> 58<li><img alt="" src="/images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li> 59<li><img alt="" src="/images/down.gif" /> <a href="#error">Error</a></li> 60<li><img alt="" src="/images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li> 61<li><img alt="" src="/images/down.gif" /> <a href="#errorlog">ErrorLog</a></li> 62<li><img alt="" src="/images/down.gif" /> <a href="#errorlogformat">ErrorLogFormat</a></li> 63<li><img alt="" src="/images/down.gif" /> <a href="#extendedstatus">ExtendedStatus</a></li> 64<li><img alt="" src="/images/down.gif" /> <a href="#fileetag">FileETag</a></li> 65<li><img alt="" src="/images/down.gif" /> <a href="#files"><Files></a></li> 66<li><img alt="" src="/images/down.gif" /> <a href="#filesmatch"><FilesMatch></a></li> 67<li><img alt="" src="/images/down.gif" /> <a href="#forcetype">ForceType</a></li> 68<li><img alt="" src="/images/down.gif" /> <a href="#gprofdir">GprofDir</a></li> 69<li><img alt="" src="/images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li> 70<li><img alt="" src="/images/down.gif" /> <a href="#if"><If></a></li> 71<li><img alt="" src="/images/down.gif" /> <a href="#ifdefine"><IfDefine></a></li> 72<li><img alt="" src="/images/down.gif" /> <a href="#ifmodule"><IfModule></a></li> 73<li><img alt="" src="/images/down.gif" /> <a href="#include">Include</a></li> 74<li><img alt="" src="/images/down.gif" /> <a href="#includeoptional">IncludeOptional</a></li> 75<li><img alt="" src="/images/down.gif" /> <a href="#keepalive">KeepAlive</a></li> 76<li><img alt="" src="/images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li> 77<li><img alt="" src="/images/down.gif" /> <a href="#limit"><Limit></a></li> 78<li><img alt="" src="/images/down.gif" /> <a href="#limitexcept"><LimitExcept></a></li> 79<li><img alt="" src="/images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li> 80<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li> 81<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li> 82<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li> 83<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li> 84<li><img alt="" src="/images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li> 85<li><img alt="" src="/images/down.gif" /> <a href="#location"><Location></a></li> 86<li><img alt="" src="/images/down.gif" /> <a href="#locationmatch"><LocationMatch></a></li> 87<li><img alt="" src="/images/down.gif" /> <a href="#loglevel">LogLevel</a></li> 88<li><img alt="" src="/images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li> 89<li><img alt="" src="/images/down.gif" /> <a href="#maxrangeoverlaps">MaxRangeOverlaps</a></li> 90<li><img alt="" src="/images/down.gif" /> <a href="#maxrangereversals">MaxRangeReversals</a></li> 91<li><img alt="" src="/images/down.gif" /> <a href="#maxranges">MaxRanges</a></li> 92<li><img alt="" src="/images/down.gif" /> <a href="#mutex">Mutex</a></li> 93<li><img alt="" src="/images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li> 94<li><img alt="" src="/images/down.gif" /> <a href="#options">Options</a></li> 95<li><img alt="" src="/images/down.gif" /> <a href="#protocol">Protocol</a></li> 96<li><img alt="" src="/images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li> 97<li><img alt="" src="/images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li> 98<li><img alt="" src="/images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li> 99<li><img alt="" src="/images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li> 100<li><img alt="" src="/images/down.gif" /> <a href="#seerequesttail">SeeRequestTail</a></li> 101<li><img alt="" src="/images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li> 102<li><img alt="" src="/images/down.gif" /> <a href="#serveralias">ServerAlias</a></li> 103<li><img alt="" src="/images/down.gif" /> <a href="#servername">ServerName</a></li> 104<li><img alt="" src="/images/down.gif" /> <a href="#serverpath">ServerPath</a></li> 105<li><img alt="" src="/images/down.gif" /> <a href="#serverroot">ServerRoot</a></li> 106<li><img alt="" src="/images/down.gif" /> <a href="#serversignature">ServerSignature</a></li> 107<li><img alt="" src="/images/down.gif" /> <a href="#servertokens">ServerTokens</a></li> 108<li><img alt="" src="/images/down.gif" /> <a href="#sethandler">SetHandler</a></li> 109<li><img alt="" src="/images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li> 110<li><img alt="" src="/images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li> 111<li><img alt="" src="/images/down.gif" /> <a href="#timeout">TimeOut</a></li> 112<li><img alt="" src="/images/down.gif" /> <a href="#traceenable">TraceEnable</a></li> 113<li><img alt="" src="/images/down.gif" /> <a href="#undefine">UnDefine</a></li> 114<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li> 115<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li> 116<li><img alt="" src="/images/down.gif" /> <a href="#virtualhost"><VirtualHost></a></li> 117</ul> 118<ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> 119 120<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 121<div class="directive-section"><h2><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">Directive</a></h2> 122<table class="directive"> 123<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'optimiser la configuration d'une socket pour 124l'�coute d'un protocole</td></tr> 125<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptFilter <var>protocole</var> <var>filtre 126d'acceptation</var></code></td></tr> 127<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 128<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 129<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 130<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.3 sous Windows et 2.1.5 131sur les autres plates-formes.</td></tr> 132</table> 133 <p>Cette directive permet d'effectuer une optimisation de la socket 134 d'�coute d'un type de protocole en fonction du syst�me 135 d'exploitation. Le but premier est de faire en sorte que le noyau 136 n'envoie pas de socket au processus du serveur jusqu'� ce que 137 des donn�es soient re�ues, ou qu'une requ�te HTTP compl�te soit mise 138 en tampon. Seuls les <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter& sektion=9">Filtres d'acceptation de FreeBSD</a>, le filtre plus 139 primitif <code>TCP_DEFER_ACCEPT</code> sous Linux, et la version 140 optimis�e d'AcceptEx() de Windows sont actuellement support�s.</p> 141 142 <p>L'utilisation de l'argument <code>none</code> va d�sactiver tout 143 filtre d'acceptation pour ce protocole. Ceci s'av�re utile pour les 144 protocoles qui n�cessitent l'envoi de donn�es par le serveur en 145 premier, comme <code>ftp:</code> ou <code>nntp</code>:</p> 146 <pre class="prettyprint lang-config">AcceptFilter nntp none</pre> 147 148 149 <p>Les noms de protocoles par d�faut sont <code>https</code> pour le 150 port 443 et <code>http</code> pour tous les autres ports. Pour 151 sp�cifier un autre protocole � utiliser avec un port en �coute, 152 ajoutez l'argument <var>protocol</var> � la directive <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code>.</p> 153 154 <p>Sous FreeBSD, les valeurs par d�faut sont :</p> 155 <pre class="prettyprint lang-config">AcceptFilter http httpready 156AcceptFilter https dataready</pre> 157 158 159 <p>Le filtre d'acceptation <code>httpready</code> met en tampon des 160 requ�tes HTTP enti�res au niveau du noyau. Quand une requ�te 161 enti�re a �t� re�ue, le noyau l'envoie au serveur. Voir la page de 162 manuel de <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http& sektion=9">accf_http(9)</a> pour plus de d�tails. Comme les requ�tes 163 HTTPS sont chiffr�es, celles-ci n'autorisent que le filtre <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data& sektion=9">accf_data(9)</a>.</p> 164 165 <p>Sous Linux, les valeurs par d�faut sont :</p> 166 <pre class="prettyprint lang-config">AcceptFilter http data 167AcceptFilter https data</pre> 168 169 170 <p>Le filtre <code>TCP_DEFER_ACCEPT</code> de Linux ne supporte pas 171 la mise en tampon des requ�tes http. Toute valeur autre que 172 <code>none</code> active le filtre <code>TCP_DEFER_ACCEPT</code> 173 pour ce protocole. Pour plus de d�tails, voir la page de 174 manuel Linux de <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/ tcp.7.html">tcp(7)</a>.</p> 175 176 <p>Sous Windows, les valeurs par d�faut sont :</p> 177 <pre class="prettyprint lang-config">AcceptFilter http data 178AcceptFilter https data</pre> 179 180 181 <p>Le module MPM pour Windows mpm_winnt utilise la directive 182 AcceptFilter comme commutateur de l'API AcceptEx(), et ne supporte 183 pas la mise en tampon du protocole http. Deux valeurs utilisent 184 l'API Windows AcceptEx() et vont recycler les sockets r�seau entre 185 les connexions. <code>data</code> attend jusqu'� ce que les donn�es 186 aient �t� transmises comme d�crit plus haut, et le tampon de donn�es 187 initiales ainsi que les adresses r�seau finales sont tous extraits 188 gr�ce � une seule invocation d'AcceptEx(). <code>connect</code> 189 utilise l'API AcceptEx(), extrait aussi les adresses r�seau finales, 190 mais � l'instar de <code>none</code>, la valeur <code>connect</code> 191 n'attend pas la transmission des donn�es initiales.</p> 192 193 <p>Sous Windows, <code>none</code> utilise accept() au lieu 194 d'AcceptEx(), et ne recycle pas les sockets entre les connexions. 195 Ceci s'av�re utile pour les interfaces r�seau dont le pilote est 196 d�fectueux, ainsi que pour certains fournisseurs de r�seau comme les 197 pilotes vpn, ou les filtres anti-spam, anti-virus ou 198 anti-spyware.</p> 199 200 201<h3>Voir aussi</h3> 202<ul> 203<li><code class="directive"><a href="#protocol">Protocol</a></code></li> 204</ul> 205</div> 206<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 207<div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">Directive</a></h2> 208<table class="directive"> 209<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les ressources acceptent des informations sous forme d'un 210nom de chemin en fin de requ�te.</td></tr> 211<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr> 212<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AcceptPathInfo Default</code></td></tr> 213<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 214<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 215<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 216<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 217</table> 218 219 <p>Cette directive permet de d�finir si les requ�tes contenant des 220 informations sous forme d'un nom de chemin suivant le nom d'un 221 fichier r�el (ou un fichier qui n'existe pas dans un r�pertoire qui 222 existe) doivent �tre accept�es ou rejet�es. Les scripts peuvent 223 acc�der � cette information via la variable d'environnement 224 <code>PATH_INFO</code>.</p> 225 226 <p>Supposons par exemple que <code>/test/</code> pointe vers un 227 r�pertoire qui ne contient que le fichier <code>here.html</code>. 228 Les requ�tes pour <code>/test/here.html/more</code> et 229 <code>/test/nothere.html/more</code> vont affecter la valeur 230 <code>/more</code> � la variable d'environnement 231 <code>PATH_INFO</code>.</p> 232 233 <p>L'argument de la directive <code class="directive">AcceptPathInfo</code> 234 poss�de trois valeurs possibles :</p> 235 <dl> 236 <dt><code>Off</code></dt><dd>Une requ�te ne sera accept�e que si 237 elle correspond � un chemin qui existe. Par cons�quent, une requ�te 238 contenant une information de chemin apr�s le nom de fichier r�el 239 comme <code>/test/here.html/more</code> dans l'exemple ci-dessus 240 renverra une erreur "404 NOT FOUND".</dd> 241 242 <dt><code>On</code></dt><dd>Une requ�te sera accept�e si la partie 243 principale du chemin correspond � un fichier existant. Dans 244 l'exemple ci-dessus <code>/test/here.html/more</code>, la requ�te 245 sera accept�e si <code>/test/here.html</code> correspond � un nom de 246 fichier valide.</dd> 247 248 <dt><code>Default</code></dt><dd>Le traitement des requ�tes est 249 d�termin� par le <a href="/handler.html">gestionnaire</a> responsable de la requ�te. 250 Le gestionnaire de base pour les fichiers normaux rejette par d�faut 251 les requ�tes avec <code>PATH_INFO</code>. Les gestionnaires qui 252 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 253 d�faut les requ�tes avec <code>PATH_INFO</code>.</dd> 254 </dl> 255 256 <p>Le but premier de la directive <code>AcceptPathInfo</code> est de 257 vous permettre de remplacer le choix du gestionnaire d'accepter ou 258 de rejeter <code>PATH_INFO</code>. Ce remplacement est n�cessaire 259 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� 260 sur <code>PATH_INFO</code>. Le gestionnaire de base va en g�n�ral 261 rejeter la requ�te, et vous pouvez utiliser la configuration 262 suivante pour utiliser un tel script :</p> 263<pre class="prettyprint lang-config"><Files "mypaths.shtml"> 264 Options +Includes 265 SetOutputFilter INCLUDES 266 AcceptPathInfo On 267</Files></pre> 268 269 270 271 272</div> 273<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 274<div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">Directive</a></h2> 275<table class="directive"> 276<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du fichier de configuration distribu�</td></tr> 277<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AccessFileName <var>nom-du-fichier</var> 278[<var>nom-du-fichier</var>] ...</code></td></tr> 279<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AccessFileName .htaccess</code></td></tr> 280<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 281<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 282<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 283</table> 284 <p>Au cours du traitement d'une requ�te, le serveur recherche le 285 premier fichier de configuration existant � partir de la liste 286 de noms dans chaque r�pertoire composant le chemin du document, � 287 partir du moment o� les fichiers de configuration distribu�s sont <a href="#allowoverride">activ�s pour ce r�pertoire</a>. Par exemple 288 :</p> 289 290 <pre class="prettyprint lang-config">AccessFileName .acl</pre> 291 292 293 <p>avant de renvoyer le document 294 <code>/usr/local/web/index.html</code>, le serveur va rechercher les 295 fichiers <code>/.acl</code>, <code>/usr/.acl</code>, 296 <code>/usr/local/.acl</code> et <code>/usr/local/web/.acl</code> 297 pour y lire d'�ventuelles directives, � moins quelles n'aient �t� 298 d�sactiv�es avec</p> 299 300 <pre class="prettyprint lang-config"><Directory /> 301 AllowOverride None 302</Directory></pre> 303 304 305<h3>Voir aussi</h3> 306<ul> 307<li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li> 308<li><a href="/configuring.html">Fichiers de configuration</a></li> 309<li><a href="/howto/htaccess.html">Fichiers .htaccess</a></li> 310</ul> 311</div> 312<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 313<div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">Directive</a></h2> 314<table class="directive"> 315<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Param�tre jeu de caract�res par d�faut � ajouter quand le 316type de contenu d'une r�ponse est <code>text/plain</code> ou 317<code>text/html</code></td></tr> 318<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> 319<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AddDefaultCharset Off</code></td></tr> 320<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 321<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 322<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 323<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 324</table> 325 <p>Cette directive sp�cifie une valeur par d�faut pour le param�tre 326 jeu de caract�res du type de m�dia (le nom d'un codage de 327 caract�res) � ajouter � une r�ponse, si et seulement si le type de 328 contenu de la r�ponse est soit <code>text/plain</code>, soit 329 <code>text/html</code>. Ceci va remplacer 330 tout jeu de caract�res sp�cifi� dans le corps de la r�ponse via un 331 �l�ment <code>META</code>, bien que cet effet d�pende en fait 332 souvent de la configuration du client de l'utilisateur. La 333 d�finition de <code>AddDefaultCharset Off</code> d�sactive cette 334 fonctionnalit�. <code>AddDefaultCharset On</code> ajoute un jeu de 335 caract�res par d�faut de <code>iso-8859-1</code>. Toute autre valeur 336 peut �tre d�finie via le param�tre <var>jeu de caract�res</var>, qui 337 doit appartenir � la liste des <a href="http://www.iana.org/assignments/character-sets">valeurs de 338 jeux de caract�res enregistr�s par l'IANA</a> � utiliser dans les 339 types de m�dia Internet (types MIME). 340 Par exemple :</p> 341 342 <pre class="prettyprint lang-config">AddDefaultCharset utf-8</pre> 343 344 345 <p>La directive <code class="directive">AddDefaultCharset</code> ne doit 346 �tre utilis�e que lorsque toutes les ressources textes auxquelles 347 elle s'applique poss�dent le jeu de caract�re sp�cifi�, et qu'il est 348 trop contraignant de d�finir leur jeu de caract�res 349 individuellement. Un exemple de ce type est l'ajout du param�tre jeu 350 de caract�res aux ressources comportant un contenu g�n�r�, comme les 351 scripts CGI h�rit�s qui peuvent �tre vuln�rables � des attaques de 352 type cross-site scripting � cause des donn�es utilisateurs incluses 353 dans leur sortie. Notez cependant qu'une meilleur solution consiste 354 � corriger (ou supprimer) ces scripts, car la d�finition d'un jeu de 355 caract�res par d�faut ne prot�ge pas les utilisateurs qui ont activ� 356 la fonctionnalit� "D�tection automatique de l'encodage des 357 caract�res" dans leur navigateur.</p> 358 359<h3>Voir aussi</h3> 360<ul> 361<li><code class="directive"><a href="/mod/mod_mime.html#addcharset">AddCharset</a></code></li> 362</ul> 363</div> 364<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 365<div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">Directive</a></h2> 366<table class="directive"> 367<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�termine si les s�parateurs de chemin encod�s sont 368autoris�s � transiter dans les URLs tels quels</td></tr> 369<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowEncodedSlashes On|Off|NoDecode</code></td></tr> 370<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr> 371<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 372<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 373<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 374<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>L'option NoDecode est disponible depuis la version 3752.3.12.</td></tr> 376</table> 377 <p>La directive <code class="directive">AllowEncodedSlashes</code> permet 378 l'utilisation des URLs contenant des s�parateurs de chemin 379 encod�s dans la partie chemin 380 (<code>%2F</code> pour <code>/</code> et m�me <code>%5C</code> pour 381 <code>\</code> sur les syst�mes concern�s).</p> 382 383 <p>Avec la valeur par d�faut, <code>Off</code>, de telles URLs sont 384 refus�es et provoquent le renvoi d'une erreur 404 (Not found).</p> 385 386 <p>Avec la valeur <code>On</code>, ces URLs sont accept�es, et les 387 slashes encod�s sont d�cod�s comme tout autre caract�re cod�.</p> 388 389 <p>Avec la valeur <code>NoDecode</code>, ces URLs sont accept�es, 390 mais les slashes cod�s ne sont pas d�cod�s et laiss�s dans leur �tat 391 cod�.</p> 392 393 <p>D�finir <code class="directive">AllowEncodedSlashes</code> � 394 <code>On</code> est surtout utile en association avec 395 <code>PATH_INFO</code>.</p> 396 397 <div class="note"><h3>Note</h3> 398 <p>Si le codage des slashes dans la partie chemin est n�cessaire, 399 l'utilisation de l'option <code>NoDecode</code> est fortement 400 recommand�e par mesure de s�curit�. Permettre le d�codage des 401 slashes pourrait �ventuellement induire l'autorisation de chemins 402 non s�rs.</p> 403 </div> 404 405<h3>Voir aussi</h3> 406<ul> 407<li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li> 408</ul> 409</div> 410<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 411<div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">Directive</a></h2> 412<table class="directive"> 413<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types de directives autoris�es dans les fichiers 414<code>.htaccess</code></td></tr> 415<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowOverride All|None|<var>type directive</var> 416[<var>type directive</var>] ...</code></td></tr> 417<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AllowOverride None � partir de la version 2.3.9, AllowOverride 418All pour les versions ant�rieures</code></td></tr> 419<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire</td></tr> 420<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 421<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 422</table> 423 <p>Lorsque le serveur trouve un fichier <code>.htaccess</code> (dont 424 le nom est d�fini par la directive <code class="directive"><a href="#accessfilename">AccessFileName</a></code>), il doit savoir lesquelles 425 des directives plac�es dans ce fichier sont autoris�es � modifier la 426 configuration pr�existante.</p> 427 428 <div class="note"><h3>Valable seulement dans les sections 429 <Directory></h3> 430 La directive <code class="directive">AllowOverride</code> ne peut �tre 431 utilis�e que dans les sections <code class="directive"><a href="#directory"><Directory></a></code> d�finies sans expressions 432 rationnelles, et non dans les sections <code class="directive"><a href="#location"><Location></a></code>, <code class="directive"><a href="#directorymatch"><DirectoryMatch></a></code> ou 433 <code class="directive"><a href="#files"><Files></a></code>. 434 </div> 435 436 <p>Lorsque cette directive et la directive <code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code> sont d�finies � <code>None</code>, les 437 fichiers <a href="#accessfilename">.htaccess</a> sont totalement 438 ignor�s. Dans ce cas, le serveur n'essaiera m�me pas de lire les 439 fichiers <code>.htaccess</code> du syst�me de fichiers.</p> 440 441 <p>Lorsque cette directive est d�finie � <code>All</code>, toute 442 directive valable dans le <a href="directive-dict.html#Context">Contexte</a> .htaccess sera 443 autoris�e dans les fichiers <code>.htaccess</code>.</p> 444 445 <p>L'argument <var>type directive</var> peut contenir les 446 groupements de directives suivants :</p> 447 448 <dl> 449 <dt>AuthConfig</dt> 450 451 <dd> 452 453 Permet l'utilisation des directives d'autorisation (<code class="directive"><a href="/mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>, 454 <code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>, 455 <code class="directive"><a href="/mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>, 456 <code class="directive"><a href="/mod/mod_authn_core.html#authname">AuthName</a></code>, 457 <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> 458 459 <dt>FileInfo</dt> 460 461 <dd> 462 Permet l'utilisation des directives qui contr�lent les types de 463 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>, 464 <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 465 module <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code> Add* et Remove*), des metadonn�es 466 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 467 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 468 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 469 <code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code> du module 470 <code class="module"><a href="/mod/mod_actions.html">mod_actions</a></code>. 471 </dd> 472 473 <dt>Indexes</dt> 474 475 <dd> 476 Permet l'utilisation des directives qui contr�lent l'indexation 477 des r�pertoires (<code class="directive"><a href="/mod/mod_autoindex.html#adddescription">AddDescription</a></code>, 478 <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>, 479 <code class="directive"><a href="/mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>, 480 <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>, <a href="mod_autoindex.html#indexoptions.fancyindexing"><code>FancyIndexing</code></a>, 481 <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>, 482 <em>etc...</em>).</dd> 483 484 <dt>Limit</dt> 485 486 <dd> 487 Permet l'utilisation des directives contr�lant l'acc�s au serveur 488 (<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> 489 490 <dt>Nonfatal=[Override|Unknown|All]</dt> 491 492 <dd> 493 Permet d'utiliser l'option AllowOverride pour rendre les erreurs 494 de syntaxe non fatales dans les fichiers .htaccess : au lieu de 495 causer une Internal Server Error, les directives non autoris�es ou 496 non reconnues seront ignor�es et un avertissement enregistr� dans 497 le journal : 498 <ul> 499 <li><strong>Nonfatal=Override</strong> rend les directives 500 interdite par AllowOverride non fatales.</li> 501 <li><strong>Nonfatal=Unknown</strong> rend les directives 502 inconnues non fatales. Sont concern�es les erreurs de frappe 503 et les directives impl�ment�es par un module non charg�.</li> 504 <li><strong>Nonfatal=All</strong> rend toutes les directives 505 pr�c�dentes non fatales.</li> 506 </ul> 507 <p>Notez qu'une erreur de syntaxe dans une directive valide 508 causera toujours une internal server error.</p> 509 <div class="warning"><h3>S�curit�</h3> 510 Les erreurs non fatales peuvent �tre � l'origine de probl�mes 511 de s�curit� pour les utilisateurs de fichiers .htaccess. Par 512 exemple, si AllowOverride interdit AuthConfig, toute 513 configuration utilisateur destin�e � restreindre l'acc�s � un 514 site ne sera pas prise en compte. 515 </div> 516 </dd> 517 518 <dt>Options[=<var>Option</var>,...]</dt> 519 520 <dd> 521 Permet l'utilisation des directives contr�lant les fonctionnalit�s 522 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 523 suivi d'un signe "�gal", puis d'une liste d'options s�par�es par des 524 virgules (pas d'espaces) ; ces options doivent �tre d�finies � 525 l'aide de la commande <code class="directive"><a href="#options">Options</a></code>. 526 527 <div class="note"><h3>D�sactivation implicite des options</h3> 528 <p>Bien que la liste des options disponibles dans les fichiers 529 .htaccess puisse �tre limit�e par cette directive, tant qu'un 530 directive <code class="directive"><a href="#options">Options</a></code> est 531 autoris�e, toute autre option h�rit�e peut �tre d�sactiv�e en 532 utilisant la syntaxe non-relative. En d'autres termes, ce 533 m�canisme ne peut pas forcer une option sp�cifique � rester 534 <em>activ�e</em> tout en permettant � toute autre option d'�tre 535 activ�e. 536 </p></div> 537 538 <div class="example"><p><code> 539 AllowOverride Options=Indexes,MultiViews 540 </code></p></div> 541 542 </dd> 543 </dl> 544 545 <p>Exemple :</p> 546 547 <pre class="prettyprint lang-config">AllowOverride AuthConfig Indexes</pre> 548 549 550 <p>Dans l'exemple ci-dessus, toutes les directives qui ne font 551 partie ni du groupe <code>AuthConfig</code>, ni du groupe 552 <code>Indexes</code>, provoquent une erreur "internal 553 server error".</p> 554 555 <div class="note"><p>Pour des raisons de s�curit� et de performance, ne 556 d�finissez pas <code>AllowOverride</code> � autre chose que 557 <code>None</code> dans votre bloc <code><Directory /></code>. 558 Recherchez plut�t (ou cr�ez) le bloc <code><Directory></code> 559 qui se r�f�re au r�pertoire o� vous allez pr�cis�ment placer un 560 fichier <code>.htaccess</code>.</p> 561 </div> 562 563<h3>Voir aussi</h3> 564<ul> 565<li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li> 566<li><code class="directive"><a href="#allowoverridelist">AllowOverrideList</a></code></li> 567<li><a href="/configuring.html">Fichiers de configuration</a></li> 568<li><a href="/howto/htaccess.html">Fichiers .htaccess</a></li> 569</ul> 570</div> 571<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 572<div class="directive-section"><h2><a name="AllowOverrideList" id="AllowOverrideList">AllowOverrideList</a> <a name="allowoverridelist" id="allowoverridelist">Directive</a></h2> 573<table class="directive"> 574<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directives autoris�es dans les fichiers <code>.htaccess</code></td></tr> 575<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowOverrideList None|<var>directive</var> 576[<var>directive-type</var>] ...</code></td></tr> 577<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AllowOverrideList None</code></td></tr> 578<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire</td></tr> 579<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 580<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 581</table> 582 <p>Lorsque le serveur trouve un fichier <code>.htaccess</code> 583 (comme sp�cifi� par la directive <code class="directive"><a href="#accessfilename">AccessFileName</a></code>), il doit savoir lesquelles 584 des directives d�clar�es dans ce fichier peuvent remplacer des 585 directives des fichiers de configuration du serveur.</p> 586 587 <div class="note"><h3>Seulement disponible dans les sections <Directory></h3> 588 La directive <code class="directive">AllowOverrideList</code> n'est 589 disponible que dans les sections <code class="directive"><a href="#directory"><Directory></a></code> sp�cifi�es sans expressions 590 rationnelles. 591 </div> 592 593 <p>Lorsque cette directive et la directive <code class="directive"><a href="#allowoverride">AllowOverride</a></code> sont d�finies � 594 <code>None</code>, les fichiers <a href="#accessfilename">.htaccess</a> sont totalement ignor�s. Dans 595 ce cas, le serveur ne cherchera m�me pas � lire des fichiers 596 <code>.htaccess</code> dans le syst�me de fichiers.</p> 597 598 <p>Example:</p> 599 600 <pre class="prettyprint lang-config">AllowOverride None 601AllowOverrideList Redirect RedirectMatch</pre> 602 603 604 <p>Dans l'exemple ci-dessus, seules les directives 605 <code>Redirect</code> et <code>RedirectMatch</code> sont autoris�es. 606 Toutes les autres provoqueront une erreur interne du serveur.</p> 607 608 <p>Example:</p> 609 610 <pre class="prettyprint lang-config">AllowOverride AuthConfig 611AllowOverrideList CookieTracking CookieName</pre> 612 613 614 <p>Dans l'exemple ci-dessus, la directive <code class="directive"><a href="#allowoverride">AllowOverride</a></code> autorise les directives du 615 groupement <code>AuthConfig</code>, et 616 <code class="directive">AllowOverrideList</code> n'autorise que deux 617 directives du groupement <code>FileInfo</code>. Toutes les autres 618 provoqueront une erreur interne du serveur.</p> 619 620<h3>Voir aussi</h3> 621<ul> 622<li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li> 623<li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li> 624<li><a href="/configuring.html">Fichiers de configuration</a></li> 625<li><a href="/howto/htaccess.html">Fichiers .htaccess</a></li> 626</ul> 627</div> 628<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 629<div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">Directive</a></h2> 630<table class="directive"> 631<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique permettant de localiser l'interpr�teur des 632scripts CGI</td></tr> 633<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIMapExtension <var>chemin CGI</var> <var>.extension</var></code></td></tr> 634<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 635<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 636<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 637<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 638<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>NetWare uniquement</td></tr> 639</table> 640 <p>Cette directive permet de contr�ler la mani�re dont Apache httpd trouve 641 l'interpr�teur servant � ex�cuter les scripts CGI. Par exemple, avec 642 la d�finition <code>CGIMapExtension sys:\foo.nlm .foo</code>, tous 643 les fichiers scripts CGI poss�dant une extension <code>.foo</code> 644 seront pass�s � l'interpr�teur FOO.</p> 645 646</div> 647<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 648<div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a> <a name="contentdigest" id="contentdigest">Directive</a></h2> 649<table class="directive"> 650<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> 651dans la r�ponse HTTP</td></tr> 652<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ContentDigest On|Off</code></td></tr> 653<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ContentDigest Off</code></td></tr> 654<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 655<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr> 656<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 657<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 658</table> 659 <p>Cette directive active la g�n�ration d'un en-t�te 660 <code>Content-MD5</code> selon les d�finitions des RFC 1864 et 661 2616.</p> 662 663 <p>MD5 est un algorithme permettant de g�n�rer un condens� (parfois 664 appel� "empreinte") � partir de donn�es d'une taille al�atoire ; le 665 degr� de pr�cision est tel que la moindre alt�ration des donn�es 666 d'origine entra�ne une alt�ration de l'empreinte.</p> 667 668 <p>L'en-t�te <code>Content-MD5</code> permet de v�rifier 669 l'int�grit� de la r�ponse HTTP dans son ensemble. Un serveur mandataire 670 ou un client peut utiliser cet en-t�te pour rechercher une 671 �ventuelle modification accidentelle de la r�ponse au cours de sa 672 transmission. Exemple d'en-t�te :</p> 673 674 <div class="example"><p><code> 675 Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA== 676 </code></p></div> 677 678 <p>Notez que des probl�mes de performances peuvent affecter votre 679 serveur, car l'empreinte est g�n�r�e pour chaque requ�te (il n'y a 680 pas de mise en cache).</p> 681 682 <p>L'en-t�te <code>Content-MD5</code> n'est envoy� qu'avec les 683 documents servis par le module <code class="module"><a href="/mod/core.html">core</a></code>, � l'exclusion 684 de tout autre module. Ainsi, les documents SSI, les sorties de 685 scripts CGI, et les r�ponses � des requ�tes partielles (byte range) 686 ne comportent pas cet en-t�te.</p> 687 688</div> 689<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 690<div class="directive-section"><h2><a name="DefaultRuntimeDir" id="DefaultRuntimeDir">DefaultRuntimeDir</a> <a name="defaultruntimedir" id="defaultruntimedir">Directive</a></h2> 691<table class="directive"> 692<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> 693<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultRuntimeDir <var>chemin-r�pertoire</var></code></td></tr> 694<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>DefaultRuntimeDir DEFAULT_REL_RUNTIMEDIR (logs/)</code></td></tr> 695<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 696<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 697<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 698</table> 699 <p>La directive <code class="directive">DefaultRuntimeDir</code> permet de 700 d�finir le r�pertoire dans lequel le serveur va cr�er les diff�rents 701 fichiers relatifs � son ex�cution (m�moire partag�e, verrous, 702 etc...). Si le chemin sp�cifi� est relatif, le chemin absolu sera 703 g�n�r� relativement � la valeur de la directive 704 <code class="directive">ServerRoot</code></p> 705 706 <p><strong>Example</strong></p> 707 <pre class="prettyprint lang-config">DefaultRuntimeDir scratch/</pre> 708 709 710 <p>La valeur par d�faut de la directive 711 <code class="directive">DefaultRuntimeDir</code> peut �tre modifi�e en 712 changeant la valeur de la macro <code>DEFAULT_REL_RUNTIMEDIR</code> 713 d�finie � la compilation.</p> 714 715 <p>Note: si la valeur de <code class="directive">ServerRoot</code> n'a pas 716 �t� sp�cifi�e avant d'utiliser cette directive, c'est la valeur par 717 d�faut de <code class="directive">ServerRoot</code> qui sera utilis�e pour 718 d�finir la base du r�pertoire.</p> 719 720 721<h3>Voir aussi</h3> 722<ul> 723<li>Voir les <a href="/misc/security_tips.html#serverroot">conseils � propos de 724s�surit�</a> pour plus d'informations en vue de d�finir correctement les 725permissions sur la racine du serveur <code class="directive">ServerRoot</code></li> 726</ul> 727</div> 728<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 729<div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">Directive</a></h2> 730<table class="directive"> 731<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les seuls effets de cette directive sont des �missions 732d'avertissements si sa valeur est diff�rente de <code>none</code>. Dans 733les versions pr�c�dentes, DefaultType permettait de sp�cifier un type de 734m�dia � assigner par d�faut au contenu d'une r�ponse pour lequel aucun 735autre type de m�dia n'avait �t� trouv�. 736</td></tr> 737<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultType <var>type m�dia|none</var></code></td></tr> 738<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>DefaultType none</code></td></tr> 739<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 740<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 741<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 742<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 743<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>L'argument <code>none</code> est disponible dans les 744versions d'Apache httpd 2.2.7 et sup�rieures. Tous les autres choix sont 745DESACTIV�S � partir des version 2.3.x.</td></tr> 746</table> 747 <p>Cette directive a �t� d�sactiv�e. Pour la compatibilit� 748 ascendante avec les anciens fichiers de configuration, elle peut 749 �tre sp�cifi�e avec la valeur <code>none</code>, c'est � dire sans 750 type de m�dium par d�faut. Par exemple :</p> 751 752 <pre class="prettyprint lang-config">DefaultType None</pre> 753 754 755 <p><code>DefaultType None</code> n'est disponible que dans les 756 versions d'Apache 2.2.7 et sup�rieures.</p> 757 758 <p>Utilisez le fichier de configuration mime.types et la directive 759 <code class="directive"><a href="/mod/mod_mime.html#addtype">AddType</a></code> pour configurer 760 l'assignement d'un type de m�dium via les extensions de fichiers, ou 761 la directive <code class="directive"><a href="#forcetype">ForceType</a></code> pour 762 attribuer un type de m�dium � des ressources sp�cifiques. Dans le 763 cas contraire, le serveur enverra sa r�ponse sans champ d'en-t�te 764 Content-Type, et le destinataire devra d�terminer lui-m�me le type 765 de m�dium.</p> 766 767</div> 768<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 769<div class="directive-section"><h2><a name="Define" id="Define">Define</a> <a name="define" id="define">Directive</a></h2> 770<table class="directive"> 771<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de d�finir une variable</td></tr> 772<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> 773<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 774<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 775<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 776</table> 777 <p>Avec un seul param�tre, l'effet de la directive 778 <code class="directive">Define</code> est identique � celui de l'argument 779 <code>-D</code> du programme <code class="program"><a href="/programs/httpd.html">httpd</a></code>. Il permet de 780 modifier le comportement des sections <code class="directive"><a href="#ifdefine"><IfDefine></a></code> sans avoir � ajouter d'argument 781 <code>-D</code> au sein des scripts de d�marrage.</p> 782 783 <p>De plus, le second param�tre permet d'affecter une valeur � la 784 variable d�finie par le premier. Cette variable peut �tre r�f�renc�e 785 dans le fichier de configuration via la syntaxe <code>${VAR}</code>. 786 La port�e de la variable est toujours globale, et n'est jamais 787 limit�e � la section de configuration courante.</p> 788 789 <pre class="prettyprint lang-config"><IfDefine TEST> 790 Define servername test.example.com 791</IfDefine> 792<IfDefine !TEST> 793 Define servername www.example.com 794 Define SSL 795</IfDefine> 796 797DocumentRoot /var/www/${servername}/htdocs</pre> 798 799 800 <p>Le caract�re ":" est interdit dans les noms de variables afin 801 d'�viter les conflits avec la syntaxe de la directive <code class="directive"><a href="/mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p> 802 803</div> 804<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 805<div class="directive-section"><h2><a name="Directory" id="Directory"><Directory></a> <a name="directory" id="directory">Directive</a></h2> 806<table class="directive"> 807<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe un ensemble de directives qui ne s'appliquent 808qu'au r�pertoire concern� du syst�me de fichiers, � ses 809sous-r�pertoires, et � leur contenu.</td></tr> 810<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Directory <var>chemin r�pertoire</var>> 811... </Directory></code></td></tr> 812<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 813<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 814<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 815</table> 816 <p>Les balises <code class="directive"><Directory></code> et 817 <code></Directory></code> permettent de regrouper un ensemble 818 de directives qui ne s'appliquent qu'au r�pertoire pr�cis�, 819 � ses sous-r�pertoires, et aux fichiers situ�s dans ces 820 sous-r�pertoires. Toute directive 821 autoris�e dans un contexte de r�pertoire peut �tre utilis�e. 822 <var>chemin r�pertoire</var> est soit le chemin absolu d'un 823 r�pertoire, soit une cha�ne de caract�res avec caract�res g�n�riques 824 utilisant la comparaison Unix de style shell. Dans une cha�ne de 825 caract�res avec caract�res g�n�riques, <code>?</code> correspond � 826 un caract�re quelconque, et <code>*</code> � toute cha�ne de 827 caract�res. Les intervalles de caract�res <code>[]</code> sont aussi 828 autoris�s. Aucun caract�re g�n�rique ne peut remplacer le caract�re 829 `/', si bien que l'expression <code><Directory 830 /*/public_html></code> ne conviendra pas pour le chemin 831 * <code>/home/user/public_html</code>, alors que <code><Directory 832 /home/*/public_html></code> conviendra. Exemple :</p> 833 834 <pre class="prettyprint lang-config"><Directory "/usr/local/httpd/htdocs"> 835 Options Indexes FollowSymLinks 836</Directory></pre> 837 838 839 <div class="note"> 840 <p>Soyez prudent avec l'argument <var>chemin r�pertoire</var> : il 841 doit correspondre exactement au chemin du syst�me de fichier 842 qu'Apache httpd utilise pour acc�der aux fichiers. Les directives 843 comprises dans une section <code><Directory></code> ne 844 s'appliqueront pas aux fichiers du m�me r�pertoire auxquels on 845 aura acc�d� via un chemin diff�rent, per exemple via un lien 846 symbolique.</p> 847 </div> 848 849 <p> Les <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> 850 peuvent aussi �tre utilis�es en ajoutant le caract�re 851 <code>~</code>. Par exemple :</p> 852 853 <pre class="prettyprint lang-config"><Directory ~ "^/www/[0-9]{3}"> 854 855</Directory></pre> 856 857 858 <p>pourra correspondre � tout r�pertoire situ� dans /www/ et dont le 859 nom se compose de trois chiffres.</p> 860 861 <p>Si plusieurs sections <code class="directive"><Directory></code> (sans expression rationnelle) 862 correspondent au r�pertoire (ou � un de ses parents) qui contient le 863 document, les directives de la section <code class="directive"><Directory></code> dont le chemin est le plus 864 court sont appliqu�es en premier, en s'intercalant avec les 865 directives des fichiers <a href="#accessfilename">.htaccess</a>. Par 866 exemple, avec</p> 867 868 <pre class="prettyprint lang-config"><Directory /> 869 AllowOverride None 870</Directory> 871 872<Directory "/home"> 873 AllowOverride FileInfo 874</Directory></pre> 875 876 877 <p>l'acc�s au document <code>/home/web/dir/doc.html</code> emprunte 878 le chemin suivant :</p> 879 880 <ul> 881 <li>Aplication de la directive <code>AllowOverride None</code> 882 (qui d�sactive les fichiers <code>.htaccess</code>).</li> 883 884 <li>Application de la directive <code>AllowOverride 885 FileInfo</code> (pour le r�pertoire <code>/home</code>).</li> 886 887 <li>Application de toute directive <code>FileInfo</code> qui se 888 trouverait dans d'�ventuels fichiers <code>/home/.htaccess</code>, 889 <code>/home/web/.htaccess</code> ou 890 <code>/home/web/dir/.htaccess</code>, dans cet ordre.</li> 891 </ul> 892 893 <p>Les directives associ�es aux r�pertoires sous forme d'expressions 894 rationnelles ne sont prises en compte qu'une fois toutes les 895 directives des sections sans expressions rationnelles appliqu�es. 896 Alors, tous les r�pertoires avec expressions rationnelles sont 897 test�s selon l'ordre dans lequel ils apparaissent dans le fichier de 898 configuration. Par exemple, avec</p> 899 900 <pre class="prettyprint lang-config"><Directory ~ "abc$"> 901 # ... directives ici ... 902</Directory></pre> 903 904 905 <p>la section avec expression rationnelle ne sera prise en compte 906 qu'apr�s les sections <code class="directive"><Directory></code> sans expression rationnelle 907 et les fichiers <code>.htaccess</code>. Alors, l'expression 908 rationnelle conviendra pour <code>/home/abc/public_html/abc</code> 909 et la section <code class="directive"><Directory></code> 910 correspondante s'appliquera.</p> 911 912 <p><strong>Notez que la politique d'acc�s par d�faut 913 dans les sections <code><Directory /></code> consiste � 914 autoriser tout acc�s sans restriction. Ceci signifie qu'Apache httpd va servir tout fichier 915 correspondant � une URL. Il est recommand� de modifier cette 916 situation � l'aide d'un bloc du style</strong></p> 917 918 <pre class="prettyprint lang-config"><Directory /> 919 Require all denied 920</Directory></pre> 921 922 923 <p><strong>puis d'affiner la configuration pour les r�pertoires que vous 924 voulez rendre accessibles. Voir la page <a href="/misc/security_tips.html">Conseils � propos de s�curit�</a> 925 pour plus de d�tails.</strong></p> 926 927 <p>Les sections <code class="directive"><Directory></code> se situent 928 dans le fichier <code>httpd.conf</code>. Les directives <code class="directive"><Directory></code> ne peuvent pas �tre imbriqu�es 929 et ne sont pas autoris�es dans les sections <code class="directive"><a href="#limit"><Limit></a></code> ou <code class="directive"><a href="#limitexcept"><LimitExcept></a></code>.</p> 930 931<h3>Voir aussi</h3> 932<ul> 933<li><a href="/sections.html">Comment fonctionnent les sections 934<Directory>, <Location> et <Files></a> pour des 935explications � propos de la mani�re dont ces diff�rentes sections se 936combinent entre elles � la r�ception d'une requ�te</li> 937</ul> 938</div> 939<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 940<div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch"><DirectoryMatch></a> <a name="directorymatch" id="directorymatch">Directive</a></h2> 941<table class="directive"> 942<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives qui s'appliquent au contenu de r�pertoires 943du syst�me de fichiers correspondant � une expression rationnelle</td></tr> 944<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><DirectoryMatch <var>regex</var>> 945... </DirectoryMatch></code></td></tr> 946<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 947<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 948<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 949</table> 950 <p>Les balises <code class="directive"><DirectoryMatch></code> 951 et <code></DirectoryMatch></code> permettent de regrouper un 952 ensemble de directives qui ne s'appliqueront qu'au r�pertoire 953 pr�cis� (et aux fichiers qu'il contient), comme pour la section <code class="directive"><a href="#directory"><Directory></a></code>. Cependant, le 954 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> 955 956 <pre class="prettyprint lang-config"><DirectoryMatch "^/www/(.+/)?[0-9]{3}"> 957 # ... 958</DirectoryMatch></pre> 959 960 961 <p>conviendrait pour les sous-r�pertoires de <code>/www/</code> dont 962 le nom se compose de trois chiffres.</p> 963 964 <div class="note"><h3>Compatibilit�</h3> 965 Avant la version 2.3.9, cette directive s'appliquait aussi aux 966 sous-r�pertoires (comme la directive <code class="directive"><a href="#directory"><Directory></a></code>), et ne tenait pas compte du 967 symbole de fin de ligne ($). Depuis la version 2.3.9, seuls les 968 r�pertoires qui correspondent � l'expression sont affect�s par les 969 directives contenues dans la section. 970 </div> 971 972 <div class="note"><h3>slash de fin</h3> 973 Cette directive s'applique aux requ�tes pour des r�pertoires avec 974 ou sans slash de fin ; les expressions contenant un symbole de fin 975 de ligne ($) doivent donc faire l'objet d'une attention 976 particuli�re. 977 </div> 978 979 <p>A partir de la version 2.4.8, les groupes nomm�s et les 980 r�f�rences arri�res sont extraits et enregistr�s dans 981 l'environnement avec leur nom en majuscules et pr�fix� 982 par "MATCH_". Ceci permet 983 de r�f�rencer des URLs dans des <a href="/expr.html">expressions</a> 984 ou au sein de modules comme <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>. Pour 985 �viter toute confusion, les r�f�rences arri�res num�rot�es (non 986 nomm�es) sont ignor�es. Vous devez utiliser � la place des groupes 987 nomm�s.</p> 988 989<pre class="prettyprint lang-config"><DirectoryMatch ^/var/www/combined/(?<sitename>[^/]+)> 990 require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example 991</DirectoryMatch></pre> 992 993 994 995<h3>Voir aussi</h3> 996<ul> 997<li><code class="directive"><a href="#directory"><Directory></a></code> 998pour une description de la mani�re dont les expressions rationnelles 999sont trait�es en pr�sence d'autres sections <code class="directive"><Directory></code> sans expressions rationnelles</li> 1000<li><a href="/sections.html">Comment fonctionnent les sections 1001<Directory>, <Location> et <Files></a> pour une 1002explication � propos de la mani�re dont ces diff�rentes sections se 1003combinent entre elles � la r�ception d'une requ�te</li> 1004</ul> 1005</div> 1006<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1007<div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">Directive</a></h2> 1008<table class="directive"> 1009<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine principale de l'arborescence des documents visible 1010depuis Internet</td></tr> 1011<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DocumentRoot <var>chemin r�pertoire</var></code></td></tr> 1012<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr> 1013<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1014<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1015<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1016</table> 1017 <p>Cette directive permet de d�finir le r�pertoire � partir duquel 1018 <code class="program"><a href="/programs/httpd.html">httpd</a></code> va servir les fichiers. S'il ne correspond 1019 pas � un <code class="directive"><a href="/mod/mod_alias.html#alias">Alias</a></code>, le chemin 1020 de l'URL sera ajout� par le serveur � la racine des documents afin 1021 de construire le chemin du document recherch�. Exemple :</p> 1022 1023 <pre class="prettyprint lang-config">DocumentRoot "/usr/web"</pre> 1024 1025 1026 <p>un acc�s � <code>http://my.example.com/index.html</code> se 1027 r�f�re alors � <code>/usr/web/index.html</code>. Si <var>chemin 1028 r�pertoire</var> n'est pas un chemin absolu, il est consid�r� comme 1029 relatif au chemin d�fini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p> 1030 1031 <p>Le r�pertoire d�fini par la directive 1032 <code class="directive">DocumentRoot</code> ne doit pas comporter de slash 1033 final.</p> 1034 1035<h3>Voir aussi</h3> 1036<ul> 1037<li><a href="/urlmapping.html#documentroot">Mise en 1038correspondance des URLs avec le syst�me de fichiers</a></li> 1039</ul> 1040</div> 1041<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1042<div class="directive-section"><h2><a name="Else" id="Else"><Else></a> <a name="else" id="else">Directive</a></h2> 1043<table class="directive"> 1044<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si la 1045condition correspondant � la section <code class="directive"><a href="#if"><If></a></code> ou <code class="directive"><a href="#elseif"><ElseIf></a></code> pr�c�dente n'est pas satisfaite par la 1046requ�te � l'ex�cution</td></tr> 1047<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Else> ... </Else></code></td></tr> 1048<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 1049<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 1050<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1051<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1052</table> 1053 <p>La section <code class="directive"><Else></code> applique 1054 les directives qu'elle contient si et seulement si les conditions 1055 correspondant � la section <code class="directive"><If></code> 1056 ou <code class="directive"><ElseIf></code> imm�diatement 1057 sup�rieure et dans la m�me port�e n'ont pas �t� satisfaites. Par 1058 exemple, dans :</p> 1059 1060 <pre class="prettyprint lang-config"><If "-z req('Host')"> 1061 # ... 1062</If> 1063<Else> 1064 # ... 1065</Else></pre> 1066 1067 1068 <p>La condition de la section <code class="directive"><If></code> serait satisfaite pour les requ�tes 1069 HTTP/1.0 sans en-t�te <var>Host:</var>, alors que celle de la section 1070 <code class="directive"><Else></code> le serait pour les 1071 requ�tes comportant un en-t�te <var>Host:</var>.</p> 1072 1073 1074<h3>Voir aussi</h3> 1075<ul> 1076<li><code class="directive"><a href="#if"><If></a></code></li> 1077<li><code class="directive"><a href="#elseif"><ElseIf></a></code></li> 1078<li><a href="/sections.html">Fonctionnement des sections <Directory>, <Location>, 1079 <Files></a> pour une explication de la mani�re dont ces 1080 diff�rentes section se combinent entre elles lorsqu'une requ�te est 1081 re�ue. Les directives <code class="directive"><If></code>, 1082 <code class="directive"><ElseIf></code>, et <code class="directive"><Else></code> s'appliquent en dernier.</li> 1083</ul> 1084</div> 1085<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1086<div class="directive-section"><h2><a name="ElseIf" id="ElseIf"><ElseIf></a> <a name="elseif" id="elseif">Directive</a></h2> 1087<table class="directive"> 1088<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si la 1089condition correspondante est satisfaite par une requ�te � l'ex�cution, 1090alors que la condition correspondant � la section <code class="directive"><a href="#if"><If></a></code> ou <code class="directive"><ElseIf></code> pr�c�dente ne l'�tait pas.</td></tr> 1091<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><ElseIf <var>expression</var>> ... </ElseIf></code></td></tr> 1092<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 1093<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 1094<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1095<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1096</table> 1097 <p>La section <code class="directive"><ElseIf></code> applique 1098 les directives qu'elle contient si et seulement si d'une part la 1099 condition correspondante est satisfaite, et d'autre part la condition 1100 correspondant � la section <code class="directive"><If></code> 1101 ou <code class="directive"><ElseIf></code> de la m�me port�e ne 1102 l'est pas. Par exemple, dans :</p> 1103 1104 <pre class="prettyprint lang-config"><If "-R '10.1.0.0/16'"> 1105 #... 1106</If> 1107<ElseIf "-R '10.0.0.0/8'"> 1108 #... 1109</ElseIf> 1110<Else> 1111 #... 1112</Else></pre> 1113 1114 1115 <p>La condition correspondant � la section <code class="directive"><ElseIf></code> est satisfaite si l'adresse 1116 distante de la requ�te appartient au sous-r�seau 10.0.0.0/8, mais 1117 pas si elle appartient au sous-r�seau 10.1.0.0/16.</p> 1118 1119 1120<h3>Voir aussi</h3> 1121<ul> 1122<li><a href="/expr.html">Les expressions dans le serveur HTTP 1123Apache</a>, pour une r�f�rence compl�te et d'autres exemples.</li> 1124<li><code class="directive"><a href="#if"><If></a></code></li> 1125<li><code class="directive"><a href="#else"><Else></a></code></li> 1126<li><a href="/sections.html">Fonctionnement des sections <Directory>, <Location>, 1127 <Files></a> pour une explication de la mani�re dont ces 1128 diff�rentes section se combinent entre elles lorsqu'une requ�te est 1129 re�ue. Les directives <code class="directive"><If></code>, 1130 <code class="directive"><ElseIf></code>, et <code class="directive"><Else></code> s'appliquent en dernier.</li> 1131</ul> 1132</div> 1133<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1134<div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">Directive</a></h2> 1135<table class="directive"> 1136<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise la projection en m�moire (Memory-Mapping) pour 1137lire les fichiers pendant qu'ils sont servis</td></tr> 1138<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableMMAP On|Off</code></td></tr> 1139<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>EnableMMAP On</code></td></tr> 1140<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 1141<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 1142<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1143<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1144</table> 1145 <p>Cette directive d�finit si <code class="program"><a href="/programs/httpd.html">httpd</a></code> peut utiliser 1146 la projection en m�moire (Memory-Mapping) quand il doit lire le contenu 1147 d'un fichier pendant qu'il est servi. Par d�faut, lorsque le 1148 traitement d'une requ�te requiert l'acc�s aux donn�es contenues dans 1149 un fichier -- par exemple, pour servir un fichier interpr�t� par le 1150 serveur � l'aide de <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> -- Apache httpd projette 1151 le fichier en m�moire si le syst�me d'exploitation le permet.</p> 1152 1153 <p>Cette projection en m�moire induit parfois une am�lioration des 1154 performances. Sur certains syst�mes cependant, il est pr�f�rable de 1155 d�sactiver la projection en m�moire afin d'�viter certains probl�mes 1156 op�rationnels :</p> 1157 1158 <ul> 1159 <li>Sur certains syst�mes multi-processeurs, la projection en 1160 m�moire peut d�grader les performances du programme 1161 <code class="program"><a href="/programs/httpd.html">httpd</a></code>.</li> 1162 <li>S'il fait l'objet d'une projection en m�moire par 1163 <code class="program"><a href="/programs/httpd.html">httpd</a></code>, la suppression ou la troncature d'un 1164 fichier peut provoquer un crash de <code class="program"><a href="/programs/httpd.html">httpd</a></code> avec une 1165 erreur de segmentation.</li> 1166 </ul> 1167 1168 <p>Pour les configurations de serveur sujettes � ce genre de 1169 probl�me, il est pr�f�rable de d�sactiver la projection en m�moire 1170 des fichiers servis en sp�cifiant :</p> 1171 1172 <pre class="prettyprint lang-config">EnableMMAP Off</pre> 1173 1174 1175 <p>Pour les montages NFS, cette fonctionnalit� peut �tre 1176 explicitement d�sactiv�e pour les fichiers concern�s en sp�cifiant 1177 :</p> 1178 1179 <pre class="prettyprint lang-config"><Directory "/path-to-nfs-files"> 1180 EnableMMAP Off 1181</Directory></pre> 1182 1183 1184</div> 1185<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1186<div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">Directive</a></h2> 1187<table class="directive"> 1188<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise le support sendfile du noyau pour servir les 1189fichiers aux clients</td></tr> 1190<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableSendfile On|Off</code></td></tr> 1191<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>EnableSendfile Off</code></td></tr> 1192<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 1193<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 1194<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1195<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1196<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Par d�faut � Off depuis la version 2.3.9.</td></tr> 1197</table> 1198 <p>Cette directive d�finit si le programme <code class="program"><a href="/programs/httpd.html">httpd</a></code> 1199 peut utiliser le support sendfile du noyau pour transmettre le 1200 contenu des fichiers aux clients. Par d�faut, lorsque le traitement 1201 d'une requ�te ne requiert pas l'acc�s aux donn�es contenues dans un 1202 fichier -- par exemple, pour la transmission d'un fichier statique 1203 -- Apache httpd utilise sendfile pour transmettre le contenu du fichier 1204 sans m�me lire ce dernier, si le syst�me d'exploitation le 1205 permet.</p> 1206 1207 <p>Ce m�canisme sendfile �vite la s�paration des op�rations de 1208 lecture et d'envoi, ainsi que les r�servations de tampons. sur 1209 certains syst�mes cependant, ou sous certains syst�mes de fichiers, 1210 il est pr�f�rable de d�sactiver cette fonctionnalit� afin d'�viter 1211 certains probl�mes op�rationnels :</p> 1212 1213 <ul> 1214 <li>Certains syst�mes peuvent pr�senter un support sendfile 1215 d�fectueux que le syst�me de compilation n'a pas d�tect�, en 1216 particulier si les ex�cutables ont �t� compil�s sur une autre 1217 machine, puis copi�s sur la premi�re avec un support sendfile 1218 d�fectueux.</li> 1219 <li>Sous Linux, l'utilisation de sendfile induit des bogues lors de 1220 la r�cup�ration des paquets de v�rification TCP (TCP-checksum) avec 1221 certaines cartes r�seau lorsqu'on utilise IPv6.</li> 1222 <li>Sous Linux sur Itanium, <code>sendfile</code> peut s'av�rer incapable de 1223 traiter les fichiers de plus de 2 Go.</li> 1224 <li>Avec un montage r�seau de <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (par exemple NFS, SMB, CIFS, 1225 FUSE), le 1226 noyau peut s'av�rer incapable de servir un fichier de ce montage 1227 r�seau en passant par son propre cache.</li> 1228 </ul> 1229 1230 <p>Pour les configurations de serveur non sujettes � ce genre de 1231 probl�me, vous pouvez activer cette fonctionnalit� en 1232 sp�cifiant :</p> 1233 1234 <pre class="prettyprint lang-config">EnableSendfile On</pre> 1235 1236 1237 <p>Pour les montages r�seau, cette fonctionnalit� peut �tre 1238 explicitement d�sactiv�e pour les fichiers concern�s en sp�cifiant 1239 :</p> 1240 1241 <pre class="prettyprint lang-config"><Directory "/path-to-nfs-files"> 1242 EnableSendfile Off 1243</Directory></pre> 1244 1245 <p>Veuillez noter que la configuration de la directive 1246 <code class="directive">EnableSendfile</code> dans un contexte de r�pertoire 1247 ou de fichier .htaccess n'est pas support�e par 1248 <code class="module"><a href="/mod/mod_cache_disk.html">mod_cache_disk</a></code>. Le module ne prend en compte la 1249 d�finition de <code class="directive">EnableSendfile</code> que dans un 1250 contexte global. 1251 </p> 1252 1253</div> 1254<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1255<div class="directive-section"><h2><a name="Error" id="Error">Error</a> <a name="error" id="error">Directive</a></h2> 1256<table class="directive"> 1257<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interrompt la lecture de la configuration avec un message 1258d'erreur personnalis�</td></tr> 1259<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Error <var>message</var></code></td></tr> 1260<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 1261<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1262<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1263<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>� partir de la version 2.3.9</td></tr> 1264</table> 1265 <p>Si une erreur peut �tre d�tect�e dans la configuration, souvent 1266 un module manquant, cette 1267 directive peut �tre utilis�e pour g�n�rer un message d'erreur 1268 personnalis�, et interrompre la lecture de la configuration. </p> 1269 1270 <pre class="prettyprint lang-config"># Exemple 1271# v�rification du chargement de mod_include 1272<IfModule !include_module> 1273 Error "mod_include is required by mod_foo. Load it with LoadModule." 1274</IfModule> 1275 1276# v�rification de la d�finition de SSL ou (exclusif) NOSSL 1277<IfDefine SSL> 1278<IfDefine NOSSL> 1279 Error "Both SSL and NOSSL are defined. Define only one of them." 1280</IfDefine> 1281</IfDefine> 1282<IfDefine !SSL> 1283<IfDefine !NOSSL> 1284 Error "Either SSL or NOSSL must be defined." 1285</IfDefine> 1286</IfDefine></pre> 1287 1288 1289 1290</div> 1291<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1292<div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">Directive</a></h2> 1293<table class="directive"> 1294<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Document que le serveur renvoie au client en cas 1295d'erreur</td></tr> 1296<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ErrorDocument <var>code erreur</var> <var>document</var></code></td></tr> 1297<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 1298<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 1299<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1300<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1301</table> 1302 <p>Apache httpd peut traiter les probl�mes et les erreurs de quatre 1303 mani�res,</p> 1304 1305 <ol> 1306 <li>afficher un simple message d'erreur au contenu fixe</li> 1307 1308 <li>afficher un message personnalis�</li> 1309 1310 <li>rediriger en interne vers un <var>chemin d'URL</var> local pour traiter 1311 le probl�me ou l'erreur</li> 1312 1313 <li>rediriger vers une <var>URL</var> externe pour traiter 1314 le probl�me ou l'erreur</li> 1315 </ol> 1316 1317 <p>La premi�re option constitue le comportement par d�faut; pour 1318 choisir une des trois autres options, il faut configurer Apache � 1319 l'aide de la directive <code class="directive">ErrorDocument</code>, suivie 1320 du code de la r�ponse HTTP et d'une URL ou d'un message. Apache 1321 httpd fournit parfois des informations suppl�mentaires � propos du 1322 probl�me ou de l'erreur.</p> 1323 1324 <p>Les URLs peuvent commencer par un slash (/) pour les chemins web 1325 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 1326 forme d'une URL compl�te que le client pourra r�soudre. 1327 Alternativement, un message � afficher par le navigateur pourra �tre 1328 fourni. Exemples :</p> 1329 1330 <pre class="prettyprint lang-config">ErrorDocument 500 http://foo.example.com/cgi-bin/tester 1331ErrorDocument 404 /cgi-bin/bad_urls.pl 1332ErrorDocument 401 /subscription_info.html 1333ErrorDocument 403 "Sorry can't allow you access today" 1334ErrorDocument 403 Forbidden!</pre> 1335 1336 1337 <p>De plus, on peut sp�cifier la valeur sp�ciale <code>default</code> 1338 pour indiquer l'utilisation d'un simple message d'Apache httpd cod� en 1339 dur. Bien que non n�cessaire dans des circonstances normales, la 1340 sp�cification de la valeur <code>default</code> va permettre de 1341 r�tablir l'utilisation du simple message d'Apache httpd cod� en dur pour 1342 les configurations qui sans cela, h�riteraient d'une directive 1343 <code class="directive">ErrorDocument</code> existante.</p> 1344 1345 <pre class="prettyprint lang-config">ErrorDocument 404 /cgi-bin/bad_urls.pl 1346 1347<Directory /web/docs> 1348 ErrorDocument 404 default 1349</Directory></pre> 1350 1351 1352 <p>Notez que lorsque vous sp�cifiez une directive 1353 <code class="directive">ErrorDocument</code> pointant vers une URL distante 1354 (c'est � dire tout ce qui commence par le pr�fixe http), le serveur 1355 HTTP Apache va 1356 envoyer une redirection au client afin de lui indiquer o� trouver le 1357 document, m�me dans le cas o� ce document se trouve sur le serveur 1358 local. Ceci a de nombreuses cons�quences dont la plus importante 1359 r�side dans le fait que le client ne recevra pas le code d'erreur 1360 original, mais au contraire un code de statut de redirection. Ceci 1361 peut en retour semer la confusion chez les robots web et divers 1362 clients qui tentent de d�terminer la validit� d'une URL en examinant 1363 le code de statut. De plus, si vous utilisez une URL distante avec 1364 <code>ErrorDocument 401</code>, le client ne saura pas qu'il doit 1365 demander un mot de passe � l'utilisateur car il ne recevra pas le 1366 code de statut 401. C'est pourquoi, <strong>si vous utilisez une 1367 directive <code>ErrorDocument 401</code>, elle devra faire r�f�rence 1368 � un document par le biais d'un chemin local.</strong></p> 1369 1370 <p>Microsoft Internet Explorer (MSIE) ignore par d�faut les messages 1371 d'erreur g�n�r�s par le serveur lorsqu'ils sont trop courts et 1372 remplacent ses propres messages d'erreur "amicaux". Le seuil de 1373 taille varie en fonction du type d'erreur, mais en g�n�ral, si la 1374 taille de votre message d'erreur est sup�rieure � 512 octets, il y a 1375 peu de chances pour que MSIE l'occulte, et il sera affich� par ce 1376 dernier. Vous trouverez d'avantage d'informations dans l'article de 1377 la base de connaissances Microsoft <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p> 1378 1379 <p>Bien que la plupart des messages d'erreur internes originaux 1380 puissent �tre remplac�s, ceux-ci sont cependant conserv�s dans 1381 certaines circonstances sans tenir compte de la d�finition de la 1382 directive <code class="directive"><a href="#errordocument">ErrorDocument</a></code>. En 1383 particulier, en cas de d�tection d'une requ�te mal form�e, le 1384 processus de traitement normal des requ�tes est imm�diatement 1385 interrompu, et un message d'erreur interne est renvoy�, ceci afin de 1386 se pr�munir contre les probl�mes de s�curit� li�s aux requ�tes mal 1387 form�es.</p> 1388 1389 <p>Si vous utilisez mod_proxy, il est en g�n�ral pr�f�rable 1390 d'activer <code class="directive"><a href="/mod/mod_proxy.html#proxyerroroverride">ProxyErrorOverride</a></code> afin d'�tre en 1391 mesure de produire des messages d'erreur personnalis�s pour le 1392 compte de votre serveur d'origine. Si vous n'activez pas 1393 ProxyErrorOverride, Apache httpd ne g�n�rera pas de messages d'erreur 1394 personnalis�s pour le contenu mandat�.</p> 1395 1396 1397<h3>Voir aussi</h3> 1398<ul> 1399<li><a href="/custom-error.html">documentation sur la 1400personnalisation des r�ponses</a></li> 1401</ul> 1402</div> 1403<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1404<div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">Directive</a></h2> 1405<table class="directive"> 1406<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finition du chemin du journal des erreurs</td></tr> 1407<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> ErrorLog <var>chemin fichier</var>|syslog[:<var>facility</var>]</code></td></tr> 1408<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> 1409<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1410<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1411<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1412</table> 1413 <p>La directive <code class="directive">ErrorLog</code> permet de d�finir le 1414 nom du fichier dans lequel le serveur va journaliser toutes les 1415 erreurs qu'il rencontre. Si le <var>chemin fichier</var> n'est pas 1416 absolu, il est consid�r� comme relatif au chemin d�fini par la 1417 directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p> 1418 1419 <pre class="prettyprint lang-config">ErrorLog "/var/log/httpd/error_log"</pre> 1420 1421 1422 <p>Si le <var>chemin fichier</var> commence par une barre verticale 1423 "<code>(|)</code>", il est consid�r� comme une commande � lancer pour traiter la 1424 journalisation de l'erreur.</p> 1425 1426 <pre class="prettyprint lang-config">ErrorLog "|/usr/local/bin/httpd_errors"</pre> 1427 1428 1429 <p>Voir les notes � propos des <a href="/logs.html#piped">journaux 1430 redirig�s</a> pour plus d'informations.</p> 1431 1432 <p>L'utilisation de <code>syslog</code> � la place d'un nom de 1433 fichier active la journalisation via syslogd(8) si le syst�me le 1434 supporte. Le dispositif syslog par d�faut est <code>local7</code>, 1435 mais vous pouvez le modifier � l'aide de la syntaxe 1436 <code>syslog:<var>facility</var></code>, o� <var>facility</var> peut 1437 �tre remplac� par un des noms habituellement document�s dans la page 1438 de man syslog(1). Le dispositif syslog <code>local7</code> est 1439 global, et si il est modifi� dans un serveur virtuel, le dispositif 1440 final sp�cifi� affecte l'ensemble du serveur</p> 1441 1442 <pre class="prettyprint lang-config">ErrorLog syslog:user</pre> 1443 1444 1445 <p>SECURITE : Voir le document <a href="/misc/security_tips.html#serverroot">conseils � propos de 1446 s�curit�</a> pour des d�tails sur les raisons pour lesquelles votre 1447 s�curit� peut �tre compromise si le r�pertoire contenant les 1448 fichiers journaux pr�sente des droits en �criture pour tout autre 1449 utilisateur que celui sous lequel le serveur est d�marr�.</p> 1450 <div class="warning"><h3>Note</h3> 1451 <p>Lors de la sp�cification d'un chemin de fichier sur les 1452 plates-formes non-Unix, on doit veiller � n'utiliser que des 1453 slashes (/), m�me si la plate-forme autorise l'utilisation des 1454 anti-slashes (\). Et d'une mani�re g�n�rale, il est recommand� de 1455 n'utiliser que des slashes (/) dans les fichiers de 1456 configuration.</p> 1457 </div> 1458 1459<h3>Voir aussi</h3> 1460<ul> 1461<li><code class="directive"><a href="#loglevel">LogLevel</a></code></li> 1462<li><a href="/logs.html">Fichiers journaux du serveur HTTP Apache</a></li> 1463</ul> 1464</div> 1465<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1466<div class="directive-section"><h2><a name="ErrorLogFormat" id="ErrorLogFormat">ErrorLogFormat</a> <a name="errorlogformat" id="errorlogformat">Directive</a></h2> 1467<table class="directive"> 1468<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> 1469<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> ErrorLogFormat [connection|request] <var>format</var></code></td></tr> 1470<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1471<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1472<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1473<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr> 1474</table> 1475 <p>La directive <code class="directive">ErrorLogFormat</code> permet de 1476 sp�cifier quelles informations suppl�mentaires vont �tre enregistr�es 1477 dans le journal des erreurs en plus du message habituel.</p> 1478 1479 <pre class="prettyprint lang-config"># Exemple simple 1480ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"</pre> 1481 1482 1483 <p>La sp�cification de <code>connection</code> ou 1484 <code>request</code> comme premier param�tre permet de d�finir des 1485 formats suppl�mentaires, ce qui a pour effet de journaliser des 1486 informations additionnelles lorsque le premier message est 1487 enregistr� respectivement pour une connexion ou une requ�te 1488 sp�cifique. Ces informations additionnelles ne sont enregistr�es 1489 qu'une seule fois par connexion/requ�te. Si le traitement d'une 1490 connexion ou d'une requ�te ne g�n�re aucun message dans le journal, 1491 alors aucune information additionnelle n'est enregistr�e.</p> 1492 1493 <p>Il peut arriver que certains items de la cha�ne de format ne 1494 produisent aucune sortie. Par exemple, l'en-t�te Referer n'est 1495 pr�sent que si le message du journal est associ� � une requ�te et s'il 1496 est g�n�r� � un moment o� l'en-t�te Referer a d�j� �t� lu par le 1497 client. Si aucune sortie n'est g�n�r�e, le comportement par d�faut 1498 consiste � supprimer tout ce qui se trouve entre l'espace pr�c�dent 1499 et le suivant. Ceci implique que la ligne de journalisation est 1500 divis�e en champs ne contenant pas d'espace s�par�s par des espaces. 1501 Si un item de la cha�ne de format ne g�n�re aucune sortie, 1502 l'ensemble du champ est omis. Par exemple, si l'adresse distante 1503 <code>%a</code> du format <code>[%t] [%l] [%a] %M </code> n'est 1504 pas disponible, les crochets qui l'entourent ne seront eux-m�mes pas 1505 enregistr�s. Il est possible d'�chapper les espaces par un anti-slash 1506 afin qu'ils ne soient pas consid�r�s comme s�parateurs de champs. 1507 La combinaison '% ' (pourcentage espace) est un d�limiteur de 1508 champ de taille nulle qui ne g�n�re aucune sortie.</p> 1509 1510 <p>Ce comportement peut �tre chang� en ajoutant des modificateurs � 1511 l'item de la cha�ne de format. Le modificateur <code>-</code> 1512 (moins) provoque l'enregistrement d'un signe moins si l'item 1513 consid�r� ne g�n�re aucune sortie. Pour les formats � enregistrement 1514 unique par connexion/requ�te, il est aussi possible d'utiliser le 1515 modificateur <code>+</code> (plus). Si un item ne g�n�rant aucune 1516 sortie poss�de le modificateur plus, la ligne dans son ensemble est 1517 omise.</p> 1518 1519 <p>Un modificateur de type entier permet d'assigner un niveau de 1520 s�v�rit� � un item de format. L'item consid�r� ne 1521 sera journalis� que si la s�v�rit� du message n'est pas 1522 plus haute que le niveau de s�v�rit� sp�cifi�. Les 1523 valeurs possibles vont de 1 (alert) � 15 (trace8), en passant par 4 1524 (warn) ou 7 (debug).</p> 1525 1526 <p>Par exemple, voici ce qui arriverait si vous ajoutiez des 1527 modificateurs � l'item <code>%{Referer}i</code> qui enregistre le 1528 contenu de l'en-t�te <code>Referer</code>.</p> 1529 1530 <table class="bordered"><tr class="header"><th>Item modifi�</th><th>Signification</th></tr> 1531<tr> 1532 <td><code>%-{Referer}i</code></td> 1533 <td>Enregistre le caract�re <code>-</code> si l'en-t�te 1534 <code>Referer</code> n'est pas d�fini.</td> 1535 </tr> 1536<tr class="odd"> 1537 <td><code>%+{Referer}i</code></td> 1538 <td>N'enregistre rien si l'en-t�te 1539 <code>Referer</code> n'est pas d�fini.</td> 1540 </tr> 1541<tr> 1542 <td><code>%4{Referer}i</code></td> 1543 <td>N'enregistre le contenu de l'en-t�te <code>Referer</code> que si 1544 la s�v�rit� du message de journalisation est sup�rieure � 4.</td> 1545 </tr> 1546</table> 1547 1548 <p>Certains items de format acceptent des param�tres suppl�mentaires 1549 entre accolades.</p> 1550 1551 <table class="bordered"><tr class="header"><th>Cha�ne de format</th> <th>Description</th></tr> 1552<tr><td><code>%%</code></td> 1553 <td>Le signe pourcentage</td></tr> 1554<tr class="odd"><td><code>%a</code></td> 1555 <td>Adresse IP et port clients</td></tr> 1556<tr><td><code>%{c}a</code></td> 1557 <td>Port et adresse IP sous-jacents du correspondant pour la 1558 connexion (voir le module 1559 <code class="module"><a href="/mod/mod_remoteip.html">mod_remoteip</a></code>)</td></tr> 1560<tr class="odd"><td><code>%A</code></td> 1561 <td>Adresse IP et port locaux</td></tr> 1562<tr><td><code>%{<em>name</em>}e</code></td> 1563 <td>Variable d'environnement de requ�te <em>name</em></td></tr> 1564<tr class="odd"><td><code>%E</code></td> 1565 <td>Etat d'erreur APR/OS et cha�ne</td></tr> 1566<tr><td><code>%F</code></td> 1567 <td>Nom du fichier source et num�ro de ligne de l'appel du 1568 journal</td></tr> 1569<tr class="odd"><td><code>%{<em>name</em>}i</code></td> 1570 <td>En-t�te de requ�te <em>name</em></td></tr> 1571<tr><td><code>%k</code></td> 1572 <td>Nombre de requ�tes persistantes pour cette connexion</td></tr> 1573<tr class="odd"><td><code>%l</code></td> 1574 <td>S�v�rit� du message</td></tr> 1575<tr><td><code>%L</code></td> 1576 <td>Identifiant journal de la requ�te</td></tr> 1577<tr class="odd"><td><code>%{c}L</code></td> 1578 <td>Identifiant journal de la connexion</td></tr> 1579<tr><td><code>%{C}L</code></td> 1580 <td>Identifiant journal de la connexion si utilis� dans la 1581 port�e de la connexion, vide sinon</td></tr> 1582<tr class="odd"><td><code>%m</code></td> 1583 <td>Nom du module qui effectue la journalisation du message</td></tr> 1584<tr><td><code>%M</code></td> 1585 <td>Le message effectif</td></tr> 1586<tr class="odd"><td><code>%{<em>name</em>}n</code></td> 1587 <td>Note de requ�te <em>name</em></td></tr> 1588<tr><td><code>%P</code></td> 1589 <td>Identifiant du processus courant</td></tr> 1590<tr class="odd"><td><code>%T</code></td> 1591 <td>Identifiant du thread courant</td></tr> 1592<tr><td><code>%{g}T</code></td> 1593 <td>Identifiant unique de thread syst�me du thread courant 1594 (l'identifiant affich� par la commande <code>top</code> par 1595 exemple ; seulement sous Linux pour l'instant)</td></tr> 1596<tr class="odd"><td><code>%t</code></td> 1597 <td>L'heure courante</td></tr> 1598<tr><td><code>%{u}t</code></td> 1599 <td>L'heure courante avec les microsecondes</td></tr> 1600<tr class="odd"><td><code>%{cu}t</code></td> 1601 <td>L'heure courante au format compact ISO 8601, avec les 1602 microsecondes</td></tr> 1603<tr><td><code>%v</code></td> 1604 <td>Le nom de serveur canonique <code class="directive"><a href="#servername">ServerName</a></code> du serveur courant.</td></tr> 1605<tr class="odd"><td><code>%V</code></td> 1606 <td>Le nom de serveur du serveur qui sert la requ�te en accord 1607 avec la d�finition de la directive <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>.</td></tr> 1608<tr><td><code>\ </code> (anti-slash espace)</td> 1609 <td>Espace non d�limiteur</td></tr> 1610<tr class="odd"><td><code>% </code> (pourcentage espace)</td> 1611 <td>D�limiteur de champ (aucune sortie)</td></tr> 1612</table> 1613 1614 <p>L'item de format identifiant journal <code>%L</code> g�n�re un 1615 identifiant unique pour une connexion ou une requ�te. Il peut servir 1616 � d�terminer quelles lignes correspondent � la m�me connexion ou 1617 requ�te ou quelle requ�te est associ�e � tel connexion. Un item de 1618 format <code>%L</code> est aussi disponible dans le module 1619 <code class="module"><a href="/mod/mod_log_config.html">mod_log_config</a></code>, mais il permet dans ce contexte de 1620 corr�ler les entr�es du journal des acc�s avec celles du journal des 1621 erreurs. Si le module <code class="module"><a href="/mod/mod_unique_id.html">mod_unique_id</a></code> est charg�, 1622 c'est son identifiant unique qui sera utilis� comme identifiant de 1623 journal pour les requ�tes.</p> 1624 1625 <pre class="prettyprint lang-config"># Exemple (format par d�faut pour les MPMs thread�s) 1626ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M%�,\�referer\�%{Referer}i"</pre> 1627 1628 1629 <p>Cet exemple renverrait un message d'erreur du style :</p> 1630 1631 <div class="example"><p><code> 1632 [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 1633 </code></p></div> 1634 1635 <p>Notez que, comme indiqu� plus haut, certains champs sont 1636 totalement supprim�s s'ils n'ont pas �t� d�finis.</p> 1637 1638 <pre class="prettyprint lang-config"># Exemple (similaire au format 2.2.x) 1639ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M%�,\�referer\�%{Referer}i"</pre> 1640 1641 1642 <pre class="prettyprint lang-config"># Exemple avanc� avec identifiants journal de requ�te/connexion 1643ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M" 1644ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T" 1645ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'" 1646ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'" 1647ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"</pre> 1648 1649 1650 1651<h3>Voir aussi</h3> 1652<ul> 1653<li><code class="directive"><a href="#errorlog">ErrorLog</a></code></li> 1654<li><code class="directive"><a href="#loglevel">LogLevel</a></code></li> 1655<li><a href="/logs.html">Fichiers journaux du serveur HTTP Apache</a></li> 1656</ul> 1657</div> 1658<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1659<div class="directive-section"><h2><a name="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a> <a name="extendedstatus" id="extendedstatus">Directive</a></h2> 1660<table class="directive"> 1661<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Extrait des informations d'�tat �tendues pour chaque 1662requ�te</td></tr> 1663<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExtendedStatus On|Off</code></td></tr> 1664<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ExtendedStatus Off</code></td></tr> 1665<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 1666<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1667<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1668</table> 1669 1670 <p>Cette option permet d'extraire des donn�es suppl�mentaires 1671 concernant la requ�te en cours de traitement pour un processus 1672 donn�, ainsi qu'un r�sum� d'utilisation ; vous pouvez acc�der � 1673 ces variables pendant l'ex�cution en configurant 1674 <code class="module"><a href="/mod/mod_status.html">mod_status</a></code>. Notez que d'autres modules sont 1675 susceptibles de s'appuyer sur ce tableau de bord.</p> 1676 1677 <p>Cette directive s'applique au serveur dans son ensemble, et ne 1678 peut pas �tre activ�e/d�sactiv�e pour un serveur virtuel 1679 particulier. Notez que l'extraction des informations d'�tat �tendues 1680 peut ralentir le serveur. Notez aussi que cette d�finition ne peut 1681 pas �tre modifi�e au cours d'un red�marrage graceful.</p> 1682 1683 <div class="note"> 1684 <p>Notez que le chargement de <code class="module"><a href="/mod/mod_status.html">mod_status</a></code> d�finit 1685 automatiquement ExtendedStatus � On, et que d'autres modules tiers 1686 sont susceptibles d'en faire de m�me. De tels modules ont besoin 1687 d'informations d�taill�es � propos de l'�tat de tous les processus. 1688 Depuis la version 2.3.6, <code class="module"><a href="/mod/mod_status.html">mod_status</a></code> a d�finit la 1689 valeur par d�faut � On, alors qu'elle �tait � Off dans les versions 1690 ant�rieures.</p> 1691 </div> 1692 1693 1694</div> 1695<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1696<div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">Directive</a></h2> 1697<table class="directive"> 1698<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Caract�ristiques de fichier utilis�es lors de la g�n�ration 1699de l'en-t�te de r�ponse HTTP ETag pour les fichiers statiques</td></tr> 1700<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FileETag <var>composant</var> ...</code></td></tr> 1701<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>FileETag MTime Size</code></td></tr> 1702<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 1703<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 1704<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1705<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1706<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>La valeur par d�faut �tait "INode MTime Size" 1707dans les versions 2.3.14 et ant�rieures.</td></tr> 1708</table> 1709 <p> 1710 La directive <code class="directive">FileETag</code> d�finit les 1711 caract�ristiques de fichier utilis�es lors de la g�n�ration de 1712 l'en-t�te de r�ponse HTTP <code>ETag</code> (entity tag) quand le 1713 document est contenu dans un fichier statique(la valeur de 1714 <code>ETag</code> 1715 est utilis�e dans le cadre de la gestion du cache pour pr�server la 1716 bande passante r�seau). La directive 1717 <code class="directive">FileETag</code> vous permet maintenant de choisir 1718 quelles caract�ristiques du fichier vont �tre utilis�es, le cas 1719 �ch�ant. Les mots-cl�s reconnus sont : 1720 </p> 1721 1722 <dl> 1723 <dt><strong>INode</strong></dt> 1724 <dd>Le num�ro d'i-node du fichier sera inclus dans le processus de 1725 g�n�ration</dd> 1726 <dt><strong>MTime</strong></dt> 1727 <dd>La date et l'heure auxquelles le fichier a �t� modifi� la 1728 derni�re fois seront incluses</dd> 1729 <dt><strong>Size</strong></dt> 1730 <dd>La taille du fichier en octets sera incluse</dd> 1731 <dt><strong>All</strong></dt> 1732 <dd>Tous les champs disponibles seront utilis�s. Cette d�finition 1733 est �quivalente � : 1734 <pre class="prettyprint lang-config">FileETag INode MTime Size</pre> 1735</dd> 1736 <dt><strong>None</strong></dt> 1737 <dd>Si le document se compose d'un fichier, aucun champ 1738 <code>ETag</code> ne sera inclus dans la r�ponse</dd> 1739 </dl> 1740 1741 <p>Les mots-cl�s <code>INode</code>, <code>MTime</code>, et 1742 <code>Size</code> peuvent �tre pr�fix�s par <code>+</code> ou 1743 <code>-</code>, ce qui permet de modifier les valeurs par d�faut 1744 h�rit�es d'un niveau de configuration plus g�n�ral. Tout mot-cl� 1745 apparaissant sans aucun pr�fixe annule enti�rement et imm�diatement 1746 les configurations h�rit�es.</p> 1747 1748 <p>Si la configuration d'un r�pertoire contient 1749 <code>FileETag INode MTime Size</code>, et si un de 1750 ses sous-r�pertoires contient <code>FileETag -INode</code>, la 1751 configuration de ce sous-r�pertoire (qui sera propag�e vers tout 1752 sous-r�pertoire qui ne la supplante pas), sera �quivalente � 1753 <code>FileETag MTime Size</code>.</p> 1754 <div class="warning"><h3>Avertissement</h3> 1755 Ne modifiez pas les valeurs par d�faut pour les r�pertoires ou 1756 localisations o� WebDAV est activ� et qui utilisent 1757 <code class="module"><a href="/mod/mod_dav_fs.html">mod_dav_fs</a></code> comme fournisseur de stockage. 1758 <code class="module"><a href="/mod/mod_dav_fs.html">mod_dav_fs</a></code> utilise 1759 <code>MTime Size</code> comme format fixe pour les 1760 comparaisons de champs <code>ETag</code> dans les requ�tes 1761 conditionnelles. Ces requ�tes conditionnelles �choueront si le 1762 format <code>ETag</code> est modifi� via la directive 1763 <code class="directive">FileETag</code>. 1764 </div> 1765 <div class="note"><h3>Inclusions c�t� serveur</h3> 1766 Aucun champ ETag n'est g�n�r� pour les r�ponses interpr�t�es par 1767 <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>, car l'entit� de la r�ponse peut 1768 changer sans modification de l'INode, du MTime, ou de la taille du 1769 fichier statique contenant les directives SSI. 1770 </div> 1771 1772 1773 1774</div> 1775<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1776<div class="directive-section"><h2><a name="Files" id="Files"><Files></a> <a name="files" id="files">Directive</a></h2> 1777<table class="directive"> 1778<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent aux fichiers 1779pr�cis�s</td></tr> 1780<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Files <var>nom fichier</var>> ... </Files></code></td></tr> 1781<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 1782<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 1783<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1784<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1785</table> 1786 <p>La directive <code class="directive"><Files></code> limite 1787 la port�e des directives qu'elle contient aux fichiers pr�cis�s. 1788 Elle est comparable aux directives <code class="directive"><a href="#directory"><Directory></a></code> et <code class="directive"><a href="#location"><Location></a></code>. Elle doit se terminer par une 1789 balise <code></Files></code>. Les directives contenues dans 1790 cette section s'appliqueront � tout objet dont le nom de base (la 1791 derni�re partie du nom de fichier) correspond au fichier sp�cifi�. 1792 Les sections <code class="directive"><Files></code> sont 1793 trait�es selon l'ordre dans lequel elles apparaissent dans le 1794 fichier de configuration, apr�s les sections <code class="directive"><a href="#directory"><Directory></a></code> et la lecture des fichiers 1795 <code>.htaccess</code>, mais avant les sections <code class="directive"><a href="#location"><Location></a></code>. Notez que les 1796 sections <code class="directive"><Files></code> peuvent �tre 1797 imbriqu�es dans les sections <code class="directive"><a href="#directory"><Directory></a></code> afin de restreindre la portion 1798 du syst�me de fichiers � laquelle ces derni�res vont 1799 s'appliquer.</p> 1800 1801 <p>L'argument <var>filename</var> peut contenir un nom de fichier 1802 ou une cha�ne de caract�res avec caract�res g�n�riques, o� 1803 <code>?</code> remplace un caract�re, et <code>*</code> toute cha�ne 1804 de caract�res.</p> 1805 <pre class="prettyprint lang-config"><Files "cat.html"> 1806 # Ins�rer ici des directives qui s'appliquent au fichier cat.html 1807</Files> 1808 1809<Files "?at.*"> 1810 # Les directives ins�r�es ici s'appliqueront aux fichiers 1811 # cat.html, bat.html, hat.php, et ainsi de suite. 1812</Files></pre> 1813 1814 1815 <p>On peut aussi utiliser les <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> en ajoutant la 1816 caract�re <code>~</code>. Par exemple :</p> 1817 1818 <pre class="prettyprint lang-config"><Files ~ "\.(gif|jpe?g|png)$"> 1819 #... 1820</Files></pre> 1821 1822 1823 <p>correspondrait � la plupart des formats graphiques de l'Internet. 1824 Il est cependant pr�f�rable d'utiliser la directive <code class="directive"><a href="#filesmatch"><FilesMatch></a></code>.</p> 1825 1826 <p>Notez qu'� la diff�rence des sections <code class="directive"><a href="#directory"><Directory></a></code> et <code class="directive"><a href="#location"><Location></a></code>, les sections <code class="directive"><Files></code> peuvent �tre utilis�es dans les 1827 fichiers <code>.htaccess</code>. Ceci permet aux utilisateurs de 1828 contr�ler l'acc�s � leurs propres ressources, fichier par 1829 fichier.</p> 1830 1831 1832<h3>Voir aussi</h3> 1833<ul> 1834<li><a href="/sections.html">Comment fonctionnent les sections 1835<Directory>, <Location> et <Files></a> pour une 1836explication de la mani�re dont ces diff�rentes sections se combinent 1837entre elles � la r�ception d'une requ�te</li> 1838</ul> 1839</div> 1840<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1841<div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch"><FilesMatch></a> <a name="filesmatch" id="filesmatch">Directive</a></h2> 1842<table class="directive"> 1843<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent � des fichiers 1844sp�cifi�s sous la forme d'expressions rationnelles</td></tr> 1845<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><FilesMatch <var>expression rationnelle</var>> ... 1846</FilesMatch></code></td></tr> 1847<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 1848<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 1849<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1850<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1851</table> 1852 <p>La section <code class="directive"><FilesMatch></code> 1853 limite la port�e des directives qu'elle contient aux fichiers 1854 sp�cifi�s, tout comme le ferait une section <code class="directive"><a href="#files"><Files></a></code>. Mais elle accepte aussi les 1855 <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expressions rationnelles</a>. Par 1856 exemple :</p> 1857 1858 <pre class="prettyprint lang-config"><FilesMatch "\.(gif|jpe?g|png)$"> 1859 # ... 1860</FilesMatch></pre> 1861 1862 1863 <p>correspondrait � la plupart des formats graphiques de 1864 l'Internet.</p> 1865 1866 <p>A partir de la version 2.4.8, les groupes nomm�s et les 1867 r�f�rences arri�res sont extraits et enregistr�s dans 1868 l'environnement avec leur nom en majuscules et pr�fix� 1869 par "MATCH_". Ceci permet 1870 de r�f�rencer des URLs dans des <a href="/expr.html">expressions</a> 1871 ou au sein de modules comme <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>. Pour 1872 �viter toute confusion, les r�f�rences arri�res num�rot�es (non 1873 nomm�es) sont ignor�es. Vous devez utiliser � la place des groupes 1874 nomm�s.</p> 1875 1876<pre class="prettyprint lang-config"><FileMatch ^(?<sitename>[^/]+)> 1877 require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example 1878</FileMatch></pre> 1879 1880 1881 1882<h3>Voir aussi</h3> 1883<ul> 1884<li><a href="/sections.html">Comment fonctionnent les sections 1885<Directory>, <Location> et <Files></a> pour une 1886explication de la mani�re dont ces diff�rentes sections se combinent 1887entre elles � la r�ception d'une requ�te</li> 1888</ul> 1889</div> 1890<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1891<div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">Directive</a></h2> 1892<table class="directive"> 1893<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 1894HTTP Content-Type pour les fichiers correspondants</td></tr> 1895<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForceType <var>type m�dium</var>|None</code></td></tr> 1896<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 1897<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 1898<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1899<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1900</table> 1901 <p>Lorsqu'elle est plac�e dans un fichier <code>.htaccess</code> ou 1902 une section <code class="directive"><a href="#directory"><Directory></a></code>, <code class="directive"><a href="#location"><Location></a></code>, ou <code class="directive"><a href="#files"><Files></a></code>, cette directive force 1903 l'identification du type MIME des fichiers sp�cifi�s � la valeur de 1904 l'argument <var>type m�dium</var>. Par exemple, si vous poss�dez un 1905 r�pertoire ne contenant que des fichiers GIF, et si vous ne voulez 1906 pas leur ajouter l'extension <code>.gif</code>, vous pouvez utiliser 1907 :</p> 1908 1909 <pre class="prettyprint lang-config">ForceType image/gif</pre> 1910 1911 1912 <p>Notez que cette directive l'emporte sur d'autres associations de 1913 type de m�dium indirectes d�finies dans mime.types ou via la 1914 directive <code class="directive"><a href="/mod/mod_mime.html#addtype">AddType</a></code>.</p> 1915 1916 <p>Vous pouvez aussi annuler toute d�finition plus g�n�rale de 1917 <code class="directive">ForceType</code> en affectant la valeur 1918 <code>None</code> � l'argument <var>type m�dium</var> :</p> 1919 1920 <pre class="prettyprint lang-config"># force le type MIME de tous les fichiers � image/gif: 1921<Location /images> 1922 ForceType image/gif 1923</Location> 1924 1925# mais utilise les m�thodes classiques d'attribution du type MIME 1926# dans le sous-r�pertoire suivant : 1927<Location /images/mixed> 1928 ForceType None 1929</Location></pre> 1930 1931 1932 <p>A la base, cette directive �crase le type de contenu g�n�r� pour 1933 les fichiers statiques servis � partir du syt�me de fichiers. Pour 1934 les ressources autres que les fichiers statiques pour lesquels le 1935 g�n�rateur de r�ponse sp�cifie en g�n�ral un type de contenu, cette 1936 directive est ignor�e.</p> 1937 1938 1939</div> 1940<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1941<div class="directive-section"><h2><a name="GprofDir" id="GprofDir">GprofDir</a> <a name="gprofdir" id="gprofdir">Directive</a></h2> 1942<table class="directive"> 1943<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>R�pertoire dans lequel �crire les donn�es de profiling 1944gmon.out.</td></tr> 1945<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> 1946<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 1947<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1948<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1949</table> 1950 <p>Lorsque le serveur a �t� compil� avec le support du profiling 1951 gprof, la directive <code class="directive">GprofDir</code> permet de 1952 sp�cifier dans quel r�pertoire les fichiers <code>gmon.out</code> 1953 doivent �tre �crits lorsque le processus s'arr�te. Si l'argument se 1954 termine par un caract�re pourcentage ('%'), des sous-r�pertoires 1955 sont cr��s pour chaque identifiant de processus.</p> 1956 1957 <p>Cette directive ne fonctionne actuellement qu'avec le MPM 1958 <code class="module"><a href="/mod/prefork.html">prefork</a></code>.</p> 1959 1960</div> 1961<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1962<div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">Directive</a></h2> 1963<table class="directive"> 1964<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la recherche DNS sur les adresses IP des 1965clients</td></tr> 1966<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr> 1967<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>HostnameLookups Off</code></td></tr> 1968<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 1969<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 1970<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 1971</table> 1972 <p>Cette directive active la recherche DNS afin de pouvoir 1973 journaliser les nom d'h�tes (et les passer aux programmes CGI et aux 1974 inclusions SSI via la variable <code>REMOTE_HOST</code>). La valeur 1975 <code>Double</code> d�clenche une double recherche DNS inverse. En 1976 d'autres termes, une fois la recherche inverse effectu�e, on lance 1977 une recherche directe sur le r�sultat de cette derni�re. Au moins 1978 une des adresses IP fournies par la recherche directe doit 1979 correspondre � l'adresse originale (ce que l'on nomme 1980 <code>PARANOID</code> dans la terminologie "tcpwrappers").</p> 1981 1982 <p>Quelle que soit la configuration, lorsqu'on utilise 1983 <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code> pour contr�ler l'acc�s en fonction 1984 du nom d'h�te, une double recherche DNS inverse est effectu�e, 1985 s�curit� oblige. Notez cependant que le r�sultat de cette double 1986 recherche n'est en g�n�ral pas accessible, � moins que vous n'ayez 1987 sp�cifi� <code>HostnameLookups Double</code>. Par exemple, si vous 1988 n'avez sp�cifi� que <code>HostnameLookups On</code>, et si une 1989 requ�te concerne un objet prot�g� par des restrictions en fonction 1990 du nom d'h�te, quel que soit le r�sultat de la double recherche 1991 inverse, les programmes CGI ne recevront que le r�sultat de la 1992 recherche inverse simple dans la variable 1993 <code>REMOTE_HOST</code>.</p> 1994 1995 <p>La valeur par d�faut est <code>Off</code> afin de pr�server le 1996 traffic r�seau des sites pour lesquels la recherche inverse n'est 1997 pas vraiment n�cessaire. Cette valeur par d�faut est aussi b�n�fique 1998 pour les utilisateurs finaux car il n'ont ainsi pas � subir de temps 1999 d'attente suppl�mentaires dus aux recherches DNS. Les sites 2000 fortement charg�s devraient laisser cette directive � 2001 <code>Off</code>, car les recherches DNS peuvent prendre des temps 2002 tr�s longs. Vous pouvez �ventuellement utiliser hors ligne 2003 l'utilitaire <code class="program"><a href="/programs/logresolve.html">logresolve</a></code>, compil� par d�faut dans 2004 le sous-r�pertoire <code>bin</code> de votre r�pertoire 2005 d'installation, afin de d�terminer les noms d'h�tes associ�s aux 2006 adresses IP journalis�es.</p> 2007 2008 <p>Enfin, si vous avez des <a href="mod_authz_host.html#reqhost">directives Require � base de 2009 nom</a>, une recherche de nom d'h�te sera effectu�e quelle que soit 2010 la d�finition de la directive <code>HostnameLookups</code>.</p> 2011 2012</div> 2013<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2014<div class="directive-section"><h2><a name="If" id="If"><If></a> <a name="if" id="if">Directive</a></h2> 2015<table class="directive"> 2016<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si une 2017condition est satisfaite au cours du traitement d'une 2018requ�te</td></tr> 2019<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><If <var>expression</var>> ... </If></code></td></tr> 2020<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 2021<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 2022<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2023<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2024</table> 2025 <p>La directive <code class="directive"><If></code> �value une 2026 expression � la vol�e, et applique les directives qu'elle contient 2027 si et seulement si l'expression renvoie la valeur "vrai". Par 2028 exemple :</p> 2029 2030 <pre class="prettyprint lang-config"><If "-z req('Host')"></pre> 2031 2032 2033 <p>serait satisfaite pour les requ�tes HTTP/1.0 sans en-t�te 2034 <var>Host:</var>. Les expressions peuvent contenir diff�rents 2035 op�rateurs de type shell pour la comparaison de cha�nes 2036 (<code>=</code>, <code>!=</code>, <code><</code>, ...), la 2037 comparaison d'entiers (<code>-eq</code>, <code>-ne</code>, ...), ou 2038 � usages divers (<code>-n</code>, <code>-z</code>, <code>-f</code>, 2039 ...). Les expressions rationnelles sont aussi support�es,</p> 2040 2041 <pre class="prettyprint lang-config"><If "%{QUERY_STRING} =~ /(delete|commit)=.*?elem/"></pre> 2042 2043 2044 <p>ainsi que les comparaison de mod�les de type shell et de 2045 nombreuses autres op�rations. Ces op�rations peuvent �tre effectu�es 2046 sur les en-t�tes de requ�tes (<code>req</code>), les variables 2047 d'environnement (<code>env</code>), et un grand nombre d'autres 2048 propri�t�s. La documentation compl�te est disponible dans <a href="/expr.html">Les expressions dans le serveur HTTP Apache</a>.</p> 2049 2050 <p>Cette section de configuration ne peut contenir que des 2051 directives qui supportent le <a href="directive-dict.html#Context">contexte de r�pertoire</a>.</p> 2052 2053 2054<h3>Voir aussi</h3> 2055<ul> 2056<li><a href="/expr.html">Les expressions dans le serveur HTTP 2057Apache</a>, pour une r�f�rence compl�te et d'autres exemples.</li> 2058<li><code class="directive"><a href="#elseif"><ElseIf></a></code></li> 2059<li><code class="directive"><a href="#else"><Else></a></code></li> 2060<li><a href="/sections.html">Comment fonctionnent les sections 2061<Directory>, <Location> et <Files></a> pour une 2062explication de la mani�re dont ces diff�rentes sections se combinent 2063entre elles � la r�ception d'une requ�te. Les 2064directives <code class="directive"><If></code>, <code class="directive"><ElseIf></code>, et <code class="directive"><Else></code> s'appliquent en dernier.</li> 2065</ul> 2066</div> 2067<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2068<div class="directive-section"><h2><a name="IfDefine" id="IfDefine"><IfDefine></a> <a name="ifdefine" id="ifdefine">Directive</a></h2> 2069<table class="directive"> 2070<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliqueront que si un 2071test retourne "vrai" au d�marrage du serveur</td></tr> 2072<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><IfDefine [!]<var>param�tre</var>> ... 2073 </IfDefine></code></td></tr> 2074<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 2075<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 2076<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2077<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2078</table> 2079 <p>La section <code><IfDefine 2080 <var>test</var>>...</IfDefine></code> permet de 2081 conf�rer un caract�re conditionnel � un ensemble de directives. Les 2082 directives situ�es � l'int�rieur d'une section <code class="directive"><IfDefine></code> ne s'appliquent que si 2083 <var>test</var> est vrai. Si <var>test</var> est faux, tout ce qui 2084 se trouve entre les balises de d�but et de fin est ignor�.</p> 2085 2086 <p><var>test</var> peut se pr�senter sous deux formes :</p> 2087 2088 <ul> 2089 <li><var>nom param�tre</var></li> 2090 2091 <li><code>!</code><var>nom param�tre</var></li> 2092 </ul> 2093 2094 <p>Dans le premier cas, les directives situ�es entre les balises de 2095 d�but et de fin ne s'appliqueront que si le param�tre nomm� <var>nom 2096 param�tre</var> est d�fini. Le second format inverse le test, et 2097 dans ce cas, les directives ne s'appliqueront que si <var>nom 2098 param�tre</var> n'est <strong>pas</strong> d�fini.</p> 2099 2100 <p>L'argument <var>nom param�tre</var> est une d�finition qui peut 2101 �tre effectu�e par la ligne de commande 2102 <code class="program"><a href="/programs/httpd.html">httpd</a></code> via le param�tre 2103 <code>-D<var>param�tre</var></code> au d�marrage du serveur, ou via la 2104 directive <code class="directive"><a href="#define">Define</a></code>.</p> 2105 2106 <p>Les sections <code class="directive"><IfDefine></code> 2107 peuvent �tre imbriqu�es, ce qui permet d'impl�menter un test 2108 multi-param�tres simple. Exemple :</p> 2109 2110 <div class="example"><p><code>httpd -DReverseProxy -DUseCache -DMemCache ...</code></p></div> 2111 <pre class="prettyprint lang-config"><IfDefine ReverseProxy> 2112 LoadModule proxy_module modules/mod_proxy.so 2113 LoadModule proxy_http_module modules/mod_proxy_http.so 2114 <IfDefine UseCache> 2115 LoadModule cache_module modules/mod_cache.so 2116 <IfDefine MemCache> 2117 LoadModule mem_cache_module modules/mod_mem_cache.so 2118 </IfDefine> 2119 <IfDefine !MemCache> 2120 LoadModule cache_disk_module modules/mod_cache_disk.so 2121 </IfDefine> 2122 </IfDefine> 2123</IfDefine></pre> 2124 2125 2126</div> 2127<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2128<div class="directive-section"><h2><a name="IfModule" id="IfModule"><IfModule></a> <a name="ifmodule" id="ifmodule">Directive</a></h2> 2129<table class="directive"> 2130<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent qu'en fonction 2131de la pr�sence ou de l'absence d'un module sp�cifique</td></tr> 2132<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><IfModule [!]<var>fichier module</var>|<var>identificateur 2133module</var>> ... </IfModule></code></td></tr> 2134<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 2135<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 2136<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2137<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2138<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Les identificateurs de modules sont disponibles dans les 2139versions 2.1 et sup�rieures.</td></tr> 2140</table> 2141 <p>La section <code><IfModule 2142 <var>test</var>>...</IfModule></code> permet de conf�rer � 2143 des directives un caract�re conditionnel bas� sur la pr�sence d'un 2144 module sp�cifique. Les directives situ�es dans une section 2145 <code class="directive"><IfModule></code> ne s'appliquent que 2146 si <var>test</var> est vrai. Si <var>test</var> est faux, tout ce 2147 qui se trouve entre les balises de d�but et de fin est ignor�.</p> 2148 2149 <p><var>test</var> peut se pr�senter sous deux formes :</p> 2150 2151 <ul> 2152 <li><var>module</var></li> 2153 2154 <li>!<var>module</var></li> 2155 </ul> 2156 2157 <p>Dans le premier cas, les directives situ�es entre les balises de 2158 d�but et de fin ne s'appliquent que si le module <var>module</var> 2159 est pr�sent -- soit compil� avec le binaire Apache httpd, soit charg� 2160 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 2161 ce cas, les directives ne s'appliquent que si <var>module</var> 2162 n'est <strong>pas</strong> pr�sent.</p> 2163 2164 <p>L'argument <var>module</var> peut contenir soit l'identificateur 2165 du module, soit le nom du fichier source du module. Par exemple, 2166 <code>rewrite_module</code> est un identificateur et 2167 <code>mod_rewrite.c</code> le nom du fichier source 2168 correspondant. Si un module comporte plusieurs fichiers sources, 2169 utilisez le nom du fichier qui contient la cha�ne de caract�res 2170 <code>STANDARD20_MODULE_STUFF</code>.</p> 2171 2172 <p>Les sections <code class="directive"><IfModule></code> 2173 peuvent �tre imbriqu�es, ce qui permet d'impl�menter des tests 2174 multi-modules simples.</p> 2175 2176 <div class="note">Cette section ne doit �tre utilis�e que si votre fichier de 2177 configuration ne fonctionne qu'en fonction de la pr�sence ou de 2178 l'absence d'un module sp�cifique. D'une mani�re g�n�rale, il n'est 2179 pas n�cessaire de placer les directives � l'int�rieur de sections 2180 <code class="directive"><IfModule></code>.</div> 2181 2182</div> 2183<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2184<div class="directive-section"><h2><a name="Include" id="Include">Include</a> <a name="include" id="include">Directive</a></h2> 2185<table class="directive"> 2186<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inclut d'autres fichiers de configuration dans un des 2187fichiers de configuration du serveur</td></tr> 2188<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> 2189<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 2190<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2191<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2192<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Utilisation des caract�res g�n�riques dans la partie chemin depuis la 2193version 2.3.6</td></tr> 2194</table> 2195 <p>Cette directive permet l'inclusion d'autres fichiers de 2196 configuration dans un des fichiers de configuration du serveur.</p> 2197 2198 <p>On peut utiliser des caract�res g�n�riques de style Shell 2199 (<code>fnmatch()</code>) aussi bien dans la partie nom de fichier du 2200 chemin que dans la partie r�pertoires pour inclure plusieurs 2201 fichiers en une 2202 seule fois, selon leur ordre alphab�tique. De plus, si la directive 2203 <code class="directive">Include</code> pointe vers un r�pertoire, Apache 2204 httpd inclura tous les fichiers de ce r�pertoire et de tous ces 2205 sous-r�pertoires. L'inclusion de r�pertoires entiers est cependant 2206 d�conseill�e, car il est fr�quent d'oublier des fichiers 2207 temporaires dans un r�pertoire, ce qui causerait une erreur 2208 <code class="program"><a href="/programs/httpd.html">httpd</a></code> en cas d'inclusion. Pour inclure des 2209 fichiers qui correspondent � un certain mod�le, comme *.conf par 2210 exemple, nous vous recommandons d'utiliser plut�t la syntaxe avec 2211 caract�res g�n�riques comme ci-dessous.</p> 2212 2213 <p>La directive <code class="directive"><a href="#include">Include</a></code> 2214 <strong>�chouera avec un code d'erreur</strong> si une expression 2215 contenant des caract�res g�n�riques ne correspond � aucun fichier. 2216 Pour ignorer les expressions contenant des caract�res g�n�riques ne 2217 correspondant � aucun fichier, utilisez la directive <code class="directive"><a href="#includeoptional">IncludeOptional</a></code>.</p> 2218 2219 <p>Le chemin fichier sp�cifi� peut �tre soit un chemin absolu, soit 2220 un chemin relatif au r�pertoire d�fini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p> 2221 2222 <p>Exemples :</p> 2223 2224 <pre class="prettyprint lang-config">Include /usr/local/apache2/conf/ssl.conf 2225Include /usr/local/apache2/conf/vhosts/*.conf</pre> 2226 2227 2228 <p>ou encore, avec des chemins relatifs au r�pertoire d�fini par la 2229 directive <code class="directive"><a href="#serverroot">ServerRoot</a></code> :</p> 2230 2231 <pre class="prettyprint lang-config">Include conf/ssl.conf 2232Include conf/vhosts/*.conf</pre> 2233 2234 2235 <p>On peut aussi ins�rer des caract�res g�n�riques dans la partie 2236 r�pertoires du chemin. Dans l'exemple suivant, la directive 2237 �chouera si aucun sous-r�pertoire de conf/vhosts ne contient au 2238 moins un fichier *.conf :</p> 2239 2240 <pre class="prettyprint lang-config">Include conf/vhosts/*/*.conf</pre> 2241 2242 2243 <p>Par contre, dans l'exemple suivant, la directive sera simplement 2244 ignor�e si aucun sous-r�pertoire de conf/vhosts ne contient au 2245 moins un fichier *.conf :</p> 2246 2247 <pre class="prettyprint lang-config">IncludeOptional conf/vhosts/*/*.conf</pre> 2248 2249 2250 2251<h3>Voir aussi</h3> 2252<ul> 2253<li><code class="directive"><a href="#includeoptional">IncludeOptional</a></code></li> 2254<li><code class="program"><a href="/programs/apachectl.html">apachectl</a></code></li> 2255</ul> 2256</div> 2257<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2258<div class="directive-section"><h2><a name="IncludeOptional" id="IncludeOptional">IncludeOptional</a> <a name="includeoptional" id="includeoptional">Directive</a></h2> 2259<table class="directive"> 2260<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inclusion de fichiers dans le fichier de configuration</td></tr> 2261<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IncludeOptional 2262<var>chemin-fichier</var>|<var>chemin-r�pertoire</var>|<var>wildcard</var></code></td></tr> 2263<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 2264<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2265<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2266<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible � partir de la version 2.3.6 du serveur HTTP 2267Apache</td></tr> 2268</table> 2269 <p>Cette directive permet d'inclure des fichiers dans les fichiers 2270 de configuration du serveur. Elle fonctionne de mani�re identique � 2271 la directive <code class="directive"><a href="#include">Include</a></code>, � 2272 l'exception du fait que si l'expression avec caract�res g�n�riques 2273 wilcard ne correspond � aucun fichier ou r�pertoire, elle sera 2274 ignor�e silencieusement au lieu de causer une erreur.</p> 2275 2276 2277<h3>Voir aussi</h3> 2278<ul> 2279<li><code class="directive"><a href="#include">Include</a></code></li> 2280<li><code class="program"><a href="/programs/apachectl.html">apachectl</a></code></li> 2281</ul> 2282</div> 2283<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2284<div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">Directive</a></h2> 2285<table class="directive"> 2286<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active les connexions HTTP persistantes</td></tr> 2287<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeepAlive On|Off</code></td></tr> 2288<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>KeepAlive On</code></td></tr> 2289<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 2290<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2291<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2292</table> 2293 <p>L'extension Keep-Alive de HTTP/1.0 et l'impl�mentation des 2294 connexions persistantes dans HTTP/1.1 ont rendu possibles des 2295 sessions HTTP de longue dur�e, ce qui permet de transmettre 2296 plusieurs requ�tes via la m�me connexion TCP. Dans certains cas, le 2297 gain en rapidit� pour des documents comportant de nombreuses images 2298 peut atteindre 50%. Pour activer les connexions persistantes, 2299 d�finissez <code>KeepAlive On</code>.</p> 2300 2301 <p>Pour les clients HTTP/1.0, les connexions persistantes ne seront 2302 mises en oeuvre que si elles ont �t� sp�cialement demand�es par un 2303 client. De plus, une connexion persistante avec un client HTTP/1.0 2304 ne peut �tre utilis�e que si la taille du contenu est connue 2305 d'avance. Ceci implique que les contenus dynamiques comme les 2306 sorties CGI, les pages SSI, et les listings de r�pertoires g�n�r�s 2307 par le serveur n'utiliseront en g�n�ral pas les connexions 2308 persistantes avec les clients HTTP/1.0. Avec les clients HTTP/1.1, 2309 les connexions persistantes sont utilis�es par d�faut, sauf 2310 instructions contraires. Si le client le demande, le transfert par 2311 tron�ons de taille fixe (chunked encoding) sera utilis� afin de 2312 transmettre un contenu de longueur inconnue via une connexion 2313 persistante.</p> 2314 2315 <p>Lorsqu'un client utilise une connexion persistante, elle comptera 2316 pour une seule requ�te pour la directive <code class="directive"><a href="/mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>, quel 2317 que soit le nombre de requ�tes transmises via cette connexion.</p> 2318 2319<h3>Voir aussi</h3> 2320<ul> 2321<li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li> 2322</ul> 2323</div> 2324<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2325<div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">Directive</a></h2> 2326<table class="directive"> 2327<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dur�e pendant laquelle le serveur va attendre une requ�te 2328avant de fermer une connexion persistante</td></tr> 2329<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeepAliveTimeout <var>nombre</var>[ms]</code></td></tr> 2330<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>KeepAliveTimeout 5</code></td></tr> 2331<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 2332<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2333<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2334<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>La sp�cification d'une valeur en millisecondes est 2335possible depuis les versions 2.3.2 et sup�rieures d'Apache httpd</td></tr> 2336</table> 2337 <p>Le nombre de secondes pendant lesquelles Apache httpd va attendre une 2338 requ�te avant de fermer la connexion. Le d�lai peut �tre d�fini en 2339 millisecondes en suffixant sa valeur par ms. La valeur du d�lai 2340 sp�cifi�e par la directive <code class="directive"><a href="#timeout">Timeout</a></code> s'applique d�s qu'une requ�te a 2341 �t� re�ue.</p> 2342 2343 <p>Donner une valeur trop �l�v�e � 2344 <code class="directive">KeepAliveTimeout</code> peut induire des probl�mes 2345 de performances sur les serveurs fortement charg�s. Plus le d�lai 2346 est �l�v�, plus nombreux seront les processus serveur en attente de 2347 requ�tes de la part de clients inactifs.</p> 2348 2349 <p>Dans un contexte de serveur virtuel � base de nom, c'est 2350 la valeur de la paire adresse IP/port du serveur virtuel qui 2351 correspond le mieux qui sera utilis�e.</p> 2352 2353</div> 2354<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2355<div class="directive-section"><h2><a name="Limit" id="Limit"><Limit></a> <a name="limit" id="limit">Directive</a></h2> 2356<table class="directive"> 2357<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite les contr�les d'acc�s que la section contient � 2358certaines m�thodes HTTP</td></tr> 2359<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Limit <var>m�thode</var> [<var>m�thode</var>] ... > ... 2360 </Limit></code></td></tr> 2361<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 2362<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig, Limit</td></tr> 2363<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2364<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2365</table> 2366 <p>Les contr�les d'acc�s s'appliquent normalement � 2367 <strong>toutes</strong> les m�thodes d'acc�s, et c'est en g�n�ral le 2368 comportement souhait�. <strong>Dans le cas g�n�ral, les directives 2369 de contr�le d'acc�s n'ont pas � �tre plac�es dans une section 2370 <code class="directive"><Limit></code>.</strong></p> 2371 2372 <p>La directive <code class="directive"><Limit></code> a pour 2373 but de limiter les effets des contr�les d'acc�s aux m�thodes HTTP 2374 sp�cifi�es. Pour toutes les autres m�thodes, les restrictions 2375 d'acc�s contenues dans la section <code class="directive"><Limit></code> <strong>n'auront aucun 2376 effet</strong>. L'exemple suivant n'applique les contr�les d'acc�s 2377 qu'aux m�thodes <code>POST</code>, <code>PUT</code>, et 2378 <code>DELETE</code>, en laissant les autres m�thodes sans protection 2379 :</p> 2380 2381 <pre class="prettyprint lang-config"><Limit POST PUT DELETE> 2382 Require valid-user 2383</Limit></pre> 2384 2385 2386 <p>La liste des noms de m�thodes peut contenir une ou plusieurs 2387 valeurs parmi les suivantes : <code>GET</code>, <code>POST</code>, 2388 <code>PUT</code>, <code>DELETE</code>, <code>CONNECT</code>, 2389 <code>OPTIONS</code>, <code>PATCH</code>, <code>PROPFIND</code>, 2390 <code>PROPPATCH</code>, <code>MKCOL</code>, <code>COPY</code>, 2391 <code>MOVE</code>, <code>LOCK</code>, et <code>UNLOCK</code>. 2392 <strong>Le nom de m�thode est sensible � la casse.</strong> Si la 2393 valeur <code>GET</code> est pr�sente, les requ�tes <code>HEAD</code> 2394 seront aussi concern�es. La m�thode <code>TRACE</code> ne peut pas 2395 �tre limit�e (voir la directive <code class="directive"><a href="#traceenable">TraceEnable</a></code>).</p> 2396 2397 <div class="warning">Une section <code class="directive"><LimitExcept></code> doit toujours �tre pr�f�r�e � 2398 une section <code class="directive"><Limit></code> pour la 2399 restriction d'acc�s, car une section <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> fournit une protection contre 2400 les m�thodes arbitraires.</div> 2401 2402 <p>Les directives <code class="directive"><Limit></code> et 2403 <code class="directive"><a href="#limitexcept"><LimitExcept></a></code> 2404 peuvent �tre imbriqu�es. Dans ce cas, pour chaque niveau des 2405 directives <code class="directive"><Limit></code> ou <code class="directive"><a href="#limitexcept"><LimitExcept></a></code>, ces derni�res 2406 doivent restreindre l'acc�s pour les m�thodes auxquelles les 2407 contr�les d'acc�s s'appliquent.</p> 2408 2409 <div class="warning">Lorsqu'on utilise les directives <code class="directive"><Limit></code> ou <code class="directive"><LimitExcept></code> avec la directive <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code>, la premi�re directive 2410 <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code> dont la 2411 condition est satisfaite autorise la requ�te, sans tenir compte de 2412 la pr�sence d'autres directives <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code>.</div> 2413 2414 <p>Par exemple, avec la configuration suivante, tous les 2415 utilisateurs seront autoris�s � effectuer des requ�tes 2416 <code>POST</code>, et la directive <code>Require group 2417 editors</code> sera ignor�e dans tous les cas :</p> 2418 2419 <pre class="prettyprint lang-config"><LimitExcept GET> 2420 Require valid-user 2421</LimitExcept> 2422<Limit POST> 2423 Require group editors 2424</Limit></pre> 2425 2426 2427</div> 2428<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2429<div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept"><LimitExcept></a> <a name="limitexcept" id="limitexcept">Directive</a></h2> 2430<table class="directive"> 2431<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applique les contr�les d'acc�s � toutes les m�thodes HTTP, 2432sauf celles qui sont sp�cifi�es</td></tr> 2433<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><LimitExcept <var>m�thode</var> [<var>m�thode</var>] ... > ... 2434 </LimitExcept></code></td></tr> 2435<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 2436<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig, Limit</td></tr> 2437<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2438<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2439</table> 2440 <p><code class="directive"><LimitExcept></code> et 2441 <code></LimitExcept></code> permettent de regrouper des 2442 directives de contr�le d'acc�s qui s'appliqueront � toutes les 2443 m�thodes d'acc�s HTTP qui ne font <strong>pas</strong> partie de la 2444 liste des arguments ; en d'autres termes, elles ont un comportement 2445 oppos� � celui de la section <code class="directive"><a href="#limit"><Limit></a></code>, et on peut les utiliser pour 2446 contr�ler aussi bien les m�thodes standards que les m�thodes non 2447 standards ou non reconnues. Voir la documentation de la section 2448 <code class="directive"><a href="#limit"><Limit></a></code> pour plus 2449 de d�tails.</p> 2450 2451 <p>Par exemple :</p> 2452 2453 <pre class="prettyprint lang-config"><LimitExcept POST GET> 2454 Require valid-user 2455</LimitExcept></pre> 2456 2457 2458 2459</div> 2460<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2461<div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a name="limitinternalrecursion" id="limitinternalrecursion">Directive</a></h2> 2462<table class="directive"> 2463<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�termine le nombre maximal de redirections internes et de 2464sous-requ�tes imbriqu�es</td></tr> 2465<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitInternalRecursion <var>nombre</var> [<var>nombre</var>]</code></td></tr> 2466<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitInternalRecursion 10</code></td></tr> 2467<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 2468<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2469<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2470</table> 2471 <p>Une redirection interne survient, par exemple, quand on utilise 2472 la directive <code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code> qui 2473 redirige en interne la requ�te d'origine vers un script CGI. Une 2474 sous-requ�te est le m�canisme qu'utilise Apache httpd pour d�terminer ce 2475 qui se passerait pour un URI s'il faisait l'objet d'une requ�te. Par 2476 exemple, <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> utilise les sous-requ�tes pour 2477 rechercher les fichiers list�s dans la directive <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>.</p> 2478 2479 <p>La directive <code class="directive">LimitInternalRecursion</code> permet 2480 d'�viter un crash du serveur d� � un bouclage infini de redirections 2481 internes ou de sous-requ�tes. De tels bouclages sont dus en g�n�ral 2482 � des erreurs de configuration.</p> 2483 2484 <p>La directive accepte, comme arguments, deux limites qui sont 2485 �valu�es � chaque requ�te. Le premier <var>nombre</var> est le 2486 nombre maximum de redirections internes qui peuvent se succ�der. Le 2487 second <var>nombre</var> d�termine la profondeur d'imbrication 2488 maximum des sous-requ�tes. Si vous ne sp�cifiez qu'un seul 2489 <var>nombre</var>, il sera affect� aux deux limites.</p> 2490 2491 <pre class="prettyprint lang-config">LimitInternalRecursion 5</pre> 2492 2493 2494</div> 2495<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2496<div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">Directive</a></h2> 2497<table class="directive"> 2498<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>limite la taille maximale du corps de la requ�te HTTP 2499envoy�e par le client</td></tr> 2500<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestBody <var>octets</var></code></td></tr> 2501<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitRequestBody 0</code></td></tr> 2502<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 2503<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 2504<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2505<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2506</table> 2507 <p>Cette directive sp�cifie la taille maximale autoris�e pour le 2508 corps d'une requ�te ; la valeur de l'argument <var>octets</var> va 2509 de 0 (pour une taille illimit�e), � 2147483647 (2Go). Voir la note 2510 ci-dessous pour la limite d'applicabilit� aux requ�tes mandat�es.</p> 2511 2512 <p>La directive <code class="directive">LimitRequestBody</code> permet de 2513 d�finir une limite pour la taille maximale autoris�e du corps d'une 2514 requ�te HTTP en tenant compte du contexte dans lequel la directive 2515 a �t� plac�e (c'est � dire au niveau du serveur, d'un r�pertoire, 2516 d'un fichier ou d'une localisation). Si la requ�te du client d�passe 2517 cette limite, le serveur r�pondra par un message d'erreur et ne 2518 traitera pas la requ�te. La taille du corps d'une requ�te normale va 2519 varier de mani�re importante en fonction de la nature de la 2520 ressource et des m�thodes autoris�es pour cette derni�re. Les 2521 scripts CGI utilisent souvent le corps du message pour extraire les 2522 informations d'un formulaire. Les impl�mentations de la m�thode 2523 <code>PUT</code> n�cessitent une valeur au moins aussi �lev�e que la 2524 taille maximale des repr�sentations que le serveur d�sire accepter 2525 pour cette ressource.</p> 2526 2527 <p>L'administrateur du serveur peut utiliser cette directive pour 2528 contr�ler plus efficacement les comportements anormaux des requ�tes 2529 des clients, ce qui lui permettra de pr�venir certaines formes 2530 d'attaques par d�ni de service.</p> 2531 2532 <p>Si par exemple, vous autorisez le chargement de fichiers vers une 2533 localisation particuli�re, et souhaitez limiter la taille des 2534 fichiers charg�s � 100Ko, vous pouvez utiliser la directive suivante 2535 :</p> 2536 2537 <pre class="prettyprint lang-config">LimitRequestBody 102400</pre> 2538 2539 2540 <div class="note"><p>Pour une description d�taill�e de la mani�re dont cette 2541 directive est interpr�t�e par les requ�tes mandat�es, voir la 2542 documentation du module <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>.</p> 2543 </div> 2544 2545 2546</div> 2547<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2548<div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">Directive</a></h2> 2549<table class="directive"> 2550<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 2551requ�te HTTP</td></tr> 2552<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFields <var>nombre</var></code></td></tr> 2553<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitRequestFields 100</code></td></tr> 2554<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 2555<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2556<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2557</table> 2558 <p><var>nombre</var> est un entier de 0 (nombre de champs illimit�) 2559 � 32767. La valeur par d�faut est d�finie � la compilation par la 2560 constante <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (100 selon la 2561 distribution).</p> 2562 2563 <p>La directive <code class="directive">LimitRequestFields</code> permet � 2564 l'administrateur du serveur de modifier le nombre maximum de champs 2565 d'en-t�te autoris�s dans une requ�te HTTP. Pour un serveur, cette 2566 valeur doit �tre sup�rieure au nombre de champs qu'une requ�te 2567 client normale peut contenir. Le nombre de champs d'en-t�te d'une 2568 requ�te qu'un client utilise d�passe rarement 20, mais ce nombre 2569 peut varier selon les impl�mentations des clients, et souvent en 2570 fonction des extensions que les utilisateurs configurent dans leurs 2571 navigateurs pour supporter la n�gociation de contenu d�taill�e. Les 2572 extensions HTTP optionnelles utilisent souvent les 2573 champs d'en-t�te des requ�tes.</p> 2574 2575 <p>L'administrateur du serveur peut utiliser cette directive pour 2576 contr�ler plus efficacement les comportements anormaux des requ�tes 2577 des clients, ce qui lui permettra de pr�venir certaines formes 2578 d'attaques par d�ni de service. La valeur sp�cifi�e doit �tre 2579 augment�e si les clients standards re�oivent une erreur du serveur 2580 indiquant que la requ�te comportait un nombre d'en-t�tes trop 2581 important.</p> 2582 2583 <p>Par exemple :</p> 2584 2585 <pre class="prettyprint lang-config">LimitRequestFields 50</pre> 2586 2587 2588 <div class="warning"><h3>Avertissement</h3> 2589 <p>Dans le cas des serveurs virtuels � base de noms, la valeur de 2590 cette directive est extraite du serveur virtuel par d�faut (le 2591 premier de la liste) pour la paire adresse IP/port.</p> 2592 </div> 2593 2594 2595</div> 2596<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2597<div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">Directive</a></h2> 2598<table class="directive"> 2599<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 2600requ�te HTTP</td></tr> 2601<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFieldSize <var>octets</var></code></td></tr> 2602<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitRequestFieldSize 8190</code></td></tr> 2603<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 2604<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2605<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2606</table> 2607 <p>Cette directive permet de d�finir le nombre maximum 2608 d'<var>octets</var> autoris�s dans un en-t�te de requ�te HTTP.</p> 2609 2610 <p>La directive <code class="directive">LimitRequestFieldSize</code> permet 2611 � l'administrateur du serveur de d�finir la taille 2612 maximale autoris�e d'un en-t�te de requ�te HTTP. Pour un serveur, 2613 cette valeur doit �tre suffisamment grande pour contenir tout 2614 en-t�te d'une requ�te client normale. La taille d'un champ d'en-t�te 2615 de requ�te normal va varier selon les impl�mentations des clients, 2616 et en fonction des extensions que les utilisateurs 2617 configurent dans leurs navigateurs pour supporter la n�gociation de 2618 contenu d�taill�e. Les en-t�tes d'authentification SPNEGO peuvent 2619 atteindre une taille de 12392 octets.</p> 2620 2621 <p>>L'administrateur du serveur peut utiliser cette directive pour 2622 contr�ler plus efficacement les comportements anormaux des requ�tes 2623 des clients, ce qui lui permettra de pr�venir certaines formes 2624 d'attaques par d�ni de service.</p> 2625 2626 <p>Par exemple ::</p> 2627 2628 <pre class="prettyprint lang-config">LimitRequestFieldSize 4094</pre> 2629 2630 2631 <div class="note">Dans des conditions normales, la valeur par d�faut de cette 2632 directive ne doit pas �tre modifi�e.</div> 2633 2634 <div class="warning"><h3>Avertissement</h3> 2635 <p>Dans le cas des serveurs virtuels � base de noms, la valeur de 2636 cette directive est extraite du serveur virtuel par d�faut (le 2637 premier de la liste) pour lequel la paire adresse IP/port 2638 correspond le mieux.</p> 2639 </div> 2640 2641</div> 2642<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2643<div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">Directive</a></h2> 2644<table class="directive"> 2645<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit la taille maximale d'une ligne de requ�te 2646HTTP</td></tr> 2647<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestLine <var>octets</var></code></td></tr> 2648<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitRequestLine 8190</code></td></tr> 2649<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 2650<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2651<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2652</table> 2653 <p>Cette directive permet de d�finir la taille maximale autoris�e 2654 pour une ligne de requ�te HTTP en <var>octets</var>.</p> 2655 2656 <p>La directive <code class="directive">LimitRequestLine</code> permet � 2657 l'administrateur du serveur de d�finir la taille 2658 maximale autoris�e d'une ligne de requ�te HTTP client. Comme une 2659 requ�te comporte une m�thode HTTP, un URI, et une version de 2660 protocole, la directive <code class="directive">LimitRequestLine</code> 2661 impose une restriction sur la longueur maximale autoris�e pour un 2662 URI dans une requ�te au niveau du serveur. Pour un serveur, cette 2663 valeur doit �tre suffisamment grande pour r�f�rencer les noms de 2664 toutes ses ressources, y compris toutes informations pouvant �tre 2665 ajout�es dans la partie requ�te d'une m�thode <code>GET</code>.</p> 2666 2667 <p>L'administrateur du serveur peut utiliser cette directive pour 2668 contr�ler plus efficacement les comportements anormaux des requ�tes 2669 des clients, ce qui lui permettra de pr�venir certaines formes 2670 d'attaques par d�ni de service.</p> 2671 2672 <p>Par exemple :</p> 2673 2674 <pre class="prettyprint lang-config">LimitRequestLine 4094</pre> 2675 2676 2677 <div class="note">Dans des conditions normales, la valeur par d�faut de cette 2678 directive ne doit pas �tre modifi�e. En outre, vous ne 2679 pouvez pas sp�cifier une valeur sup�rieure � 8190 sans modifier le 2680 code source et recompiler.</div> 2681 2682 <div class="warning"><h3>Avertissement</h3> 2683 <p>Dans le cas des serveurs virtuels � base de noms, la valeur de 2684 cette directive est extraite du serveur virtuel par d�faut (le 2685 premier de la liste) pour lequel la paire adresse IP/port 2686 correspond le mieux.</p> 2687 </div> 2688 2689 2690</div> 2691<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2692<div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a></h2> 2693<table class="directive"> 2694<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 2695XML</td></tr> 2696<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitXMLRequestBody <var>octets</var></code></td></tr> 2697<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr> 2698<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 2699<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 2700<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2701<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2702</table> 2703 <p>Taille maximale (en octets) du corps d'une requ�te au format XML. 2704 Une valeur de <code>0</code> signifie qu'aucune limite n'est 2705 impos�e.</p> 2706 2707 <p>Exemple :</p> 2708 2709 <pre class="prettyprint lang-config">LimitXMLRequestBody 0</pre> 2710 2711 2712 2713</div> 2714<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2715<div class="directive-section"><h2><a name="Location" id="Location"><Location></a> <a name="location" id="location">Directive</a></h2> 2716<table class="directive"> 2717<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'applique les directives contenues qu'aux URLs 2718sp�cifi�es</td></tr> 2719<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Location 2720 <var>chemin URL</var>|<var>URL</var>> ... </Location></code></td></tr> 2721<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 2722<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2723<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2724</table> 2725 <p>La directive <code class="directive"><Location></code> 2726 limite la port�e des directives contenues aux URLs d�finies par 2727 l'argument URL. Elle est similaire � la directive <code class="directive"><a href="#directory"><Directory></a></code>, et marque le 2728 d�but d'une section qui se termine par une directive 2729 <code></Location></code>. Les sections <code class="directive"><Location></code> sont trait�es selon l'ordre dans 2730 lequel elles apparaissent dans le fichier de configuration, mais 2731 apr�s les sections <code class="directive"><a href="#directory"><Directory></a></code> et la lecture des 2732 fichiers <code>.htaccess</code>, et apr�s les sections <code class="directive"><a href="#files"><Files></a></code>.</p> 2733 2734 <p>Les sections <code class="directive"><Location></code> 2735 agissent compl�tement en dehors du syst�me de fichiers. Ceci a de 2736 nombreuses cons�quences. Parmi les plus importantes, on ne doit pas 2737 utiliser les sections <code class="directive"><Location></code> 2738 pour contr�ler l'acc�s aux r�pertoires du syst�me de fichiers. Comme 2739 plusieurs URLs peuvent correspondre au m�me r�pertoire du syst�me de 2740 fichiers, un tel contr�le d'acc�s pourrait �tre contourn�.</p> 2741 2742 <p>Les directives que contient cette section seront appliqu�es aux 2743 requ�tes si la partie chemin de l'URL satisfait � l'un au moins de 2744 ces crit�res : 2745 </p> 2746 <ul> 2747 <li>Le chemin sp�cifi� correspond exactement � la partie chemin de 2748 l'URL. 2749 </li> 2750 <li>Le chemin sp�cifi�, qui se termine par un slash, est un 2751 pr�fixe de la partie chemin de l'URL (trait� comme une racine du 2752 contexte). 2753 </li> 2754 <li>Le chemin sp�cifi�, si on lui ajoute un slash de fin, est un 2755 pr�fixe de la partie chemin de l'URL (aussi trait� comme une racine du 2756 contexte). 2757 </li> 2758 </ul> 2759 <p> 2760 Dans l'exemple ci-dessous, o� aucun slash de fin n'est utilis�, les 2761 directives contenues dans la section s'appliqueront � /private1, 2762 /private1/ et /private1/file.txt, mais pas � /private1other. 2763 </p> 2764 <pre class="prettyprint lang-config"><Location /private1> 2765 # ... 2766</Location></pre> 2767 2768 <p> 2769 De m�me, dans l'exemple ci-dessous, o� l'on utilise un slash de fin, les 2770 directives contenues dans la section s'appliqueront � /private2/ et 2771 � /private2/file.txt, mais pas � /private2other. 2772 </p> 2773 <pre class="prettyprint lang-config"><Location /private2<em>/</em>> 2774 # ... 2775</Location></pre> 2776 2777 2778 <div class="note"><h3>Quand utiliser la section <code class="directive"><Location></code></h3> 2779 2780 <p>Vous pouvez utiliser une section <code class="directive"><Location></code> pour appliquer des directives � 2781 des contenus situ�s en dehors du syst�me de fichiers. Pour les 2782 contenus situ�s � l'int�rieur du syst�me de fichiers, utilisez 2783 plut�t les sections <code class="directive"><a href="#directory"><Directory></a></code> et <code class="directive"><a href="#files"><Files></a></code>. <code><Location 2784 /></code> constitue une exception et permet d'appliquer ais�ment 2785 une configuration � l'ensemble du serveur.</p> 2786 </div> 2787 2788 <p>Pour toutes les requ�tes originales (non mandat�es), l'argument 2789 URL est un chemin d'URL de la forme 2790 <code>/chemin/</code>. <em>Aucun protocole, nom d'h�te, port, ou cha�ne 2791 de requ�te ne doivent appara�tre.</em> Pour les requ�tes mandat�es, l'URL 2792 sp�cifi�e doit �tre de la forme 2793 <code>protocole://nom_serveur/chemin</code>, et vous devez inclure 2794 le pr�fixe.</p> 2795 2796 <p>L'URL peut contenir des caract�res g�n�riques. Dans une cha�ne 2797 avec caract�res g�n�riques, <code>?</code> correspond � un caract�re 2798 quelconque, et <code>*</code> � toute cha�ne de caract�res. Les 2799 caract�res g�n�riques ne peuvent pas remplacer un / dans le chemin 2800 URL.</p> 2801 2802 <p>On peut aussi utiliser les <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">Expressions 2803 rationnelles</a>, moyennant l'addition d'un caract�re 2804 <code>~</code>. Par exemple :</p> 2805 2806 <pre class="prettyprint lang-config"><Location ~ "/(extra|special)/data"> 2807 #... 2808</Location></pre> 2809 2810 2811 <p>concernerait les URLs contenant les sous-cha�ne 2812 <code>/extra/data</code> ou <code>/special/data</code>. La directive 2813 <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> 2814 pr�sente un comportement identique � la version avec expressions 2815 rationnelles de la directive <code class="directive"><Location></code>, et son utilisation est 2816 pr�f�rable � l'utilisation de cette derni�re pour la simple raison 2817 qu'il est difficile de distinguer <code>~</code> de <code>-</code> 2818 dans la plupart des fontes.</p> 2819 2820 <p>La directive <code class="directive"><Location></code> 2821 s'utilise principalement avec la directive <code class="directive"><a href="#sethandler">SetHandler</a></code>. Par exemple, pour activer les 2822 requ�tes d'�tat, mais ne les autoriser que depuis des navigateurs 2823 appartenant au domaine <code>example.com</code>, vous pouvez 2824 utiliser :</p> 2825 2826 <pre class="prettyprint lang-config"><Location /status> 2827 SetHandler server-status 2828 Require host example.com 2829</Location></pre> 2830 2831 2832 <div class="note"><h3>Note � propos du slash (/)</h3> 2833 <p>La signification du caract�re slash d�pend de l'endroit o� il 2834 se trouve dans l'URL. Les utilisateurs peuvent �tre habitu�s � 2835 son comportement dans le syst�me de fichiers o� plusieurs slashes 2836 successifs sont souvent r�duits � un slash unique (en d'autres 2837 termes, <code>/home///foo</code> est identique � 2838 <code>/home/foo</code>). Dans l'espace de nommage des URLs, ce 2839 n'est cependant pas toujours le cas. Pour la directive <code class="directive"><a href="#locationmatch"><LocationMatch></a></code> et la 2840 version avec expressions rationnelles de la directive <code class="directive"><Location></code>, vous devez sp�cifier 2841 explicitement les slashes multiples si telle est votre 2842 intention.</p> 2843 2844 <p>Par exemple, <code><LocationMatch ^/abc></code> va 2845 correspondre � l'URL <code>/abc</code> mais pas � l'URL <code> 2846 //abc</code>. La directive <code class="directive"><Location></code> sans expression rationnelle se comporte de 2847 la m�me mani�re lorsqu'elle est utilis�e pour des requ�tes 2848 mandat�es. Par contre, lorsque la directive <code class="directive"><Location></code> sans expression rationnelle 2849 est utilis�e pour des requ�tes non mandat�es, elle fera 2850 correspondre implicitement les slashes multiples � des slashes 2851 uniques. Par exemple, si vous sp�cifiez <code><Location 2852 /abc/def></code>, une requ�te de la forme 2853 <code>/abc//def</code> correspondra.</p> 2854 </div> 2855 2856<h3>Voir aussi</h3> 2857<ul> 2858<li><a href="/sections.html">Comment fonctionnent les sections 2859<Directory>, <Location> et <Files></a> pour une 2860explication de la mani�re dont ces diff�rentes sections se combinent 2861entre elles � la r�ception d'une requ�te.</li> 2862</ul> 2863</div> 2864<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2865<div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch"><LocationMatch></a> <a name="locationmatch" id="locationmatch">Directive</a></h2> 2866<table class="directive"> 2867<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'applique les directives contenues qu'aux URLs 2868correspondant � une expression rationnelle</td></tr> 2869<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><LocationMatch 2870 <var>regex</var>> ... </LocationMatch></code></td></tr> 2871<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 2872<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2873<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2874</table> 2875 <p>La directive <code class="directive"><LocationMatch></code> 2876 limite la port�e des directives contenues � l'URL sp�cifi�e, de 2877 mani�re identique � la directive <code class="directive"><a href="#location"><Location></a></code>. Mais son argument permettant de 2878 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 2879 cha�ne de caract�res. Par exemple :</p> 2880 2881 <pre class="prettyprint lang-config"><LocationMatch "/(extra|special)/data"> 2882 # ... 2883</LocationMatch></pre> 2884 2885 2886 <p>correspondrait � toute URL contenant les sous-cha�nes 2887 <code>/extra/data</code> ou <code>/special/data</code>.</p> 2888 2889 <p>A partir de la version 2.4.8, les groupes nomm�s et les 2890 r�f�rences arri�res sont extraits et enregistr�s dans 2891 l'environnement avec leur nom en majuscules et pr�fix� 2892 par "MATCH_". Ceci permet 2893 de r�f�rencer des URLs dans des <a href="/expr.html">expressions</a> 2894 ou au sein de modules comme <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>. Pour 2895 �viter toute confusion, les r�f�rences arri�res num�rot�es (non 2896 nomm�es) sont ignor�es. Vous devez utiliser � la place des groupes 2897 nomm�s.</p> 2898 2899<pre class="prettyprint lang-config"><LocationMatch ^/combined/(?<sitename>[^/]+)> 2900 require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example 2901</LocationMatch></pre> 2902 2903 2904 2905<h3>Voir aussi</h3> 2906<ul> 2907<li><a href="/sections.html">Comment fonctionnent les sections 2908<Directory>, <Location> et <Files></a> pour une 2909explication de la mani�re dont ces diff�rentes sections se combinent 2910entre elles � la r�ception d'une requ�te.</li> 2911</ul> 2912</div> 2913<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 2914<div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">Directive</a></h2> 2915<table class="directive"> 2916<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contr�le la verbosit� du journal des erreurs</td></tr> 2917<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogLevel [<var>module</var>:]<var>niveau</var> 2918 [<var>module</var>:<var>niveau</var>] ... 2919</code></td></tr> 2920<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LogLevel warn</code></td></tr> 2921<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 2922<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 2923<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 2924<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>La configuration du niveau de journalisation par module 2925et par r�pertoire est disponible depuis la version 2.3.6 du serveur HTTP 2926Apache</td></tr> 2927</table> 2928 <p>La directive <code class="directive">LogLevel</code> permet d'ajuster la 2929 verbosit� des messages enregistr�s dans les journaux d'erreur (voir 2930 la directive <code class="directive"><a href="#errorlog">ErrorLog</a></code> 2931 directive). Les <var>niveau</var>x disponibles sont pr�sent�s 2932 ci-apr�s, par ordre de criticit� d�croissante :</p> 2933 2934 <table class="bordered"> 2935 2936 <tr> 2937 <th><strong>Niveau</strong> </th> 2938 2939 <th><strong>Description</strong> </th> 2940 2941 <th><strong>Exemple</strong> </th> 2942 </tr> 2943 2944 <tr> 2945 <td><code>emerg</code> </td> 2946 2947 <td>Urgences - le syst�me est inutilisable.</td> 2948 2949 <td>"Child cannot open lock file. Exiting"</td> 2950 </tr> 2951 2952 <tr> 2953 <td><code>alert</code> </td> 2954 2955 <td>Des mesures doivent �tre prises imm�diatement.</td> 2956 2957 <td>"getpwuid: couldn't determine user name from uid"</td> 2958 </tr> 2959 2960 <tr> 2961 <td><code>crit</code> </td> 2962 2963 <td>Conditions critiques.</td> 2964 2965 <td>"socket: Failed to get a socket, exiting child"</td> 2966 </tr> 2967 2968 <tr> 2969 <td><code>error</code> </td> 2970 2971 <td>Erreurs.</td> 2972 2973 <td>"Premature end of script headers"</td> 2974 </tr> 2975 2976 <tr> 2977 <td><code>warn</code> </td> 2978 2979 <td>Avertissements.</td> 2980 2981 <td>"child process 1234 did not exit, sending another 2982 SIGHUP"</td> 2983 </tr> 2984 2985 <tr> 2986 <td><code>notice</code> </td> 2987 2988 <td>Ev�nement important mais normal.</td> 2989 2990 <td>"httpd: caught SIGBUS, attempting to dump core in 2991 ..."</td> 2992 </tr> 2993 2994 <tr> 2995 <td><code>info</code> </td> 2996 2997 <td>Informations.</td> 2998 2999 <td>"Server seems busy, (you may need to increase 3000 StartServers, or Min/MaxSpareServers)..."</td> 3001 </tr> 3002 3003 <tr> 3004 <td><code>debug</code> </td> 3005 3006 <td>Messages de d�bogage.</td> 3007 3008 <td>"Opening config file ..."</td> 3009 </tr> 3010 <tr> 3011 <td><code>trace1</code> </td> 3012 3013 <td>Messages de traces</td> 3014 3015 <td>"proxy: FTP: control connection complete"</td> 3016 </tr> 3017 <tr> 3018 <td><code>trace2</code> </td> 3019 3020 <td>Messages de traces</td> 3021 3022 <td>"proxy: CONNECT: sending the CONNECT request to the remote proxy"</td> 3023 </tr> 3024 <tr> 3025 <td><code>trace3</code> </td> 3026 3027 <td>Messages de traces</td> 3028 3029 <td>"openssl: Handshake: start"</td> 3030 </tr> 3031 <tr> 3032 <td><code>trace4</code> </td> 3033 3034 <td>Messages de traces</td> 3035 3036 <td>"read from buffered SSL brigade, mode 0, 17 bytes"</td> 3037 </tr> 3038 <tr> 3039 <td><code>trace5</code> </td> 3040 3041 <td>Messages de traces</td> 3042 3043 <td>"map lookup FAILED: map=rewritemap key=keyname"</td> 3044 </tr> 3045 <tr> 3046 <td><code>trace6</code> </td> 3047 3048 <td>Messages de traces</td> 3049 3050 <td>"cache lookup FAILED, forcing new map lookup"</td> 3051 </tr> 3052 <tr> 3053 <td><code>trace7</code> </td> 3054 3055 <td>Messages de traces, enregistrement d'une grande quantit� de 3056 donn�es</td> 3057 3058 <td>"| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |"</td> 3059 </tr> 3060 <tr> 3061 <td><code>trace8</code> </td> 3062 3063 <td>Messages de traces, enregistrement d'une grande quantit� de 3064 donn�es</td> 3065 3066 <td>"| 0000: 02 23 44 30 13 40 ac 34 df 3d bf 9a 19 49 39 15 |"</td> 3067 </tr> 3068 </table> 3069 3070 <p>Lorsqu'un niveau particulier est sp�cifi�, les messages de tous 3071 les autres niveaux de criticit� sup�rieure seront aussi enregistr�s. 3072 <em>Par exemple</em>, si <code>LogLevel info</code> est sp�cifi�, 3073 les messages de niveaux <code>notice</code> et <code>warn</code> 3074 seront aussi �mis.</p> 3075 3076 <p>Il est recommand� d'utiliser un niveau <code>crit</code> ou 3077 inf�rieur.</p> 3078 3079 <p>Par exemple :</p> 3080 3081 <pre class="prettyprint lang-config">LogLevel notice</pre> 3082 3083 3084 <div class="note"><h3>Note</h3> 3085 <p>Si la journalisation s'effectue directement dans un fichier, 3086 les messages de niveau <code>notice</code> ne peuvent pas �tre 3087 supprim�s et sont donc toujours journalis�s. Cependant, ceci ne 3088 s'applique pas lorsque la journalisation s'effectue vers 3089 <code>syslog</code>.</p> 3090 </div> 3091 3092 <p>Sp�cifier un niveau sans nom de module va attribuer ce niveau � 3093 tous les modules. Sp�cifier un niveau avec nom de module va 3094 attribuer ce niveau � ce module seulement. Il est possible de 3095 sp�cifier un module par le nom de son fichier source ou par son 3096 identificateur, avec ou sans le suffixe <code>_module</code>. Les 3097 trois sp�cifications suivantes sont donc �quivalentes :</p> 3098 3099 <pre class="prettyprint lang-config">LogLevel info ssl:warn 3100LogLevel info mod_ssl.c:warn 3101LogLevel info ssl_module:warn</pre> 3102 3103 3104 <p>Il est aussi possible d'attribuer un niveau de journalisation par 3105 r�pertoire :</p> 3106 3107 <pre class="prettyprint lang-config">LogLevel info 3108<Directory "/usr/local/apache/htdocs/app"> 3109 LogLevel debug 3110</Directory></pre> 3111 3112 3113 <div class="note"> 3114 La configuration du niveau de journalisation par r�pertoire 3115 n'affecte que les messages journalis�s apr�s l'interpr�tation de 3116 la requ�te et qui sont associ�s � cette derni�re. Les messages 3117 de journalisation associ�s � la connexion ou au serveur ne sont 3118 pas affect�s. 3119 </div> 3120 3121<h3>Voir aussi</h3> 3122<ul> 3123<li><code class="directive"><a href="#errorlog">ErrorLog</a></code></li> 3124<li><code class="directive"><a href="#errorlogformat">ErrorLogFormat</a></code></li> 3125<li><a href="/logs.html">Journaux du serveur HTTP Apache</a></li> 3126</ul> 3127</div> 3128<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3129<div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a name="maxkeepaliverequests" id="maxkeepaliverequests">Directive</a></h2> 3130<table class="directive"> 3131<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de requ�tes permises pour une connexion 3132persistante</td></tr> 3133<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxKeepAliveRequests <var>nombre</var></code></td></tr> 3134<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr> 3135<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 3136<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3137<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3138</table> 3139 <p>La directive <code class="directive">MaxKeepAliveRequests</code> permet 3140 de limiter le nombre de requ�tes autoris�es par connexion lorsque 3141 <code class="directive"><a href="#keepalive">KeepAlive</a></code> est � "on". Si sa 3142 valeur est <code>0</code>, le nombre de requ�tes autoris�es est 3143 illimit�. Il est recommand� de d�finir une valeur assez haute pour 3144 des performances du serveur maximales.</p> 3145 3146 <p>Par exemple :</p> 3147 3148 <pre class="prettyprint lang-config">MaxKeepAliveRequests 500</pre> 3149 3150 3151</div> 3152<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3153<div class="directive-section"><h2><a name="MaxRangeOverlaps" id="MaxRangeOverlaps">MaxRangeOverlaps</a> <a name="maxrangeoverlaps" id="maxrangeoverlaps">Directive</a></h2> 3154<table class="directive"> 3155<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de chevauchements de segments de donn�es autoris� 3156 (par exemple <code>100-200,150-300</code>) avant le renvoi de la 3157 ressource compl�te</td></tr> 3158<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRangeOverlaps default | unlimited | none | <var>nombre de 3159 chevauchements</var></code></td></tr> 3160<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>MaxRangeOverlaps 20</code></td></tr> 3161<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 3162<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3163<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3164<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.15 du serveur HTTP 3165 Apache</td></tr> 3166</table> 3167 <p>La directive <code class="directive">MaxRangeOverlaps</code> permet 3168 de limiter le nombre de chevauchements de segments de donn�es HTTP 3169 autoris� par le serveur. Si le nombre de 3170 chevauchements de segments demand� est sup�rieur au nombre maximal 3171 autoris�, la ressource sera renvoy�e dans son int�gralit�.</p> 3172 3173 <dl> 3174 <dt><strong>default</strong></dt> 3175 <dd>Limite le nombre de chevauchements de segments � la valeur 3176 par d�faut 20 d�finie � la compilation.</dd> 3177 3178 <dt><strong>none</strong></dt> 3179 <dd>Aucun chevauchement de segment n'est autoris�.</dd> 3180 3181 <dt><strong>unlimited</strong></dt> 3182 <dd>Le nombre de chevauchements de segments est illimit�.</dd> 3183 3184 <dt><var>number-of-ranges</var></dt> 3185 <dd>Un nombre positif repr�sente le nombre maximal de 3186 chevauchements de segments autoris� par le serveur.</dd> 3187 </dl> 3188 3189</div> 3190<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3191<div class="directive-section"><h2><a name="MaxRangeReversals" id="MaxRangeReversals">MaxRangeReversals</a> <a name="maxrangereversals" id="maxrangereversals">Directive</a></h2> 3192<table class="directive"> 3193<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre d'inversions d'ordre autoris� dans la sp�cification des 3194 segments de donn�es (par exemple <code>100-200,50-70</code>) avant le renvoi de la 3195 ressource compl�te</td></tr> 3196<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxRangeReversals default | unlimited | none | <var>nombre 3197 d'inversions</var></code></td></tr> 3198<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>MaxRangeReversals 20</code></td></tr> 3199<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 3200<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3201<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3202<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.15 du serveur HTTP 3203 Apache</td></tr> 3204</table> 3205 <p>La directive <code class="directive">MaxRangeReversals</code> permet 3206 de limiter le nombre d'inversions d'ordre dans la sp�cification 3207 des segments de donn�es HTTP 3208 autoris� par le serveur. Si le nombre 3209 d'inversions demand� est sup�rieur au nombre maximal 3210 autoris�, la ressource sera renvoy�e dans son int�gralit�.</p> 3211 3212 <dl> 3213 <dt><strong>default</strong></dt> 3214 <dd>Limite le nombre d'inversions � la valeur 3215 par d�faut 20 d�finie � la compilation.</dd> 3216 3217 <dt><strong>none</strong></dt> 3218 <dd>Aucune inversion n'est autoris�e.</dd> 3219 3220 <dt><strong>unlimited</strong></dt> 3221 <dd>Le nombre d'inversions est illimit�.</dd> 3222 3223 <dt><var>number-of-ranges</var></dt> 3224 <dd>Un nombre positif repr�sente le nombre maximal 3225 d'inversions autoris� par le serveur.</dd> 3226 </dl> 3227 3228</div> 3229<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3230<div class="directive-section"><h2><a name="MaxRanges" id="MaxRanges">MaxRanges</a> <a name="maxranges" id="maxranges">Directive</a></h2> 3231<table class="directive"> 3232<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de segments de donn�es autoris� avant le renvoi de 3233l'int�gralit� de la ressource</td></tr> 3234<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> 3235<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>MaxRanges 200</code></td></tr> 3236<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 3237<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3238<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3239<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.15 du serveur HTTP 3240Apache</td></tr> 3241</table> 3242 <p>La directive <code class="directive">MaxRanges</code> permet de limiter 3243 le nombre de segments de donn�es que le serveur va renvoyer au 3244 client. Si un nombre de segments plus important est demand�, la 3245 ressource sera renvoy�e dans son int�gralit�.</p> 3246 3247 <dl> 3248 <dt><strong>default</strong></dt> 3249 <dd>Limite le nombre de segments de donn�es � 200 (valeur par 3250 d�faut d�finie � la compilation).</dd> 3251 3252 <dt><strong>none</strong></dt> 3253 <dd>Les en-t�tes Range sont ignor�s.</dd> 3254 3255 <dt><strong>unlimited</strong></dt> 3256 <dd>Le nombre de segments de donn�es est illimit�.</dd> 3257 3258 <dt><var>nombre de segments</var></dt> 3259 <dd>Un nombre positif repr�sentera la nombre de segments de 3260 donn�es maximal que le serveur renverra au client.</dd> 3261 </dl> 3262 3263</div> 3264<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3265<div class="directive-section"><h2><a name="Mutex" id="Mutex">Mutex</a> <a name="mutex" id="mutex">Directive</a></h2> 3266<table class="directive"> 3267<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit les m�canismes de mutex et le repertoire du fichier 3268verrou pour tous les mutex ou seulement les mutex sp�cifi�s</td></tr> 3269<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> 3270<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Mutex default</code></td></tr> 3271<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 3272<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3273<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3274<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> 3275</table> 3276 <p>La directive <code class="directive">Mutex</code> permet de d�finir le 3277 m�canisme de mutex, et �ventuellement le r�pertoire du fichier 3278 verrou que les modules et httpd utilisent pour s�rialiser l'acc�s aux 3279 ressources. Sp�cifiez <code>default</code> comme premier argument 3280 pour modifier la configuration de tous les mutex ; sp�cifiez un nom 3281 de mutex (voir la table ci-dessous) comme premier argument pour 3282 ne modifier que la configuration de ce mutex.</p> 3283 3284 <p>La directive <code class="directive">Mutex</code> est typiquement 3285 utilis�e dans les situations exceptionnelles suivantes :</p> 3286 3287 <ul> 3288 <li>choix d'un autre m�canisme de mutex lorsque le m�canisme par 3289 d�faut s�lectionn� par <a class="glossarylink" href="/glossary.html#apr" title="voir glossaire">APR</a> pr�sente un 3290 probl�me de fonctionnement ou de performances.</li> 3291 3292 <li>choix d'un autre r�pertoire utilis� par les mutex � base de 3293 fichier lorsque le r�pertoire par d�faut ne supporte pas le 3294 verrouillage</li> 3295 </ul> 3296 3297 <div class="note"><h3>Modules support�s</h3> 3298 <p>Cette directive ne configure que les mutex qui ont �t� 3299 enregistr�s avec le serveur de base via l'API 3300 <code>ap_mutex_register()</code>. Tous les modules fournis avec 3301 httpd supportent la directive <code class="directive">Mutex</code>, mais il 3302 n'en sera pas forc�ment de m�me pour les modules tiers. 3303 Reportez-vous � la documentation du module tiers consid�r� afin de 3304 d�terminer le(s) nom(s) de mutex qui pourront �tre d�finis si la 3305 directive est support�e.</p> 3306 </div> 3307 3308 3309 3310 <p>Les <em>m�canismes</em> de mutex disponibles sont les suivants :</p> 3311 <ul> 3312 <li><code>default | yes</code> 3313 <p>C'est l'impl�mentation du verrouillage par d�faut, telle 3314 qu'elle est d�finie par <a class="glossarylink" href="/glossary.html#apr" title="voir glossaire">APR</a>. On peut 3315 afficher l'impl�mentation du verrouillage par d�faut via la 3316 commande <code class="program"><a href="/programs/httpd.html">httpd</a></code> avec l'option <code>-V</code>.</p></li> 3317 3318 <li><code>none | no</code> 3319 <p>Le mutex est d�sactiv�, et cette valeur n'est permise pour un 3320 mutex que si le module indique qu'il s'agit d'un choix valide. 3321 Consultez la documentation du module pour plus d'informations.</p></li> 3322 3323 <li><code>posixsem</code> 3324 <p>Une variante de mutex bas�e sur un s�maphore Posix.</p> 3325 3326 <div class="warning"><h3>Avertissement</h3> 3327 <p>La propri�t� du s�maphore n'est pas restitu�e si un thread du 3328 processus g�rant le mutex provoque une erreur de segmentation, 3329 ce qui provoquera un blocage du serveur web.</p> 3330 </div> 3331 </li> 3332 3333 <li><code>sysvsem</code> 3334 <p>Une variante de mutex bas�e sur un s�maphore IPC SystemV.</p> 3335 3336 <div class="warning"><h3>Avertissement</h3> 3337 <p>Il peut arriver que les s�maphores SysV soient conserv�s si le 3338 processus se crashe avant que le s�maphore ne soit supprim�.</p> 3339 </div> 3340 3341 <div class="warning"><h3>S�curit�</h3> 3342 <p>L'API des s�maphores permet les attaques par d�ni de service 3343 par tout programme CGI s'ex�cutant sous le m�me uid que le 3344 serveur web (autrement dit tous les programmes CGI, � moins que 3345 vous n'utilisiez un programme du style <code class="program"><a href="/programs/suexec.html">suexec</a></code> 3346 ou <code>cgiwrapper</code>).</p> 3347 </div> 3348 </li> 3349 3350 <li><code>sem</code> 3351 <p>S�lection de la "meilleure" impl�mentation des s�maphores 3352 disponible ; le choix s'effectue entre les s�maphores posix et 3353 IPC SystemV, dans cet ordre.</p></li> 3354 3355 <li><code>pthread</code> 3356 <p>Une variante de mutex � base de mutex de thread Posix 3357 inter-processus.</p> 3358 3359 <div class="warning"><h3>Avertissement</h3> 3360 <p>Sur la plupart des syst�mes, si un processus enfant se 3361 termine anormalement alors qu'il d�tenait un mutex qui utilise 3362 cette impl�mentation, le serveur va se bloquer et cesser de 3363 r�pondre aux requ�tes. Dans ce cas, un red�marrage manuel est 3364 n�cessaire pour r�cup�rer le mutex.</p> 3365 <p>Solaris constitue une exception notable, en ceci qu'il fournit 3366 un m�canisme qui permet en g�n�ral de r�cup�rer le mutex apr�s 3367 l'arr�t anormal d'un processus enfant qui d�tenait le mutex.</p> 3368 <p>Si votre syst�me impl�mente la fonction 3369 <code>pthread_mutexattr_setrobust_np()</code>, vous devriez 3370 pouvoir utiliser l'option <code>pthread</code> sans probl�me.</p> 3371 </div> 3372 </li> 3373 3374 <li><code>fcntl:/chemin/vers/mutex</code> 3375 <p>Une variante de mutex utilisant un fichier verrou physique et 3376 la fonction <code>fcntl()</code>.</p> 3377 3378 <div class="warning"><h3>Avertissement</h3> 3379 <p>Lorsqu'on utilise plusieurs mutex bas�s sur ce m�canisme dans 3380 un environnement multi-processus, multi-thread, des erreurs de 3381 blocage (EDEADLK) peuvent �tre rapport�es pour des op�rations de 3382 mutex valides si la fonction <code>fcntl()</code> ne g�re pas 3383 les threads, comme sous Solaris.</p> 3384 </div> 3385 </li> 3386 3387 <li><code>flock:/chemin/vers/mutex</code> 3388 <p>M�thode similaire � <code>fcntl:/chemin/vers/mutex</code>, 3389 mais c'est la fonction <code>flock()</code> qui est utilis�e 3390 pour g�rer le verrouillage par fichier.</p></li> 3391 3392 <li><code>file:/chemin/vers/mutex</code> 3393 <p>S�lection de la "meilleure" impl�mentation de verrouillage 3394 par fichier disponible ; le choix s'effectue entre 3395 <code>fcntl</code> et <code>flock</code>, dans cet ordre.</p></li> 3396 </ul> 3397 3398 <p>La plupart des m�canismes ne sont disponibles que sur les 3399 plate-formes o� ces derni�res et <a class="glossarylink" href="/glossary.html#apr" title="voir glossaire">APR</a> les 3400 supportent. Les m�canismes qui ne sont pas disponibles sur toutes 3401 les plate-formes sont <em>posixsem</em>, 3402 <em>sysvsem</em>, <em>sem</em>, <em>pthread</em>, <em>fcntl</em>, 3403 <em>flock</em>, et <em>file</em>.</p> 3404 3405 <p>Avec les m�canismes � base de fichier <em>fcntl</em> et 3406 <em>flock</em>, le chemin, s'il est fourni, est un r�pertoire dans 3407 lequel le fichier verrou sera cr��. Le r�pertoire par 3408 d�faut est le r�pertoire d'ex�cution de httpd relatif � la 3409 directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>. 3410 Utilisez toujours un syst�me 3411 de fichiers local sur disque pour <code>/chemin/vers/mutex</code> et 3412 jamais un r�pertoire se trouvant dans un syst�me de fichiers NFS ou 3413 AFS. Le nom de base du fichier se composera du type de mutex, d'une 3414 cha�ne optionnelle correspondant � l'instance et fournie par le 3415 module ; et, sauf si le mot-cl� <code>OmitPID</code> a �t� sp�cifi�, 3416 l'identificateur du processus parent httpd sera ajout� afin de 3417 rendre le nom du fichier unique, �vitant ainsi tout conflit lorsque 3418 plusieurs instances d'httpd partagent le m�me r�pertoire de 3419 verrouillage. Par exemple, si le nom de mutex est 3420 <code>mpm-accept</code>, et si le r�pertoire de verrouillage est 3421 <code>/var/httpd/locks</code>, le nom du fichier verrou pour 3422 l'instance httpd dont le processus parent a pour identifiant 12345 3423 sera <code>/var/httpd/locks/mpm-accept.12345</code>.</p> 3424 3425 <div class="warning"><h3>S�curit�</h3> 3426 <p>Il est conseill� d'<em>�viter</em> de placer les fichiers mutex 3427 dans un r�pertoire o� tout le monde peut �crire comme 3428 <code>/var/tmp</code>, car quelqu'un pourrait initier une attaque 3429 par d�ni de service et emp�cher le serveur de d�marrer en cr�ant un 3430 fichier verrou poss�dant un nom identique � celui que le serveur va 3431 tenter de cr�er.</p> 3432 </div> 3433 3434 <p>La table suivante d�crit les noms de mutex utilis�s par httpd et 3435 ses modules associ�s.</p> 3436 3437 <table class="bordered"><tr class="header"> 3438 <th>Nom mutex</th> 3439 <th>Module(s)</th> 3440 <th>Ressource prot�g�e</th> 3441 </tr> 3442<tr> 3443 <td><code>mpm-accept</code></td> 3444 <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> 3445 <td>connexions entrantes, afin d'�viter le probl�me de 3446 l'afflux de requ�tes ; pour plus d'informations, voir la 3447 documentation <a href="/misc/perf-tuning.html">Am�lioration des 3448 performances</a></td> 3449 </tr> 3450<tr class="odd"> 3451 <td><code>authdigest-client</code></td> 3452 <td><code class="module"><a href="/mod/mod_auth_digest.html">mod_auth_digest</a></code></td> 3453 <td>liste de clients en m�moire partag�e</td> 3454 </tr> 3455<tr> 3456 <td><code>authdigest-opaque</code></td> 3457 <td><code class="module"><a href="/mod/mod_auth_digest.html">mod_auth_digest</a></code></td> 3458 <td>compteur en m�moire partag�e</td> 3459 </tr> 3460<tr class="odd"> 3461 <td><code>ldap-cache</code></td> 3462 <td><code class="module"><a href="/mod/mod_ldap.html">mod_ldap</a></code></td> 3463 <td>cache de r�sultat de recherche LDAP</td> 3464 </tr> 3465<tr> 3466 <td><code>rewrite-map</code></td> 3467 <td><code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code></td> 3468 <td>communication avec des programmes externes 3469 d'associations de valeurs, afin d'�viter les interf�rences 3470 d'entr�es/sorties entre plusieurs requ�tes</td> 3471 </tr> 3472<tr class="odd"> 3473 <td><code>ssl-cache</code></td> 3474 <td><code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code></td> 3475 <td>cache de session SSL</td> 3476 </tr> 3477<tr> 3478 <td><code>ssl-stapling</code></td> 3479 <td><code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code></td> 3480 <td>cache de l'�tiquetage OCSP ("OCSP stapling")</td> 3481 </tr> 3482<tr class="odd"> 3483 <td><code>watchdog-callback</code></td> 3484 <td><code class="module"><a href="/mod/mod_watchdog.html">mod_watchdog</a></code></td> 3485 <td>fonction de rappel d'un module client particulier</td> 3486 </tr> 3487</table> 3488 3489 <p>Le mot-cl� <code>OmitPID</code> permet d'emp�cher l'addition de 3490 l'identifiant du processus httpd parent au nom du fichier verrou.</p> 3491 3492 3493 <p>Dans l'exemple suivant, le m�canisme de mutex pour le mutex 3494 mpm-accept est modifi� pour passer du m�canisme par d�faut au 3495 m�canisme <code>fcntl</code>, avec le fichier verrou associ� cr�� 3496 dans le r�pertoire <code>/var/httpd/locks</code>. Le m�canisme de 3497 mutex par d�faut pour tous les autres mutex deviendra 3498 <code>sysvsem</code>.</p> 3499 3500 <pre class="prettyprint lang-config">Mutex sysvsem default 3501Mutex fcntl:/var/httpd/locks mpm-accept</pre> 3502 3503 3504</div> 3505<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3506<div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">Directive</a></h2> 3507<table class="directive"> 3508<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>OBSOLETE : D�finit une adresse IP pour les serveurs virtuels � base de 3509nom</td></tr> 3510<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NameVirtualHost <var>adresse</var>[:<var>port</var>]</code></td></tr> 3511<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 3512<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3513<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3514</table> 3515 3516 <p>Avant la version 2.3.11, il �tait n�cessaire de d�finir une 3517 directive <code class="directive">NameVirtualHost</code> pour indiquer au 3518 serveur qu'une paire adresse IP/port particuli�re pouvait �tre 3519 utilis�e comme serveur virtuel � base de nom. Depuis la version 3520 2.3.11, chaque fois qu'une paire adresse IP/port est utilis�e dans 3521 plusieurs serveurs virtuels, l'h�bergement virtuel � base de nom est 3522 automatiquement activ� pour cette adresse.</p> 3523 3524 <p>Cette directive n'a actuellement plus aucun effet.</p> 3525 3526<h3>Voir aussi</h3> 3527<ul> 3528<li><a href="/vhosts/">Documentation sur les serveurs 3529virtuels</a></li> 3530</ul> 3531</div> 3532<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3533<div class="directive-section"><h2><a name="Options" id="Options">Options</a> <a name="options" id="options">Directive</a></h2> 3534<table class="directive"> 3535<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit les fonctionnalit�s disponibles pour un r�pertoire 3536particulier</td></tr> 3537<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Options 3538 [+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr> 3539<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Options FollowSymlinks</code></td></tr> 3540<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 3541<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr> 3542<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3543<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3544<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 3545� FollowSymlinks</td></tr> 3546</table> 3547 <p>La directive <code class="directive">Options</code> permet de d�finir 3548 les fonctionnalit�s de serveur disponibles pour un r�pertoire 3549 particulier.</p> 3550 3551 <p><var>option</var> peut �tre d�fini � <code>None</code>, auquel 3552 cas aucune fonctionnalit� sp�cifique n'est activ�e, ou comprendre 3553 une ou plusieurs des options suivantes :</p> 3554 3555 <dl> 3556 <dt><code>All</code></dt> 3557 3558 <dd>Toutes les options except� <code>MultiViews</code>.</dd> 3559 3560 <dt><code>ExecCGI</code></dt> 3561 3562 <dd>L'ex�cution de scripts CGI � l'aide du module 3563 <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code> est permise.</dd> 3564 3565 <dt><code>FollowSymLinks</code></dt> 3566 3567 <dd> 3568 3569 Le serveur va suivre les liens symboliques dans le r�pertoire 3570 concern�. Il s'agit de la valeur par d�faut. 3571 <div class="note"> 3572 <p>Bien que le serveur suive les liens symboliques, il ne modifie 3573 <em>pas</em> le nom de chemin concern� d�fini par la section 3574 <code class="directive"><a href="#directory"><Directory></a></code>.</p> 3575 3576 <p>Les options <code>FollowSymLinks</code> et 3577 <code>SymLinksIfOwnerMatch</code> ne fonctionnent que dans les 3578 sections <code class="directive"><a href="#directory"><Directory></a></code> ou les fichiers 3579 <code>.htaccess</code>.</p> 3580 3581 <p>Le fait d'omettre cette option ne doit pas �tre consid�r� comme 3582 une mesure de s�curit� efficace, car il existe toujours une 3583 situation de comp�tition (race condition) entre l'instant o� l'on 3584 v�rifie qu'un chemin n'est pas un lien symbolique, et l'instant o� 3585 l'on utilise effectivement ce chemin.</p> 3586 </div></dd> 3587 3588 <dt><code>Includes</code></dt> 3589 3590 <dd> 3591 Les inclusions c�t� serveur (SSI) � l'aide du module 3592 <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> sont autoris�es.</dd> 3593 3594 <dt><code>IncludesNOEXEC</code></dt> 3595 3596 <dd> 3597 3598 Les inclusions c�t� serveur (SSI) sont permises, mais <code>#exec 3599 cmd</code> et <code>#exec cgi</code> sont d�sactiv�s. 3600 L'utilisation de <code>#include virtual</code> pour les scripts 3601 CGI est cependant toujours possible depuis des r�pertoires 3602 d�finis par <code class="directive"><a href="/mod/mod_alias.html#scriptalias">ScriptAlias</a></code>.</dd> 3603 3604 <dt><code>Indexes</code></dt> 3605 3606 <dd> 3607 Si une URL requise correspond au r�pertoire concern�, et si aucun 3608 <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> (<em>par 3609 exemple</em> <code>index.html</code>) n'est d�fini pour ce 3610 r�pertoire, le module <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> va renvoyer 3611 un listing format� du r�pertoire.</dd> 3612 3613 <dt><code>MultiViews</code></dt> 3614 3615 <dd> 3616 Les vues multiples ("multiviews") � <a href="/content-negotiation.html">contenu n�goci�</a> � l'aide du 3617 module <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code> sont autoris�es. 3618 <div class="note"><h3>Note</h3> <p>Cette option est ignor�e si elle est 3619 d�finie en tout autre endroit qu'une section <code class="directive"><a href="#directory"><Directory></a></code>, car 3620 <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code> a besoin de ressources r�elles 3621 pour effectuer ses comparaisons et ses �valuations.</p></div> 3622 3623 </dd> 3624 3625 <dt><code>SymLinksIfOwnerMatch</code></dt> 3626 3627 <dd>Le serveur ne suivra que les liens symboliques qui renvoient 3628 vers un fichier ou un r�pertoire dont le propri�taire est le m�me 3629 que celui du lien. 3630 3631 <div class="note"><h3>Note</h3> 3632 <p>Les options <code>FollowSymLinks</code> et 3633 <code>SymLinksIfOwnerMatch</code> ne fonctionnent que dans les 3634 sections <code class="directive"><a href="#directory"><Directory></a></code> ou les fichiers 3635 <code>.htaccess</code>.</p> 3636 3637 <p>Le fait d'omettre cette option ne doit pas �tre consid�r� comme 3638 une mesure de s�curit� efficace, car il existe toujours une 3639 situation de comp�tition (race condition) entre l'instant o� l'on 3640 v�rifie qu'un chemin n'est pas un lien symbolique, et l'instant o� 3641 l'on utilise effectivement ce chemin.</p> 3642 </div> </dd> 3643 </dl> 3644 3645 <p>Normalement, si plusieurs directives 3646 <code class="directive">Options</code> peuvent s'appliquer � un r�pertoire, 3647 c'est la plus sp�cifique qui est utilis�e et les autres sont 3648 ignor�es ; les options ne sont pas fusionn�es (voir <a href="/sections.html#mergin">comment les sections sont 3649 fusionn�es</a>). Elles le sont cependant si <em>toutes</em> les 3650 options de la directive <code class="directive">Options</code> sont 3651 pr�c�d�es d'un symbole <code>+</code> ou <code>-</code>. Toute 3652 option pr�c�d�e d'un <code>+</code> est ajout�e � la liste des 3653 options courantes de mani�re forc�e et toute option pr�c�d�e d'un 3654 <code>-</code> est supprim�e de la liste des options courantes de la 3655 m�me mani�re.</p> 3656 3657 <div class="note"><h3>Note</h3> 3658 <p>M�langer des <code class="directive">Options</code> avec <code>+</code> 3659 ou <code>-</code> avec des <code class="directive">Options</code> sans 3660 <code>+</code> ou <code>-</code> constitue une erreur de syntaxe, et 3661 la v�rification de la syntaxe au cours du d�marrage du serveur fera 3662 �chouer ce dernier.</p> 3663 </div> 3664 3665 <p>Par exemple, sans aucun symbole <code>+</code> et <code>-</code> 3666 :</p> 3667 3668 <pre class="prettyprint lang-config"><Directory "/web/docs"> 3669 Options Indexes FollowSymLinks 3670</Directory> 3671 3672<Directory "/web/docs/spec"> 3673 Options Includes 3674</Directory></pre> 3675 3676 3677 <p>ici, seule l'option <code>Includes</code> sera prise en compte 3678 pour le r�pertoire <code>/web/docs/spec</code>. Par contre, si la 3679 seconde directive <code class="directive">Options</code> utilise les 3680 symboles <code>+</code> et <code>-</code> :</p> 3681 3682 <pre class="prettyprint lang-config"><Directory "/web/docs"> 3683 Options Indexes FollowSymLinks 3684</Directory> 3685 3686<Directory "/web/docs/spec"> 3687 Options +Includes -Indexes 3688</Directory></pre> 3689 3690 3691 <p>alors, les options <code>FollowSymLinks</code> et 3692 <code>Includes</code> seront prises en compte pour le r�pertoire 3693 <code>/web/docs/spec</code>.</p> 3694 3695 <div class="note"><h3>Note</h3> 3696 <p>L'utilisation de <code>-IncludesNOEXEC</code> ou 3697 <code>-Includes</code> d�sactive compl�tement les inclusions c�t� 3698 serveur sans tenir compte des d�finitions pr�c�dentes.</p> 3699 </div> 3700 3701 <p>En l'absence de toute d�finition d'options, la valeur par d�faut 3702 est <code>FollowSymlinks</code>.</p> 3703 3704</div> 3705<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3706<div class="directive-section"><h2><a name="Protocol" id="Protocol">Protocol</a> <a name="protocol" id="protocol">Directive</a></h2> 3707<table class="directive"> 3708<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Protocole pour une socket d'�coute</td></tr> 3709<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Protocol <var>protocole</var></code></td></tr> 3710<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 3711<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3712<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3713<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.1.5 d'Apache, mais 3714seulement depuis la version 2.3.3 sous Windows.</td></tr> 3715</table> 3716 <p>Cette directive permet de sp�cifier le protocole utilis� pour une 3717 socket d'�coute particuli�re. Le protocole sert � d�terminer quel 3718 module doit traiter une requ�te, et d'appliquer les optimisations 3719 sp�cifiques au protocole via la directive 3720 <code class="directive">AcceptFilter</code>.</p> 3721 3722 <p>Vous ne devez d�finir le protocole que si vous travaillez avec 3723 des ports non standards ; dans le cas g�n�ral, le protocole 3724 <code>http</code> est associ� au port 80 et le protocole 3725 <code>https</code> au port 443.</p> 3726 3727 <p>Par exemple, si vous travaillez avec le protocole 3728 <code>https</code> sur un port non standard, sp�cifiez le protocole 3729 de mani�re explicite :</p> 3730 3731 <pre class="prettyprint lang-config">Protocol https</pre> 3732 3733 3734 <p>Vous pouvez aussi sp�cifier le protocole via la directive 3735 <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code>.</p> 3736 3737<h3>Voir aussi</h3> 3738<ul> 3739<li><code class="directive"><a href="#acceptfilter">AcceptFilter</a></code></li> 3740<li><code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code></li> 3741</ul> 3742</div> 3743<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3744<div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">Directive</a></h2> 3745<table class="directive"> 3746<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le temps CPU allou� aux processus initi�s par les 3747processus enfants d'Apache httpd</td></tr> 3748<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> 3749<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 3750d'exploitation</code></td></tr> 3751<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 3752<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 3753<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3754<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3755</table> 3756 <p>Prend 1 ou 2 param�tres. Le premier definit la limite de 3757 consommation de ressources pour tous les processus, et le second la 3758 consommation de ressources maximale. Les deux param�tres peuvent 3759 contenir soit un nombre, soit <code>max</code> pour indiquer au 3760 serveur que la limite de consommation correspond � la valeur 3761 maximale autoris�e par la configuration du syst�me d'exploitation. 3762 Pour augmenter la consommation maximale de ressources, le serveur 3763 doit s'ex�cuter en tant que <code>root</code>, ou se trouver dans sa 3764 phase de d�marrage.</p> 3765 3766 <p>Cette directive s'applique aux processus initi�s par les 3767 processus enfants d'Apache httpd qui traitent les requ�tes, et non aux 3768 processus enfants eux-m�mes. Sont concern�s les scripts CGI et les 3769 commandes exec des SSI, mais en aucun cas les processus initi�s par 3770 le processus parent d'Apache httpd comme les journalisations redirig�es 3771 vers un programme.</p> 3772 3773 <p>Les limites de ressources CPU sont exprim�es en secondes par 3774 processus.</p> 3775 3776<h3>Voir aussi</h3> 3777<ul> 3778<li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li> 3779<li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li> 3780</ul> 3781</div> 3782<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3783<div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">Directive</a></h2> 3784<table class="directive"> 3785<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite la m�moire allou�e aux processus initi�s par les 3786processus enfants d'Apache httpd</td></tr> 3787<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> 3788<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 3789d'exploitation</code></td></tr> 3790<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 3791<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 3792<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3793<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3794</table> 3795 <p>Prend 1 ou 2 param�tres. Le premier definit la limite de 3796 consommation de ressources pour tous les processus, et le second la 3797 consommation de ressources maximale. Les deux param�tres peuvent 3798 contenir soit un nombre, soit <code>max</code> pour indiquer au 3799 serveur que la limite de consommation correspond � la valeur 3800 maximale autoris�e par la configuration du syst�me d'exploitation. 3801 Pour augmenter la consommation maximale de ressources, le serveur 3802 doit s'ex�cuter en tant que <code>root</code>, ou se trouver dans sa 3803 phase de d�marrage.</p> 3804 3805 <p>Cette directive s'applique aux processus initi�s par les 3806 processus enfants d'Apache httpd qui traitent les requ�tes, et non aux 3807 processus enfants eux-m�mes. Sont concern�s les scripts CGI et les 3808 commandes exec des SSI, mais en aucun cas les processus initi�s par 3809 le processus parent d'Apache httpd comme les journalisations redirig�es 3810 vers un programme.</p> 3811 3812 <p>Les limites de ressources m�moire sont exprim�es en octets par 3813 processus.</p> 3814 3815<h3>Voir aussi</h3> 3816<ul> 3817<li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li> 3818<li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li> 3819</ul> 3820</div> 3821<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3822<div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">Directive</a></h2> 3823<table class="directive"> 3824<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de processus qui peuvent �tre initi�s par 3825les processus initi�s par les processus enfants d'Apache httpd</td></tr> 3826<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> 3827<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Unset; uses operating system defaults</code></td></tr> 3828<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 3829<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 3830<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3831<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3832</table> 3833 <p>Prend 1 ou 2 param�tres. Le premier definit la limite de 3834 consommation de ressources pour tous les processus, et le second la 3835 consommation de ressources maximale. Les deux param�tres peuvent 3836 contenir soit un nombre, soit <code>max</code> pour indiquer au 3837 serveur que la limite de consommation correspond � la valeur 3838 maximale autoris�e par la configuration du syst�me d'exploitation. 3839 Pour augmenter la consommation maximale de ressources, le serveur 3840 doit s'ex�cuter en tant que <code>root</code>, ou se trouver dans sa 3841 phase de d�marrage.</p> 3842 3843 <p>Cette directive s'applique aux processus initi�s par les 3844 processus enfants d'Apache httpd qui traitent les requ�tes, et non aux 3845 processus enfants eux-m�mes. Sont concern�s les scripts CGI et les 3846 commandes exec des SSI, mais en aucun cas les processus initi�s par 3847 le processus parent d'Apache httpd comme les journalisations redirig�es 3848 vers un programme.</p> 3849 3850 <p>Les limites des processus contr�lent le nombre de processus par 3851 utilisateur.</p> 3852 3853 <div class="note"><h3>Note</h3> 3854 <p>Si les processus CGI s'ex�cutent sous le m�me 3855 utilisateur que celui du serveur web, cette 3856 directive va limiter le nombre de processus que le serveur 3857 pourra lui-m�me cr�er. La pr�sence de messages 3858 <strong><code>cannot fork</code></strong> dans le journal des 3859 erreurs indiquera que la limite est atteinte.</p> 3860 </div> 3861 3862<h3>Voir aussi</h3> 3863<ul> 3864<li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li> 3865<li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li> 3866</ul> 3867</div> 3868<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3869<div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a></h2> 3870<table class="directive"> 3871<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de localiser l'interpr�teur des scripts 3872CGI</td></tr> 3873<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr> 3874<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr> 3875<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 3876<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 3877<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3878<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3879<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Win32 seulement.</td></tr> 3880</table> 3881 <p>Cette directive permet de contr�ler la m�thode qu'utilise Apache 3882 httpd pour trouver l'interpr�teur destin� � ex�cuter les scripts CGI. La 3883 d�finition par d�faut est <code>Script</code> : ceci indique � 3884 Apache httpd qu'il doit utiliser l'interpr�teur pr�cis� dans la ligne 3885 shebang du script (la premi�re ligne, commen�ant par 3886 <code>#!</code>). Sur les syst�mes Win32, cette ligne ressemble 3887 souvent � ceci :</p> 3888 3889 <pre class="prettyprint lang-perl">#!C:/Perl/bin/perl.exe</pre> 3890 3891 3892 <p>ou simplement, dans le cas o� <code>perl</code> est dans le 3893 <code>PATH</code> :</p> 3894 3895 <pre class="prettyprint lang-perl">#!perl</pre> 3896 3897 3898 <p>Avec <code>ScriptInterpreterSource Registry</code>, Windows va 3899 effectuer une recherche dans l'arborescence 3900 <code>HKEY_CLASSES_ROOT</code> de la base de registre avec comme 3901 mot-cl� l'extension du fichier contenant le script (par exemple 3902 <code>.pl</code>). C'est la commande d�finie par la sous-cl� de 3903 registre <code>Shell\ExecCGI\Command</code> ou, si elle n'existe 3904 pas, la sous-cl� <code>Shell\Open\Command</code> qui est utilis�e 3905 pour ouvrir le fichier du script. Si ces cl�s de registre ne sont 3906 pas trouv�es, Apache httpd utilise la m�thode de l'option 3907 <code>Script</code>.</p> 3908 3909 <div class="warning"><h3>S�curit�</h3> 3910 <p>Soyez prudent si vous utilisez <code>ScriptInterpreterSource 3911 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 3912 d'ex�cuter <strong>tous</strong> les fichiers contenus dans 3913 celui-ci. L'option <code>Registry</code> peut causer des appels de 3914 programmes non voulus sur des fichiers non destin�s � �tre ex�cut�s. 3915 Par exemple, la commande par d�faut open sur les fichiers 3916 <code>.htm</code> sur la plupart des syst�mes Windows va lancer 3917 Microsoft Internet Explorer ; ainsi, toute requ�te HTTP pour un 3918 fichier <code>.htm</code> situ� dans le r�pertoire des scripts 3919 va lancer le navigateur en arri�re-plan sur le serveur, ce qui a 3920 toutes les chances de crasher votre syst�me dans les minutes qui 3921 suivent.</p> 3922 </div> 3923 3924 <p>L'option <code>Registry-Strict</code>, apparue avec la version 3925 2.0 du serveur HTTP Apache, 3926 agit de mani�re identique � <code>Registry</code>, mais n'utilise 3927 que la sous-cl� <code>Shell\ExecCGI\Command</code>. La pr�sence de 3928 la cl� <code>ExecCGI</code> n'�tant pas syst�matique, Elle doit �tre 3929 d�finie manuellement dans le registre Windows et �vite ainsi tout 3930 appel de programme accidentel sur votre syst�me.</p> 3931 3932</div> 3933<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3934<div class="directive-section"><h2><a name="SeeRequestTail" id="SeeRequestTail">SeeRequestTail</a> <a name="seerequesttail" id="seerequesttail">Directive</a></h2> 3935<table class="directive"> 3936<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�termine si mod_status affiche les 63 premiers caract�res 3937d'une requ�te ou les 63 derniers, en supposant que la requ�te 3938elle-m�me poss�de plus de 63 caract�res.</td></tr> 3939<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SeeRequestTail On|Off</code></td></tr> 3940<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>SeeRequestTail Off</code></td></tr> 3941<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 3942<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3943<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3944<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.2.7 3945d'Apache httpd.</td></tr> 3946</table> 3947 <p>Avec <code>ExtendedStatus On</code>, mod_status affiche la 3948 v�ritable requ�te en cours de traitement. Pour des raisons 3949 historiques, seuls 63 caract�res de la requ�te sont r�ellement 3950 stock�s � des fins d'affichage. Cette directive permet de d�terminer 3951 si ce sont les 63 premiers caract�res qui seront stock�s (c'est le 3952 comportement par d�faut), 3953 ou si ce sont les 63 derniers. Ceci ne s'applique bien entendu que 3954 si la taille de la requ�te est de 64 caract�res ou plus.</p> 3955 3956 <p>Si Apache httpd traite la requ�te <code>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</code> 3957 , l'affichage de la requ�te par mod_status se pr�sentera comme suit : 3958 </p> 3959 3960 <table class="bordered"> 3961 <tr> 3962 <th>Off (d�faut)</th> 3963 <td>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourritu</td> 3964 </tr> 3965 <tr> 3966 <th>On</th> 3967 <td>apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</td> 3968 </tr> 3969 </table> 3970 3971 3972</div> 3973<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 3974<div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">Directive</a></h2> 3975<table class="directive"> 3976<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'adresse �lectronique que le serveur inclut dans les 3977messages d'erreur envoy�s au client</td></tr> 3978<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAdmin <var>adresse �lectronique</var>|<var>URL</var></code></td></tr> 3979<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 3980<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 3981<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 3982</table> 3983 <p>La directive <code class="directive">ServerAdmin</code> permet de d�finir 3984 l'adresse de contact que le serveur va inclure dans tout message 3985 d'erreur qu'il envoie au client. Si le programme <code>httpd</code> 3986 ne reconnait pas l'argument fourni comme une URL, il suppose que 3987 c'est une <var>adresse �lectronique</var>, et lui ajoute le pr�fixe 3988 <code>mailto:</code> dans les cibles des hyperliens. Il est 3989 cependant recommand� d'utiliser exclusivement une adresse 3990 �lectronique, car de nombreux scripts CGI consid�rent ceci comme 3991 implicite. Si vous utilisez une URL, elle doit pointer vers un autre 3992 serveur que vous contr�lez. Dans le cas contraire, les utilisateurs 3993 seraient dans l'impossibilit� de vous contacter en cas de probl�me.</p> 3994 3995 <p>Il peut s'av�rer utile de d�finir une adresse d�di�e � 3996 l'administration du serveur, par exemple :</p> 3997 3998 <pre class="prettyprint lang-config">ServerAdmin www-admin@foo.example.com</pre> 3999 4000 <p>car les utilisateurs ne mentionnent pas syst�matiquement le 4001 serveur dont ils parlent !</p> 4002 4003</div> 4004<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4005<div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">Directive</a></h2> 4006<table class="directive"> 4007<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Autres noms d'un serveur utilisables pour atteindre des 4008serveurs virtuels � base de nom</td></tr> 4009<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAlias <var>nom serveur</var> [<var>nom serveur</var>] 4010...</code></td></tr> 4011<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel</td></tr> 4012<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4013<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4014</table> 4015 <p>La directive <code class="directive">ServerAlias</code> permet de d�finir 4016 les noms alternatifs d'un serveur utilisables pour atteindre des <a href="/vhosts/name-based.html">serveurs virtuels � base de 4017 nom</a>. La directive <code class="directive">ServerAlias</code> peut 4018 contenir des caract�res g�n�riques, si n�cessaire.</p> 4019 4020 <pre class="prettyprint lang-config"><VirtualHost *:80> 4021 ServerName server.example.com 4022 ServerAlias server server2.example.com server2 4023 ServerAlias *.example.com 4024 UseCanonicalName Off 4025 # ... 4026</VirtualHost></pre> 4027 4028 <p>La recherche du serveur virtuel � base de nom correspondant au 4029 plus pr�s � la requ�te s'effectue selon l'ordre d'apparition des 4030 directives <code class="directive"><a href="#virtualhost"><virtualhost></a></code> dans le fichier de 4031 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 4032 priorit� particuli�re si le nom contient des caract�res g�n�riques 4033 (que ce soit pour ServerName ou ServerAlias).</p> 4034 4035 <p>Tous les noms sp�cifi�s au sein d'une section 4036 <code class="directive">VirtualHost</code> sont trait�s comme un 4037 <code class="directive">ServerAlias</code> (sans caract�res g�n�riques).</p> 4038 4039 4040<h3>Voir aussi</h3> 4041<ul> 4042<li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li> 4043<li><a href="/vhosts/">Documentation sur les serveurs virtuels 4044du serveur HTTP Apache</a></li> 4045</ul> 4046</div> 4047<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4048<div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">Directive</a></h2> 4049<table class="directive"> 4050<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom d'h�te et port que le serveur utilise pour 4051s'authentifier lui-m�me</td></tr> 4052<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerName [<var>protocole</var>://]<var>nom de domaine 4053enti�rement qualifi�</var>[:<var>port</var>]</code></td></tr> 4054<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 4055<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4056<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4057</table> 4058 <p>La directive <code class="directive">ServerName</code> permet de d�finir 4059 les protocole, nom d'h�te et port d'une requ�te que le serveur 4060 utilise pour s'authentifier lui-m�me. Ceci est utile lors de la 4061 cr�ation de redirections d'URLs.</p> 4062 4063 <p>La directive <code class="directive">ServerName</code> permet aussi 4064 (�ventuellement en conjonction avec la directive 4065 <code class="directive">ServerAlias</code>) d'identifier de mani�re unique 4066 un serveur virtuel, lorsqu'elle est utilis�e dans un contexte de <a href="/vhosts/name-based.html">serveurs virtuels � base de 4067 noms</a>.</p> 4068 4069 <p>Par exemple, si le nom de la 4070 machine h�bergeant le serveur web est 4071 <code>simple.example.com</code>, la machine poss�de l'alias 4072 DNS <code>www.example.com</code>, et si vous voulez que le serveur 4073 web s'identifie avec cet alias, vous devez utilisez la d�finition 4074 suivante :</p> 4075 4076 <pre class="prettyprint lang-config">ServerName www.example.com</pre> 4077 4078 4079 <p>La directive <code class="directive">ServerName</code> peut appara�tre � 4080 toutes les �tapes de la d�finition du serveur. Toute occurrence 4081 annule cependant la pr�c�dente (pour ce serveur).</p> 4082 4083 <p>Si la directive <code class="directive">ServerName</code> n'est pas 4084 d�finie, le serveur tente de d�terminer le nom d'h�te en effectuant 4085 une recherche DNS inverse sur son adresse IP. Si la directive 4086 <code class="directive">ServerName</code> ne pr�cise pas de port, le serveur 4087 utilisera celui de la requ�te entrante. Il est recommand� de 4088 sp�cifier un nom d'h�te et un port sp�cifiques � l'aide de la 4089 directive <code class="directive">ServerName</code> pour une fiabilit� 4090 optimale et � titre pr�ventif.</p> 4091 4092 <p>Si vous d�finissez des <a href="/vhosts/name-based.html">serveurs virtuels � base de 4093 nom</a>, une directive <code class="directive">ServerName</code> situ�e � 4094 l'int�rieur d'une section <code class="directive"><a href="#virtualhost"><VirtualHost></a></code> sp�cifiera quel nom d'h�te 4095 doit appara�tre dans l'en-t�te de requ�te <code>Host:</code> pour 4096 pouvoir atteindre ce serveur virtuel.</p> 4097 4098 4099 <p>Parfois, le serveur s'ex�cute en amont d'un dispositif qui 4100 impl�mente SSL, comme un mandataire inverse, un r�partiteur de 4101 charge ou un bo�tier d�di� SSL. Dans ce cas, sp�cifiez le protocole 4102 <code>https://</code> et le port auquel les clients se connectent 4103 dans la directive <code class="directive">ServerName</code>, afin de 4104 s'assurer que le serveur g�n�re correctement ses URLs 4105 d'auto-identification. 4106 </p> 4107 4108 <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 4109 d�finitions qui permettent de d�terminer si les URLs 4110 auto-identifiantes (par exemple via le module 4111 <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code>) vont faire r�f�rence au port sp�cifi�, ou 4112 au port indiqu� dans la requ�te du client. 4113 </p> 4114 4115 <div class="warning"> 4116 <p>Si la valeur de la directive <code class="directive">ServerName</code> ne 4117 peut pas �tre r�solue en adresse IP, le d�marrage du serveur 4118 provoquera un avertissement. <code>httpd</code> va alors utiliser le 4119 r�sultat de la commande syst�me <code>hostname</code> pour 4120 d�terminer le nom du serveur, ce qui ne correspondra pratiquement 4121 jamais au nom de serveur que vous souhaitez r�ellement.</p> 4122 <div class="example"><p><code> 4123 httpd: Could not reliably determine the server's fully qualified domain name, using rocinante.local for ServerName 4124 </code></p></div> 4125 </div> 4126 4127 4128<h3>Voir aussi</h3> 4129<ul> 4130<li><a href="/dns-caveats.html">Probl�mes concernant le DNS et 4131le serveur HTTP Apache</a></li> 4132<li><a href="/vhosts/">Documentation sur les serveurs virtuels 4133du serveur HTTP Apache</a></li> 4134<li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li> 4135<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li> 4136<li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li> 4137</ul> 4138</div> 4139<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4140<div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">Directive</a></h2> 4141<table class="directive"> 4142<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom de chemin d'URL h�rit� pour un serveur virtuel � base 4143de nom acc�d� par un navigateur incompatible</td></tr> 4144<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerPath <var>chemin d'URL</var></code></td></tr> 4145<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel</td></tr> 4146<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4147<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4148</table> 4149 <p>La directive <code class="directive">ServerPath</code> permet de d�finir 4150 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> 4151 4152<h3>Voir aussi</h3> 4153<ul> 4154<li><a href="/vhosts/">Documentation sur les serveurs virtuels 4155du serveur HTTP Apache</a></li> 4156</ul> 4157</div> 4158<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4159<div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">Directive</a></h2> 4160<table class="directive"> 4161<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine du r�pertoire d'installation du 4162serveur</td></tr> 4163<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerRoot <var>chemin de r�pertoire</var></code></td></tr> 4164<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr> 4165<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 4166<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4167<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4168</table> 4169 <p>La directive <code class="directive">ServerRoot</code> permet de d�finir 4170 le r�pertoire dans lequel le serveur est install�. En particulier, 4171 il contiendra les sous-r�pertoires <code>conf/</code> et 4172 <code>logs/</code>. Les chemins relatifs indiqu�s dans les autres 4173 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 4174 rapport � ce r�pertoire.</p> 4175 4176 <pre class="prettyprint lang-config">ServerRoot "/home/httpd"</pre> 4177 4178 4179 <p>La valeur par d�faut de <code class="directive">ServerRoot</code> peut 4180 �tre modifi�e via l'argument <code>--prefix</code> de la commande <a href="/programs/configure.html"><code>configure</code></a>, et de 4181 nombreuses distributions tierces du serveur proposent une valeur 4182 diff�rente de celles list�es ci-dessus.</p> 4183 4184 4185<h3>Voir aussi</h3> 4186<ul> 4187<li><a href="/invoking.html">the <code>-d</code> 4188 options de <code>httpd</code></a></li> 4189<li><a href="/misc/security_tips.html#serverroot">les conseils � 4190propos de s�curit�</a> pour des informations sur la mani�re de d�finir 4191correctement les permissions sur le r�pertoire indiqu� par la directive 4192<code class="directive">ServerRoot</code></li> 4193</ul> 4194</div> 4195<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4196<div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">Directive</a></h2> 4197<table class="directive"> 4198<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 4199serveur</td></tr> 4200<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr> 4201<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ServerSignature Off</code></td></tr> 4202<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 4203<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr> 4204<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4205<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4206</table> 4207 <p>La directive <code class="directive">ServerSignature</code> permet de 4208 d�finir une ligne de pied de page fixe pour les documents g�n�r�s 4209 par le serveur (messages d'erreur, listings de r�pertoires ftp de 4210 <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>, 4211 etc...). Dans le cas d'une cha�ne de mandataires, l'utilisateur n'a 4212 souvent aucun moyen de d�terminer lequel des mandataires cha�n�s a 4213 g�n�r� un message d'erreur, et c'est une des raisons pour lesquelles 4214 on peut �tre amen� � ajouter un tel pied de page.</p> 4215 4216 <p>La valeur par d�faut <code>Off</code> supprime la ligne de pied 4217 de page (et est ainsi compatible avec le comportement des 4218 versions 1.2 et ant�rieures d'Apache). la valeur <code>On</code> 4219 ajoute simplement une ligne contenant le num�ro de version du 4220 serveur ainsi que le nom du serveur virtuel issu de la directive 4221 <code class="directive"><a href="#servername">ServerName</a></code>, alors que la valeur 4222 <code>EMail</code> ajoute en plus une r�f�rence "mailto:" � 4223 l'administrateur du document r�f�renc� issu la directive 4224 <code class="directive"><a href="#serveradmin">ServerAdmin</a></code>.</p> 4225 4226 <p>Apr�s la version 2.0.44, les d�tails � propos du num�ro de 4227 version du serveur sont contr�l�s � l'aide de la directive 4228 <code class="directive"><a href="#servertokens">ServerTokens</a></code>.</p> 4229 4230<h3>Voir aussi</h3> 4231<ul> 4232<li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li> 4233</ul> 4234</div> 4235<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4236<div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">Directive</a></h2> 4237<table class="directive"> 4238<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure l'en-t�te <code>Server</code> de la r�ponse 4239HTTP</td></tr> 4240<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> 4241<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ServerTokens Full</code></td></tr> 4242<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 4243<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4244<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4245</table> 4246 <p>Cette directive permet de contr�ler le contenu de l'en-t�te 4247 <code>Server</code> inclus dans la r�ponse envoy�e au client : cet 4248 en-t�te peut contenir le type de syst�me d'exploitation du serveur, 4249 ainsi que des informations � propos des modules compil�s avec le 4250 serveur.</p> 4251 4252 <dl> 4253 <dt><code>ServerTokens Full</code> (ou non sp�cifi�)</dt> 4254 4255 <dd>Le serveur envoie par exemple : <code>Server: Apache/2.4.2 4256 (Unix) PHP/4.2.2 MyMod/1.2</code></dd> 4257 4258 <dt><code>ServerTokens Prod[uctOnly]</code></dt> 4259 4260 <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server: 4261 Apache</code></dd> 4262 4263 <dt><code>ServerTokens Major</code></dt> 4264 4265 <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server: 4266 Apache/2</code></dd> 4267 4268 <dt><code>ServerTokens Minor</code></dt> 4269 4270 <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server: 4271 Apache/2.4</code></dd> 4272 4273 <dt><code>ServerTokens Min[imal]</code></dt> 4274 4275 <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server: 4276 Apache/2.4.2</code></dd> 4277 4278 <dt><code>ServerTokens OS</code></dt> 4279 4280 <dd>Le serveur renvoie (<em>par exemple</em>): <code>Server: 4281 Apache/2.4.2 (Unix)</code></dd> 4282 4283 4284 4285 </dl> 4286 4287 <p>Cette d�finition s'applique � l'ensemble du serveur et ne peut 4288 �tre activ�e ou d�sactiv�e pour tel ou tel serveur virtuel.</p> 4289 4290 <p>Dans les versions post�rieures � 2.0.44, cette directive contr�le 4291 aussi les informations fournies par la directive <code class="directive"><a href="#serversignature">ServerSignature</a></code>.</p> 4292 4293 <div class="note">D�finir <code class="directive">ServerTokens</code> � une 4294 valeur inf�rieure � <code>minimal</code> n'est pas 4295 recommand� car le d�bogage des probl�mes 4296 interop�rationnels n'en sera alors que plus difficile. Notez 4297 aussi que la d�sactivation de l'en-t�te Server: 4298 n'am�liore en rien la s�curit� de votre 4299 serveur ; le concept de "s�curit� par 4300 l'obscurit�" est un mythe et conduit � 4301 une mauvaise perception de ce qu'est la s�curit�.</div> 4302 4303 4304 4305<h3>Voir aussi</h3> 4306<ul> 4307<li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li> 4308</ul> 4309</div> 4310<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4311<div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">Directive</a></h2> 4312<table class="directive"> 4313<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force le traitement des fichiers sp�cifi�s par un 4314gestionnaire particulier</td></tr> 4315<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetHandler <var>nom gestionnaire</var>|None</code></td></tr> 4316<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 4317<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 4318<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4319<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4320</table> 4321 <p>Lorsqu'elle se situe � l'int�rieur d'un fichier 4322 <code>.htaccess</code>, ou d'une section <code class="directive"><a href="#directory"><Directory></a></code> ou <code class="directive"><a href="#location"><Location></a></code>, cette directive force le 4323 traitement de tous les fichiers sp�cifi�s par le <a href="/handler.html">gestionnaire</a> d�fini par l'argument 4324 <var>nom gestionnaire</var>. Par exemple, dans le cas d'un 4325 r�pertoire dont vous voulez interpr�ter le contenu comme des 4326 fichiers de r�gles d'images cliquables, sans tenir compte des 4327 extensions, vous pouvez ajouter la ligne suivante dans un fichier 4328 <code>.htaccess</code> de ce r�pertoire :</p> 4329 4330 <pre class="prettyprint lang-config">SetHandler imap-file</pre> 4331 4332 4333 <p>Autre exemple : si vous voulez que le serveur affiche un 4334 compte-rendu d'�tat chaque fois qu'une URL du type <code>http://nom 4335 serveur/status</code> est appel�e, vous pouvez ajouter ceci dans 4336 <code>httpd.conf</code> :</p> 4337 4338 <pre class="prettyprint lang-config"><Location "/status"> 4339 SetHandler server-status 4340</Location></pre> 4341 4342 4343 <p>Vous pouvez aussi utiliser cette directive pour associer un 4344 gestionnaire � des fichiers poss�dant une extension de nom de 4345 fichier particuli�re. Par exemple :</p> 4346 4347 <pre class="prettyprint lang-config"><FilesMatch \.php$> 4348 SetHandler application/x-httpd-php 4349</FilesMatch></pre> 4350 4351 4352 <p>Vous pouvez �craser la d�finition ant�rieure d'une directive 4353 <code class="directive">SetHandler</code> en utilisant la valeur 4354 <code>None</code>.</p> 4355 4356 <div class="note"><h3>Note</h3> 4357 <p>Comme <code class="directive">SetHandler</code> l'emporte sur la 4358 d�finition des gestionnaires par d�faut, le comportement habituel 4359 consistant � traiter les URLs se terminant par un slash (/) comme 4360 des r�pertoires ou des fichiers index est d�sactiv�.</p></div> 4361 4362<h3>Voir aussi</h3> 4363<ul> 4364<li><code class="directive"><a href="/mod/mod_mime.html#addhandler">AddHandler</a></code></li> 4365</ul> 4366</div> 4367<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4368<div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">Directive</a></h2> 4369<table class="directive"> 4370<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit les filtres par lesquels vont passer les requ�tes 4371client et les donn�es POST</td></tr> 4372<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetInputFilter <var>filtre</var>[;<var>filtre</var>...]</code></td></tr> 4373<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 4374<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 4375<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4376<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4377</table> 4378 <p>La directive <code class="directive">SetInputFilter</code> permet de 4379 d�finir le ou les filtres par lesquels vont passer les requ�tes 4380 client et les donn�es POST au moment o� le serveur les re�oit. Cette 4381 d�finition vient en ajout � tout autre filtre d�fini en 4382 quelqu'endroit que ce soit, y compris via la directive <code class="directive"><a href="/mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>.</p> 4383 4384 <p>Si la directive comporte plusieurs filtres, ils doivent �tre 4385 s�par�s par des points-virgules, et sp�cifi�s selon l'ordre dans 4386 lequel vous souhaitez les voir agir sur les contenus.</p> 4387 4388<h3>Voir aussi</h3> 4389<ul> 4390<li>documentation des <a href="/filter.html">Filtres</a></li> 4391</ul> 4392</div> 4393<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4394<div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">Directive</a></h2> 4395<table class="directive"> 4396<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit les filtres par lesquels vont passer les r�ponses 4397du serveur</td></tr> 4398<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetOutputFilter <var>filtre</var>[;<var>filtre</var>...]</code></td></tr> 4399<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 4400<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 4401<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4402<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4403</table> 4404 <p>La directive <code class="directive">SetOutputFilter</code> permet de 4405 d�finir les filtres par lesquels vont passer les r�ponses du serveur 4406 avant d'�tre envoy�es au client. Cette d�finition vient en ajout � 4407 tout autre filtre d�fini en quelqu'endroit que ce soit, y compris 4408 via la directive <code class="directive"><a href="/mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>.</p> 4409 4410 <p>Par exemple, la configuration suivante va traiter tous les 4411 fichiers du r�pertoire <code>/www/data/</code> comme des inclusions 4412 c�t� serveur (SSI) :</p> 4413 4414 <pre class="prettyprint lang-config"><Directory "/www/data/"> 4415 SetOutputFilter INCLUDES 4416</Directory></pre> 4417 4418 4419 <p>Si la directive comporte plusieurs filtres, ils doivent �tre 4420 s�par�s par des points-virgules, et sp�cifi�s selon l'ordre dans 4421 lequel vous souhaitez les voir agir sur les contenus.</p> 4422 4423<h3>Voir aussi</h3> 4424<ul> 4425<li><a href="/filter.html">Filters</a> documentation</li> 4426</ul> 4427</div> 4428<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4429<div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">Directive</a></h2> 4430<table class="directive"> 4431<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Temps pendant lequel le serveur va attendre certains 4432�v�nements avant de consid�rer qu'une requ�te a �chou�</td></tr> 4433<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TimeOut <var>secondes</var></code></td></tr> 4434<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>TimeOut 60</code></td></tr> 4435<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 4436<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4437<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4438</table> 4439 <p>La directive <code class="directive">TimeOut</code> permet de d�finir le 4440 temps maximum pendant lequel Apache httpd va attendre des entr�es/sorties 4441 selon les circonstances :</p> 4442 4443 <ol> 4444 <li>Lors de la lecture de donn�es en provenance du client, le 4445 temps maximum jusqu'� l'arriv�e d'un paquet TCP si le tampon est 4446 vide.</li> 4447 4448 <li>Lors de l'�criture de donn�es destin�es au client, le temps 4449 maximum jusqu'� l'arriv�e de l'accus�-r�ception d'un paquet si le 4450 tampon d'envoi est plein.</li> 4451 4452 <li>Avec <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>, le temps d'attente maximum des 4453 sorties d'un script CGI.</li> 4454 4455 <li>Avec <code class="module"><a href="/mod/mod_ext_filter.html">mod_ext_filter</a></code>, le temps d'attente 4456 maximum des sorties d'un processus de filtrage.</li> 4457 4458 <li>Avec <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>, la valeur du d�lai par d�faut 4459 si <code class="directive"><a href="/mod/mod_proxy.html#proxytimeout">ProxyTimeout</a></code> n'est 4460 pas d�fini.</li> 4461 </ol> 4462 4463 4464</div> 4465<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4466<div class="directive-section"><h2><a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a name="traceenable" id="traceenable">Directive</a></h2> 4467<table class="directive"> 4468<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�termine le comportement des requ�tes 4469<code>TRACE</code></td></tr> 4470<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr> 4471<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>TraceEnable on</code></td></tr> 4472<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 4473<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4474<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4475</table> 4476 <p>Cette directive l'emporte sur le comportement de 4477 <code>TRACE</code> pour le noyau du serveur et 4478 <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. La d�finition par d�faut 4479 <code>TraceEnable on</code> permet des requ�tes <code>TRACE</code> 4480 selon la RFC 2616, qui interdit d'ajouter tout corps � la requ�te. 4481 La d�finition <code>TraceEnable off</code> indique au noyau du 4482 serveur et � <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> de retourner un code 4483 d'erreur <code>405</code> (M�thode non autoris�e) au client.</p> 4484 4485 <p>En fait, et � des fins de test et de diagnostic seulement, on 4486 peut autoriser l'ajout d'un corps de requ�te � l'aide de la 4487 d�finition non standard <code>TraceEnable extended</code>. Le noyau 4488 du serveur (dans le cas d'un serveur d'origine) va limiter la taille 4489 du corps de requ�te � 64k (plus 8k pour les en-t�tes de 4490 fractionnement si <code>Transfer-Encoding: chunked</code> est 4491 utilis�). Le noyau du serveur va reproduire l'ensemble des en-t�tes, 4492 y compris les en-t�tes de fractionnement avec le corps de la 4493 r�ponse. Dans le cas d'un serveur mandataire, la taille du corps de 4494 requ�te n'est pas limit�e � 64k.</p> 4495 4496 <div class="note"><h3>Note</h3> 4497 <p>Bien que certains pr�tendent le contraire, <code>TRACE</code> ne 4498 constitue pas une vuln�rabilit� en mati�re de s�curit�, et il n'y a 4499 aucune raison suffisante pour le d�sactiver, ce qui rendrait 4500 votre serveur non conforme.</p> 4501 </div> 4502 4503</div> 4504<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4505<div class="directive-section"><h2><a name="UnDefine" id="UnDefine">UnDefine</a> <a name="undefine" id="undefine">Directive</a></h2> 4506<table class="directive"> 4507<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Invalide la d�finition d'une variable</td></tr> 4508<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UnDefine <var>nom-variable</var></code></td></tr> 4509<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 4510<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4511<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4512</table> 4513 <p>Annule l'effet d'une directive <code class="directive"><a href="#define">Define</a></code> ou d'un argument <code>-D</code> de 4514 <code class="program"><a href="/programs/httpd.html">httpd</a></code> en invalidant l'existence de la variable 4515 correspondante.</p> 4516 <p>On peut utiliser cette directive pour inverser l'effet d'une 4517 section <code class="directive"><a href="#ifdefine"><IfDefine></a></code> 4518 sans avoir � modifier les arguments <code>-D</code> dans les scripts 4519 de d�marrage.</p> 4520 4521</div> 4522<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4523<div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">Directive</a></h2> 4524<table class="directive"> 4525<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 4526et son port</td></tr> 4527<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr> 4528<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>UseCanonicalName Off</code></td></tr> 4529<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 4530<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4531<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4532</table> 4533 <p>Dans de nombreuses situations, Apache httpd doit construire une URL 4534 <em>auto-identifiante</em> -- c'est � dire une URL qui fait 4535 r�f�rence au serveur lui-m�me. Avec <code>UseCanonicalName 4536 On</code>, Apache httpd va utiliser le nom d'h�te et le port sp�cifi�s par 4537 la directive <code class="directive"><a href="#servername">ServerName</a></code> pour 4538 construire le nom canonique du serveur. Ce nom est utilis� dans 4539 toutes les URLs auto-identifiantes, et affect� aux variables 4540 <code>SERVER_NAME</code> et <code>SERVER_PORT</code> dans les 4541 programmes CGI.</p> 4542 4543 <p>Avec <code>UseCanonicalName Off</code>, Apache httpd va construire ses 4544 URLs auto-identifiantes � l'aide du nom d'h�te et du port fournis 4545 par le client, si ce dernier en a fourni un (dans la n�gative, 4546 Apache utilisera le nom canonique, de la m�me mani�re que 4547 ci-dessus). Ces valeurs sont les m�mes que celles qui sont utilis�es 4548 pour impl�menter les <a href="/vhosts/name-based.html">serveurs virtuels � base de 4549 nom</a>, et sont disponibles avec les m�mes clients. De m�me, les 4550 variables CGI <code>SERVER_NAME</code> et <code>SERVER_PORT</code> 4551 seront affect�es des valeurs fournies par le client.</p> 4552 4553 <p>Cette directive peut s'av�rer utile, par exemple, sur un serveur 4554 intranet auquel les utilisateurs se connectent en utilisant des noms 4555 courts tels que <code>www</code>. Si les utilisateurs tapent un nom 4556 court suivi d'une URL qui fait r�f�rence � un r�pertoire, comme 4557 <code>http://www/splat</code>, <em>sans le slash terminal</em>, vous 4558 remarquerez qu'Apache httpd va les rediriger vers 4559 <code>http://www.example.com/splat/</code>. Si vous avez activ� 4560 l'authentification, ceci va obliger l'utilisateur � s'authentifier 4561 deux fois (une premi�re fois pour <code>www</code> et une seconde 4562 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 4563 foire aux questions sur ce sujet pour plus d'informations</a>). 4564 Par contre, si <code class="directive">UseCanonicalName</code> est d�finie � 4565 <code>Off</code>, Apache httpd redirigera l'utilisateur vers 4566 <code>http://www/splat/</code>.</p> 4567 4568 <p>Pour l'h�bergement virtuel en masse � base d'adresse IP, on 4569 utilise une troisi�me option, <code>UseCanonicalName 4570 DNS</code>, pour supporter les clients anciens qui ne 4571 fournissent pas d'en-t�te <code>Host:</code>. Apache httpd effectue alors 4572 une recherche DNS inverse sur l'adresse IP du serveur auquel le 4573 client s'est connect� afin de construire ses URLs 4574 auto-identifiantes.</p> 4575 4576 <div class="warning"><h3>Avertissement</h3> 4577 <p>Les programmes CGI risquent d'�tre perturb�s par cette option 4578 s'ils tiennent compte de la variable <code>SERVER_NAME</code>. Le 4579 client est pratiquement libre de fournir la valeur qu'il veut comme 4580 nom d'h�te. Mais si le programme CGI n'utilise 4581 <code>SERVER_NAME</code> que pour construire des URLs 4582 auto-identifiantes, il ne devrait pas y avoir de probl�me.</p> 4583 </div> 4584 4585<h3>Voir aussi</h3> 4586<ul> 4587<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li> 4588<li><code class="directive"><a href="#servername">ServerName</a></code></li> 4589<li><code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code></li> 4590</ul> 4591</div> 4592<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4593<div class="directive-section"><h2><a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a> <a name="usecanonicalphysicalport" id="usecanonicalphysicalport">Directive</a></h2> 4594<table class="directive"> 4595<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit la mani�re dont le serveur 4596d�termine son propre port</td></tr> 4597<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr> 4598<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr> 4599<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr> 4600<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4601<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4602</table> 4603 <p>Dans de nombreuses situations, Apache httpd doit construire une URL 4604 <em>auto-identifiante</em> -- c'est � dire une URL qui fait 4605 r�f�rence au serveur lui-m�me. Avec <code>UseCanonicalPhysicalPort 4606 On</code>, Apache httpd va fournir le num�ro de port physique r�el utilis� 4607 par la requ�te en tant que port potentiel, pour construire le port 4608 canonique afin que le serveur puisse alimenter la directive 4609 <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>. Avec 4610 <code>UseCanonicalPhysicalPort Off</code>, Apache httpd n'utilisera pas le 4611 num�ro de port physique r�el, mais au contraire se r�f�rera aux 4612 informations de configuration pour construire un num�ro de port 4613 valide.</p> 4614 4615 <div class="note"><h3>Note</h3> 4616 <p>L'ordre dans lequel s'effectue la recherche quand on utilise le 4617 port physique est le suivant :</p> 4618 <dl> 4619 <dt><code>UseCanonicalName On</code></dt> 4620 <dd> 4621 <ol> 4622 <li>Port indiqu� dans <code class="directive"><a href="#servername">Servername</a></code></li> 4623 <li>Port physique</li> 4624 <li>Port par d�faut</li> 4625 </ol> 4626 </dd> 4627 <dt><code>UseCanonicalName Off | DNS</code></dt> 4628 <dd> 4629 <ol> 4630 <li>Port sp�cifi� dans l'en-t�te <code>Host:</code></li> 4631 <li>Port physique</li> 4632 <li>Port sp�cifi� par <code class="directive"><a href="#servername">Servername</a></code></li> 4633 <li>Port par d�faut</li> 4634 </ol> 4635 </dd> 4636 </dl> 4637 4638 <p>Avec <code>UseCanonicalPhysicalPort Off</code>, on reprend 4639 l'ordre ci-dessus en supprimant "Port physique".</p> 4640 </div> 4641 4642 4643<h3>Voir aussi</h3> 4644<ul> 4645<li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li> 4646<li><code class="directive"><a href="#servername">ServerName</a></code></li> 4647<li><code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code></li> 4648</ul> 4649</div> 4650<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 4651<div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost"><VirtualHost></a> <a name="virtualhost" id="virtualhost">Directive</a></h2> 4652<table class="directive"> 4653<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent qu'� un nom 4654d'h�te sp�cifique ou � une adresse IP</td></tr> 4655<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><VirtualHost 4656 <var>adresse IP</var>[:<var>port</var>] [<var>adresse 4657 IP</var>[:<var>port</var>]] ...> ... 4658 </VirtualHost></code></td></tr> 4659<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 4660<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr> 4661<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr> 4662</table> 4663 <p>Les balises <code class="directive"><VirtualHost></code> et 4664 <code></VirtualHost></code> permettent de rassembler un groupe 4665 de directives qui ne s'appliquent qu'� un serveur virtuel 4666 particulier. Toute directive autoris�e dans un contexte de serveur 4667 virtuel peut �tre utilis�e. Lorsque le serveur re�oit un requ�te 4668 pour un document h�berg� par un serveur virtuel particulier, il 4669 applique les directives de configuration rassembl�es dans la section 4670 <code class="directive"><VirtualHost></code>. <var>adresse 4671 IP</var> peut �tre une des entit�s suivantes, �ventuellement suivies 4672 d'un caract�re ':' et d'un num�ro de port (ou *) :</p> 4673 4674 <ul> 4675 <li>L'adresse IP du serveur virtuel ;</li> 4676 4677 <li>Un nom de domaine enti�rement qualifi� correspondant � 4678 l'adresse IP du serveur virtuel (non recommand�) ;</li> 4679 4680 <li>Le caract�re <code>*</code>, qui agit comme un 4681 caract�re g�n�rique, et correspond � toute adresse IP.</li> 4682 4683 <li>La cha�ne <code>_default_</code>, dont la signification est 4684 identique � celle du caract�re <code>*</code></li> 4685 4686 </ul> 4687 4688 <pre class="prettyprint lang-config"><VirtualHost 10.1.2.3:80> 4689 ServerAdmin webmaster@host.example.com 4690 DocumentRoot /www/docs/host.example.com 4691 ServerName host.example.com 4692 ErrorLog logs/host.example.com-error_log 4693 TransferLog logs/host.example.com-access_log 4694</VirtualHost></pre> 4695 4696 4697 4698 <p>Les adresses IPv6 doivent �tre entour�es de crochets car dans le 4699 cas contraire, un �ventuel port optionnel ne pourrait pas �tre 4700 d�termin�. Voici un exemple de serveur virtuel avec adresse IPv6 4701 :</p> 4702 4703 <pre class="prettyprint lang-config"><VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80> 4704 ServerAdmin webmaster@host.example.com 4705 DocumentRoot /www/docs/host.example.com 4706 ServerName host.example.com 4707 ErrorLog logs/host.example.com-error_log 4708 TransferLog logs/host.example.com-access_log 4709</VirtualHost></pre> 4710 4711 4712 <p>Chaque serveur virtuel doit correspondre � une adresse IP, un 4713 port ou un nom d'h�te sp�cifique ; dans le premier cas, le serveur 4714 doit �tre configur� pour recevoir les paquets IP de plusieurs 4715 adresses (si le serveur n'a qu'une interface r�seau, on peut 4716 utiliser � cet effet la commande <code>ifconfig alias</code> -- si 4717 votre syst�me d'exploitation le permet).</p> 4718 4719 <div class="note"><h3>Note</h3> 4720 <p>L'utilisation de la directive <code class="directive"><VirtualHost></code> n'affecte en rien les 4721 adresses IP sur lesquelles Apache httpd est en �coute. Vous devez vous 4722 assurer que les adresses des serveurs virtuels sont bien incluses 4723 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> 4724 </div> 4725 4726 <p>Tout bloc <code class="directive"><VirtualHost></code> doit comporter une directive 4727 <code class="directive"><a href="#servername">ServerName</a></code>. Dans le cas 4728 contraire, le serveur virtuel h�ritera de la valeur de la directive 4729 <code class="directive"><a href="#servername">ServerName</a></code> issue de la 4730 configuration du serveur principal.</p> 4731 4732 <p>A l'arriv�e d'une requ�te, le serveur tente de la 4733 faire prendre en compte par la section <code class="directive"><VirtualHost></code> qui correspond le mieux en ne 4734 se basant que sur la paire adresse IP/port. Les cha�nes sans 4735 caract�res g�n�riques l'emportent sur celles qui en contiennent. Si 4736 aucune correspondance du point de vue de l'adresse IP/port n'est 4737 trouv�e, c'est la configuration du serveur "principal" qui sera 4738 utilis�e.</p> 4739 4740 <p>Si plusieurs serveurs virtuels correspondent du point de vue de 4741 l'adresse IP/port, le serveur s�lectionne celui qui correspond le 4742 mieux du point de vue du nom d'h�te de la requ�te. Si aucune 4743 correspondance du point de vue du nom d'h�te n'est trouv�e, c'est le 4744 premier serveur virtuel dont l'adresse IP/port correspond qui sera 4745 utilis�. Par voie de cons�quence, le premier serveur virtuel 4746 comportant une certaine paire adresse IP/port est le serveur virtuel 4747 par d�faut pour cette paire adresse IP/port.</p> 4748 4749 <div class="warning"><h3>S�curit�</h3> 4750 <p>Voir le document sur les <a href="/misc/security_tips.html">conseils � propos de s�curit�</a> 4751 pour une description d�taill�e des raisons pour lesquelles la 4752 s�curit� de votre serveur pourrait �tre compromise, si le r�pertoire 4753 contenant les fichiers journaux est inscriptible par tout autre 4754 utilisateur que celui qui d�marre le serveur.</p> 4755 </div> 4756 4757<h3>Voir aussi</h3> 4758<ul> 4759<li><a href="/vhosts/">Documentation des serveurs virtuels 4760du serveur HTTP Apache</a></li> 4761<li><a href="/dns-caveats.html">Probl�mes concernant le DNS et 4762le serveur HTTP Apache</a></li> 4763<li><a href="/bind.html">D�finition des adresses et ports 4764qu'utilise le serveur HTTP Apache</a></li> 4765<li><a href="/sections.html">Comment fonctionnent les sections 4766<Directory>, <Location> et <Files></a> pour une 4767explication de la mani�re dont ces diff�rentes sections se combinent 4768entre elles � la r�ception d'une requ�te</li> 4769</ul> 4770</div> 4771</div> 4772<div class="bottomlang"> 4773<p><span>Langues Disponibles: </span><a href="/de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | 4774<a href="/en/mod/core.html" hreflang="en" rel="alternate" title="English"> en </a> | 4775<a href="/es/mod/core.html" hreflang="es" rel="alternate" title="Espa�ol"> es </a> | 4776<a href="/fr/mod/core.html" title="Fran�ais"> fr </a> | 4777<a href="/ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 4778<a href="/tr/mod/core.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 4779</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 4780<script type="text/javascript"><!--//--><![CDATA[//><!-- 4781var comments_shortname = 'httpd'; 4782var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/core.html'; 4783(function(w, d) { 4784 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 4785 d.write('<div id="comments_thread"><\/div>'); 4786 var s = d.createElement('script'); 4787 s.type = 'text/javascript'; 4788 s.async = true; 4789 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 4790 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 4791 } 4792 else { 4793 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 4794 } 4795})(window, document); 4796//--><!]]></script></div><div id="footer"> 4797<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 4798<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 4799if (typeof(prettyPrint) !== 'undefined') { 4800 prettyPrint(); 4801} 4802//--><!]]></script> 4803</body></html>