mirror of
https://github.com/apache/httpd.git
synced 2025-08-06 11:06:17 +00:00
12745a93ae
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1836023 13f79535-47bb-0310-9956-ffa450edef68
253 lines
20 KiB
Plaintext
253 lines
20 KiB
Plaintext
<?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>
|
|
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
|
|
<!--
|
|
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
|
This file is generated from xml source: DO NOT EDIT
|
|
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
|
-->
|
|
<title>Fichiers de configuration - Serveur HTTP Apache Version 2.5</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
|
|
<script src="./style/scripts/prettify.min.js" type="text/javascript">
|
|
</script>
|
|
|
|
<link href="./images/favicon.ico" rel="shortcut icon" /></head>
|
|
<body id="manual-page"><div id="page-header">
|
|
<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>
|
|
<p class="apache">Serveur HTTP Apache Version 2.5</p>
|
|
<img alt="" src="./images/feather.png" /></div>
|
|
<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
|
|
<div id="path">
|
|
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Fichiers de configuration</h1>
|
|
<div class="toplang">
|
|
<p><span>Langues Disponibles: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
|
|
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
|
<a href="./fr/configuring.html" title="Français"> fr </a> |
|
|
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
|
|
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
|
|
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
|
|
</div>
|
|
|
|
<p>Ce document décrit les fichiers utilisés pour configurer
|
|
le Serveur HTTP Apache.</p>
|
|
</div>
|
|
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#main">Fichiers de configuration principaux</a></li>
|
|
<li><img alt="" src="./images/down.gif" /> <a href="#syntax">Syntaxe des fichiers de configuration</a></li>
|
|
<li><img alt="" src="./images/down.gif" /> <a href="#modules">Modules</a></li>
|
|
<li><img alt="" src="./images/down.gif" /> <a href="#scope">Portée des directives</a></li>
|
|
<li><img alt="" src="./images/down.gif" /> <a href="#htaccess">Fichiers .htaccess</a></li>
|
|
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
|
|
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
|
|
<div class="section">
|
|
<h2><a name="main" id="main">Fichiers de configuration principaux</a><a title="Lien permanent" href="#main" class="permalink">¶</a></h2>
|
|
|
|
<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"><IfDefine></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>
|
|
|
|
<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
|
|
configuration au format texte. Le fichier de configuration principal se nomme
|
|
en général
|
|
<code>httpd.conf</code>. La localisation de ce fichier est définie
|
|
à la compilation, mais peut être redéfinie à l'aide de l'option
|
|
de ligne de commande <code>-f</code>. En outre, d'autres fichiers de
|
|
configuration peuvent être ajoutés à l'aide de la directive
|
|
<code class="directive"><a href="./mod/core.html#include">Include</a></code>, et des caractères de
|
|
remplacement
|
|
peuvent être utilisés pour inclure de nombreux fichiers de configuration.
|
|
Des directives de tous types peuvent être placées dans chacun de ces fichiers
|
|
de configuration. Les modifications dans les fichiers de configuration
|
|
principaux ne sont prises en compte par httpd que lorsque le serveur
|
|
est démarré ou redémarré.</p>
|
|
|
|
<p>Le serveur lit aussi un fichier contenant les types de document mime;
|
|
ce fichier est défini par la directive <code class="directive"><a href="./mod/mod_mime.html#typesconfig">TypesConfig</a></code>,
|
|
et se nomme <code>mime.types</code> par défaut.</p>
|
|
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
|
|
<div class="section">
|
|
<h2><a name="syntax" id="syntax">Syntaxe des fichiers de configuration</a><a title="Lien permanent" href="#syntax" class="permalink">¶</a></h2>
|
|
|
|
|
|
<p>Les fichiers de configuration de httpd contiennent une directive
|
|
par ligne.
|
|
On peut utiliser l'anti-slash "\" comme dernier caractère d'une ligne
|
|
pour indiquer que la directive continue à la ligne suivante.
|
|
Il ne doit y avoir aucun caractère ni espace entre l'anti-slash et
|
|
la fin de la ligne.</p>
|
|
|
|
<p>Les arguments des directives sont séparés les uns des autres par
|
|
des espaces. Si un argument contient des espaces, il doit être
|
|
entouré de guillemets.</p>
|
|
|
|
<p>Les directives dans les fichiers de configuration ne sont pas
|
|
sensibles à la casse, mais leurs arguments le sont souvent. Les lignes
|
|
qui débutent par le caractère "#" sont interprétées comme des
|
|
commentaires, et sont ignorées. Les commentaires ne doivent
|
|
<strong>pas</strong> apparaître sur la même ligne qu'une directive
|
|
de configuration. Les espaces précédant une directive
|
|
sont ignorés; vous pouvez par conséquent indenter les directives
|
|
afin d'améliorer la lisibilité. Les lignes vides sont
|
|
aussi ignorées.</p>
|
|
|
|
<p>Les valeurs des variables d'environnement ou des variables
|
|
définies via la directive <code class="directive"><a href="./mod/core.html#define">Define</a></code> peuvent être utilisées dans le
|
|
fichier de configuration en utilisant la syntaxe
|
|
<code>${VAR}</code>. Si "VAR" est le nom d'une variable valide, la
|
|
valeur de la variable est alors substituée à la chaîne
|
|
<code>${VAR}</code>, et le processus de lecture du fichier de
|
|
configuration continue comme si la chaîne correspondant à la valeur
|
|
de la variable s'y était trouvée littéralement. Les variables définies
|
|
via la directive <code class="directive"><a href="./mod/core.html#define">Define</a></code>
|
|
l'emportent sur les autres variables d'environnement du shell. Si la
|
|
variable "VAR" n'est pas trouvée, la chaîne <code>${VAR}</code>
|
|
n'est pas modifiée, et un avertissement est enregistré dans le
|
|
journal. Le caractère ":" est interdit dans les noms de variables
|
|
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>
|
|
|
|
<p>Seules les variables d'environnement du shell définies avant le démarrage
|
|
du serveur peuvent être utilisées dans les extensions.
|
|
Les variables d'environnement
|
|
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
|
|
pouvoir être utilisées dans les extensions au sein du fichier de
|
|
configuration.</p>
|
|
|
|
<p>La longueur maximale d'une ligne dans un fichier de configuration
|
|
normal, après substitution des variables et fusion des lignes
|
|
interrompues, est approximativement de 16 Mo. Dans les <a href="configuring.html#htaccess">fichiers .htaccess</a>, la longueur
|
|
maximale est de 8190 caractères.</p>
|
|
|
|
<p>Vous pouvez vérifier l'absence d'erreurs de syntaxe dans vos fichiers
|
|
de configuration sans démarrer le serveur à l'aide de la commande
|
|
<code>apachectl configtest</code> ou de l'option de ligne de commande
|
|
<code>-t</code>.</p>
|
|
|
|
<p>Vous pouvez utiliser la définition <code>-DDUMP_CONFIG</code> de
|
|
<code class="module"><a href="./mod/mod_info.html">mod_info</a></code> pour afficher la configuration avec tous
|
|
les fichiers inclus et les variables d'environnement évaluées, tous
|
|
les commentaires et les sections <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> et <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code> non actives ayant
|
|
été supprimés. Cependant, la sortie ne reflète
|
|
pas les fusions ou écrasements pouvant intervenir en cas de
|
|
définitions multiples de directives.</p>
|
|
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
|
|
<div class="section">
|
|
<h2><a name="modules" id="modules">Modules</a><a title="Lien permanent" href="#modules" class="permalink">¶</a></h2>
|
|
|
|
|
|
<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"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code></li></ul></td></tr></table>
|
|
|
|
<p>httpd est un serveur modulaire. Ceci implique que seules les
|
|
fonctionnalités les plus courantes sont incluses dans le serveur de base.
|
|
Les fonctionnalités étendues sont fournies à l'aide de <a href="mod/">modules</a> qui peuvent être chargés dans httpd.
|
|
Par défaut, un jeu de <a href="mod/module-dict.html#Status">modules de base</a> est inclus dans le
|
|
serveur à la compilation. Si le serveur est compilé de façon à utiliser
|
|
les <a href="dso.html">modules chargés dynamiquement</a>,
|
|
alors les modules peuvent être compilés séparément et chargés à
|
|
n'importe quel moment à l'aide de la directive
|
|
<code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code>.
|
|
Dans le cas contraire, httpd doit être recompilé pour ajouter ou
|
|
supprimer des modules.
|
|
Les directives de configuration peuvent être incluses de manière
|
|
conditionnelle selon la présence ou l'absence d'un module particulier
|
|
en les plaçant dans un bloc <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>.</p>
|
|
|
|
<p>Pour voir quels modules ont été compilés avec le serveur,
|
|
vous pouvez utiliser l'option de ligne de commande <code>-l</code>.</p>
|
|
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
|
|
<div class="section">
|
|
<h2><a name="scope" id="scope">Portée des directives</a><a title="Lien permanent" href="#scope" class="permalink">¶</a></h2>
|
|
|
|
|
|
<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"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
|
|
|
|
<p>Les directives placées dans les fichiers de configuration principaux
|
|
s'appliquent au serveur dans son ensemble. Si vous souhaitez modifier la
|
|
configuration d'une partie du serveur seulement, vous pouvez limiter la
|
|
portée de vos directives en les plaçant dans une section
|
|
<code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#files"><Files></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code>, ou <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>.
|
|
Ces sections limitent le champ d'application des directives qu'elles
|
|
contiennent à des URls ou des portions du système de fichiers particulières.
|
|
Elles peuvent aussi être imbriquées, ce qui permet
|
|
une configuration très fine.</p>
|
|
|
|
<p>httpd peut servir simultanément de nombreux sites web au travers des
|
|
<a href="vhosts/">Hôtes Virtuels</a>. La portée des directives peut ainsi
|
|
être limitée en les plaçant dans des sections
|
|
<code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>,
|
|
afin qu'elles ne s'appliquent qu'aux requêtes
|
|
pour un site web particulier.</p>
|
|
|
|
<p>Bien que la plupart des directives puissent être placées dans
|
|
chacune de ces sections, certaines d'entre elles n'ont aucun sens
|
|
dans certains contextes.
|
|
Par exemple, les directives qui contrôlent la création des processus
|
|
n'ont de sens que dans le contexte du serveur principal. Pour déterminer
|
|
quelles directives peuvent être placées dans quelles sections, consultez
|
|
le <a href="mod/directive-dict.html#Context">Contexte</a> de la
|
|
directive. Pour plus d'informations, nous fournissons des détails dans
|
|
<a href="sections.html">Comment fonctionnent les sections Directory,
|
|
Location et Files</a>.</p>
|
|
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
|
|
<div class="section">
|
|
<h2><a name="htaccess" id="htaccess">Fichiers .htaccess</a><a title="Lien permanent" href="#htaccess" class="permalink">¶</a></h2>
|
|
|
|
|
|
<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>
|
|
|
|
<p>httpd permet la gestion décentralisée de la configuration
|
|
via des fichiers spéciaux placés dans l'arborescence du site web.
|
|
Ces fichiers spéciaux se nomment en général <code>.htaccess</code>,
|
|
mais tout autre nom peut être spécifié à l'aide de la directive
|
|
<code class="directive"><a href="./mod/core.html#accessfilename">AccessFileName</a></code>.
|
|
Les directives placées dans les fichiers <code>.htaccess</code>
|
|
s'appliquent au répertoire dans lequel vous avez placé le fichier,
|
|
ainsi qu'à tous ses sous-répertoires.
|
|
La syntaxe des fichiers <code>.htaccess</code> est la même que celle
|
|
des fichiers de configuration principaux. Comme les fichiers
|
|
<code>.htaccess</code> sont lus à chaque requête, les modifications de
|
|
ces fichiers prennent effet immédiatement.</p>
|
|
|
|
<p>Pour déterminer quelles directives peuvent être placées
|
|
dans les fichiers <code>.htaccess</code>, consultez le
|
|
<a href="mod/directive-dict.html#Context">Contexte</a> de la
|
|
directive. L'administrateur du serveur peut contrôler quelles
|
|
directives peuvent être placées dans les fichiers
|
|
<code>.htaccess</code> en définissant la directive
|
|
<code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
|
|
dans les fichiers de configuration principaux.</p>
|
|
|
|
<p>Pour plus d'informations sur les fichiers <code>.htaccess</code>,
|
|
se référer au <a href="howto/htaccess.html">tutoriel .htaccess</a>.</p>
|
|
</div></div>
|
|
<div class="bottomlang">
|
|
<p><span>Langues Disponibles: </span><a href="./de/configuring.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
|
|
<a href="./en/configuring.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
|
<a href="./fr/configuring.html" title="Français"> fr </a> |
|
|
<a href="./ja/configuring.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
|
|
<a href="./ko/configuring.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
|
|
<a href="./tr/configuring.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
|
|
</div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
|
|
<script type="text/javascript"><!--//--><![CDATA[//><!--
|
|
var comments_shortname = 'httpd';
|
|
var comments_identifier = 'http://httpd.apache.org/docs/trunk/configuring.html';
|
|
(function(w, d) {
|
|
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
|
|
d.write('<div id="comments_thread"><\/div>');
|
|
var s = d.createElement('script');
|
|
s.type = 'text/javascript';
|
|
s.async = true;
|
|
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
|
|
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
|
|
}
|
|
else {
|
|
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
|
|
}
|
|
})(window, document);
|
|
//--><!]]></script></div><div id="footer">
|
|
<p class="apache">Copyright 2018 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/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[//><!--
|
|
if (typeof(prettyPrint) !== 'undefined') {
|
|
prettyPrint();
|
|
}
|
|
//--><!]]></script>
|
|
</body></html> |