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