core.html.fr revision 91f378b5a10f2d83820902ed10ba7967a3920c18
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>core - Serveur Apache HTTP</title>
<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="/images/favicon.ico" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.3</p>
<img alt="" src="/images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Fonctionalit�s de Base Apache</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="/de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="/en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="/fr/mod/core.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
<a href="/ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/tr/mod/core.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fonctionnalit�s de base du serveur HTTP Apache toujours
disponibles</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Core</td></tr></table>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="/images/down.gif" /> <a href="#acceptfilter">AcceptFilter</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#acceptpathinfo">AcceptPathInfo</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#accessfilename">AccessFileName</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#adddefaultcharset">AddDefaultCharset</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#addoutputfilterbytype">AddOutputFilterByType</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#allowencodedslashes">AllowEncodedSlashes</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#allowoverride">AllowOverride</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#cgimapextension">CGIMapExtension</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#contentdigest">ContentDigest</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#defaulttype">DefaultType</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#define">Define</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#directory">&lt;Directory&gt;</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#directorymatch">&lt;DirectoryMatch&gt;</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#documentroot">DocumentRoot</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#enablemmap">EnableMMAP</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#enablesendfile">EnableSendfile</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#errordocument">ErrorDocument</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#errorlog">ErrorLog</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#fileetag">FileETag</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#files">&lt;Files&gt;</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#filesmatch">&lt;FilesMatch&gt;</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#forcetype">ForceType</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#hostnamelookups">HostnameLookups</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#if">&lt;If&gt;</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#ifdefine">&lt;IfDefine&gt;</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#ifmodule">&lt;IfModule&gt;</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#include">Include</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#keepalive">KeepAlive</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#keepalivetimeout">KeepAliveTimeout</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#limit">&lt;Limit&gt;</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#limitexcept">&lt;LimitExcept&gt;</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#limitinternalrecursion">LimitInternalRecursion</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestbody">LimitRequestBody</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfields">LimitRequestFields</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestfieldsize">LimitRequestFieldSize</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#limitrequestline">LimitRequestLine</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#limitxmlrequestbody">LimitXMLRequestBody</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#location">&lt;Location&gt;</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#locationmatch">&lt;LocationMatch&gt;</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#loglevel">LogLevel</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#namevirtualhost">NameVirtualHost</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#rlimitcpu">RLimitCPU</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#rlimitmem">RLimitMEM</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#rlimitnproc">RLimitNPROC</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#scriptinterpretersource">ScriptInterpreterSource</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#serveradmin">ServerAdmin</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#serveralias">ServerAlias</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#servername">ServerName</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#serverpath">ServerPath</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#serverroot">ServerRoot</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#serversignature">ServerSignature</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#servertokens">ServerTokens</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#sethandler">SetHandler</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#setinputfilter">SetInputFilter</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#setoutputfilter">SetOutputFilter</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#timeout">TimeOut</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#traceenable">TraceEnable</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalname">UseCanonicalName</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#virtualhost">&lt;VirtualHost&gt;</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="AcceptFilter" id="AcceptFilter">AcceptFilter</a> <a name="acceptfilter" id="acceptfilter">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet d'optimiser la configuration d'une socket pour
l'�coute d'un protocole</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptFilter <var>protocole</var> <var>filtre
d'acceptation</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.3 sous Windows et 2.1.5
sur les autres plates-formes.</td></tr>
</table>
<p>Cette directive permet d'effectuer une optimisation de la socket
d'�coute d'un type de protocole en fonction du syst�me
d'exploitation. Le but premier est de faire en sorte que le noyau
n'envoie pas de socket au processus du serveur jusqu'� ce que
des donn�es soient re�ues, ou qu'une requ�te HTTP compl�te soit mise
en tampon. Seuls les <a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&amp; sektion=9">Filtres d'acceptation de FreeBSD</a>, le filtre plus
primitif <code>TCP_DEFER_ACCEPT</code> sous Linux, et la version
optimis�e d'AcceptEx() de Windows sont actuellement support�s.</p>
<p>L'utilisation de l'argument <code>none</code> va d�sactiver tout
filtre d'acceptation pour ce protocole. Ceci s'av�re utile pour les
protocoles qui n�cessitent l'envoi de donn�es par le serveur en
premier, comme <code>ftp:</code> ou <code>nntp</code>:</p>
<div class="example"><p><code>AcceptFilter nntp none</code></p></div>
<p>Sous FreeBSD, les valeurs par d�faut sont :</p>
<div class="example"><p><code>
AcceptFilter http httpready <br />
AcceptFilter https dataready
</code></p></div>
<p>Le filtre d'acceptation <code>httpready</code> met en tampon des
requ�tes HTTP enti�res au niveau du noyau. Quand une requ�te
enti�re a �t� re�ue, le noyau l'envoie au serveur. Voir la page de
manuel de <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&amp; sektion=9">accf_http(9)</a> pour plus de d�tails. Comme les requ�tes
HTTPS sont chiffr�es, celles-ci n'autorisent que le filtre <a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&amp; sektion=9">accf_data(9)</a>.</p>
<p>Sous Linux, les valeurs par d�faut sont :</p>
<div class="example"><p><code>
AcceptFilter http data <br />
AcceptFilter https data
</code></p></div>
<p>Le filtre <code>TCP_DEFER_ACCEPT</code> de Linux ne supporte pas
la mise en tampon des requ�tes http. Toute valeur autre que
<code>none</code> active le filtre <code>TCP_DEFER_ACCEPT</code>
pour ce protocole. Pour plus de d�tails, voir la page de
manuel Linux de <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/ tcp.7.html">tcp(7)</a>.</p>
<p>Sous Windows, les valeurs par d�faut sont :</p>
<div class="example"><p><code>
AcceptFilter http data <br />
AcceptFilter https data
</code></p></div>
<p>Le module MPM pour Windows mpm_winnt utilise la directive
AcceptFilter comme commutateur de l'API AcceptEx(), et ne supporte
pas la mise en tampon du protocole http. Deux valeurs utilisent
l'API Windows AcceptEx() et vont recycler les sockets r�seau entre
les connexions. <code>data</code> attend jusqu'� ce que les donn�es
aient �t� transmises comme d�crit plus haut, et le tampon de donn�es
initiales ainsi que les adresses r�seau finales sont tous extraits
gr�ce � une seule invocation d'AcceptEx(). <code>connect</code>
utilise l'API AcceptEx(), extrait aussi les adresses r�seau finales,
mais � l'instar de <code>none</code>, la valeur <code>connect</code>
n'attend pas la transmission des donn�es initiales.</p>
<p>Sous Windows, <code>none</code> utilise accept() au lieu
d'AcceptEx(), et ne recycle pas les sockets entre les connexions.
Ceci s'av�re utile pour les interfaces r�seau dont le pilote est
d�fectueux, ainsi que pour certains fournisseurs de r�seau comme les
pilotes vpn, ou les filtres anti-spam, anti-virus ou
anti-spyware.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="AcceptPathInfo" id="AcceptPathInfo">AcceptPathInfo</a> <a name="acceptpathinfo" id="acceptpathinfo">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les ressources acceptent des informations sous forme d'un
nom de chemin en fin de requ�te.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AcceptPathInfo On|Off|Default</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AcceptPathInfo Default</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible dans Apache version 2.0.30 et
sup�rieures</td></tr>
</table>
<p>Cette directive permet de d�finir si les requ�tes contenant des
informations sous forme d'un nom de chemin suivant le nom d'un
fichier r�el (ou un fichier qui n'existe pas dans un r�pertoire qui
existe) doivent �tre accept�es ou rejet�es. Les scripts peuvent
acc�der � cette information via la variable d'environnement
<code>PATH_INFO</code>.</p>
<p>Supposons par exemple que <code>/test/</code> pointe vers un
r�pertoire qui ne contient que le fichier <code>here.html</code>.
Les requ�tes pour <code>/test/here.html/more</code> et
<code>/test/nothere.html/more</code> vont affecter la valeur
<code>/more</code> � la variable d'environnement
<code>PATH_INFO</code>.</p>
<p>L'argument de la directive <code class="directive">AcceptPathInfo</code>
poss�de trois valeurs possibles :</p>
<dl>
<dt><code>Off</code></dt><dd>Une requ�te ne sera accept�e que si
elle correspond � un chemin qui existe. Par cons�quent, une requ�te
contenant une information de chemin apr�s le nom de fichier r�el
comme <code>/test/here.html/more</code> dans l'exemple ci-dessus
renverra une erreur "404 NOT FOUND".</dd>
<dt><code>On</code></dt><dd>Une requ�te sera accept�e si la partie
principale du chemin correspond � un fichier existant. Dans
l'exemple ci-dessus <code>/test/here.html/more</code>, la requ�te
sera accept�e si <code>/test/here.html</code> correspond � un nom de
fichier valide.</dd>
<dt><code>Default</code></dt><dd>Le traitement des requ�tes est
d�termin� par le <a href="/handler.html">gestionnaire</a> responsable de la requ�te.
Le gestionnaire de base pour les fichiers normaux rejette par d�faut
les requ�tes avec <code>PATH_INFO</code>. Les gestionnaires qui
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
d�faut les requ�tes avec <code>PATH_INFO</code>.</dd>
</dl>
<p>Le but premier de la directive <code>AcceptPathInfo</code> est de
vous permettre de remplacer le choix du gestionnaire d'accepter ou
de rejeter <code>PATH_INFO</code>. Ce remplacement est n�cessaire
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�
sur <code>PATH_INFO</code>. Le gestionnaire de base va en g�n�ral
rejeter la requ�te, et vous pouvez utiliser la configuration
suivante pour utiliser un tel script :</p>
<div class="example"><p><code>
&lt;Files "mes-chemins.shtml"&gt;<br />
<span class="indent">
Options +Includes<br />
SetOutputFilter INCLUDES<br />
AcceptPathInfo On<br />
</span>
&lt;/Files&gt;
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="AccessFileName" id="AccessFileName">AccessFileName</a> <a name="accessfilename" id="accessfilename">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du fichier de configuration distribu�</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AccessFileName <var>nom-du-fichier</var>
[<var>nom-du-fichier</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AccessFileName .htaccess</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Au cours du traitement d'une requ�te, le serveur recherche le
premier fichier de configuration existant � partir de la liste
de noms dans chaque r�pertoire composant le chemin du document, �
partir du moment o� les fichiers de configuration distribu�s sont <a href="#allowoverride">activ�s pour ce r�pertoire</a>. Par exemple
:</p>
<div class="example"><p><code>
AccessFileName .acl
</code></p></div>
<p>avant de renvoyer le document
<code>/usr/local/web/index.html</code>, le serveur va rechercher les
fichiers <code>/.acl</code>, <code>/usr/.acl</code>,
<code>/usr/local/.acl</code> et <code>/usr/local/web/.acl</code>
pour y lire d'�ventuelles directives, � moins quelles n'aient �t�
d�sactiv�es avec</p>
<div class="example"><p><code>
&lt;Directory /&gt;<br />
<span class="indent">
AllowOverride None<br />
</span>
&lt;/Directory&gt;
</code></p></div>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#allowoverride">AllowOverride</a></code></li>
<li><a href="/configuring.html">Fichiers de configuration</a></li>
<li><a href="/howto/htaccess.html">Fichiers .htaccess</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="AddDefaultCharset" id="AddDefaultCharset">AddDefaultCharset</a> <a name="adddefaultcharset" id="adddefaultcharset">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Param�tre jeu de caract�res par d�faut � ajouter quand le
type de contenu d'une r�ponse est <code>text/plain</code> ou
<code>text/html</code></td></tr>
<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>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AddDefaultCharset Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Cette directive sp�cifie une valeur par d�faut pour le param�tre
jeu de caract�res du type de m�dia (le nom d'un codage de
caract�res) � ajouter � une r�ponse, si et seulement si le type de
contenu de la r�ponse est soit <code>text/plain</code>, soit
<code>text/html</code>. Ceci va remplacer
tout jeu de caract�res sp�cifi� dans le corps de la r�ponse via un
�l�ment <code>META</code>, bien que cet effet d�pende en fait
souvent de la configuration du client de l'utilisateur. La
d�finition de <code>AddDefaultCharset Off</code> d�sactive cette
fonctionnalit�. <code>AddDefaultCharset On</code> ajoute un jeu de
caract�res par d�faut de <code>iso-8859-1</code>. Toute autre valeur
peut �tre d�finie via le param�tre <var>jeu de caract�res</var>, qui
doit appartenir � la liste des <a href="http://www.iana.org/assignments/character-sets">valeurs de
jeux de caract�res enregistr�s par l'IANA</a> � utiliser dans les
types de m�dia Internet (types MIME).
Par exemple :</p>
<div class="example"><p><code>
AddDefaultCharset utf-8
</code></p></div>
<p>La directive <code class="directive">AddDefaultCharset</code> ne doit
�tre utilis�e que lorsque toutes les ressources textes auxquelles
elle s'applique poss�dent le jeu de caract�re sp�cifi�, et qu'il est
trop contraignant de d�finir leur jeu de caract�res
individuellement. Un exemple de ce type est l'ajout du param�tre jeu
de caract�res aux ressources comportant un contenu g�n�r�, comme les
scripts CGI h�rit�s qui peuvent �tre vuln�rables � des attaques de
type cross-site scripting � cause des donn�es utilisateurs incluses
dans leur sortie. Notez cependant qu'une meilleur solution consiste
� corriger (ou supprimer) ces scripts, car la d�finition d'un jeu de
caract�res par d�faut ne prot�ge pas les utilisateurs qui ont activ�
la fonctionnalit� "D�tection automatique de l'encodage des
caract�res" dans leur navigateur.</p>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="/mod/mod_mime.html#addcharset">AddCharset</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a> <a name="addoutputfilterbytype" id="addoutputfilterbytype">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>assigne un filtre en sortie pour un type de m�dia
particulier</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddOutputFilterByType <var>filtre</var>[;<var>filtre</var>...]
<var>type de m�dia</var> [<var>type de m�dia</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible dans Apache version 2.0.33 et sup�rieures ;
obsol�te dans les versions 2.1 et sup�rieures</td></tr>
</table>
<p>Cette directive active un <a href="/filter.html">filtre</a> en sortie particulier pour une
requ�te en fonction du <a class="glossarylink" href="/glossary.html#type de m�dia" title="voir glossaire">type de m�dia</a> de la r�ponse.
Suite � certains probl�mes �voqu�s plus loin, cette directive a �t�
abandonn�e. Le m�me r�sultat peut �tre obtenu � l'aide du module
<code class="module"><a href="/mod/mod_filter.html">mod_filter</a></code>.</p>
<p>L'exemple suivant active le filtre <code>DEFLATE</code> qui est
fourni par le module <code class="module"><a href="/mod/mod_deflate.html">mod_deflate</a></code>. Il va compresser
toute sortie dont le type MIME est <code>text/html</code> ou
<code>text/plain</code> avant de l'envoyer au client.</p>
<div class="example"><p><code>
AddOutputFilterByType DEFLATE text/html text/plain
</code></p></div>
<p>Si vous voulez assigner plusieurs filtres au contenu, leurs noms
doivent �tre s�par�s par des points-virgules. On peut aussi utiliser
une directive <code class="directive">AddOutputFilterByType</code> pour
chacun des filtres � assigner.</p>
<p>La configuration ci-dessous impose le traitement de toute sortie
de script dont le type MIME est <code>text/html</code> en premier
lieu par le filtre <code>INCLUDES</code>, puis par le filtre
<code>DEFLATE</code>.</p>
<div class="example"><p><code>
&lt;Location /cgi-bin/&gt;<br />
<span class="indent">
Options Includes<br />
AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
</span>
&lt;/Location&gt;
</code></p></div>
<div class="warning"><h3>Note</h3>
<p>L'activation de filtres par la directive
<code class="directive">AddOutputFilterByType</code> peut partiellement
�chouer, ou m�me compl�tement dans certains cas. Par exemple,
aucun filtre n'est appliqu� si le <a class="glossarylink" href="/glossary.html#type de&#10; m�dia" title="voir glossaire">type de
m�dia</a> n'a pas pu �tre d�termin�. Si vous voulez vous
assurer que les filtres seront
appliqu�s, assignez explicitement le type de contenu � une
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
d�finir le type de contenu dans un script CGI (non-nph).</p>
</div>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="/mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li>
<li><code class="directive"><a href="#setoutputfilter">SetOutputFilter</a></code></li>
<li><a href="/filter.html">Les filtres</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="AllowEncodedSlashes" id="AllowEncodedSlashes">AllowEncodedSlashes</a> <a name="allowencodedslashes" id="allowencodedslashes">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�termine si les s�parateurs de chemin encod�s sont
autoris�s � transiter dans les URLs tels quels</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowEncodedSlashes On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AllowEncodedSlashes Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible dans Apache version 2.0.46 et
sup�rieures</td></tr>
</table>
<p>La directive <code class="directive">AllowEncodedSlashes</code> permet
l'utilisation des URLs contenant des s�parateurs de chemin encod�s
(<code>%2F</code> pour <code>/</code> et m�me <code>%5C</code> pour
<code>\</code> sur les syst�mes concern�s). Habituellement, ces URLs
sont rejet�es avec un code d'erreur 404 (Not found).</p>
<p>D�finir <code class="directive">AllowEncodedSlashes</code> �
<code>On</code> est surtout utile en association avec
<code>PATH_INFO</code>.</p>
<div class="note"><h3>Note</h3>
<p>Permettre les slashes encod�s n'implique <em>pas</em> leur
<em>d�codage</em>. Toutes les occurrences de <code>%2F</code> ou
<code>%5C</code> (<em>seulement</em> sur les syst�mes concern�s)
seront laiss�s telles quelles dans la cha�ne de l'URL d�cod�e.</p>
</div>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#acceptpathinfo">AcceptPathInfo</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="AllowOverride" id="AllowOverride">AllowOverride</a> <a name="allowoverride" id="allowoverride">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Types de directives autoris�es dans les fichiers
<code>.htaccess</code></td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowOverride All|None|<var>type directive</var>
[<var>type directive</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AllowOverride All</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Lorsque le serveur trouve un fichier <code>.htaccess</code> (dont
le nom est d�fini par la directive <code class="directive"><a href="#accessfilename">AccessFileName</a></code>), il doit savoir lesquelles
des directives plac�es dans ce fichier sont autoris�es � modifier la
configuration pr�existante.</p>
<div class="note"><h3>Valable seulement dans les sections
&lt;Directory&gt;</h3>
La directive <code class="directive">AllowOverride</code> ne peut �tre
utilis�e que dans les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> d�finies sans expressions
rationnelles, et non dans les sections <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, <code class="directive"><a href="#directorymatch">&lt;DirectoryMatch&gt;</a></code> ou
<code class="directive"><a href="#files">&lt;Files&gt;</a></code>.
</div>
<p>Lorsque cette directive est d�finie � <code>None</code>, les
fichiers <a href="#accessfilename">.htaccess</a> sont totalement
ignor�s. Dans ce cas, le serveur n'essaiera m�me pas de lire les
fichiers <code>.htaccess</code> du syst�me de fichiers.</p>
<p>Lorsque cette directive est d�finie � <code>All</code>, toute
directive valable dans le <a href="directive-dict.html#Context">Contexte</a> .htaccess sera
autoris�e dans les fichiers <code>.htaccess</code>.</p>
<p>L'argument <var>type directive</var> peut contenir les
groupements de directives suivants :</p>
<dl>
<dt>AuthConfig</dt>
<dd>
Permet l'utilisation des directives d'autorisation (<code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code>,
<code class="directive"><a href="/mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>,
<code class="directive"><a href="/mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code>,
<code class="directive"><a href="/mod/mod_authn_core.html#authname">AuthName</a></code>,
<code class="directive"><a href="/mod/mod_authn_core.html#authtype">AuthType</a></code>, <code class="directive"><a href="/mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>, <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code>, <em>etc...</em>).</dd>
<dt>FileInfo</dt>
<dd>
Permet l'utilisation des directives qui contr�lent les types de
documents (directives <code class="directive"><a href="#errordocument">ErrorDocument</a></code>, <code class="directive"><a href="#forcetype">ForceType</a></code>, <code class="directive"><a href="/mod/mod_negotiation.html#languagepriority">LanguagePriority</a></code>,
<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
module <code class="module"><a href="/mod/mod_mime.html">mod_mime</a></code> Add* et Remove*), 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
module <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> <code class="directive"><a href="/mod/mod_rewrite.html#rewriteengine">RewriteEngine</a></code>, <code class="directive"><a href="/mod/mod_rewrite.html#rewriteoptions">RewriteOptions</a></code>, <code class="directive"><a href="/mod/mod_rewrite.html#rewritebase">RewriteBase</a></code>, <code class="directive"><a href="/mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>, <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>) et de la directive
<code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code> du module
<code class="module"><a href="/mod/mod_actions.html">mod_actions</a></code>.
</dd>
<dt>Indexes</dt>
<dd>
Permet l'utilisation des directives qui contr�lent l'indexation
des r�pertoires (<code class="directive"><a href="/mod/mod_autoindex.html#adddescription">AddDescription</a></code>,
<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>,
<code class="directive"><a href="/mod/mod_autoindex.html#addiconbytype">AddIconByType</a></code>,
<code class="directive"><a href="/mod/mod_autoindex.html#defaulticon">DefaultIcon</a></code>, <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#fancyindexing">FancyIndexing</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#headername">HeaderName</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#indexignore">IndexIgnore</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#indexoptions">IndexOptions</a></code>, <code class="directive"><a href="/mod/mod_autoindex.html#readmename">ReadmeName</a></code>,
<em>etc...</em>).</dd>
<dt>Limit</dt>
<dd>
Permet l'utilisation des directives contr�lant l'acc�s au serveur
(<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>
<dt>Options[=<var>Option</var>,...]</dt>
<dd>
Permet l'utilisation des directives contr�lant les fonctionnalit�s
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
suivi d'un signe "�gal", puis d'une liste d'options s�par�es par des
virgules (pas d'espaces) ; ces options doivent �tre d�finies �
l'aide de la commande <code class="directive"><a href="#options">Options</a></code>.</dd>
</dl>
<p>Exemple :</p>
<div class="example"><p><code>
AllowOverride AuthConfig Indexes
</code></p></div>
<p>Dans l'exemple ci-dessus, toutes les directives qui ne font
partie ni du groupe <code>AuthConfig</code>, ni du groupe
<code>Indexes</code>, provoquent une erreur "internal
server error".</p>
<div class="note"><p>Pour des raisons de s�curit� et de performance, ne
d�finissez pas <code>AllowOverride</code> � autre chose que
<code>None</code> dans votre bloc <code>&lt;Directory /&gt;</code>.
Recherchez plut�t (ou cr�ez) le bloc <code>&lt;Directory&gt;</code>
qui se r�f�re au r�pertoire o� vous allez pr�cis�ment placer un
fichier <code>.htaccess</code>.</p>
</div>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#accessfilename">AccessFileName</a></code></li>
<li><a href="/configuring.html">Configuration Files</a></li>
<li><a href="/howto/htaccess.html">.htaccess Files</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="CGIMapExtension" id="CGIMapExtension">CGIMapExtension</a> <a name="cgimapextension" id="cgimapextension">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Technique permettant de localiser l'interpr�teur des
scripts CGI</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CGIMapExtension <var>chemin CGI</var> <var>.extension</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>NetWare uniquement</td></tr>
</table>
<p>Cette directive permet de contr�ler la mani�re dont Apache trouve
l'interpr�teur servant � ex�cuter les scripts CGI. Par exemple, avec
la d�finition <code>CGIMapExtension sys:\foo.nlm .foo</code>, tous
les fichiers scripts CGI poss�dant une extension <code>.foo</code>
seront pass�s � l'interpr�teur FOO.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ContentDigest" id="ContentDigest">ContentDigest</a> <a name="contentdigest" id="contentdigest">Directive</a></h2>
<table class="directive">
<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>
dans la r�ponse HTTP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ContentDigest On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ContentDigest Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Options</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Cette directive active la g�n�ration d'un en-t�te
<code>Content-MD5</code> selon les d�finitions des RFC 1864 et
2616.</p>
<p>MD5 est un algorithme permettant de g�n�rer un condens� (parfois
appel� "empreinte") � partir de donn�es d'une taille al�atoire ; le
degr� de pr�cision est tel que la moindre alt�ration des donn�es
d'origine entra�ne une alt�ration de l'empreinte.</p>
<p>L'en-t�te <code>Content-MD5</code> permet de v�rifier
l'int�grit� de la r�ponse HTTP dans son ensemble. Un serveur mandataire
ou un client peut utiliser cet en-t�te pour rechercher une
�ventuelle modification accidentelle de la r�ponse au cours de sa
transmission. Exemple d'en-t�te :</p>
<div class="example"><p><code>
Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
</code></p></div>
<p>Notez que des probl�mes de performances peuvent affecter votre
serveur, car l'empreinte est g�n�r�e pour chaque requ�te (il n'y a
pas de mise en cache).</p>
<p>L'en-t�te <code>Content-MD5</code> n'est envoy� qu'avec les
documents servis par le module <code class="module"><a href="/mod/core.html">core</a></code>, � l'exclusion
de tout autre module. Ainsi, les documents SSI, les sorties de
scripts CGI, et les r�ponses � des requ�tes partielles (byte range)
ne comportent pas cet en-t�te.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="DefaultType" id="DefaultType">DefaultType</a> <a name="defaulttype" id="defaulttype">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les seuls effets de cette directive sont des �missions
d'avertissements si sa valeur est diff�rente de <code>none</code>. Dans
les versions pr�c�dentes, DefaultType permettait de sp�cifier un type de
m�dia � assigner par d�faut au contenu d'une r�ponse pour lequel aucun
autre type de m�dia n'avait �t� trouv�.
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultType <var>type m�dia|none</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>DefaultType none</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>L'argument <code>none</code> est disponible dans les
versions d'Apache 2.2.7 et sup�rieures. Tous les autres choix sont
DESACTIV�S � partir des version 2.3.x.</td></tr>
</table>
<p>Cette directive a �t� d�sactiv�e. Pour la compatibilit�
ascendante avec les anciens fichiers de configuration, elle peut
�tre sp�cifi�e avec la valeur <code>none</code>, c'est � dire sans
type de m�dium par d�faut. Par exemple :</p>
<div class="example"><p><code>
DefaultType None
</code></p></div>
<p><code>DefaultType None</code> n'est disponible que dans les
versions d'Apache 2.2.7 et sup�rieures.</p>
<p>Utilisez le fichier de configuration mime.types et la directive
<code class="directive"><a href="/mod/mod_mime.html#addtype">AddType</a></code> pour configurer
l'assignement d'un type de m�dium via les extensions de fichiers, ou
la directive <code class="directive"><a href="#forcetype">ForceType</a></code> pour
attribuer un type de m�dium � des ressources sp�cifiques. Dans le
cas contraire, le serveur enverra sa r�ponse sans champ d'en-t�te
Content-Type, et le destinataire devra d�terminer lui-m�me le type
de m�dium.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="Define" id="Define">Define</a> <a name="define" id="define">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de d�finir l'existence d'une variable</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Define <var>nom variable</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Cette directive produit le m�me effet que l'argument
<code>-D</code> du programme <code class="program"><a href="/programs/httpd.html">httpd</a></code>.</p>
<p>Elle permet de faire basculer le fonctionnement de sections
<code class="directive"><a href="#ifdefine">&lt;IfDefine&gt;</a></code> sans
avoir � modifier les arguments de l'option <code>-D</code> dans
aucun script de d�marrage.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="Directory" id="Directory">&lt;Directory&gt;</a> <a name="directory" id="directory">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe un ensemble de directives qui ne s'appliquent
qu'au r�pertoire concern� du syst�me de fichiers et � ses
sous-r�pertoires</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Directory <var>chemin r�pertoire</var>&gt;
... &lt;/Directory&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Les balises <code class="directive">&lt;Directory&gt;</code> et
<code>&lt;/Directory&gt;</code> permettent de regrouper un ensemble
de directives qui ne s'appliquent qu'au r�pertoire pr�cis�
et � ses sous-r�pertoires. Toute directive
autoris�e dans un contexte de r�pertoire peut �tre utilis�e.
<var>chemin r�pertoire</var> est soit le chemin absolu d'un
r�pertoire, soit une cha�ne de caract�res avec caract�res g�n�riques
utilisant la comparaison Unix de style shell. Dans une cha�ne de
caract�res avec caract�res g�n�riques, <code>?</code> correspond �
un caract�re quelconque, et <code>*</code> � toute cha�ne de
caract�res. Les intervalles de caract�res <code>[]</code> sont aussi
autoris�s. Aucun caract�re g�n�rique ne peut remplacer le caract�re
`/', si bien que l'expression <code>&lt;Directory
/*/public_html&gt;</code> ne conviendra pas pour le chemin
* <code>/home/user/public_html</code>, alors que <code>&lt;Directory
/home/*/public_html&gt;</code> conviendra. Exemple :</p>
<div class="example"><p><code>
&lt;Directory /usr/local/httpd/htdocs&gt;<br />
<span class="indent">
Options Indexes FollowSymLinks<br />
</span>
&lt;/Directory&gt;
</code></p></div>
<div class="note">
<p>Soyez prudent avec l'argument <var>chemin r�pertoire</var> : il
doit correspondre exactement au chemin du syst�me de fichier
qu'Apache utilise pour acc�der aux fichiers. Les directives
comprises dans une section <code>&lt;Directory&gt;</code> ne
s'appliqueront pas aux fichiers du m�me r�pertoire auxquels on
aura acc�d� via un chemin diff�rent, per exemple via un lien
symbolique.</p>
</div>
<p> Les <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">Expressions rationnelles</a>
peuvent aussi �tre utilis�es en ajoutant le caract�re
<code>~</code>. Par exemple :</p>
<div class="example"><p><code>
&lt;Directory ~ "^/www/.*/[0-9]{3}"&gt;
</code></p></div>
<p>pourra correspondre � tout r�pertoire situ� dans /www/ et dont le
nom se compose de trois chiffres.</p>
<p>Si plusieurs sections <code class="directive">&lt;Directory&gt;</code> (sans expression rationnelle)
correspondent au r�pertoire (ou � un de ses parents) qui contient le
document, les directives de la section <code class="directive">&lt;Directory&gt;</code> dont le chemin est le plus
court sont appliqu�es en premier, en s'intercalant avec les
directives des fichiers <a href="#accessfilename">.htaccess</a>. Par
exemple, avec</p>
<div class="example"><p><code>
&lt;Directory /&gt;<br />
<span class="indent">
AllowOverride None<br />
</span>
&lt;/Directory&gt;<br />
<br />
&lt;Directory /home/&gt;<br />
<span class="indent">
AllowOverride FileInfo<br />
</span>
&lt;/Directory&gt;
</code></p></div>
<p>l'acc�s au document <code>/home/web/dir/doc.html</code> emprunte
le chemin suivant :</p>
<ul>
<li>Aplication de la directive <code>AllowOverride None</code>
(qui d�sactive les fichiers <code>.htaccess</code>).</li>
<li>Application de la directive <code>AllowOverride
FileInfo</code> (pour le r�pertoire <code>/home</code>).</li>
<li>Application de toute directive <code>FileInfo</code> qui se
trouverait dans d'�ventuels fichiers <code>/home/.htaccess</code>,
<code>/home/web/.htaccess</code> ou
<code>/home/web/dir/.htaccess</code>, dans cet ordre.</li>
</ul>
<p>Les directives associ�es aux r�pertoires sous forme d'expressions
rationnelles ne sont prises en compte qu'une fois toutes les
directives des sections sans expressions rationnelles appliqu�es.
Alors, tous les r�pertoires avec expressions rationnelles sont
test�s selon l'ordre dans lequel ils apparaissent dans le fichier de
configuration. Par exemple, avec</p>
<div class="example"><p><code>
&lt;Directory ~ abc$&gt;<br />
<span class="indent">
# ... directives here ...<br />
</span>
&lt;/Directory&gt;
</code></p></div>
<p>la section avec expression rationnelle ne sera prise en compte
qu'apr�s les sections <code class="directive">&lt;Directory&gt;</code> sans expression rationnelle
et les fichiers <code>.htaccess</code>. Alors, l'expression
rationnelle conviendra pour <code>/home/abc/public_html/abc</code>
et la section <code class="directive">&lt;Directory&gt;</code>
correspondante s'appliquera.</p>
<p><strong>Notez que pour Apache, la politique d'acc�s par d�faut
dans les sections <code>&lt;Directory /&gt;</code> est <code>Allow
from All</code>. Ceci signifie qu'Apache va servir tout fichier
correspondant � une URL. Il est recommand� de modifier cette
situation � l'aide d'un bloc du style</strong></p>
<div class="example"><p><code>
&lt;Directory /&gt;<br />
<span class="indent">
Order Deny,Allow<br />
Deny from All<br />
</span>
&lt;/Directory&gt;
</code></p></div>
<p><strong>puis d'affiner la configuration pour les r�pertoires que vous
voulez rendre accessibles. Voir la page <a href="/misc/security_tips.html">Conseils � propos de s�curit�</a>
pour plus de d�tails.</strong></p>
<p>Les sections <code class="directive">&lt;Directory&gt;</code> se situent
dans le fichier <code>httpd.conf</code>. Les directives <code class="directive">&lt;Directory&gt;</code> ne peuvent pas �tre imbriqu�es
et ne sont pas autoris�es dans les sections <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> ou <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>.</p>
<h3>Voir aussi</h3>
<ul>
<li><a href="/sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour des
explications � propos de la mani�re dont ces diff�rentes sections se
combinent entre elles � la r�ception d'une requ�te</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="DirectoryMatch" id="DirectoryMatch">&lt;DirectoryMatch&gt;</a> <a name="directorymatch" id="directorymatch">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives qui s'appliquent � des r�pertoires
du syst�me de fichiers correspondant � une expression rationnelle et �
leurs sous-r�pertoires</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;DirectoryMatch <var>regex</var>&gt;
... &lt;/DirectoryMatch&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Les balises <code class="directive">&lt;DirectoryMatch&gt;</code>
et <code>&lt;/DirectoryMatch&gt;</code> permettent de regrouper un
ensemble de directives qui ne s'appliqueront qu'au r�pertoire
pr�cis� et � ses sous-r�pertoires, comme pour la section <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>. Cependant, le
r�pertoire est pr�cis� sous la forme d'une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a>. Par exemple :</p>
<div class="example"><p><code>
&lt;DirectoryMatch "^/www/(.+/)?[0-9]{3}"&gt;
</code></p></div>
<p>conviendrait pour les sous-r�pertoires de <code>/www/</code> dont
le nom se compose de trois chiffres.</p>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>
pour une description de la mani�re dont les expressions rationnelles
sont trait�es en pr�sence d'autres sections <code class="directive">&lt;Directory&gt;</code> sans expressions rationnelles</li>
<li><a href="/sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
explication � propos de la mani�re dont ces diff�rentes sections se
combinent entre elles � la r�ception d'une requ�te</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a> <a name="documentroot" id="documentroot">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine principale de l'arborescence des documents visible
depuis Internet</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DocumentRoot <var>chemin r�pertoire</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>DocumentRoot /usr/local/apache/htdocs</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Cette directive permet de d�finir le r�pertoire � partir duquel
<code class="program"><a href="/programs/httpd.html">httpd</a></code> va servir les fichiers. S'il ne correspond
pas � un <code class="directive"><a href="/mod/mod_alias.html#alias">Alias</a></code>, le chemin
de l'URL sera ajout� par le serveur � la racine des documents afin
de construire le chemin du document recherch�. Exemple :</p>
<div class="example"><p><code>
DocumentRoot /usr/web
</code></p></div>
<p>un acc�s � <code>http://www.my.host.com/index.html</code> se
r�f�re alors � <code>/usr/web/index.html</code>. Si <var>chemin
r�pertoire</var> n'est pas un chemin absolu, il est consid�r� comme
relatif au chemin d�fini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
<p>Le r�pertoire d�fini par la directive
<code class="directive">DocumentRoot</code> ne doit pas comporter de slash
final.</p>
<h3>Voir aussi</h3>
<ul>
<li><a href="/urlmapping.html#documentroot">Mise en
correspondance des URLs avec le syst�me de fichiers</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a> <a name="enablemmap" id="enablemmap">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise la projection en m�moire (Memory-Mapping) pour
lire les fichiers pendant qu'ils sont servis</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>EnableMMAP On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Cette directive d�finit si <code class="program"><a href="/programs/httpd.html">httpd</a></code> peut utiliser
la projection en m�moire (Memory-Mapping) quand il doit lire le contenu
d'un fichier pendant qu'il est servi. Par d�faut, lorsque le
traitement d'une requ�te requiert l'acc�s aux donn�es contenues dans
un fichier -- par exemple, pour servir un fichier interpr�t� par le
serveur � l'aide de <code class="module"><a href="/mod/mod_include.html">mod_include</a></code> -- Apache projette
le fichier en m�moire si le syst�me d'exploitation le permet.</p>
<p>Cette projection en m�moire induit parfois une am�lioration des
performances. Sur certains syst�mes cependant, il est pr�f�rable de
d�sactiver la projection en m�moire afin d'�viter certains probl�mes
op�rationnels :</p>
<ul>
<li>Sur certains syst�mes multi-processeurs, la projection en
m�moire peut d�grader les performances du programme
<code class="program"><a href="/programs/httpd.html">httpd</a></code>.</li>
</ul>
<p>Pour les configurations de serveur sujettes � ce genre de
probl�me, il est pr�f�rable de d�sactiver la projection en m�moire
des fichiers servis en sp�cifiant :</p>
<ul><li>S'il fait l'objet d'une projection en m�moire par
<code class="program"><a href="/programs/httpd.html">httpd</a></code>, la suppression ou la troncature d'un
fichier peut provoquer un crash de <code class="program"><a href="/programs/httpd.html">httpd</a></code> avec une
erreur de segmentation.</li></ul>
<div class="example"><p><code>
EnableMMAP Off
</code></p></div>
<p>Pour les montages NFS, cette fonctionnalit� peut �tre
explicitement d�sactiv�e pour les fichiers concern�s en sp�cifiant
:</p>
<div class="example"><p><code>
&lt;Directory "/chemin vers montage NFS"&gt;
<span class="indent">
EnableMMAP Off
</span>
&lt;/Directory&gt;
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a> <a name="enablesendfile" id="enablesendfile">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise le support sendfile du noyau pour servir les
fichiers aux clients</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>EnableSendfile On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible dans les versions 2.0.44 et
sup�rieures</td></tr>
</table>
<p>Cette directive d�finit si le programme <code class="program"><a href="/programs/httpd.html">httpd</a></code>
peut utiliser le support sendfile du noyau pour transmettre le
contenu des fichiers aux clients. Par d�faut, lorsque le traitement
d'une requ�te ne requiert pas l'acc�s aux donn�es contenues dans un
fichier -- par exemple, pour la transmission d'un fichier statique
-- Apache utilise sendfile pour transmettre le contenu du fichier
sans m�me lire ce dernier, si le syst�me d'exploitation le
permet.</p>
<p>Ce m�canisme sendfile �vite la s�paration des op�rations de
lecture et d'envoi, ainsi que les r�servations de tampons. sur
certains syst�mes cependant, ou sous certains syst�mes de fichiers,
il est pr�f�rable de d�sactiver cette fonctionnalit� afin d'�viter
certains probl�mes op�rationnels :</p>
<ul>
<li>Certains syst�mes peuvent pr�senter un support sendfile
d�fectueux que le syst�me de compilation n'a pas d�tect�, en
particulier si les ex�cutables ont �t� compil�s sur une autre
machine, puis copi�s sur la premi�re avec un support sendfile
d�fectueux.</li>
<li>Sous Linux, l'utilisation de sendfile induit des bogues lors de
la r�cup�ration des paquets de v�rification TCP (TCP-checksum) avec
certaines cartes r�seau lorsqu'on utilise IPv6.</li>
<li>Sous Linux sur Itanium, sendfile peut s'av�rer incapable de
traiter les fichiers de plus de 2 Go.</li>
<li>Avec un montage r�seau de <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (par exemple NFS ou SMB), le
noyau peut s'av�rer incapable de servir un fichier de ce montage
r�seau en passant par son propre cache.</li>
</ul>
<p>Pour les configurations de serveur sujettes � ce genre de
probl�me, il est recommand� de d�sactiver cette fonctionnalit� en
sp�cifiant :</p>
<div class="example"><p><code>
EnableSendfile Off
</code></p></div>
<p>Pour les montages NFS ou SMB, cette fonctionnalit� peut �tre
explicitement d�sactiv�e pour les fichiers concern�s en sp�cifiant
:</p>
<div class="example"><p><code>
&lt;Directory "/chemin vers montage r�seau"&gt;
<span class="indent">
EnableSendfile Off
</span>
&lt;/Directory&gt;
</code></p></div>
<p>Veuillez noter que la configuration de la directive
<code class="directive">EnableSendfile</code> dans un contexte de r�pertoire
ou de fichier .htaccess n'est pas support�e par
<code class="module"><a href="/mod/mod_disk_cache.html">mod_disk_cache</a></code>. Le module ne prend en compte la
d�finition de <code class="directive">EnableSendfile</code> que dans un
contexte global.
</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a> <a name="errordocument" id="errordocument">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Document que le serveur renvoie au client en cas
d'erreur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ErrorDocument <var>code erreur</var> <var>document</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>La syntaxe des guillemets pour les messages textes est
diff�rente dans Apache 2.0</td></tr>
</table>
<p>Apache peut traiter les probl�mes et les erreurs de quatre
mani�res,</p>
<ol>
<li>afficher un simple message d'erreur au contenu fixe</li>
<li>afficher un message personnalis�</li>
<li>rediriger vers un <var>chemin d'URL</var> local pour traiter
le probl�me ou l'erreur</li>
<li>rediriger vers une <var>URL</var> externe pour traiter
le probl�me ou l'erreur</li>
</ol>
<p>La premi�re option constitue le comportement par d�faut; pour
choisir une des trois autres options, il faut configurer Apache �
l'aide de la directive <code class="directive">ErrorDocument</code>, suivie
du code de la r�ponse HTTP et d'une URL ou d'un message. Apache
fournit parfois des informations suppl�mentaires � propos du
probl�me ou de l'erreur.</p>
<p>Les URLs peuvent commencer par un slash (/) pour les chemins web
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
forme d'une URL compl�te que le client pourra r�soudre.
Alternativement, un message � afficher par le navigateur pourra �tre
fourni. Exemples :</p>
<div class="example"><p><code>
ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
ErrorDocument 404 /cgi-bin/bad_urls.pl<br />
ErrorDocument 401 /subscription_info.html<br />
ErrorDocument 403 "D�sol�, vous n'avez pas l'autorisation d'acc�s
aujourd'hui"
</code></p></div>
<p>De plus, on peut sp�cifier la valeur sp�ciale <code>default</code>
pour indiquer l'utilisation d'un simple message d'Apache cod� en
dur. Bien que non n�cessaire dans des circonstances normales, la
sp�cification de la valeur <code>default</code> va permettre de
r�tablir l'utilisation du simple message d'Apache cod� en dur pour
les configurations qui sans cela, h�riteraient d'une directive
<code class="directive">ErrorDocument</code> existante.</p>
<div class="example"><p><code>
ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
&lt;Directory /web/docs&gt;<br />
<span class="indent">
ErrorDocument 404 default<br />
</span>
&lt;/Directory&gt;
</code></p></div>
<p>Notez que lorsque vous sp�cifiez une directive
<code class="directive">ErrorDocument</code> pointant vers une URL distante
(c'est � dire tout ce qui commence par le pr�fixe http), Apache va
envoyer une redirection au client afin de lui indiquer o� trouver le
document, m�me dans le cas o� ce document se trouve sur le serveur
local. Ceci a de nombreuses cons�quences dont la plus importante
r�side dans le fait que le client ne recevra pas le code d'erreur
original, mais au contraire un code de statut de redirection. Ceci
peut en retour semer la confusion chez les robots web et divers
clients qui tentent de d�terminer la validit� d'une URL en examinant
le code de statut. De plus, si vous utilisez une URL distante avec
<code>ErrorDocument 401</code>, le client ne saura pas qu'il doit
demander un mot de passe � l'utilisateur car il ne recevra pas le
code de statut 401. C'est pourquoi, <strong>si vous utilisez une
directive <code>ErrorDocument 401</code>, elle devra faire r�f�rence
� un document par le biais d'un chemin local.</strong></p>
<p>Microsoft Internet Explorer (MSIE) ignore par d�faut les messages
d'erreur g�n�r�s par le serveur lorsqu'ils sont trop courts et
remplacent ses propres messages d'erreur "amicaux". Le seuil de
taille varie en fonction du type d'erreur, mais en g�n�ral, si la
taille de votre message d'erreur est sup�rieure � 512 octets, il y a
peu de chances pour que MSIE l'occulte, et il sera affich� par ce
dernier. Vous trouverez d'avantage d'informations dans l'article de
la base de connaissances Microsoft <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>
<p>Bien que la plupart des messages d'erreur internes originaux
puissent �tre remplac�s, ceux-ci sont cependant conserv�s dans
certaines circonstances sans tenir compte de la d�finition de la
directive <code class="directive"><a href="#errordocument">ErrorDocument</a></code>. En
particulier, en cas de d�tection d'une requ�te mal form�e, le
processus de traitement normal des requ�tes est imm�diatement
interrompu, et un message d'erreur interne est renvoy�, ceci afin de
se pr�munir contre les probl�mes de s�curit� li�s aux requ�tes mal
form�es.</p>
<p>Avant la version 2.0, les messages �taient indiqu�s en les
pr�fixant par un seul caract�re guillemet isol�.</p>
<h3>Voir aussi</h3>
<ul>
<li><a href="/custom-error.html">documentation sur la
personnalisation des r�ponses</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ErrorLog" id="ErrorLog">ErrorLog</a> <a name="errorlog" id="errorlog">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finition du chemin du journal des erreurs</td></tr>
<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>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2)</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">ErrorLog</code> permet de d�finir le
nom du fichier dans lequel le serveur va journaliser toutes les
erreurs qu'il rencontre. Si le <var>chemin fichier</var> n'est pas
absolu, il est consid�r� comme relatif au chemin d�fini par la
directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
<div class="example"><h3>Exemple</h3><p><code>
ErrorLog /var/log/httpd/error_log
</code></p></div>
<p>Si le <var>chemin fichier</var> commence par une barre verticale
(|), il est consid�r� comme une commande � lancer pour traiter la
journalisation de l'erreur.</p>
<div class="example"><h3>Exemple</h3><p><code>
ErrorLog "|/usr/local/bin/erreurs_httpd"
</code></p></div>
<p>L'utilisation de <code>syslog</code> � la place d'un nom de
fichier active la journalisation via syslogd(8) si le syst�me le
supporte. Le dispositif syslog par d�faut est <code>local7</code>,
mais vous pouvez le modifier � l'aide de la syntaxe
<code>syslog:<var>facility</var></code>, o� <var>facility</var> peut
�tre remplac� par un des noms habituellement document�s dans la page
de man syslog(1).</p>
<div class="example"><h3>Exemple</h3><p><code>
ErrorLog syslog:user
</code></p></div>
<p>SECURITE : Voir le document <a href="/misc/security_tips.html#serverroot">conseils � propos de
s�curit�</a> pour des d�tails sur les raisons pour lesquelles votre
s�curit� peut �tre compromise si le r�pertoire contenant les
fichiers journaux pr�sente des droits en �criture pour tout autre
utilisateur que celui sous lequel le serveur est d�marr�.</p>
<div class="warning"><h3>Note</h3>
<p>Lors de la sp�cification d'un chemin de fichier sur les
plates-formes non-Unix, on doit veiller � n'utiliser que des
slashes (/), m�me si la plate-forme autorise l'utilisation des
anti-slashes (\). Et d'une mani�re g�n�rale, il est recommand� de
n'utiliser que des slashes (/) dans les fichiers de
configuration.</p>
</div>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
<li><a href="/logs.html">Fichiers journaux d'Apache</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="FileETag" id="FileETag">FileETag</a> <a name="fileetag" id="fileetag">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Caract�ristiques de fichier utilis�s lors de la g�n�ration
de l'en-t�te de r�ponse HTTP ETag</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FileETag <var>composant</var> ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>FileETag INode MTime Size</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>
La directive <code class="directive">FileETag</code> d�finit les
caract�ristiques de fichier utilis�es lors de la g�n�ration de
l'en-t�te de r�ponse HTTP <code>ETag</code> (entity tag) quand le
document est contenu dans un fichier (la valeur de <code>ETag</code>
est utilis�e dans le cadre de la gestion du cache pour pr�server la
bande passante r�seau). Dans les versions 1.3.22 et ant�rieures
d'Apache, la valeur de l'en-t�te <code>ETag</code> se composait
<em>toujours</em> de l'inode du fichier, de sa taille et de sa date
de derni�re modification (mtime). La directive
<code class="directive">FileETag</code> vous permet maintenant de choisir
quelles caract�ristiques du fichier vont �tre utilis�es, le cas
�ch�ant. Les mots-cl�s reconnus sont :
</p>
<dl>
<dt><strong>INode</strong></dt>
<dd>Le num�ro d'i-node du fichier sera inclus dans le processus de
g�n�ration</dd>
<dt><strong>MTime</strong></dt>
<dd>La date et l'heure auxquelles le fichier a �t� modifi� la
derni�re fois seront incluses</dd>
<dt><strong>Size</strong></dt>
<dd>La taille du fichier en octets sera incluse</dd>
<dt><strong>All</strong></dt>
<dd>Tous les champs disponibles seront utilis�s. Cette d�finition
est �quivalente � : <div class="example"><p><code>FileETag INode MTime
Size</code></p></div></dd>
<dt><strong>None</strong></dt>
<dd>Si le document se compose d'un fichier, aucun champ
<code>ETag</code> ne sera inclus dans la r�ponse</dd>
</dl>
<p>Les mots-cl�s <code>INode</code>, <code>MTime</code>, et
<code>Size</code> peuvent �tre pr�fix�s par <code>+</code> ou
<code>-</code>, ce qui permet de modifier les valeurs par d�faut
h�rit�es d'un niveau de configuration plus g�n�ral. Tout mot-cl�
apparaissant sans aucun pr�fixe annule enti�rement et imm�diatement
les configurations h�rit�es.</p>
<p>Si la configuration d'un r�pertoire contient
<code>FileETag&nbsp;INode&nbsp;MTime&nbsp;Size</code>, et si un de
ses sous-r�pertoires contient <code>FileETag&nbsp;-INode</code>, la
configuration de ce sous-r�pertoire (qui sera propag�e vers tout
sou-r�pertoire qui ne la supplante pas), sera �quivalente �
<code>FileETag&nbsp;MTime&nbsp;Size</code>.</p>
<div class="warning"><h3>Avertissement</h3>
Ne modifiez pas les valeurs par d�faut pour les r�pertoires ou
localisations o� WebDAV est activ� et qui utilisent
<code class="module"><a href="/mod/mod_dav_fs.html">mod_dav_fs</a></code> comme fournisseur de stockage.
<code class="module"><a href="/mod/mod_dav_fs.html">mod_dav_fs</a></code> utilise
<code>INode&nbsp;MTime&nbsp;Size</code> comme format fixe pour les
comparaisons de champs <code>ETag</code> dans les requ�tes
conditionnelles. Ces requ�tes conditionnelles �choueront si le
format <code>ETag</code> est modifi� via la directive
<code class="directive">FileETag</code>.
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="Files" id="Files">&lt;Files&gt;</a> <a name="files" id="files">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent aux fichiers
pr�cis�s</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Files <var>nom fichier</var>&gt; ... &lt;/Files&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">&lt;Files&gt;</code> limite
la port�e des directives qu'elle contient aux fichiers pr�cis�s.
Elle est comparable aux directives <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Elle doit se terminer par une
balise <code>&lt;/Files&gt;</code>. Les directives contenues dans
cette section s'appliqueront � tout objet dont le nom de base (la
derni�re partie du nom de fichier) correspond au fichier sp�cifi�.
Les sections <code class="directive">&lt;Files&gt;</code> sont
trait�es selon l'ordre dans lequel elles apparaissent dans le
fichier de configuration, apr�s les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et la lecture des fichiers
<code>.htaccess</code>, mais avant les sections <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Notez que les
sections <code class="directive">&lt;Files&gt;</code> peuvent �tre
imbriqu�es dans les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> afin de restreindre la portion
du syst�me de fichiers � laquelle ces derni�res vont
s'appliquer.</p>
<p>L'argument <var>filename</var> peut contenir un nom de fichier
ou une cha�ne de caract�res avec caract�res g�n�riques, o�
<code>?</code> remplace un caract�re, et <code>*</code> toute cha�ne
de caract�res. On peut aussi utiliser les <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> en ajoutant la
caract�re <code>~</code>. Par exemple :</p>
<div class="example"><p><code>
&lt;Files ~ "\.(gif|jpe?g|png)$"&gt;
</code></p></div>
<p>correspondrait � la plupart des formats graphiques de l'Internet.
Il est cependant pr�f�rable d'utiliser la directive <code class="directive"><a href="#filesmatch">&lt;FilesMatch&gt;</a></code>.</p>
<p>Notez qu'� la diff�rence des sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, les sections <code class="directive">&lt;Files&gt;</code> peuvent �tre utilis�es dans les
fichiers <code>.htaccess</code>. Ceci permet aux utilisateurs de
contr�ler l'acc�s � leurs propres ressources, fichier par
fichier.</p>
<h3>Voir aussi</h3>
<ul>
<li><a href="/sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
explication de la mani�re dont ces diff�rentes sections se combinent
entre elles � la r�ception d'une requ�te</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="FilesMatch" id="FilesMatch">&lt;FilesMatch&gt;</a> <a name="filesmatch" id="filesmatch">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent � des fichiers
sp�cifi�s sous la forme d'expressions rationnelles</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;FilesMatch <var>expression rationnelle</var>&gt; ...
&lt;/FilesMatch&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La section <code class="directive">&lt;FilesMatch&gt;</code>
limite la port�e des directives qu'elle contient aux fichiers
sp�cifi�s, tout comme le ferait une section <code class="directive"><a href="#files">&lt;Files&gt;</a></code>. Mais elle accepte aussi les
<a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expressions rationnelles</a>. Par
exemple :</p>
<div class="example"><p><code>
&lt;FilesMatch "\.(gif|jpe?g|png)$"&gt;
</code></p></div>
<p>correspondrait � la plupart des formats graphiques de
l'Internet.</p>
<h3>Voir aussi</h3>
<ul>
<li><a href="/sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
explication de la mani�re dont ces diff�rentes sections se combinent
entre elles � la r�ception d'une requ�te</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ForceType" id="ForceType">ForceType</a> <a name="forcetype" id="forcetype">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force le type de m�dium sp�cifi� dans le champ d'en-t�te
HTTP Content-Type pour les fichiers correspondants</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForceType <var>type m�dium</var>|None</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Int�gr� dans le coeur d'Apache depuis la version
2.0</td></tr>
</table>
<p>Lorsqu'elle est plac�e dans un fichier <code>.htaccess</code> ou
une section <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>, <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, ou <code class="directive"><a href="#files">&lt;Files&gt;</a></code>, cette directive force
l'identification du type MIME des fichiers sp�cifi�s � la valeur de
l'argument <var>type m�dium</var>. Par exemple, si vous poss�dez un
r�pertoire ne contenant que des fichiers GIF, et si vous ne voulez
pas leur ajouter l'extension <code>.gif</code>, vous pouvez utiliser
:</p>
<div class="example"><p><code>
ForceType image/gif
</code></p></div>
<p>Notez que cette directive l'emporte sur d'autres associations de
type de m�dium indirectes d�finies dans mime.types ou via la
directive <code class="directive"><a href="/mod/mod_mime.html#addtype">AddType</a></code>.</p>
<p>Vous pouvez aussi annuler toute d�finition plus g�n�rale de
<code class="directive">ForceType</code> en affectant la valeur
<code>None</code> � l'argument <var>type m�dium</var> :</p>
<div class="example"><p><code>
# force le type MIME de tous les fichiers � image/gif:<br />
&lt;Location /images&gt;<br />
<span class="indent">
ForceType image/gif<br />
</span>
&lt;/Location&gt;<br />
<br />
# mais utilise les m�thodes classiques d'attribution du type MIME
# dans le sous-r�pertoire suivant :<br />
&lt;Location /images/mixed&gt;<br />
<span class="indent">
ForceType None<br />
</span>
&lt;/Location&gt;
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="HostnameLookups" id="HostnameLookups">HostnameLookups</a> <a name="hostnamelookups" id="hostnamelookups">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la recherche DNS sur les adresses IP des
clients</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HostnameLookups On|Off|Double</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>HostnameLookups Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Cette directive active la recherche DNS afin de pouvoir
journaliser les nom d'h�tes (et les passer aux programmes CGI et aux
inclusions SSI via la variable <code>REMOTE_HOST</code>). La valeur
<code>Double</code> d�clenche une double recherche DNS inverse. En
d'autres termes, une fois la recherche inverse effectu�e, on lance
une recherche directe sur le r�sultat de cette derni�re. Au moins
une des adresses IP fournies par la recherche directe doit
correspondre � l'adresse originale (ce que l'on nomme
<code>PARANOID</code> dans la terminologie "tcpwrappers").</p>
<p>Quelle que soit la configuration, lorsqu'on utilise
<code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code> pour contr�ler l'acc�s en fonction
du nom d'h�te, une double recherche DNS inverse est effectu�e,
s�curit� oblige. Notez cependant que le r�sultat de cette double
recherche n'est en g�n�ral pas accessible, � moins que vous n'ayez
sp�cifi� <code>HostnameLookups Double</code>. Par exemple, si vous
n'avez sp�cifi� que <code>HostnameLookups On</code>, et si une
requ�te concerne un objet prot�g� par des restrictions en fonction
du nom d'h�te, quel que soit le r�sultat de la double recherche
inverse, les programmes CGI ne recevront que le r�sultat de la
recherche inverse simple dans la variable
<code>REMOTE_HOST</code>.</p>
<p>La valeur par d�faut est <code>Off</code> afin de pr�server le
traffic r�seau des sites pour lesquels la recherche inverse n'est
pas vraiment n�cessaire. Cette valeur par d�faut est aussi b�n�fique
pour les utilisateurs finaux car il n'ont ainsi pas � subir de temps
d'attente suppl�mentaires dus aux recherches DNS. Les sites
fortement charg�s devraient laisser cette directive �
<code>Off</code>, car les recherches DNS peuvent prendre des temps
tr�s longs. Vous pouvez �ventuellement utiliser hors ligne
l'utilitaire <code class="program"><a href="/programs/logresolve.html">logresolve</a></code>, compil� par d�faut dans
le sous-r�pertoire <code>bin</code> de votre r�pertoire
d'installation, afin de d�terminer les noms d'h�tes associ�s aux
adresses IP journalis�es.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="If" id="If">&lt;If&gt;</a> <a name="if" id="if">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si une
condition est satisfaite au cours du traitement d'une
requ�te</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;If <var>expression</var>&gt; ... &lt;/If&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">&lt;If&gt;</code> �value une
expression � la vol�e, et applique les directives qu'elle contient
si et seulement si l'expression renvoie la valeur "vrai". Par
exemple :</p>
<div class="example"><p><code>
&lt;If "$req{Host} = ''"&gt;
</code></p></div>
<p>sera satisfaite dans le cas des requ�tes HTTP/1.0 sans en-t�te
<var>Host:</var>.</p>
<p>Vous pouvez tester la valeur de tout en-t�te de requ�te ($req),
de tout en-t�te de r�ponse ($resp) ou de toute variable
d'environnement ($env) dans votre expression.</p>
<h3>Voir aussi</h3>
<ul>
<li><a href="/sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
explication de la mani�re dont ces diff�rentes sections se combinent
entre elles � la r�ception d'une requ�te. La directive <code class="directive">&lt;If&gt;</code> poss�de la m�me priorit� et s'utilise de
la m�me fa�on que la directive <code class="directive">&lt;Files&gt;</code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="IfDefine" id="IfDefine">&lt;IfDefine&gt;</a> <a name="ifdefine" id="ifdefine">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliqueront que si un
test retourne "vrai" au d�marrage du serveur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;IfDefine [!]<var>param�tre</var>&gt; ...
&lt;/IfDefine&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La section <code>&lt;IfDefine
<var>test</var>&gt;...&lt;/IfDefine&gt;</code> permet de
conf�rer un caract�re conditionnel � un ensemble de directives. Les
directives situ�es � l'int�rieur d'une section <code class="directive">&lt;IfDefine&gt;</code> ne s'appliquent que si
<var>test</var> est vrai. Si <var>test</var> est faux, tout ce qui
se trouve entre les balises de d�but et de fin est ignor�.</p>
<p><var>test</var> peut se pr�senter sous deux formes :</p>
<ul>
<li><var>nom param�tre</var></li>
<li><code>!</code><var>nom param�tre</var></li>
</ul>
<p>Dans le premier cas, les directives situ�es entre les balises de
d�but et de fin ne s'appliqueront que si le param�tre nomm� <var>nom
param�tre</var> est d�fini. Le second format inverse le test, et
dans ce cas, les directives ne s'appliqueront que si <var>nom
param�tre</var> n'est <strong>pas</strong> d�fini.</p>
<p>L'argument <var>nom param�tre</var> est une d�finition qui peut
�tre effectu�e par la ligne de commande
<code class="program"><a href="/programs/httpd.html">httpd</a></code> via le param�tre
<code>-D<var>param�tre</var></code> au d�marrage du serveur, ou via la
directive <code class="directive"><a href="#define">Define</a></code>.</p>
<p>Les sections <code class="directive">&lt;IfDefine&gt;</code>
peuvent �tre imbriqu�es, ce qui permet d'impl�menter un test
multi-param�tres simple. Exemple :</p>
<div class="example"><p><code>
httpd -DReverseProxy -DUseCache -DMemCache ...<br />
<br />
# httpd.conf<br />
&lt;IfDefine ReverseProxy&gt;<br />
<span class="indent">
LoadModule proxy_module modules/mod_proxy.so<br />
LoadModule proxy_http_module modules/mod_proxy_http.so<br />
&lt;IfDefine UseCache&gt;<br />
<span class="indent">
LoadModule cache_module modules/mod_cache.so<br />
&lt;IfDefine MemCache&gt;<br />
<span class="indent">
LoadModule mem_cache_module modules/mod_mem_cache.so<br />
</span>
&lt;/IfDefine&gt;<br />
&lt;IfDefine !MemCache&gt;<br />
<span class="indent">
LoadModule disk_cache_module modules/mod_disk_cache.so<br />
</span>
&lt;/IfDefine&gt;
</span>
&lt;/IfDefine&gt;
</span>
&lt;/IfDefine&gt;
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="IfModule" id="IfModule">&lt;IfModule&gt;</a> <a name="ifmodule" id="ifmodule">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent qu'en fonction
de la pr�sence ou de l'absence d'un module sp�cifique</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;IfModule [!]<var>fichier module</var>|<var>identificateur
module</var>&gt; ... &lt;/IfModule&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Les identificateurs de modules sont disponibles dans les
versions 2.1 et sup�rieures.</td></tr>
</table>
<p>La section <code>&lt;IfModule
<var>test</var>&gt;...&lt;/IfModule&gt;</code> permet de conf�rer �
des directives un caract�re conditionnel bas� sur la pr�sence d'un
module sp�cifique. Les directives situ�es dans une section
<code class="directive">&lt;IfModule&gt;</code> ne s'appliquent que
si <var>test</var> est vrai. Si <var>test</var> est faux, tout ce
qui se trouve entre les balises de d�but et de fin est ignor�.</p>
<p><var>test</var> peut se pr�senter sous deux formes :</p>
<ul>
<li><var>module</var></li>
<li>!<var>module</var></li>
</ul>
<p>Dans le premier cas, les directives situ�es entre les balises de
d�but et de fin ne s'appliquent que si le module <var>module</var>
est pr�sent -- soit compil� avec le binaire httpd, soit charg�
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
ce cas, les directives ne s'appliquent que si <var>module</var>
n'est <strong>pas</strong> pr�sent.</p>
<p>L'argument <var>module</var> peut contenir soit l'identificateur
du module, soit le nom du fichier source du module. Par exemple,
<code>rewrite_module</code> est un identificateur et
<code>mod_rewrite.c</code> le nom du fichier source
correspondant. Si un module comporte plusieurs fichiers sources,
utilisez le nom du fichier qui contient la cha�ne de caract�res
<code>STANDARD20_MODULE_STUFF</code>.</p>
<p>Les sections <code class="directive">&lt;IfModule&gt;</code>
peuvent �tre imbriqu�es, ce qui permet d'impl�menter des tests
multi-modules simples.</p>
<div class="note">Cette section ne doit �tre utilis�e que si votre fichier de
configuration ne fonctionne qu'en fonction de la pr�sence ou de
l'absence d'un module sp�cifique. D'une mani�re g�n�rale, il n'est
pas n�cessaire de placer les directives � l'int�rieur de sections
<code class="directive">&lt;IfModule&gt;</code>.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="Include" id="Include">Include</a> <a name="include" id="include">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Inclut d'autres fichiers de configuration dans un des
fichiers de configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Include <var>chemin fichier</var>|<var>chemin
r�pertoire</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Utilisation des caract�res g�n�riques depuis la version
2.0.41</td></tr>
</table>
<p>Cette directive permet l'inclusion d'autres fichiers de
configuration dans un des fichiers de configuration du serveur.</p>
<p>On peut utiliser des caract�res g�n�riques de style Shell
(<code>fnmatch()</code>) pour inclure plusieurs fichiers en une
seule fois, selon leur ordre alphab�tique. De plus, si la directive
<code class="directive">Include</code> pointe vers un r�pertoire, Apache
inclura tous les fichiers de ce r�pertoire et de tous ces
sous-r�pertoires. L'inclusion de r�pertoires entiers est cependant
d�conseill�e, car il est fr�quent d'oublier des fichiers
temporaires dans un r�pertoire, ce qui causerait une erreur
<code class="program"><a href="/programs/httpd.html">httpd</a></code> en cas d'inclusion. Pour inclure des
fichiers qui correspondent � un certain mod�le, comme *.conf par
exemple, nous vous recommandons d'utiliser plut�t la syntaxe avec
caract�res g�n�riques comme ci-dessous.</p>
<p>Le chemin fichier sp�cifi� peut �tre soit un chemin absolu, soit
un chemin relatif au r�pertoire d�fini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>
<p>Exemples :</p>
<div class="example"><p><code>
Include /usr/local/apache2/conf/ssl.conf<br />
Include /usr/local/apache2/conf/vhosts/*.conf
</code></p></div>
<p>ou encore, avec des chemins relatifs au r�pertoire d�fini par la
directive <code class="directive"><a href="#serverroot">ServerRoot</a></code> :</p>
<div class="example"><p><code>
Include conf/ssl.conf<br />
Include conf/vhosts/*.conf
</code></p></div>
<h3>Voir aussi</h3>
<ul>
<li><code class="program"><a href="/programs/apachectl.html">apachectl</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="KeepAlive" id="KeepAlive">KeepAlive</a> <a name="keepalive" id="keepalive">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active les connexions HTTP persistantes</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeepAlive On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>KeepAlive On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>L'extension Keep-Alive de HTTP/1.0 et l'impl�mentation des
connexions persistantes dans HTTP/1.1 ont rendu possibles des
sessions HTTP de longue dur�e, ce qui permet de transmettre
plusieurs requ�tes via la m�me connexion TCP. Dans certains cas, le
gain en rapidit� pour des documents comportant de nombreuses images
peut atteindre 50%. Pour activer les connexions persistantes,
d�finissez <code>KeepAlive On</code>.</p>
<p>Pour les clients HTTP/1.0, les connexions persistantes ne seront
mises en oeuvre que si elles ont �t� sp�cialement demand�es par un
client. De plus, une connexion persistante avec un client HTTP/1.0
ne peut �tre utilis�e que si la taille du contenu est connue
d'avance. Ceci implique que les contenus dynamiques comme les
sorties CGI, les pages SSI, et les listings de r�pertoires g�n�r�s
par le serveur n'utiliseront en g�n�ral pas les connexions
persistantes avec les clients HTTP/1.0. Avec les clients HTTP/1.1,
les connexions persistantes sont utilis�es par d�faut, sauf
instructions contraires. Si le client le demande, le transfert par
tron�ons de taille fixe (chunked encoding) sera utilis� afin de
transmettre un contenu de longueur inconnue via une connexion
persistante.</p>
<p>Lorsqu'un client utilise une connexion persistante, elle comptera
pour une seule requ�te pour la directive <code class="directive"><a href="/mod/mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></code>, quel
que soit le nombre de requ�tes transmises via cette connexion.</p>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#maxkeepaliverequests">MaxKeepAliveRequests</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="KeepAliveTimeout" id="KeepAliveTimeout">KeepAliveTimeout</a> <a name="keepalivetimeout" id="keepalivetimeout">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dur�e pendant laquelle le serveur va attendre une requ�te
avant de fermer une connexion persistante</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeepAliveTimeout <var>nombre</var>[ms]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>KeepAliveTimeout 5</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>La sp�cification d'une valeur en millisecondes est
possible depuis les versions 2.3.2 et sup�rieures d'Apache</td></tr>
</table>
<p>Le nombre de secondes pendant lesquelles Apache va attendre une
requ�te avant de fermer la connexion. Le d�lai peut �tre d�fini en
millisecondes en suffixant sa valeur par ms. La valeur du d�lai
sp�cifi�e par la directive <code class="directive"><a href="#timeout">Timeout</a></code> s'applique d�s qu'une requ�te a
�t� re�ue.</p>
<p>Donner une valeur trop �l�v�e �
<code class="directive">KeepAliveTimeout</code> peut induire des probl�mes
de performances sur les serveurs fortement charg�s. Plus le d�lai
est �l�v�, plus nombreux seront les processus serveur en attente de
requ�tes de la part de clients inactifs.</p>
<p>Dans un contexte de serveur virtuel � base de nom, c'est le d�lai
du premier serveur virtuel d�fini (le serveur par d�faut) parmi un
ensemble de directives <code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code> qui sera utilis�. Les
autres valeurs seront ignor�es.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="Limit" id="Limit">&lt;Limit&gt;</a> <a name="limit" id="limit">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite les contr�les d'acc�s que la section contient �
certaines m�thodes HTTP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Limit <var>m�thode</var> [<var>m�thode</var>] ... &gt; ...
&lt;/Limit&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig, Limit</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Les contr�les d'acc�s s'appliquent normalement �
<strong>toutes</strong> les m�thodes d'acc�s, et c'est en g�n�ral le
comportement souhait�. <strong>Dans le cas g�n�ral, les directives
de contr�le d'acc�s n'ont pas � �tre plac�es dans une section
<code class="directive">&lt;Limit&gt;</code>.</strong></p>
<p>La directive <code class="directive">&lt;Limit&gt;</code> a pour
but de limiter les effets des contr�les d'acc�s aux m�thodes HTTP
sp�cifi�es. Pour toutes les autres m�thodes, les restrictions
d'acc�s contenues dans la section <code class="directive">&lt;Limit&gt;</code> <strong>n'auront aucun
effet</strong>. L'exemple suivant n'applique les contr�les d'acc�s
qu'aux m�thodes <code>POST</code>, <code>PUT</code>, et
<code>DELETE</code>, en laissant les autres m�thodes sans protection
:</p>
<div class="example"><p><code>
&lt;Limit POST PUT DELETE&gt;<br />
<span class="indent">
Require valid-user<br />
</span>
&lt;/Limit&gt;
</code></p></div>
<p>La liste des noms de m�thodes peut contenir une ou plusieurs
valeurs parmi les suivantes : <code>GET</code>, <code>POST</code>,
<code>PUT</code>, <code>DELETE</code>, <code>CONNECT</code>,
<code>OPTIONS</code>, <code>PATCH</code>, <code>PROPFIND</code>,
<code>PROPPATCH</code>, <code>MKCOL</code>, <code>COPY</code>,
<code>MOVE</code>, <code>LOCK</code>, et <code>UNLOCK</code>.
<strong>Le nom de m�thode est sensible � la casse.</strong> Si la
valeur <code>GET</code> est pr�sente, les requ�tes <code>HEAD</code>
seront aussi concern�es. La m�thode <code>TRACE</code> ne peut pas
�tre limit�e (voir la directive <code class="directive"><a href="#traceenable">TraceEnable</a></code>).</p>
<div class="warning">Une section <code class="directive">&lt;LimitExcept&gt;</code> doit toujours �tre pr�f�r�e �
une section <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> pour la restriction d'acc�s, car une
section <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code> fournit une protection contre
les m�thodes arbitraires.</div>
<p>Les directives <code class="directive">&lt;Limit&gt;</code> et
<code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>
peuvent �tre imbriqu�es. Dans ce cas, pour chaque niveau des
directives <code class="directive">&lt;Limit&gt;</code> ou <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>, ces derni�res
doivent restreindre l'acc�s pour les m�thodes auxquelles les
contr�les d'acc�s s'appliquent.</p>
<div class="warning">Lorsqu'on utilise les directives <code class="directive">&lt;Limit&gt;</code> ou <code class="directive">&lt;LimitExcept&gt;</code> avec la directive <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code>, la premi�re directive
<code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code> dont la
condition est satisfaite autorise la requ�te, sans tenir compte de
la pr�sence d'autres directives <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code>.</div>
<p>Par exemple, avec la configuration suivante, tous les
utilisateurs seront autoris�s � effectuer des requ�tes
<code>POST</code>, et la directive <code>Require group
editors</code> sera ignor�e dans tous les cas :</p>
<div class="example"><p><code>
&lt;LimitExcept GET&gt;
<span class="indent">
Require valid-user
</span>
&lt;/LimitExcept&gt;<br />
&lt;Limit POST&gt;
<span class="indent">
Require group editors
</span>
&lt;/Limit&gt;
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="LimitExcept" id="LimitExcept">&lt;LimitExcept&gt;</a> <a name="limitexcept" id="limitexcept">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Applique les contr�les d'acc�s � toutes les m�thodes HTTP,
sauf celles qui sont sp�cifi�es</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;LimitExcept <var>m�thode</var> [<var>m�thode</var>] ... &gt; ...
&lt;/LimitExcept&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>AuthConfig, Limit</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p><code class="directive">&lt;LimitExcept&gt;</code> et
<code>&lt;/LimitExcept&gt;</code> permettent de regrouper des
directives de contr�le d'acc�s qui s'appliqueront � toutes les
m�thodes d'acc�s HTTP qui ne font <strong>pas</strong> partie de la
liste des arguments ; en d'autres termes, elles ont un comportement
oppos� � celui de la section <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code>, et on peut les utiliser pour
contr�ler aussi bien les m�thodes standards que les m�thodes non
standards ou non reconnues. Voir la documentation de la section
<code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> pour plus
de d�tails.</p>
<p>Par exemple :</p>
<div class="example"><p><code>
&lt;LimitExcept POST GET&gt;<br />
<span class="indent">
Require valid-user<br />
</span>
&lt;/LimitExcept&gt;
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="LimitInternalRecursion" id="LimitInternalRecursion">LimitInternalRecursion</a> <a name="limitinternalrecursion" id="limitinternalrecursion">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�termine le nombre maximal de redirections internes et de
sous-requ�tes imbriqu�es</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitInternalRecursion <var>nombre</var> [<var>nombre</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitInternalRecursion 10</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible � partir de la version 2.0.47 d'Apache</td></tr>
</table>
<p>Une redirection interne survient, par exemple, quand on utilise
la directive <code class="directive"><a href="/mod/mod_actions.html#action">Action</a></code> qui
redirige en interne la requ�te d'origine vers un script CGI. Une
sous-requ�te est le m�canisme qu'utilise Apache pour d�terminer ce
qui se passerait pour un URI s'il faisait l'objet d'une requ�te. Par
exemple, <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> utilise les sous-requ�tes pour
rechercher les fichiers list�s dans la directive <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>.</p>
<p>La directive <code class="directive">LimitInternalRecursion</code> permet
d'�viter un crash du serveur d� � un bouclage infini de redirections
internes ou de sous-requ�tes. De tels bouclages sont dus en g�n�ral
� des erreurs de configuration.</p>
<p>La directive accepte, comme arguments, deux limites qui sont
�valu�es � chaque requ�te. Le premier <var>nombre</var> est le
nombre maximum de redirections internes qui peuvent se succ�der. Le
second <var>nombre</var> d�termine la profondeur d'imbrication
maximum des sous-requ�tes. Si vous ne sp�cifiez qu'un seul
<var>nombre</var>, il sera affect� aux deux limites.</p>
<div class="example"><h3>Exemple</h3><p><code>
LimitInternalRecursion 5
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="LimitRequestBody" id="LimitRequestBody">LimitRequestBody</a> <a name="limitrequestbody" id="limitrequestbody">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>limite la taille maximale du corps de la requ�te HTTP
envoy�e par le client</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestBody <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitRequestBody 0</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Cette directive sp�cifie la taille maximale autoris�e pour le
corps d'une requ�te ; la valeur de l'argument <var>octets</var> va
de 0 (pour une taille illimit�e), � 2147483647 (2Go).</p>
<p>La directive <code class="directive">LimitRequestBody</code> permet de
d�finir une limite pour la taille maximale autoris�e du corps d'une
requ�te HTTP en tenant compte du contexte dans lequel la directive
a �t� plac�e (c'est � dire au niveau du serveur, d'un r�pertoire,
d'un fichier ou d'une localisation). Si la requ�te du client d�passe
cette limite, le serveur r�pondra par un message d'erreur et ne
traitera pas la requ�te. La taille du corps d'une requ�te normale va
varier de mani�re importante en fonction de la nature de la
ressource et des m�thodes autoris�es pour cette derni�re. Les
scripts CGI utilisent souvent le corps du message pour extraire les
informations d'un formulaire. Les impl�mentations de la m�thode
<code>PUT</code> n�cessitent une valeur au moins aussi �lev�e que la
taille maximale des repr�sentations que le serveur d�sire accepter
pour cette ressource.</p>
<p>L'administrateur du serveur peut utiliser cette directive pour
contr�ler plus efficacement les comportements anormaux des requ�tes
des clients, ce qui lui permettra de pr�venir certaines formes
d'attaques par d�ni de service.</p>
<p>Si par exemple, vous autorisez le chargement de fichiers vers une
localisation particuli�re, et souhaitez limiter la taille des
fichiers charg�s � 100Ko, vous pouvez utiliser la directive suivante
:</p>
<div class="example"><p><code>
LimitRequestBody 102400
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="LimitRequestFields" id="LimitRequestFields">LimitRequestFields</a> <a name="limitrequestfields" id="limitrequestfields">Directive</a></h2>
<table class="directive">
<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
requ�te HTTP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFields <var>nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitRequestFields 100</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p><var>nombre</var> est un entier de 0 (nombre de champs illimit�)
� 32767. La valeur par d�faut est d�finie � la compilation par la
constante <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (100 selon la
distribution).</p>
<p>La directive <code class="directive">LimitRequestFields</code> permet �
l'administrateur du serveur de modifier le nombre maximum de champs
d'en-t�te autoris�s dans une requ�te HTTP. Pour un serveur, cette
valeur doit �tre sup�rieure au nombre de champs qu'une requ�te
client normale peut contenir. Le nombre de champs d'en-t�te d'une
requ�te qu'un client utilise d�passe rarement 20, mais ce nombre
peut varier selon les impl�mentations des clients, et souvent en
fonction des extensions que les utilisateurs configurent dans leurs
navigateurs pour supporter la n�gociation de contenu d�taill�e. Les
extensions HTTP optionnelles utilisent souvent les
champs d'en-t�te des requ�tes.</p>
<p>L'administrateur du serveur peut utiliser cette directive pour
contr�ler plus efficacement les comportements anormaux des requ�tes
des clients, ce qui lui permettra de pr�venir certaines formes
d'attaques par d�ni de service. La valeur sp�cifi�e doit �tre
augment�e si les clients standards re�oivent une erreur du serveur
indiquant que la requ�te comportait un nombre d'en-t�tes trop
important.</p>
<p>Par exemple :</p>
<div class="example"><p><code>
LimitRequestFields 50
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="LimitRequestFieldSize" id="LimitRequestFieldSize">LimitRequestFieldSize</a> <a name="limitrequestfieldsize" id="limitrequestfieldsize">Directive</a></h2>
<table class="directive">
<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
requ�te HTTP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestFieldSize <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitRequestFieldSize 8190</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Cette directive permet de d�finir le nombre maximum
d'<var>octets</var> autoris�s dans un en-t�te de requ�te HTTP.</p>
<p>La directive <code class="directive">LimitRequestFieldSize</code> permet
� l'administrateur du serveur de r�duire ou augmenter la taille
maximale autoris�e d'un en-t�te de requ�te HTTP. Pour un serveur,
cette valeur doit �tre suffisamment grande pour contenir tout
en-t�te d'une requ�te client normale. La taille d'un champ d'en-t�te
de requ�te normal va varier selon les impl�mentations des clients,
et en fonction des extensions que les utilisateurs
configurent dans leurs navigateurs pour supporter la n�gociation de
contenu d�taill�e. Les en-t�tes d'authentification SPNEGO peuvent
atteindre une taille de 12392 octets.</p>
<p>&gt;L'administrateur du serveur peut utiliser cette directive pour
contr�ler plus efficacement les comportements anormaux des requ�tes
des clients, ce qui lui permettra de pr�venir certaines formes
d'attaques par d�ni de service.</p>
<p>Par exemple ::</p>
<div class="example"><p><code>
LimitRequestFieldSize 4094
</code></p></div>
<div class="note">Dans des conditions normales, la valeur par d�faut de cette
directive ne doit pas �tre modifi�e.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="LimitRequestLine" id="LimitRequestLine">LimitRequestLine</a> <a name="limitrequestline" id="limitrequestline">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit la taille maximale d'une ligne de requ�te
HTTP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitRequestLine <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitRequestLine 8190</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Cette directive permet de d�finir la taille maximale autoris�e
pour une ligne de requ�te HTTP en <var>octets</var>.</p>
<p>La directive <code class="directive">LimitRequestLine</code> permet �
l'administrateur du serveur de r�duire ou augmenter la taille
maximale autoris�e d'une ligne de requ�te HTTP client. Comme une
requ�te comporte une m�thode HTTP, un URI, et une version de
protocole, la directive <code class="directive">LimitRequestLine</code>
impose une restriction sur la longueur maximale autoris�e pour un
URI dans une requ�te au niveau du serveur. Pour un serveur, cette
valeur doit �tre suffisamment grande pour r�f�rencer les noms de
toutes ses ressources, y compris toutes informations pouvant �tre
ajout�es dans la partie requ�te d'une m�thode <code>GET</code>.</p>
<p>L'administrateur du serveur peut utiliser cette directive pour
contr�ler plus efficacement les comportements anormaux des requ�tes
des clients, ce qui lui permettra de pr�venir certaines formes
d'attaques par d�ni de service.</p>
<p>Par exemple :</p>
<div class="example"><p><code>
LimitRequestLine 4094
</code></p></div>
<div class="note">Dans des conditions normales, la valeur par d�faut de cette
directive ne doit pas �tre modifi�e.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="LimitXMLRequestBody" id="LimitXMLRequestBody">LimitXMLRequestBody</a> <a name="limitxmlrequestbody" id="limitxmlrequestbody">Directive</a></h2>
<table class="directive">
<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
XML</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LimitXMLRequestBody <var>octets</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LimitXMLRequestBody 1000000</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Taille maximale (en octets) du corps d'une requ�te au format XML.
Une valeur de <code>0</code> signifie qu'aucune limite n'est
impos�e.</p>
<p>Exemple :</p>
<div class="example"><p><code>
LimitXMLRequestBody 0
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="Location" id="Location">&lt;Location&gt;</a> <a name="location" id="location">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'applique les directives contenues qu'aux URLs
sp�cifi�es</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Location
<var>chemin URL</var>|<var>URL</var>&gt; ... &lt;/Location&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">&lt;Location&gt;</code>
limite la port�e des directives contenues aux URLs d�finies par
l'argument URL. Elle est similaire � la directive <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>, et marque le
d�but d'une section qui se termine par une directive
<code>&lt;/Location&gt;</code>. Les sections <code class="directive">&lt;Location&gt;</code> sont trait�es selon l'ordre dans
lequel elles apparaissent dans le fichier de configuration, mais
apr�s les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et la lecture des
fichiers <code>.htaccess</code>, et apr�s les sections <code class="directive"><a href="#files">&lt;Files&gt;</a></code>.</p>
<p>Les sections <code class="directive">&lt;Location&gt;</code>
agissent compl�tement en dehors du syst�me de fichiers. Ceci a de
nombreuses cons�quences. Parmi les plus importantes, on ne doit pas
utiliser les sections <code class="directive">&lt;Location&gt;</code>
pour contr�ler l'acc�s aux r�pertoires du syst�me de fichiers. Comme
plusieurs URLs peuvent correspondre au m�me r�pertoire du syst�me de
fichiers, un tel contr�le d'acc�s pourrait �tre contourn�.</p>
<div class="note"><h3>Quand utiliser la section <code class="directive">&lt;Location&gt;</code></h3>
<p>Vous pouvez utiliser une section <code class="directive">&lt;Location&gt;</code> pour appliquer des directives �
des contenus situ�s en dehors du syst�me de fichiers. Pour les
contenus situ�s � l'int�rieur du syst�me de fichiers, utilisez
plut�t les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et <code class="directive"><a href="#files">&lt;Files&gt;</a></code>. <code>&lt;Location
/&gt;</code> constitue une exception et permet d'appliquer ais�ment
une configuration � l'ensemble du serveur.</p>
</div>
<p>Pour toutes les requ�tes originales (non mandat�es), l'argument
URL est un chemin d'URL de la forme
<code>/chemin/</code>. <em>Aucun protocole, nom d'h�te, port, ou cha�ne
de requ�te ne doivent appara�tre.</em> Pour les requ�tes mandat�es, l'URL
sp�cifi�e doit �tre de la forme
<code>protocole://nom_serveur/chemin</code>, et vous devez inclure
le pr�fixe.</p>
<p>L'URL peut contenir des caract�res g�n�riques. Dans une cha�ne
avec caract�res g�n�riques, <code>?</code> correspond � un caract�re
quelconque, et <code>*</code> � toute cha�ne de caract�res. Les
caract�res g�n�riques ne peuvent pas remplacer un / dans le chemin
URL.</p>
<p>On peut aussi utiliser les <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">Expressions
rationnelles</a>, moyennant l'addition d'un caract�re
<code>~</code>. Par exemple :</p>
<div class="example"><p><code>
&lt;Location ~ "/(extra|special)/data"&gt;
</code></p></div>
<p>concernerait les URLs contenant les sous-cha�ne
<code>/extra/data</code> ou <code>/special/data</code>. La directive
<code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code>
pr�sente un comportement identique � la version avec expressions
rationnelles de la directive <code class="directive">&lt;Location&gt;</code>, et son utilisation est
pr�f�rable � l'utilisation de cette derni�re pour la simple raison
qu'il est difficile de distinguer <code>~</code> de <code>-</code>
dans la plupart des fontes.</p>
<p>La directive <code class="directive">&lt;Location&gt;</code>
s'utilise principalement avec la directive <code class="directive"><a href="#sethandler">SetHandler</a></code>. Par exemple, pour activer les
requ�tes d'�tat, mais ne les autoriser que depuis des navigateurs
appartenant au domaine <code>example.com</code>, vous pouvez
utiliser :</p>
<div class="example"><p><code>
&lt;Location /status&gt;<br />
<span class="indent">
SetHandler server-status<br />
Order Deny,Allow<br />
Deny from all<br />
Allow from .example.com<br />
</span>
&lt;/Location&gt;
</code></p></div>
<div class="note"><h3>Note � propos du slash (/)</h3>
<p>La signification du caract�re slash d�pend de l'endroit o� il
se trouve dans l'URL. Les utilisateurs peuvent �tre habitu�s �
son comportement dans le syst�me de fichiers o� plusieurs slashes
successifs sont souvent r�duits � un slash unique (en d'autres
termes, <code>/home///foo</code> est identique �
<code>/home/foo</code>). Dans l'espace de nommage des URLs, ce
n'est cependant pas toujours le cas. Pour la directive <code class="directive"><a href="#locationmatch">&lt;LocationMatch&gt;</a></code> et la
version avec expressions rationnelles de la directive <code class="directive">&lt;Location&gt;</code>, vous devez sp�cifier
explicitement les slashes multiples si telle est votre
intention.</p>
<p>Par exemple, <code>&lt;LocationMatch ^/abc&gt;</code> va
correspondre � l'URL <code>/abc</code> mais pas � l'URL <code>
//abc</code>. La directive <code class="directive">&lt;Location&gt;</code> sans expression rationnelle se comporte de
la m�me mani�re lorsqu'elle est utilis�e pour des requ�tes
mandat�es. Par contre, lorsque la directive <code class="directive">&lt;Location&gt;</code> sans expression rationnelle
est utilis�e pour des requ�tes non mandat�es, elle fera
correspondre implicitement les slashes multiples � des slashes
uniques. Par exemple, si vous sp�cifiez <code>&lt;Location
/abc/def&gt;</code>, une requ�te de la forme
<code>/abc//def</code> correspondra.</p>
</div>
<h3>Voir aussi</h3>
<ul>
<li><a href="/sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
explication de la mani�re dont ces diff�rentes sections se combinent
entre elles � la r�ception d'une requ�te.</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="LocationMatch" id="LocationMatch">&lt;LocationMatch&gt;</a> <a name="locationmatch" id="locationmatch">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>N'applique les directives contenues qu'aux URLs
correspondant � une expression rationnelle</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;LocationMatch
<var>regex</var>&gt; ... &lt;/LocationMatch&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">&lt;LocationMatch&gt;</code>
limite la port�e des directives contenues � l'URL sp�cifi�e, de
mani�re identique � la directive <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Mais son argument permettant de
sp�cifier les URLs concern�es est une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a> au lieu d'une simple
cha�ne de caract�res. Par exemple :</p>
<div class="example"><p><code>
&lt;LocationMatch "/(extra|special)/data"&gt;
</code></p></div>
<p>correspondrait � toute URL contenant les sous-cha�nes
<code>/extra/data</code> ou <code>/special/data</code>.</p>
<h3>Voir aussi</h3>
<ul>
<li><a href="/sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
explication de la mani�re dont ces diff�rentes sections se combinent
entre elles � la r�ception d'une requ�te.</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="LogLevel" id="LogLevel">LogLevel</a> <a name="loglevel" id="loglevel">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contr�le la verbosit� du journal des erreurs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LogLevel <var>niveau</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>LogLevel warn</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">LogLevel</code> permet d'ajuster la
verbosit� des messages enregistr�s dans les journaux d'erreur (voir
la directive <code class="directive"><a href="#errorlog">ErrorLog</a></code>
directive). Les <var>niveau</var>x disponibles sont pr�sent�s
ci-apr�s, par ordre de criticit� d�croissante :</p>
<table class="bordered">
<tr>
<th><strong>Niveau</strong> </th>
<th><strong>Description</strong> </th>
<th><strong>Exemple</strong> </th>
</tr>
<tr>
<td><code>emerg</code> </td>
<td>Urgences - le syst�me est inutilisable.</td>
<td>"Child cannot open lock file. Exiting"</td>
</tr>
<tr>
<td><code>alert</code> </td>
<td>Des mesures doivent �tre prises imm�diatement.</td>
<td>"getpwuid: couldn't determine user name from uid"</td>
</tr>
<tr>
<td><code>crit</code> </td>
<td>Conditions critiques.</td>
<td>"socket: Failed to get a socket, exiting child"</td>
</tr>
<tr>
<td><code>error</code> </td>
<td>Erreurs.</td>
<td>"Premature end of script headers"</td>
</tr>
<tr>
<td><code>warn</code> </td>
<td>Avertissements.</td>
<td>"child process 1234 did not exit, sending another
SIGHUP"</td>
</tr>
<tr>
<td><code>notice</code> </td>
<td>Ev�nement important mais normal.</td>
<td>"httpd: caught SIGBUS, attempting to dump core in
..."</td>
</tr>
<tr>
<td><code>info</code> </td>
<td>Informations.</td>
<td>"Server seems busy, (you may need to increase
StartServers, or Min/MaxSpareServers)..."</td>
</tr>
<tr>
<td><code>debug</code> </td>
<td>Messages de d�bogage.</td>
<td>"Opening config file ..."</td>
</tr>
</table>
<p>Lorsqu'un niveau particulier est sp�cifi�, les messages de tous
les autres niveaux de criticit� sup�rieure seront aussi enregistr�s.
<em>Par exemple</em>, si <code>LogLevel info</code> est sp�cifi�,
les messages de niveaux <code>notice</code> et <code>warn</code>
seront aussi �mis.</p>
<p>Il est recommand� d'utiliser un niveau <code>crit</code> ou
inf�rieur.</p>
<p>Par exemple :</p>
<div class="example"><p><code>
LogLevel notice
</code></p></div>
<div class="note"><h3>Note</h3>
<p>Si la journalisation s'effectue directement dans un fichier,
les messages de niveau <code>notice</code> ne peuvent pas �tre
supprim�s et sont donc toujours journalis�s. Cependant, ceci ne
s'applique pas lorsque la journalisation s'effectue vers
<code>syslog</code>.</p>
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="MaxKeepAliveRequests" id="MaxKeepAliveRequests">MaxKeepAliveRequests</a> <a name="maxkeepaliverequests" id="maxkeepaliverequests">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de requ�tes permises pour une connexion
persistante</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MaxKeepAliveRequests <var>nombre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>MaxKeepAliveRequests 100</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">MaxKeepAliveRequests</code> permet
de limiter le nombre de requ�tes autoris�es par connexion lorsque
<code class="directive"><a href="#keepalive">KeepAlive</a></code> est � "on". Si sa
valeur est <code>0</code>, le nombre de requ�tes autoris�es est
illimit�. Il est recommand� de d�finir une valeur assez haute pour
des performances du serveur maximales.</p>
<p>Par exemple :</p>
<div class="example"><p><code>
MaxKeepAliveRequests 500
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="NameVirtualHost" id="NameVirtualHost">NameVirtualHost</a> <a name="namevirtualhost" id="namevirtualhost">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit une adresse IP pour les serveurs virtuels � base de
nom</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NameVirtualHost <var>adresse</var>[:<var>port</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Une seule directive <code class="directive">NameVirtualHost</code> permet
d'identifier un ensemble de serveurs virtuels identiques que le serveur
va s�lectionner en fonction du <em>nom d'h�te</em> sp�cifi� par le
client. La directive <code class="directive">NameVirtualHost</code> est
obligatoire si vous souhaitez configurer des <a href="/vhosts/">serveurs virtuels � base de nom</a>.</p>
<p>Cette directive, ainsi que les directives <code class="directive">VirtualHost</code> correspondantes, <em>doit</em> comporter un
num�ro de port si le serveur supporte les connexions HTTP et HTTPS.</p>
<p>Bien que <var>adresse</var> puisse contenir un nom d'h�te, il est
recommand� d'utiliser plut�t une adresse IP ou un nom d'h�te avec
caract�res g�n�riques. Une directive NameVirtualHost contenant des
caract�res g�n�riques ne peut correspondre qu'� des serveurs virtuels
qui contiennent aussi des caract�res g�n�riques dans leur argument.</p>
<p>Dans les cas o� un pare-feu ou autre mandataire re�oit les requ�tes
et les redirige sous une adresse IP diff�rente vers le serveur, vous
devez sp�cifier l'adresse IP de l'interface physique de la machine qui
va servir les requ�tes.</p>
<p>Dans l'exemple ci-dessous, les requ�tes re�ues sur l'interface
192.0.2.1 et le port 80 ne vont d�clencher une s�lection que parmi les
deux premiers serveurs virtuels. Les requ�tes re�ues sur le port 80 et
sur toute interface ne vont d�clencher une s�lection que parmi les
troisi�me et quatri�me serveurs virtuels. D'une mani�re g�n�rale,
lorsque l'interface ne constitue pas un crit�re important de s�lection,
la valeur "*:80" suffit pour les directives NameVirtualHost et
VirtualHost.</p>
<div class="example"><p><code>
NameVirtualHost 192.0.2.1:80<br />
NameVirtualHost *:80<br /><br />
&lt;VirtualHost 192.0.2.1:80&gt;<br />
&nbsp; ServerName namebased-a.example.com<br />
&lt;/VirtualHost&gt;<br />
<br />
&lt;VirtualHost 192.0.2.1:80&gt;<br />
&nbsp; Servername namebased-b.example.com<br />
&lt;/VirtualHost&gt;<br />
<br />
&lt;VirtualHost *:80&gt;<br />
&nbsp; ServerName namebased-c.example.com <br />
&lt;/VirtualHost&gt;<br />
<br />
&lt;VirtualHost *:80&gt;<br />
&nbsp; ServerName namebased-d.example.com <br />
&lt;/VirtualHost&gt;<br />
<br />
</code></p></div>
<p>Les adresses IPv6 doivent �tre entour�es de crochets, comme dans
l'exemple suivant :</p>
<div class="example"><p><code>
NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
</code></p></div>
<div class="note"><h3>Argument de la directive <code class="directive">&lt;VirtualHost&gt;</code></h3>
<p>Notez que l'argument de la directive <code class="directive">&lt;VirtualHost&gt;</code> doit �tre identique �
l'argument de la directive <code class="directive">NameVirtualHost</code>.</p>
<div class="example"><p><code>
NameVirtualHost 192.0.2.2:80<br />
&lt;VirtualHost 192.0.2.2:80&gt;<br />
# ...<br />
&lt;/VirtualHost&gt;<br />
</code></p></div>
</div>
<h3>Voir aussi</h3>
<ul>
<li><a href="/vhosts/">Documentation sur les serveurs
virtuels</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="Options" id="Options">Options</a> <a name="options" id="options">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit les fonctionnalit�s disponibles pour un r�pertoire
particulier</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Options
[+|-]<var>option</var> [[+|-]<var>option</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Options All</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Options</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">Options</code> permet de d�finir
les fonctionnalit�s de serveur disponibles pour un r�pertoire
particulier.</p>
<p><var>option</var> peut �tre d�fini � <code>None</code>, auquel
cas aucune fonctionnalit� sp�cifique n'est activ�e, ou comprendre
une ou plusieurs des options suivantes :</p>
<dl>
<dt><code>All</code></dt>
<dd>Toutes les options except� <code>MultiViews</code>. il s'agit
de la configuration par d�faut.</dd>
<dt><code>ExecCGI</code></dt>
<dd>L'ex�cution de scripts CGI � l'aide du module
<code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code> est permise.</dd>
<dt><code>FollowSymLinks</code></dt>
<dd>
Le serveur va suivre les liens symboliques dans le r�pertoire
concern�.
<div class="note">
<p>Bien que le serveur suive les liens symboliques, il ne modifie
<em>pas</em> le nom de chemin concern� d�fini par la section
<code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>.</p>
<p>Notez aussi que cette option <strong>est ignor�e</strong> si
elle est d�finie dans une section <code class="directive"><a href="#location">&lt;Location&gt;</a></code>.</p>
<p>Le fait d'omettre cette option ne doit pas �tre consid�r� comme
une mesure de s�curit� efficace, car il existe toujours une
situation de comp�tition (race condition) entre l'instant o� l'on
v�rifie qu'un chemin n'est pas un lien symbolique, et l'instant o�
l'on utilise effectivement ce chemin.</p>
</div></dd>
<dt><code>Includes</code></dt>
<dd>
Les inclusions c�t� serveur (SSI) � l'aide du module
<code class="module"><a href="/mod/mod_include.html">mod_include</a></code> sont autoris�es.</dd>
<dt><code>IncludesNOEXEC</code></dt>
<dd>
Les inclusions c�t� serveur (SSI) sont permises, mais <code>#exec
cmd</code> et <code>#exec cgi</code> sont d�sactiv�s.
L'utilisation de <code>#include virtual</code> pour les scripts
CGI est cependant toujours possible depuis des r�pertoires
d�finis par <code class="directive"><a href="/mod/mod_alias.html#scriptalias">ScriptAlias</a></code>.</dd>
<dt><code>Indexes</code></dt>
<dd>
Si une URL requise correspond au r�pertoire concern�, et si aucun
<code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code> (<em>par
exemple</em> <code>index.html</code>) n'est d�fini pour ce
r�pertoire, le module <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> va renvoyer
un listing format� du r�pertoire.</dd>
<dt><code>MultiViews</code></dt>
<dd>
Les vues multiples ("multiviews") � <a href="/content-negotiation.html">contenu n�goci�</a> � l'aide du
module <code class="module"><a href="/mod/mod_negotiation.html">mod_negotiation</a></code> sont autoris�es.</dd>
<dt><code>SymLinksIfOwnerMatch</code></dt>
<dd>Le serveur ne suivra que les liens symboliques qui renvoient
vers un fichier ou un r�pertoire dont le propri�taire est le m�me
que celui du lien.
<div class="note"><h3>Note</h3> <p>Cette option est ignor�e si elle est
d�finie dans une section <code class="directive"><a href="#location">&lt;Location&gt;</a></code>.</p>
<p>Le fait d'omettre cette option ne doit pas �tre consid�r� comme
une mesure de s�curit� efficace, car il existe toujours une
situation de comp�tition (race condition) entre l'instant o� l'on
v�rifie qu'un chemin n'est pas un lien symbolique, et l'instant o�
l'on utilise effectivement ce chemin.</p></div>
</dd>
</dl>
<p>Normalement, si plusieurs directives
<code class="directive">Options</code> peuvent s'appliquer � un r�pertoire,
c'est la plus sp�cifique qui est utilis�e et les autres sont
ignor�es ; les options ne sont pas fusionn�es (voir <a href="/sections.html#mergin">comment les sections sont
fusionn�es</a>). Elles le sont cependant si <em>toutes</em> les
options de la directive <code class="directive">Options</code> sont
pr�c�d�es d'un symbole <code>+</code> ou <code>-</code>. Toute
option pr�c�d�e d'un <code>+</code> est ajout�e � la liste des
options courantes de mani�re forc�e et toute option pr�c�d�e d'un
<code>-</code> est supprim�e de la liste des options courantes de la
m�me mani�re.</p>
<div class="warning"><h3>Avertissement</h3>
<p>M�langer des <code class="directive">Options</code> avec <code>+</code>
ou <code>-</code> avec des <code class="directive">Options</code> sans
<code>+</code> ou <code>-</code> constitue une erreur de syntaxe, et
peut r�sulter en des comportements inattendus.</p>
</div>
<p>Par exemple, sans aucun symbole <code>+</code> et <code>-</code>
:</p>
<div class="example"><p><code>
&lt;Directory /web/docs&gt;<br />
<span class="indent">
Options Indexes FollowSymLinks<br />
</span>
&lt;/Directory&gt;<br />
<br />
&lt;Directory /web/docs/spec&gt;<br />
<span class="indent">
Options Includes<br />
</span>
&lt;/Directory&gt;
</code></p></div>
<p>ici, seule l'option <code>Includes</code> sera prise en compte
pour le r�pertoire <code>/web/docs/spec</code>. Par contre, si la
seconde directive <code class="directive">Options</code> utilise les
symboles <code>+</code> et <code>-</code> :</p>
<div class="example"><p><code>
&lt;Directory /web/docs&gt;<br />
<span class="indent">
Options Indexes FollowSymLinks<br />
</span>
&lt;/Directory&gt;<br />
<br />
&lt;Directory /web/docs/spec&gt;<br />
<span class="indent">
Options +Includes -Indexes<br />
</span>
&lt;/Directory&gt;
</code></p></div>
<p>alors, les options <code>FollowSymLinks</code> et
<code>Includes</code> seront prises en compte pour le r�pertoire
<code>/web/docs/spec</code>.</p>
<div class="note"><h3>Note</h3>
<p>L'utilisation de <code>-IncludesNOEXEC</code> ou
<code>-Includes</code> d�sactive compl�tement les inclusions c�t�
serveur sans tenir compte des d�finitions pr�c�dentes.</p>
</div>
<p>En l'absence de toute d�finition d'options, la valeur par d�faut
est <code>All</code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="RLimitCPU" id="RLimitCPU">RLimitCPU</a> <a name="rlimitcpu" id="rlimitcpu">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le temps CPU allou� aux processus initi�s par les
processus enfants d'Apache</td></tr>
<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>
<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
d'exploitation</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Prend 1 ou 2 param�tres. Le premier definit la limite de
consommation de ressources pour tous les processus, et le second la
consommation de ressources maximale. Les deux param�tres peuvent
contenir soit un nombre, soit <code>max</code> pour indiquer au
serveur que la limite de consommation correspond � la valeur
maximale autoris�e par la configuration du syst�me d'exploitation.
Pour augmenter la consommation maximale de ressources, le serveur
doit s'ex�cuter en tant que <code>root</code>, ou se trouver dans sa
phase de d�marrage.</p>
<p>Cette directive s'applique aux processus initi�s par les
processus enfants d'Apache qui traitent les requ�tes, et non aux
processus enfants eux-m�mes. Sont concern�s les scripts CGI et les
commandes exec des SSI, mais en aucun cas les processus initi�s par
le processus parent d'Apache comme les journalisations redirig�es
vers un programme.</p>
<p>Les limites de ressources CPU sont exprim�es en secondes par
processus.</p>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
<li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="RLimitMEM" id="RLimitMEM">RLimitMEM</a> <a name="rlimitmem" id="rlimitmem">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite la m�moire allou�e aux processus initi�s par les
processus enfants d'Apache</td></tr>
<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>
<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
d'exploitation</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Prend 1 ou 2 param�tres. Le premier definit la limite de
consommation de ressources pour tous les processus, et le second la
consommation de ressources maximale. Les deux param�tres peuvent
contenir soit un nombre, soit <code>max</code> pour indiquer au
serveur que la limite de consommation correspond � la valeur
maximale autoris�e par la configuration du syst�me d'exploitation.
Pour augmenter la consommation maximale de ressources, le serveur
doit s'ex�cuter en tant que <code>root</code>, ou se trouver dans sa
phase de d�marrage.</p>
<p>Cette directive s'applique aux processus initi�s par les
processus enfants d'Apache qui traitent les requ�tes, et non aux
processus enfants eux-m�mes. Sont concern�s les scripts CGI et les
commandes exec des SSI, mais en aucun cas les processus initi�s par
le processus parent d'Apache comme les journalisations redirig�es
vers un programme.</p>
<p>Les limites de ressources m�moire sont exprim�es en octets par
processus.</p>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
<li><code class="directive"><a href="#rlimitnproc">RLimitNPROC</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="RLimitNPROC" id="RLimitNPROC">RLimitNPROC</a> <a name="rlimitnproc" id="rlimitnproc">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de processus qui peuvent �tre initi�s par
les processus initi�s par les processus enfants d'Apache</td></tr>
<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>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Unset; uses operating system defaults</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Prend 1 ou 2 param�tres. Le premier definit la limite de
consommation de ressources pour tous les processus, et le second la
consommation de ressources maximale. Les deux param�tres peuvent
contenir soit un nombre, soit <code>max</code> pour indiquer au
serveur que la limite de consommation correspond � la valeur
maximale autoris�e par la configuration du syst�me d'exploitation.
Pour augmenter la consommation maximale de ressources, le serveur
doit s'ex�cuter en tant que <code>root</code>, ou se trouver dans sa
phase de d�marrage.</p>
<p>Cette directive s'applique aux processus initi�s par les
processus enfants d'Apache qui traitent les requ�tes, et non aux
processus enfants eux-m�mes. Sont concern�s les scripts CGI et les
commandes exec des SSI, mais en aucun cas les processus initi�s par
le processus parent d'Apache comme les journalisations redirig�es
vers un programme.</p>
<p>Les limites des processus contr�lent le nombre de processus par
utilisateur.</p>
<div class="note"><h3>Note</h3>
<p>Si les processus CGI s'ex�cutent sous le m�me
utilisateur que celui du serveur web, cette
directive va limiter le nombre de processus que le serveur
pourra lui-m�me cr�er. La pr�sence de messages
<strong><code>cannot fork</code></strong> dans le journal des
erreurs indiquera que la limite est atteinte.</p>
</div>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#rlimitmem">RLimitMEM</a></code></li>
<li><code class="directive"><a href="#rlimitcpu">RLimitCPU</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ScriptInterpreterSource" id="ScriptInterpreterSource">ScriptInterpreterSource</a> <a name="scriptinterpretersource" id="scriptinterpretersource">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet de localiser l'interpr�teur des scripts
CGI</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptInterpreterSource Registry|Registry-Strict|Script</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ScriptInterpreterSource Script</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Win32 seulement ;
l'option <code>Registry-Strict</code> est disponible dans les versions
2.0 et sup�rieures d'Apache</td></tr>
</table>
<p>Cette directive permet de contr�ler la m�thode qu'utilise Apache
pour trouver l'interpr�teur destin� � ex�cuter les scripts CGI. La
d�finition par d�faut est <code>Script</code> : ceci indique �
Apache qu'il doit utiliser l'interpr�teur pr�cis� dans la ligne
shebang du script (la premi�re ligne, commen�ant par
<code>#!</code>). Sur les syst�mes Win32, cette ligne ressemble
souvent � ceci :</p>
<div class="example"><p><code>
#!C:/Perl/bin/perl.exe
</code></p></div>
<p>ou simplement, dans le cas o� <code>perl</code> est dans le
<code>PATH</code> :</p>
<div class="example"><p><code>
#!perl
</code></p></div>
<p>Avec <code>ScriptInterpreterSource Registry</code>, Windows va
effectuer une recherche dans l'arborescence
<code>HKEY_CLASSES_ROOT</code> de la base de registre avec comme
mot-cl� l'extension du fichier contenant le script (par exemple
<code>.pl</code>). C'est la commande d�finie par la sous-cl� de
registre <code>Shell\ExecCGI\Command</code> ou, si elle n'existe
pas, la sous-cl� <code>Shell\Open\Command</code> qui est utilis�e
pour ouvrir le fichier du script. Si ces cl�s de registre ne sont
pas trouv�es, Apache utilise la m�thode de l'option
<code>Script</code>.</p>
<div class="warning"><h3>S�curit�</h3>
<p>Soyez prudent si vous utilisez <code>ScriptInterpreterSource
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
d'ex�cuter <strong>tous</strong> les fichiers contenus dans
celui-ci. L'option <code>Registry</code> peut causer des appels de
programmes non voulus sur des fichiers non destin�s � �tre ex�cut�s.
Par exemple, la commande par d�faut open sur les fichiers
<code>.htm</code> sur la plupart des syst�mes Windows va lancer
Microsoft Internet Explorer ; ainsi, toute requ�te HTTP pour un
fichier <code>.htm</code> situ� dans le r�pertoire des scripts
va lancer le navigateur en arri�re-plan sur le serveur, ce qui a
toutes les chances de crasher votre syst�me dans les minutes qui
suivent.</p>
</div>
<p>L'option <code>Registry-Strict</code>, apparue avec Apache 2.0,
agit de mani�re identique � <code>Registry</code>, mais n'utilise
que la sous-cl� <code>Shell\ExecCGI\Command</code>. La pr�sence de
la cl� <code>ExecCGI</code> n'�tant pas syst�matique, Elle doit �tre
d�finie manuellement dans le registre Windows et �vite ainsi tout
appel de programme accidentel sur votre syst�me.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerAdmin" id="ServerAdmin">ServerAdmin</a> <a name="serveradmin" id="serveradmin">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'adresse �lectronique que le serveur inclut dans les
messages d'erreur envoy�s au client</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAdmin <var>adresse �lectronique</var>|<var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">ServerAdmin</code> permet de d�finir
l'adresse de contact que le serveur va inclure dans tout message
d'erreur qu'il envoie au client. Si le programme <code>httpd</code>
ne reconnait pas l'argument fourni comme une URL, il suppose que
c'est une <var>adresse �lectronique</var>, et lui ajoute le pr�fixe
<code>mailto:</code> dans les cibles des hyperliens. Il est
cependant recommand� d'utiliser exclusivement une adresse
�lectronique, car de nombreux scripts CGI consid�rent ceci comme
implicite. Si vous utilisez une URL, elle doit pointer vers un autre
serveur que vous contr�lez. Dans le cas contraire, les utilisateurs
seraient dans l'impossibilit� de vous contacter en cas de probl�me.</p>
<p>Il peut s'av�rer utile de d�finir une adresse d�di�e �
l'administration du serveur, par exemple :</p>
<div class="example"><p><code>
ServerAdmin www-admin@foo.exemple.com
</code></p></div>
<p>car les utilisateurs ne mentionnent pas syst�matiquement le
serveur dont ils parlent !</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerAlias" id="ServerAlias">ServerAlias</a> <a name="serveralias" id="serveralias">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Autres noms d'un serveur utilisables pour atteindre des
serveurs virtuels � base de nom</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerAlias <var>nom serveur</var> [<var>nom serveur</var>]
...</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">ServerAlias</code> permet de d�finir
les noms alternatifs d'un serveur utilisables pour atteindre des <a href="/vhosts/name-based.html">serveurs virtuels � base de
nom</a>. La directive <code class="directive">ServerAlias</code> peut
contenir des caract�res g�n�riques, si n�cessaire.</p>
<div class="example"><p><code>
&lt;VirtualHost *:80&gt;<br />
ServerName serveur.domaine.com<br />
ServerAlias serveur serveur2.domaine.com serveur2<br />
ServerAlias *.exemple.com<br />
# ...<br />
&lt;/VirtualHost&gt;
</code></p></div>
<h3>Voir aussi</h3>
<ul>
<li><a href="/vhosts/">Documentation sur les serveurs virtuels
d'Apache</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerName" id="ServerName">ServerName</a> <a name="servername" id="servername">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom d'h�te et port que le serveur utilise pour
s'authentifier lui-m�me</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerName [<var>protocole</var>://]<var>nom de domaine
enti�rement qualifi�</var>[:<var>port</var>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Dans la version 2.0, cette directive remplace la
fonctionnalit� de la directive <code class="directive">Port</code> de la version
1.3.</td></tr>
</table>
<p>La directive <code class="directive">ServerName</code> permet de d�finir
les protocole, nom d'h�te et port d'une requ�te que le serveur
utilise pour s'authentifier lui-m�me. Ceci est utile lors de la
cr�ation de redirections d'URLs. Par exemple, si le nom de la
machine h�bergeant le serveur web est
<code>simple.exemple.com</code>, la machine poss�de l'alias
DNS <code>www.exemple.com</code>, et si vous voulez que le serveur
web s'identifie avec cet alias, vous devez utilisez la d�finition
suivante :</p>
<div class="example"><p><code>
ServerName www.exemple.com:80
</code></p></div>
<p>Si la directive <code class="directive">ServerName</code> n'est pas
d�finie, le serveur tente de d�terminer le nom d'h�te en effectuant
une recherche DNS inverse sur son adresse IP. Si la directive
<code class="directive">ServerName</code> ne pr�cise pas de port, le serveur
utilisera celui de la requ�te entrante. Il est recommand� de
sp�cifier un nom d'h�te et un port sp�cifiques � l'aide de la
directive <code class="directive">ServerName</code> pour une fiabilit�
optimale et � titre pr�ventif.</p>
<p>Si vous d�finissez des <a href="/vhosts/name-based.html">serveurs virtuels � base de
nom</a>, une directive <code class="directive">ServerName</code> situ�e �
l'int�rieur d'une section <code class="directive"><a href="#virtualhost">&lt;VirtualHost&gt;</a></code> sp�cifiera quel nom d'h�te
doit appara�tre dans l'en-t�te de requ�te <code>Host:</code> pour
pouvoir atteindre ce serveur virtuel.</p>
<p>Parfois, le serveur s'ex�cute en amont d'un dispositif qui
impl�mente SSL, comme un mandataire inverse, un r�partiteur de
charge ou un bo�tier d�di� SSL. Dans ce cas, sp�cifiez le protocole
<code>https://</code> et le port auquel les clients se connectent
dans la directive <code class="directive">ServerName</code>, afin de
s'assurer que le serveur g�n�re correctement ses URLs
d'auto-identification.
</p>
<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
d�finitions qui permettent de d�terminer si les URLs
auto-identifiantes (par exemple via le module
<code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code>) vont faire r�f�rence au port sp�cifi�, ou
au port indiqu� dans la requ�te du client.
</p>
<h3>Voir aussi</h3>
<ul>
<li><a href="/dns-caveats.html">Probl�mes concernant le DNS et
Apache</a></li>
<li><a href="/vhosts/">Documentation sur les serveurs virtuels
d'Apache</a></li>
<li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
<li><code class="directive"><a href="#namevirtualhost">NameVirtualHost</a></code></li>
<li><code class="directive"><a href="#serveralias">ServerAlias</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerPath" id="ServerPath">ServerPath</a> <a name="serverpath" id="serverpath">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom de chemin d'URL h�rit� pour un serveur virtuel � base
de nom acc�d� par un navigateur incompatible</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerPath <var>chemin d'URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">ServerPath</code> permet de d�finir
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>
<h3>Voir aussi</h3>
<ul>
<li><a href="/vhosts/">Documentation sur les serveurs virtuels
d'Apache</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerRoot" id="ServerRoot">ServerRoot</a> <a name="serverroot" id="serverroot">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine du r�pertoire d'installation du
serveur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerRoot <var>chemin de r�pertoire</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ServerRoot /usr/local/apache</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">ServerRoot</code> permet de d�finir
le r�pertoire dans lequel le serveur est install�. En particulier,
il contiendra les sous-r�pertoires <code>conf/</code> et
<code>logs/</code>. Les chemins relatifs indiqu�s dans les autres
directives (comme <code class="directive"><a href="#include">Include</a></code> ou <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code>) seront d�finis par
rapport � ce r�pertoire.</p>
<div class="example"><h3>Example</h3><p><code>
ServerRoot /home/httpd
</code></p></div>
<h3>Voir aussi</h3>
<ul>
<li><a href="/invoking.html">the <code>-d</code>
options de <code>httpd</code></a></li>
<li><a href="/misc/security_tips.html#serverroot">les conseils �
propos de s�curit�</a> pour des informations sur la mani�re de d�finir
correctement les permissions sur le r�pertoire indiqu� par la directive
<code class="directive">ServerRoot</code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerSignature" id="ServerSignature">ServerSignature</a> <a name="serversignature" id="serversignature">Directive</a></h2>
<table class="directive">
<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
serveur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerSignature On|Off|EMail</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ServerSignature Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">ServerSignature</code> permet de
d�finir une ligne de pied de page fixe pour les documents g�n�r�s
par le serveur (messages d'erreur, listings de r�pertoires ftp de
<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>,
etc...). Dans le cas d'une cha�ne de mandataires, l'utilisateur n'a
souvent aucun moyen de d�terminer lequel des mandataires cha�n�s a
g�n�r� un message d'erreur, et c'est une des raisons pour lesquelles
on peut �tre amen� � ajouter un tel pied de page.</p>
<p>La valeur par d�faut <code>Off</code> supprime la ligne de pied
de page (et est ainsi compatible avec le comportement des
versions 1.2 et ant�rieures d'Apache). la valeur <code>On</code>
ajoute simplement une ligne contenant le num�ro de version du
serveur ainsi que le nom du serveur virtuel issu de la directive
<code class="directive"><a href="#servername">ServerName</a></code>, alors que la valeur
<code>EMail</code> ajoute en plus une r�f�rence "mailto:" �
l'administrateur du document r�f�renc� issu la directive
<code class="directive"><a href="#serveradmin">ServerAdmin</a></code>.</p>
<p>Apr�s la version 2.0.44, les d�tails � propos du num�ro de
version du serveur sont contr�l�s � l'aide de la directive
<code class="directive"><a href="#servertokens">ServerTokens</a></code>.</p>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#servertokens">ServerTokens</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ServerTokens" id="ServerTokens">ServerTokens</a> <a name="servertokens" id="servertokens">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure l'en-t�te <code>Server</code> de la r�ponse
HTTP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full|Off|Set</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ServerTokens Full</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Cette directive permet de contr�ler le contenu de l'en-t�te
<code>Server</code> inclus dans la r�ponse envoy�e au client : cet
en-t�te peut contenir le type de syst�me d'exploitation du serveur,
ainsi que des informations � propos des modules compil�s avec le
serveur.</p>
<dl>
<dt><code>ServerTokens Full</code> (ou non sp�cifi�)</dt>
<dd>Le serveur envoie par exemple : <code>Server: Apache/2.0.41
(Unix) PHP/4.2.2 MyMod/1.2</code></dd>
<dt><code>ServerTokens Prod[uctOnly]</code></dt>
<dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
Apache</code></dd>
<dt><code>ServerTokens Major</code></dt>
<dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
Apache/2</code></dd>
<dt><code>ServerTokens Minor</code></dt>
<dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
Apache/2.0</code></dd>
<dt><code>ServerTokens Min[imal]</code></dt>
<dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
Apache/2.0.41</code></dd>
<dt><code>ServerTokens OS</code></dt>
<dd>Le serveur renvoie (<em>par exemple</em>): <code>Server:
Apache/2.0.41 (Unix)</code></dd>
<dt><code>ServerTokens Set <em>"Cha�ne"</em></code></dt>
<dd>Le serveur envoie la cha�ne sp�cifi�e au client (par
exemple, <code>Serveur: MonServeurWeb/8.6</code>)<br />
<strong>Note:</strong> La cha�ne doit �tre
entour�e de guillemets si elle contient des espaces.
</dd>
<dt><code>ServerTokens Off</code></dt>
<dd>Le serveur n'envoie aucun en-t�te <code>Server:</code> (et
<code>SERVER_SOFTWARE</code> est vide)</dd>
</dl>
<p>Cette d�finition s'applique � l'ensemble du serveur et ne peut
�tre activ�e ou d�sactiv�e pour tel ou tel serveur virtuel.</p>
<p>Dans les versions post�rieures � 2.0.44, cette directive contr�le
aussi les informations fournies par la directive <code class="directive"><a href="#serversignature">ServerSignature</a></code>.</p>
<div class="note">D�finir <code class="directive">ServerTokens</code> � une
valeur inf�rieure � <code>minimal</code> n'est pas
recommand� car le d�bogage des probl�mes
interop�rationnels n'en sera alors que plus difficile. Notez
aussi que la d�sactivation de l'en-t�te Server:
n'am�liore en rien la s�curit� de votre
serveur ; le concept de "s�curit� par
l'obscurit�" est un mythe et conduit �
une mauvaise perception de ce qu'est la s�curit�.</div>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#serversignature">ServerSignature</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="SetHandler" id="SetHandler">SetHandler</a> <a name="sethandler" id="sethandler">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force le traitement des fichiers sp�cifi�s par un
gestionnaire particulier</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetHandler <var>nom gestionnaire</var>|None</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Int�gr� dans le noyau d'Apache depuis la version
2.0</td></tr>
</table>
<p>Lorsqu'elle se situe � l'int�rieur d'un fichier
<code>.htaccess</code>, ou d'une section <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> ou <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, cette directive force le
traitement de tous les fichiers sp�cifi�s par le <a href="/handler.html">gestionnaire</a> d�fini par l'argument
<var>nom gestionnaire</var>. Par exemple, dans le cas d'un
r�pertoire dont vous voulez interpr�ter le contenu comme des
fichiers de r�gles d'images cliquables, sans tenir compte des
extensions, vous pouvez ajouter la ligne suivante dans un fichier
<code>.htaccess</code> de ce r�pertoire :</p>
<div class="example"><p><code>
SetHandler imap-file
</code></p></div>
<p>Autre exemple : si vous voulez que le serveur affiche un
compte-rendu d'�tat chaque fois qu'une URL du type <code>http://nom
serveur/status</code> est appel�e, vous pouvez ajouter ceci dans
<code>httpd.conf</code> :</p>
<div class="example"><p><code>
&lt;Location /status&gt;<br />
<span class="indent">
SetHandler server-status<br />
</span>
&lt;/Location&gt;
</code></p></div>
<p>Vous pouvez �craser la d�finition ant�rieure d'une directive
<code class="directive">SetHandler</code> en utilisant la valeur
<code>None</code>.</p>
<p><strong>Note :</strong> comme SetHandler l'emporte sur la
d�finition des gestionnaires par d�faut, le comportement habituel
consistant � traiter les URLs se terminant par un slash (/) comme
des r�pertoires ou des fichiers index est d�sactiv�.</p>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="/mod/mod_mime.html#addhandler">AddHandler</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="SetInputFilter" id="SetInputFilter">SetInputFilter</a> <a name="setinputfilter" id="setinputfilter">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit les filtres par lesquels vont passer les requ�tes
client et les donn�es POST</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetInputFilter <var>filtre</var>[;<var>filtre</var>...]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">SetInputFilter</code> permet de
d�finir le ou les filtres par lesquels vont passer les requ�tes
client et les donn�es POST au moment o� le serveur les re�oit. Cette
d�finition vient en ajout � tout autre filtre d�fini en
quelqu'endroit que ce soit, y compris via la directive <code class="directive"><a href="/mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>.</p>
<p>Si la directive comporte plusieurs filtres, ils doivent �tre
s�par�s par des points-virgules, et sp�cifi�s selon l'ordre dans
lequel vous souhaitez les voir agir sur les contenus.</p>
<h3>Voir aussi</h3>
<ul>
<li>documentation des <a href="/filter.html">Filtres</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="SetOutputFilter" id="SetOutputFilter">SetOutputFilter</a> <a name="setoutputfilter" id="setoutputfilter">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit les filtres par lesquels vont passer les r�ponses
du serveur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetOutputFilter <var>filtre</var>[;<var>filtre</var>...]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">SetOutputFilter</code> permet de
d�finir les filtres par lesquels vont passer les r�ponses du serveur
avant d'�tre envoy�es au client. Cette d�finition vient en ajout �
tout autre filtre d�fini en quelqu'endroit que ce soit, y compris
via la directive <code class="directive"><a href="/mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>.</p>
<p>Par exemple, la configuration suivante va traiter tous les
fichiers du r�pertoire <code>/www/data/</code> comme des inclusions
c�t� serveur (SSI) :</p>
<div class="example"><p><code>
&lt;Directory /www/data/&gt;<br />
<span class="indent">
SetOutputFilter INCLUDES<br />
</span>
&lt;/Directory&gt;
</code></p></div>
<p>Si la directive comporte plusieurs filtres, ils doivent �tre
s�par�s par des points-virgules, et sp�cifi�s selon l'ordre dans
lequel vous souhaitez les voir agir sur les contenus.</p>
<h3>Voir aussi</h3>
<ul>
<li><a href="/filter.html">Filters</a> documentation</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="TimeOut" id="TimeOut">TimeOut</a> <a name="timeout" id="timeout">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Temps pendant lequel le serveur va attendre certains
�v�nements avant de consid�rer qu'une requ�te a �chou�</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TimeOut <var>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>TimeOut 300</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>La directive <code class="directive">TimeOut</code> permet de d�finir le
temps maximum pendant lequel Apache va attendre des entr�es/sorties
selon les circonstances :</p>
<ol>
<li>Lors de la lecture de donn�es en provenance du client, le
temps maximum jusqu'� l'arriv�e d'un paquet TCP si le tampon est
vide.</li>
<li>Lors de l'�criture de donn�es destin�es au client, le temps
maximum jusqu'� l'arriv�e de l'accus�-r�ception d'un paquet si le
tampon d'envoi est plein.</li>
<li>Avec <code class="module"><a href="/mod/mod_cgi.html">mod_cgi</a></code>, le temps d'attente maximum des
sorties d'un script CGI.</li>
<li>Avec <code class="module"><a href="/mod/mod_ext_filter.html">mod_ext_filter</a></code>, le temps d'attente
maximum des sorties d'un processus de filtrage.</li>
<li>Avec <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>, la valeur du d�lai par d�faut
si <code class="directive"><a href="/mod/mod_proxy.html#proxytimeout">ProxyTimeout</a></code> n'est
pas d�fini.</li>
</ol>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="TraceEnable" id="TraceEnable">TraceEnable</a> <a name="traceenable" id="traceenable">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�termine le comportement des requ�tes
<code>TRACE</code></td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>TraceEnable <var>[on|off|extended]</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>TraceEnable on</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible dans les versions 1.3.34, 2.0.55 et
sup�rieures d'Apache</td></tr>
</table>
<p>Cette directive l'emporte sur le comportement de
<code>TRACE</code> pour le noyau du serveur et
<code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. La d�finition par d�faut
<code>TraceEnable on</code> permet des requ�tes <code>TRACE</code>
selon la RFC 2616, qui interdit d'ajouter tout corps � la requ�te.
La d�finition <code>TraceEnable off</code> indique au noyau du
serveur et � <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> de retourner un code
d'erreur <code>405</code> (M�thode non autoris�e) au client.</p>
<p>En fait, et � des fins de test et de diagnostic seulement, on
peut autoriser l'ajout d'un corps de requ�te � l'aide de la
d�finition non standard <code>TraceEnable extended</code>. Le noyau
du serveur (dans le cas d'un serveur d'origine) va limiter la taille
du corps de requ�te � 64k (plus 8k pour les en-t�tes de
fractionnement si <code>Transfer-Encoding: chunked</code> est
utilis�). Le noyau du serveur va reproduire l'ensemble des en-t�tes,
y compris les en-t�tes de fractionnement avec le corps de la
r�ponse. Dans le cas d'un serveur mandataire, la taille du corps de
requ�te n'est pas limit�e � 64k.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="UseCanonicalName" id="UseCanonicalName">UseCanonicalName</a> <a name="usecanonicalname" id="usecanonicalname">Directive</a></h2>
<table class="directive">
<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
et son port</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>UseCanonicalName Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Dans de nombreuses situations, Apache doit construire une URL
<em>auto-identifiante</em> -- c'est � dire une URL qui fait
r�f�rence au serveur lui-m�me. Avec <code>UseCanonicalName
On</code>, Apache va utiliser le nom d'h�te et le port sp�cifi�s par
la directive <code class="directive"><a href="#servername">ServerName</a></code> pour
construire le nom canonique du serveur. Ce nom est utilis� dans
toutes les URLs auto-identifiantes, et affect� aux variables
<code>SERVER_NAME</code> et <code>SERVER_PORT</code> dans les
programmes CGI.</p>
<p>Avec <code>UseCanonicalName Off</code>, Apache va construire ses
URLs auto-identifiantes � l'aide du nom d'h�te et du port fournis
par le client, si ce dernier en a fourni un (dans la n�gative,
Apache utilisera le nom canonique, de la m�me mani�re que
ci-dessus). Ces valeurs sont les m�mes que celles qui sont utilis�es
pour impl�menter les <a href="/vhosts/name-based.html">serveurs virtuels � base de
nom</a>, et sont disponibles avec les m�mes clients. De m�me, les
variables CGI <code>SERVER_NAME</code> et <code>SERVER_PORT</code>
seront affect�es des valeurs fournies par le client.</p>
<p>Cette directive peut s'av�rer utile, par exemple, sur un serveur
intranet auquel les utilisateurs se connectent en utilisant des noms
courts tels que <code>www</code>. Si les utilisateurs tapent un nom
court suivi d'une URL qui fait r�f�rence � un r�pertoire, comme
<code>http://www/splat</code>, <em>sans le slash terminal</em>, vous
remarquerez qu'Apache va les rediriger vers
<code>http://www.domain.com/splat/</code>. Si vous avez activ�
l'authentification, ceci va obliger l'utilisateur � s'authentifier
deux fois (une premi�re fois pour <code>www</code> et une seconde
fois pour <code>www.domain.com</code> -- voir <a href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">la
foire aux questions sur ce sujet pour plus d'informations</a>). Par
contre, si <code class="directive">UseCanonicalName</code> est d�finie �
<code>Off</code>, Apache redirigera l'utilisateur vers
<code>http://www/splat/</code>.</p>
<p>Pour l'h�bergement virtuel en masse � base d'adresse IP, on
utilise une troisi�me option, <code>UseCanonicalName
DNS</code>, pour supporter les clients anciens qui ne
fournissent pas d'en-t�te <code>Host:</code>. Apache effectue alors
une recherche DNS inverse sur l'adresse IP du serveur auquel le
client s'est connect� afin de construire ses URLs
auto-identifiantes.</p>
<div class="warning"><h3>Avertissement</h3>
<p>Les programmes CGI risquent d'�tre perturb�s par cette option
s'ils tiennent compte de la variable <code>SERVER_NAME</code>. Le
client est pratiquement libre de fournir la valeur qu'il veut comme
nom d'h�te. Mais si le programme CGI n'utilise
<code>SERVER_NAME</code> que pour construire des URLs
auto-identifiantes, il ne devrait pas y avoir de probl�me.</p>
</div>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
<li><code class="directive"><a href="#servername">ServerName</a></code></li>
<li><code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a> <a name="usecanonicalphysicalport" id="usecanonicalphysicalport">Directive</a></h2>
<table class="directive">
<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
et son port</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Dans de nombreuses situations, Apache doit construire une URL
<em>auto-identifiante</em> -- c'est � dire une URL qui fait
r�f�rence au serveur lui-m�me. Avec <code>UseCanonicalPhysicalPort
On</code>, Apache va fournir le num�ro de port physique r�el utilis�
par la requ�te en tant que port potentiel, pour construire le port
canonique afin que le serveur puisse alimenter la directive
<code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>. Avec
<code>UseCanonicalPhysicalPort Off</code>, Apache n'utilisera pas le
num�ro de port physique r�el, mais au contraire se r�f�rera aux
informations de configuration pour construire un num�ro de port
valide.</p>
<div class="note"><h3>Note</h3>
<p>L'ordre dans lequel s'effectue la recherche du port est le
suivant :<br /><br />
<code>UseCanonicalName On</code></p>
<ul>
<li>Port sp�cifi� par <code>Servername</code></li>
<li>Port physique</li>
<li>Port par d�faut</li>
</ul>
<code>UseCanonicalName Off | DNS</code>
<ul>
<li>Port sp�cifi� dans l'en-t�te <code>Host:</code></li>
<li>Port physique</li>
<li>Port sp�cifi� par <code>Servername</code></li>
<li>Port par d�faut</li>
</ul>
<p>Avec <code>UseCanonicalPhysicalPort Off</code>, on reprend
l'ordre ci-dessus en supprimant "Port physique".</p>
</div>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
<li><code class="directive"><a href="#servername">ServerName</a></code></li>
<li><code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="VirtualHost" id="VirtualHost">&lt;VirtualHost&gt;</a> <a name="virtualhost" id="virtualhost">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent qu'� un nom
d'h�te sp�cifique ou � une adresse IP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;VirtualHost
<var>adresse IP</var>[:<var>port</var>] [<var>adresse
IP</var>[:<var>port</var>]] ...&gt; ...
&lt;/VirtualHost&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
<p>Les balises <code class="directive">&lt;VirtualHost&gt;</code> et
<code>&lt;/VirtualHost&gt;</code> permettent de rassembler un groupe
de directives qui ne s'appliquent qu'� un serveur virtuel
particulier. Toute directive autoris�e dans un contexte de serveur
virtuel peut �tre utilis�e. Lorsque le serveur re�oit un requ�te
pour un document h�berg� par un serveur virtuel particulier, il
applique les directives de configuration rassembl�es dans la section
<code class="directive">&lt;VirtualHost&gt;</code>. <var>adresse
IP</var> peut �tre :</p>
<ul>
<li>L'adresse IP du serveur virtuel ;</li>
<li>Un nom de domaine enti�rement qualifi� correspondant �
l'adresse IP du serveur virtuel (non recommand�) ;</li>
<li>Le caract�re <code>*</code>, qui n'est utilis� qu'en
combinaison avec <code>NameVirtualHost *</code> pour intercepter
toutes les adresses IP ; ou</li>
<li>La cha�ne de caract�res <code>_default_</code>, qui n'est
utilis�e qu'avec l'h�bergement virtuel � base d'adresse IP pour
intercepter les adresses IP qui ne correspondent � aucun serveur
virtuel.</li>
</ul>
<div class="example"><h3>Exemple</h3><p><code>
&lt;VirtualHost 10.1.2.3&gt;<br />
<span class="indent">
ServerAdmin webmaster@host.exemple.com<br />
DocumentRoot /www/docs/host.exemple.com<br />
ServerName host.exemple.com<br />
ErrorLog logs/host.exemple.com-error_log<br />
TransferLog logs/host.exemple.com-access_log<br />
</span>
&lt;/VirtualHost&gt;
</code></p></div>
<p>Les adresses IPv6 doivent �tre entour�es de crochets car dans le
cas contraire, un �ventuel port optionnel ne pourrait pas �tre
d�termin�. Voici un exemple de serveur virtuel avec adresse IPv6
:</p>
<div class="example"><p><code>
&lt;VirtualHost [2001:db8::a00:20ff:fea7:ccea]&gt;<br />
<span class="indent">
ServerAdmin webmaster@host.exemple.com<br />
DocumentRoot /www/docs/host.exemple.com<br />
ServerName host.exemple.com<br />
ErrorLog logs/host.exemple.com-error_log<br />
TransferLog logs/host.exemple.com-access_log<br />
</span>
&lt;/VirtualHost&gt;
</code></p></div>
<p>Chaque serveur virtuel doit correspondre � une adresse IP, un
port ou un nom d'h�te sp�cifique ; dans le premier cas, le serveur
doit �tre configur� pour recevoir les paquets IP de plusieurs
adresses (si le serveur n'a qu'une interface r�seau, on peut
utiliser � cet effet la commande <code>ifconfig alias</code> -- si
votre syst�me d'exploitation le permet).</p>
<div class="note"><h3>Note</h3>
<p>L'utilisation de la directive <code class="directive">&lt;VirtualHost&gt;</code> n'affecte en rien les
adresses IP sur lesquelles Apache est en �coute. Vous devez vous
assurer que les adresses des serveurs virtuels sont bien incluses
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>
</div>
<p>Avec l'h�bergement virtuel � base d'adresse IP, on peut utiliser
le nom sp�cial <code>_default_</code>, auquel cas le serveur virtuel
consid�r� interceptera toute adresse IP qui n'est pas explicitement
associ�e � un autre serveur virtuel. En l'absence de serveur virtuel
associ� � <code>_default_</code>, et si l'adresse IP demand�e ne
correspond � aucun serveur virtuel, c'est la configuration du
serveur "principal" qui sera utilis�e, c'est � dire l'ensemble des
d�finitions situ�es en dehors de toute section VirtualHost.</p>
<p>Vous pouvez sp�cifier <code>:port</code> pour modifier le port du
serveur virtuel. S'il n'est pas sp�cifi�, sa valeur par d�faut
correspond � celle qui est d�finie par la derni�re directive
<code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code> du serveur
principal. Vous pouvez aussi sp�cifier <code>:*</code> pour accepter
tous les ports associ�s � l'adresse du serveur virtuel (c'est une
configuration recommand�e lorsqu'on utilise
<code>_default_</code>).</p>
<p>Tout bloc <code class="directive">&lt;VirtualHost&gt;</code> doit comporter une directive
<code class="directive"><a href="#servername">ServerName</a></code>. Dans le cas
contraire, le serveur virtuel h�ritera de la valeur de la directive
<code class="directive"><a href="#servername">ServerName</a></code> issue de la
configuration du serveur principal.</p>
<div class="warning"><h3>S�curit�</h3>
<p>Voir le document sur les <a href="/misc/security_tips.html">conseils � propos de s�curit�</a>
pour une description d�taill�e des raisons pour lesquelles la
s�curit� de votre serveur pourrait �tre compromise, si le r�pertoire
contenant les fichiers journaux est inscriptible par tout autre
utilisateur que celui qui d�marre le serveur.</p>
</div>
<h3>Voir aussi</h3>
<ul>
<li><a href="/vhosts/">Documentation des serveurs virtuels
d'Apache</a></li>
<li><a href="/dns-caveats.html">Probl�mes concernant DNS et
Apache</a></li>
<li><a href="/bind.html">D�finition des adresses et ports
qu'utilise Apache</a></li>
<li><a href="/sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
explication de la mani�re dont ces diff�rentes sections se combinent
entre elles � la r�ception d'une requ�te</li>
</ul>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="/en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="/fr/mod/core.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
<a href="/ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/tr/mod/core.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div>
</body></html>