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