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

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>Fichiers de configuration - Serveur Apache HTTP Version 2.5</title>
   9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
  12 <script src="./style/scripts/prettify.min.js" type="text/javascript">
  13 </script>
  14
  15 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
  16 <body id="manual-page"><div id="page-header">
  17 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
  18 <p class="apache">Serveur Apache HTTP Version 2.5</p>
  19 <img alt="" src="./images/feather.gif" /></div>
  20 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  21 <div id="path">
  22 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Fichiers de configuration</h1>
  23 <div class="toplang">
  24 <p><span>Langues Disponibles: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
  25 <a href="./en/configuring.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  26 <a href="./fr/configuring.html" title="Français">&nbsp;fr&nbsp;</a> |
  27 <a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  28 <a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  29 <a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  30 </div>
  31
  32 <p>Ce document décrit les fichiers utilisés pour configurer
  33 le Serveur HTTP Apache.</p>
  34 </div>
  35 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#main">Fichiers de configuration principaux</a></li>
  36 <li><img alt="" src="./images/down.gif" /> <a href="#syntax">Syntaxe des fichiers de configuration</a></li>
  37 <li><img alt="" src="./images/down.gif" /> <a href="#modules">Modules</a></li>
  38 <li><img alt="" src="./images/down.gif" /> <a href="#scope">Portée des directives</a></li>
  39 <li><img alt="" src="./images/down.gif" /> <a href="#htaccess">Fichiers .htaccess</a></li>
  40 </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
  41 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  42 <div class="section">
  43 <h2><a name="main" id="main">Fichiers de configuration principaux</a></h2>
  44
  45     <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#include">Include</a></code></li><li><code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code></li></ul></td></tr></table>
  46
  47     <p>La configuration du serveur HTTP Apache est effectuée en plaçant des <a href="mod/directives.html">directives</a> dans des fichiers de
  48     configuration au format texte. Le fichier de configuration principal se nomme
  49     en général
  50     <code>httpd.conf</code>. La localisation de ce fichier est définie
  51     à la compilation, mais peut être redéfinie à l'aide de l'option
  52     de ligne de commande <code>-f</code>. En outre, d'autres fichiers de
  53     configuration peuvent être ajoutés à l'aide de la directive
  54     <code class="directive"><a href="./mod/core.html#include">Include</a></code>, et des caractères de
  55     remplacement
  56     peuvent être utilisés pour inclure de nombreux fichiers de configuration.
  57     Des directives de tous types peuvent être placées dans chacun de ces fichiers
  58     de configuration.  Les modifications dans les fichiers de configuration
  59     principaux ne sont prises en compte par httpd que lorsque le serveur
  60     est démarré ou redémarré.</p>
  61
  62     <p>Le serveur lit aussi un fichier contenant les types de document mime;
  63     ce fichier est défini par la directive <code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code>,
  64     et se nomme <code>mime.types</code> par défaut.</p>
  65   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  66 <div class="section">
  67 <h2><a name="syntax" id="syntax">Syntaxe des fichiers de configuration</a></h2>
  68
  69
  70     <p>Les fichiers de configuration de httpd contiennent une directive
  71     par ligne.
  72     On peut utiliser l'anti-slash "\" comme dernier caractère d'une ligne
  73     pour indiquer que la directive continue à la ligne suivante.
  74     Il ne doit y avoir aucun caractère ni espace entre l'anti-slash et
  75     la fin de la ligne.</p>
  76
  77     <p>Les arguments des directives sont séparés les uns des autres par
  78     des espaces. Si un argument contient des espaces, il doit être
  79     entouré de guillemets.</p>
  80
  81     <p>Les directives dans les fichiers de configuration ne sont pas
  82     sensibles à la casse, mais leurs arguments le sont souvent. Les lignes
  83     qui débutent par le caractère "#" sont interprétées comme des
  84     commentaires, et sont ignorées. Les commentaires ne doivent
  85     <strong>pas</strong> être inclus dans une ligne après une directive
  86     de configuration. Les lignes vides et les espaces précédant une directive
  87     sont ignorés; vous pouvez par conséquent indenter les directives
  88     afin d'améliorer la lisibilité.</p>
  89
  90     <p>Les valeurs des variables d'environnement ou des variables
  91     définies via la directive <code class="directive"><a href="./mod/core.html#define">Define</a></code> peuvent être utilisées dans le
  92     fichier de configuration en utilisant la syntaxe
  93     <code>${VAR}</code>. Si "VAR" est le nom d'une variable valide, la
  94     valeur de la variable est alors substituée à la chaîne
  95     <code>${VAR}</code>, et le processus de lecture du fichier de
  96     configuration continue comme si la chaîne correspondant à la valeur
  97     de la variable s'y était trouvée littéralement. Les variables définies
  98     via la directive <code class="directive"><a href="./mod/core.html#define">Define</a></code>
  99     l'emportent sur les autres variables d'environnement du shell. Si la
 100     variable "VAR" n'est pas trouvée, la chaîne <code>${VAR}</code>
 101     n'est pas modifiée, et un avertissement est enregistré dans le
 102     journal. Le caractère ":" est interdit dans les noms de variables
 103     afin d'éviter tout conflit avec la syntaxe de la directive <code class="directive"><a href="./mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p>
 104
 105     <p>Seules les variables d'environnement du shell définies avant le démarrage
 106     du serveur peuvent être utilisées dans les extensions.
 107     Les variables d'environnement
 108     définies dans le fichier de configuration lui-même, par exemple avec <code class="directive"><a href="./mod/mod_env.html#setenv">SetEnv</a></code>, prennent effet trop tard pour
 109     pouvoir être utilisées dans les extensions au sein du fichier de
 110     configuration.</p>
 111
 112     <p>La longueur maximale d'une ligne dans un fichier de configuration
 113     normal, après substitution des variables et fusion des lignes
 114     interrompues, est approximativement de 16 Mo. Dans les <a href="configuring.html#htaccess">fichiers .htaccess</a>, la longueur
 115     maximale est de 8190 caractères.</p>
 116
 117     <p>Vous pouvez vérifier l'absence d'erreurs de syntaxe dans vos fichiers
 118     de configuration sans démarrer le serveur à l'aide de la commande
 119     <code>apachectl configtest</code> ou de l'option de ligne de commande
 120     <code>-t</code>.</p>
 121
 122     <p>Vous pouvez utiliser la définition <code>-DDUMP_CONFIG</code> de
 123     <code class="module"><a href="./mod/mod_info.html">mod_info</a></code> pour afficher la configuration avec tous
 124     les fichiers inclus et les variables d'environnement évaluées, tous
 125     les commentaires et les sections <code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> et <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> non actives ayant
 126     été supprimés. Cependant, la sortie ne reflète
 127     pas les fusions ou écrasements pouvant intervenir en cas de
 128     définitions multiples de directives.</p>
 129   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 130 <div class="section">
 131 <h2><a name="modules" id="modules">Modules</a></h2>
 132
 133
 134     <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/mod_so.html">mod_so</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code></li><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
 135
 136     <p>httpd est un serveur modulaire. Ceci implique que seules les
 137     fonctionnalités les plus courantes sont incluses dans le serveur de base.
 138     Les fonctionnalités étendues sont fournies à l'aide de <a href="mod/">modules</a> qui peuvent être chargés dans httpd.
 139     Par défaut, un jeu de <a href="mod/module-dict.html#Status">modules de base</a> est inclus dans le
 140     serveur à la compilation. Si le serveur est compilé de façon à utiliser
 141     les <a href="dso.html">modules chargés dynamiquement</a>,
 142     alors les modules peuvent être compilés séparément et chargés à
 143     n'importe quel moment à l'aide de la directive
 144     <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>.
 145     Dans le cas contraire, httpd doit être recompilé pour ajouter ou
 146     supprimer des modules.
 147     Les directives de configuration peuvent être incluses de manière
 148     conditionnelle selon la présence ou l'absence d'un module particulier
 149     en les plaçant dans un bloc <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>.</p>
 150
 151     <p>Pour voir quels modules ont été compilés avec le serveur,
 152     vous pouvez utiliser l'option de ligne de commande <code>-l</code>.</p>
 153   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 154 <div class="section">
 155 <h2><a name="scope" id="scope">Portée des directives</a></h2>
 156
 157
 158     <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code></li></ul></td></tr></table>
 159
 160     <p>Les directives placées dans les fichiers de configuration principaux
 161     s'appliquent au serveur dans son ensemble. Si vous souhaitez modifier la
 162     configuration d'une partie du serveur seulement, vous pouvez limiter la
 163     portée de vos directives en les plaçant dans une section
 164     <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>, <code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>, <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code>, <code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>, <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>, ou <code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code>.
 165     Ces sections limitent le champ d'application des directives qu'elles
 166     contiennent à des URls ou des portions du système de fichiers particulières.
 167     Elles peuvent aussi être imbriquées, ce qui permet
 168     une configuration très fine.</p>
 169
 170     <p>httpd peut servir simultanément de nombreux sites web au travers des
 171     <a href="vhosts/">Hôtes Virtuels</a>. La portée des directives peut ainsi
 172     être limitée en les plaçant dans des sections
 173     <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>,
 174     afin qu'elles ne s'appliquent qu'aux requêtes
 175     pour un site web particulier.</p>
 176
 177     <p>Bien que la plupart des directives puissent être placées dans
 178     chacune de ces sections, certaines d'entre elles n'ont aucun sens
 179     dans certains contextes.
 180     Par exemple, les directives qui contrôlent la création des processus
 181     n'ont de sens que dans le contexte du serveur principal. Pour déterminer
 182     quelles directives peuvent être placées dans quelles sections, consultez
 183     le <a href="mod/directive-dict.html#Context">Contexte</a> de la
 184     directive. Pour plus d'informations, nous fournissons des détails dans
 185     <a href="sections.html">Comment fonctionnent les sections Directory,
 186     Location et Files</a>.</p>
 187   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 188 <div class="section">
 189 <h2><a name="htaccess" id="htaccess">Fichiers .htaccess</a></h2>
 190
 191
 192     <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td /><td><ul><li><code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code></li></ul></td></tr></table>
 193
 194     <p>httpd permet la gestion décentralisée de la configuration
 195     via des fichiers spéciaux placés dans l'arborescence du site web.
 196     Ces fichiers spéciaux se nomment en général <code>.htaccess</code>,
 197     mais tout autre nom peut être spécifié à l'aide de la directive
 198     <code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code>.
 199     Les directives placées dans les fichiers <code>.htaccess</code>
 200     s'appliquent au répertoire dans lequel vous avez placé le fichier,
 201     ainsi qu'à tous ses sous-répertoires.
 202     La syntaxe des fichiers <code>.htaccess</code> est la même que celle
 203     des fichiers de configuration principaux. Comme les fichiers
 204     <code>.htaccess</code> sont lus à chaque requête, les modifications de
 205     ces fichiers prennent effet immédiatement.</p>
 206
 207     <p>Pour déterminer quelles directives peuvent être placées
 208     dans les fichiers <code>.htaccess</code>, consultez le
 209     <a href="mod/directive-dict.html#Context">Contexte</a> de la
 210     directive. L'administrateur du serveur peut contrôler quelles
 211     directives peuvent être placées dans les fichiers
 212     <code>.htaccess</code> en définissant la directive
 213     <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
 214     dans les fichiers de configuration principaux.</p>
 215
 216     <p>Pour plus d'informations sur les fichiers <code>.htaccess</code>,
 217     se référer au <a href="howto/htaccess.html">tutoriel .htaccess</a>.</p>
 218   </div></div>
 219 <div class="bottomlang">
 220 <p><span>Langues Disponibles: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
 221 <a href="./en/configuring.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 222 <a href="./fr/configuring.html" title="Français">&nbsp;fr&nbsp;</a> |
 223 <a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 224 <a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 225 <a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 226 </div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
 227 <script type="text/javascript"><!--//--><![CDATA[//><!--
 228 var comments_shortname = 'httpd';
 229 var comments_identifier = 'http://httpd.apache.org/docs/trunk/configuring.html';
 230 (function(w, d) {
 231     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 232         d.write('<div id="comments_thread"><\/div>');
 233         var s = d.createElement('script');
 234         s.type = 'text/javascript';
 235         s.async = true;
 236         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 237         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 238     }
 239     else {
 240         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 241     }
 242 })(window, document);
 243 //--><!]]></script></div><div id="footer">
 244 <p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 245 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 246 if (typeof(prettyPrint) !== 'undefined') {
 247     prettyPrint();
 248 }
 249 //--><!]]></script>
 250 </body></html>