]> granicus.if.org Git - apache/commitdiff
New htaccess howto translation
authorVincent Deffontaines <gryzor@apache.org>
Sun, 1 Feb 2009 17:17:52 +0000 (17:17 +0000)
committerVincent Deffontaines <gryzor@apache.org>
Sun, 1 Feb 2009 17:17:52 +0000 (17:17 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@739795 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/howto/auth.html.en
docs/manual/howto/htaccess.html
docs/manual/howto/htaccess.html.en
docs/manual/howto/htaccess.html.fr [new file with mode: 0644]
docs/manual/howto/htaccess.xml.fr [new file with mode: 0644]
docs/manual/howto/htaccess.xml.meta

index ad8247ab6423bad0dc9154175e04638170507765..eff3e46c54585ebda900d2a537acec188a6fcbeb 100644 (file)
@@ -19,6 +19,7 @@
 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Authentication, Authorization and Access Control</h1>
 <div class="toplang">
 <p><span>Available Languages: </span><a href="../en/howto/auth.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 </div>
@@ -602,6 +603,7 @@ person in</a></h2>
 </div></div>
 <div class="bottomlang">
 <p><span>Available Languages: </span><a href="../en/howto/auth.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/howto/auth.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/howto/auth.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/howto/auth.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 </div><div id="footer">
index fd70b65106300df3b28be4ded4c373500f8c9ca9..afb2b04fe2a6820abee22610fdea7233364ebf71 100644 (file)
@@ -4,6 +4,10 @@ URI: htaccess.html.en
 Content-Language: en
 Content-type: text/html; charset=ISO-8859-1
 
+URI: htaccess.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
 URI: htaccess.html.ja.utf8
 Content-Language: ja
 Content-type: text/html; charset=UTF-8
index c024cb863dac9fd80806dfc9d3db55ad590e6d25..be2dc8f6d9b4ebb15b39067b52fb8a4ff21903d7 100644 (file)
@@ -19,6 +19,7 @@
 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">How-To / Tutorials</a></div><div id="page-content"><div id="preamble"><h1>Apache Tutorial: .htaccess files</h1>
 <div class="toplang">
 <p><span>Available Languages: </span><a href="../en/howto/htaccess.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 <a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p>
@@ -396,6 +397,7 @@ Options +IncludesNoExec -ExecCGI<br />
 </div></div>
 <div class="bottomlang">
 <p><span>Available Languages: </span><a href="../en/howto/htaccess.html" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 <a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p>
diff --git a/docs/manual/howto/htaccess.html.fr b/docs/manual/howto/htaccess.html.fr
new file mode 100644 (file)
index 0000000..58a304f
--- /dev/null
@@ -0,0 +1,450 @@
+<?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>Tutoriel Apache : fichiers .htaccess - 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 id="manual-page"><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="./">Recettes / Tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Tutoriel Apache : fichiers .htaccess</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/howto/htaccess.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p>
+</div>
+
+<p>Les fichiers <code>.htaccess</code> fournissent une méthode pour
+modifier la configuration du serveur au niveau de chaque répertoire.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Fichiers .htaccess</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#what">Que sont ce fichiers, comment les utiliser ?</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#when">Quand doit-on (ne doit-on pas) utiliser
+    les fichiers .htaccess ?</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#how">Comment sont appliquées les directives ?</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#auth">Exemple d'authentification</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#ssi">Exemple d'Inclusion Côté Serveur (Server Side
+Includes - SSI)</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#cgi">Exemple de CGI</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">Résolution des problèmes</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="related" id="related">Fichiers .htaccess</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/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li><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#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li></ul></td></tr></table>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="what" id="what">Que sont ce fichiers, comment les utiliser ?</a></h2>
+
+
+    <p>Les fichiers <code>.htaccess</code> (ou "fichiers de
+    configuration distribués") fournissent une méthode pour modifier la
+    configuration du serveur au niveau d'un répertoire. Un fichier,
+    contenant une ou plusieurs directives de configuration, est placé
+    dans un répertoire de documents particulier, et ses directives
+    s'appliquent à ce répertoire et à tous ses sous-répertoires.</p>
+
+    <div class="note"><h3>Note :</h3>
+      <p>Si vous voulez donner un autre nom à votre fichier
+      <code>.htaccess</code>, vous pouvez le faire en utilisant la
+      directive <code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code>. Par
+      exemple, si vous préférez nommer votre fichier
+      <code>.config</code>, vous pouvez mettre ceci dans le fichier de
+      configuration de votre serveur :</p>
+
+      <div class="example"><p><code>
+        AccessFileName .config
+      </code></p></div>
+    </div>
+
+    <p>En général, les fichiers <code>.htaccess</code> utilisent la même
+    syntaxe que les <a href="../configuring.html#syntax">fichiers de
+    configuration principaux</a>. Ce que vous pouvez mettre dans ces
+    fichier est déterminé par la directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>. Cette directive spécifie,
+    sous forme de catégories, quelles directives seront traitées si
+    elles se trouvent dans un fichier <code>.htaccess</code>. Si une
+    directive est permise dans un fichier <code>.htaccess</code> file,
+    la documentation de cette directive contiendra une section Override,
+    spécifiant quelle valeur doit prendre <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> pour que cette directive
+    soit traitée.</p>
+
+    <p>Par exemple, si vous regardez la documentation de la directive
+    <code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>, vous verrez
+    que cette dernière est permise dans les fichiers
+    <code>.htaccess</code> (Voir la ligne de contexte dans le résumé de
+    la directive). La ligne <a href="../mod/directive-dict.html#Context">Override</a> indique
+    <code>FileInfo</code>. Vous devez donc avoir au moins
+    <code>AllowOverride FileInfo</code> pour que cette directive soit
+    traitée dans les fichiers <code>.htaccess</code>.</p>
+
+    <div class="example"><h3>Exemple :</h3><table>
+        <tr>
+          <td><a href="../mod/directive-dict.html#Context">Contexte :</a></td>
+          <td>configuration du serveur, serveur virtuel, directory, .htaccess</td>
+        </tr>
+
+        <tr>
+          <td><a href="../mod/directive-dict.html#Override">Override:</a></td>
+          <td>FileInfo</td>
+        </tr>
+      </table></div>
+
+    <p>Si vous n'êtes pas sûr qu'une directive particulière soit permise
+    dans un fichier <code>.htaccess</code>, lisez la documentation de
+    cette directive, et consultez la ligne de contexte pour
+    ".htaccess".</p>
+    </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="when" id="when">Quand doit-on (ne doit-on pas) utiliser
+    les fichiers .htaccess ?</a></h2>
+
+    <p>En principe, vous ne devriez utiliser les fichiers
+    <code>.htaccess</code> que si vous n'avez pas accès au fichier de
+    configuration du serveur principal. Par exemple, la fausse idée
+    selon laquelle l'authentification de l'utilisateur devrait toujours
+    être faite dans les fichiers <code>.htaccess</code> est très
+    répandue. Ceci est tout simplement faux. Vous pouvez configurer
+    l'authentification des utilisateurs au niveau de la configuration du
+    serveur principal, et c'est en fait cette méthode qui doit être
+    privilégiée.</p>
+
+    <p>Les fichiers <code>.htaccess</code> ne devraient être utilisés
+    que dans le cas où les fournisseurs de contenu ont besoin de
+    modifier la configuration du serveur au niveau d'un répertoire, mais
+    ne possèdent pas l'accès root sur le système du serveur. Si
+    l'administrateur du serveur ne souhaite pas effectuer des
+    modifications de configuration incessantes, il peut être intéressant
+    de permettre aux utilisateurs isolés d'effectuer eux-mêmes ces
+    modifications par le biais de fichiers <code>.htaccess</code>. Ceci
+    est particulièrement vrai dans le cas où le fournisseur d'accès à
+    Internet héberge de nombreux sites d'utilisateurs sur un seul
+    serveur, et souhaite que ces utilisateurs puissent modifier
+    eux-mêmes leurs configurations.</p>
+
+    <p>Cependant et d'une manière générale, il vaut mieux éviter
+    d'utiliser les fichiers <code>.htaccess</code>. Tout élément de
+    configuration que vous pourriez vouloir mettre dans un fichier
+    <code>.htaccess</code>, peut aussi être mis, et avec la même
+    efficacité, dans une section <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> du fichier de configuration de
+    votre serveur principal.</p>
+
+    <p>Il y a deux raisons principales d'éviter l'utilisation des
+    fichiers <code>.htaccess</code>.</p>
+
+    <p>La première est liée aux performances. Lorsque la directive
+    <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> est définie de
+    façon à autoriser l'utilisation des fichiers <code>.htaccess</code>,
+    Apache va rechercher leur présence dans chaque répertoire. Ainsi,
+    permettre l'utilisation des fichiers <code>.htaccess</code> est déjà
+    en soi une cause de dégradation des performances, que vous utilisiez
+    effectivement ces fichiers ou non ! De plus, le fichier
+    <code>.htaccess</code> est chargé en mémoire chaque fois qu'un
+    document fait l'objet d'une requête.</p>
+
+    <p>Notez aussi qu'Apache doit rechercher les fichiers
+    <code>.htaccess</code> dans tous les répertoires de niveau
+    supérieur, afin de rassembler toutes les directives qui s'appliquent
+    au répertoire courant (Voir la section <a href="#how">comment sont
+    appliquées les directives</a>). Ainsi, si un fichier fait l'objet
+    d'une requête à partir d'un répertoire
+    <code>/www/htdocs/exemple</code>, Apache doit rechercher les
+    fichiers suivants :</p>
+
+    <div class="example"><p><code>
+      /.htaccess<br />
+      /www/.htaccess<br />
+      /www/htdocs/.htaccess<br />
+      /www/htdocs/exemple/.htaccess
+    </code></p></div>
+
+    <p>En conséquence, chaque accès à un fichier de ce répertoire
+    nécessite 4 accès au système de fichiers supplémentaires pour
+    rechercher des fichiers <code>.htaccess</code>, même si
+    aucun de ces fichiers n'est présent. Notez que cet exemple ne peut
+    se produire que si les fichiers <code>.htaccess</code> ont été
+    autorisés pour le répertoire <code>/</code>, ce qui est rarement le
+    cas.</p>
+
+    <p>La seconde raison d'éviter l'utilisation des fichiers
+    <code>.htaccess</code> est liée à la sécurité. Si vous permettez aux
+    utilisateurs de modifier la configuration du serveur, il peut en
+    résulter des conséquences sur lesquelles vous n'aurez aucun
+    contrôle. Réfléchissez bien avant de donner ce privilège à vos
+    utilisateurs. Notez aussi que ne pas donner aux utilisateurs les
+    privilèges dont ils ont besoin va entraîner une augmentation des
+    demandes de support technique. Assurez-vous d'avoir informé
+    clairement vos utilisateurs du niveau de privilèges que vous leur
+    avez attribué. Indiquer exactement comment vous avez défini la
+    directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> et
+    diriger les utilisateurs vers la documentation correspondante vous
+    évitera bien des confusions ultérieures.</p>
+
+    <p>Notez que mettre un fichier <code>.htaccess</code> contenant une
+    directive dans un répertoire <code>/www/htdocs/exemple</code>
+    revient exactement au même que mettre la même directive dans une
+    section Directory <code>&lt;Directory /www/htdocs/exemple&gt;</code>
+    du fichier de configuration de votre serveur principal :</p>
+
+    <p>Fichier <code>.htaccess</code> dans
+    <code>/www/htdocs/exemple</code> :</p>
+
+    <div class="example"><h3>Contenu du fichier .htaccess dans
+    <code>/www/htdocs/exemple</code></h3><p><code>
+       AddType text/exemple .exm
+    </code></p></div>
+
+    <div class="example"><h3>Section de votre fichier
+    <code>httpd.conf</code></h3><p><code>
+      &lt;Directory /www/htdocs/exemple&gt;<br />
+      <span class="indent">
+        AddType text/exemple .exm<br />
+      </span>
+      &lt;/Directory&gt;
+    </code></p></div>
+
+    <p>Cependant, la perte de performances sera moindre si vous
+    définissez cette directive dans la configuration de
+    votre serveur principal, car cette dernière ne sera chargée qu'une
+    seule fois au moment du démarrage du serveur, alors qu'elle le sera
+    à chaque accès dans le cas d'un fichier <code>.htaccess</code>.</p>
+
+    <p>L'utilisation des fichiers <code>.htaccess</code> peut être
+    entièrement désactivée en définissant la directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> à <code>none</code> :</p>
+
+    <div class="example"><p><code>
+      AllowOverride None
+    </code></p></div>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="how" id="how">Comment sont appliquées les directives ?</a></h2>
+
+    <p>Les directives de configuration situées dans un fichier
+    <code>.htaccess</code> s'appliquent au répertoire dans lequel ce
+    fichier <code>.htaccess</code> se trouve, ainsi qu'à tous ses
+    sous-répertoires. Cependant, il est important de garder à l'esprit
+    qu'il peut y avoir des fichiers <code>.htaccess</code> dans les
+    répertoires de niveau supérieur. Les directives sont appliquées
+    selon l'ordre dans lequel elles sont rencontrées. Ainsi, les
+    directives d'un fichier <code>.htaccess</code> situé dans un
+    répertoire particulier peuvent écraser les directives se trouvant
+    dans des fichiers <code>.htaccess</code> situés à un niveau
+    supérieur dans l'arborescence des répertoires. Et ces dernières
+    peuvent elles-mêmes avoir écrasé des directives d'un fichier
+    <code>.htaccess</code> situé à un niveau encore plus haut, ou dans
+    le fichier de configuration du serveur principal.</p>
+
+    <p>Exemple :</p>
+
+    <p>Dans le répertoire <code>/www/htdocs/exemple1</code> se trouve un
+    fichier <code>.htaccess</code> contenant ce qui suit :</p>
+
+    <div class="example"><p><code>
+       Options +ExecCGI
+    </code></p></div>
+
+    <p>Note : "<code>AllowOverride Options</code>" doit être présent
+    pour permettre l'utilisation de la directive "<code class="directive"><a href="../mod/core.html#options">Options</a></code>"  dans les fichiers
+    <code>.htaccess</code>.</p>
+
+    <p>Dans le répertoire <code>/www/htdocs/exemple1/exemple2</code> se
+    trouve un fichier <code>.htaccess</code> contenant ce qui suit
+    :</p>
+
+    <div class="example"><p><code>
+       Options Includes
+    </code></p></div>
+
+    <p>Ainsi, à cause de ce second fichier <code>.htaccess</code> du
+    répertoire <code>/www/htdocs/exemple1/exemple2</code>, l'exécution
+    des CGI est interdite, car la dernière définition d'options
+    <code>Options Includes</code> écrase toute autre définition
+    d'options d'un fichier <code>.htaccess</code> situé dans un
+    répertoire de niveau supérieur.</p>
+
+    <h3><a name="merge" id="merge">Interactions entre les fichiers .htaccess
+    et les fichiers de configuration du serveur principal</a></h3>
+
+    <p>Comme indiqué dans la documentation sur les <a href="../sections.html">Sections de configuration</a>, les fichiers
+    <code>.htaccess</code> peuvent écraser les directives des sections
+    <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> pour
+    le répertoire correspondant, mais peuvent eux-mêmes être écrasés
+    par d'autres types de sections des fichiers de la
+    configuration principale. Cette possibilité peut s'avérer utile pour
+    forcer certaines configurations, même en cas de présence de l'option
+    libérale <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>. Par
+    exemple, pour interdire l'exécution de scripts en autorisant la
+    définition de toute autre option dans les fichiers
+    <code>.htaccess</code>, vous pouvez utiliser :</p>
+
+    <div class="example"><p><code>
+&lt;Directory /&gt;<br />
+<span class="indent">
+Allowoverride All<br />
+</span>
+&lt;/Directory&gt;<br />
+<br />
+&lt;Location /&gt;<br />
+<span class="indent">
+Options +IncludesNoExec -ExecCGI<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="section">
+<h2><a name="auth" id="auth">Exemple d'authentification</a></h2>
+
+    <p>Si vous accédez directement à ce point du document pour apprendre
+    à effectuer une authentification, il est important de noter ceci. Il
+    existe une fausse idée selon laquelle il serait nécessaire
+    d'utiliser les fichiers <code>.htaccess</code> pour implémenter
+    l'authentification par mot de passe. Ceci est tout simplement faux.
+    Pour y parvenir, il est préférable de mettre les directives
+    d'authentification dans une section <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> du fichier de configuration de
+    votre serveur principal, et les fichiers <code>.htaccess</code> ne
+    devraient être utilisés que dans le cas où vous n'avez pas accès au
+    fichier de configuration du serveur principal. Voir <a href="#when">ci-dessus</a> pour savoir dans quels cas vous devez ou
+    ne devez pas utiliser les fichiers <code>.htaccess</code>.</p>
+
+    <p>Ceci étant dit, si vous pensez que vous devez quand-même utiliser
+    un fichier <code>.htaccess</code>, vous pouvez utiliser la
+    configuration suivante :</p>
+
+    <p>Contenu du fichier <code>.htaccess</code> :</p>
+
+    <div class="example"><p><code>
+      AuthType Basic<br />
+      AuthName "Password Required"<br />
+      AuthUserFile /www/passwords/password.file<br />
+      AuthGroupFile /www/passwords/group.file<br />
+      Require Group admins
+    </code></p></div>
+
+    <p>Notez que <code>AllowOverride AuthConfig</code> doit être présent
+    pour que ces directives produisent leur effet.</p>
+
+    <p>Vous pouvez vous référer au <a href="auth.html">tutoriel sur
+    l'authentification</a> pour une description plus détaillée de
+    l'authentification et de l'autorisation.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="ssi" id="ssi">Exemple d'Inclusion Côté Serveur (Server Side
+Includes - SSI)</a></h2>
+
+    <p>Les fichiers <code>.htaccess</code> sont aussi couramment
+    utilisés pour activer les SSI pour un répertoire particulier. Pour y
+    parvenir, on utilise les directives de configuration suivantes,
+    placées dans un fichier <code>.htaccess</code> enregistré dans le
+    répertoire considéré :</p>
+
+    <div class="example"><p><code>
+       Options +Includes<br />
+       AddType text/html shtml<br />
+       AddHandler server-parsed shtml
+    </code></p></div>
+
+    <p>Notez que <code>AllowOverride Options</code> et <code>AllowOverride
+    FileInfo</code> doivent être tous les deux présents pour que ces
+    directives puissent produire leur effet.</p>
+
+    <p>Vous pouvez vous référer au <a href="ssi.html">tutoriel SSI</a>
+    pour une description plus détaillée des SSI.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="cgi" id="cgi">Exemple de CGI</a></h2>
+
+    <p>En fin de compte, vous avez décidé d'utiliser un fichier
+    <code>.htaccess</code> pour permettre l'exécution des programmes CGI
+    dans un répertoire particulier. Pour y parvenir, vous pouvez
+    utiliser la configuration suivante :</p>
+
+    <div class="example"><p><code>
+       Options +ExecCGI<br />
+       AddHandler cgi-script cgi pl
+    </code></p></div>
+
+    <p>Alternativement, si vous souhaitez que tous les fichiers d'un
+    répertoire donné soient considérés comme des programmes CGI, vous
+    pouvez utiliser la configuration suivante :</p>
+
+    <div class="example"><p><code>
+       Options +ExecCGI<br />
+       SetHandler cgi-script
+    </code></p></div>
+
+    <p>Notez que <code>AllowOverride Options</code> et <code>AllowOverride
+    FileInfo</code> doivent être tous les deux présents pour que ces
+    directives puissent produire leur effet.</p>
+
+    <p>Vous pouvez vous référer au <a href="cgi.html">tutoriel CGI</a>
+    pour une description plus détaillée de la configuration et de la
+    proprammation CGI.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="troubleshoot" id="troubleshoot">Résolution des problèmes</a></h2>
+
+    <p>De nombreuses raisons peuvent être à l'origine du fait que
+    les directives que vous avez mises dans un fichier
+    <code>.htaccess</code> ne produisent pas l'effet désiré.</p>
+
+    <p>Le plus souvent, le problème vient du fait que la définition de
+    la directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
+    ne permet pas l'activation des directives de votre fichier
+    <code>.htaccess</code>. Vérifiez si une directive
+    <code>AllowOverride None</code> n'affecte pas le répertoire où se
+    trouve votre fichier. Un bon test consiste à mettre des directives
+    dont la syntaxe est erronée dans votre ficher <code>.htaccess</code>
+    et de redémarrer le serveur. Si aucune erreur n'est générée par le
+    serveur, il est pratiquement certain qu'une directive
+    <code>AllowOverride None</code> affecte votre répertoire.</p>
+
+    <p>Par contre, si vous obtenez des erreurs de serveur lorsque vous
+    tentez d'accéder à des documents, consultez votre journal des
+    erreurs d'Apache. Il vous indiquera probablement que la directive
+    utilisée dans votre fichier <code>.htaccess</code> n'est pas
+    permise.</p>
+
+<div class="example"><p><code>
+       [Sat Aug 09 16:19:20 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteLog not allowed here
+</code></p></div>
+       <p>Cela signifie soit que vous utilisez une directive qui n'est
+       jamais permise dans les fichiers <code>.htaccess</code>, soit
+       que vous n'avez tout simplement pas défini la directive
+       <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> à un niveau
+       suffisant pour la directive que vous utilisez. Consultez la
+       documentation de cette directive pour déterminer quel cas
+       s'applique.</p>
+
+       <p>Le journal des erreurs peut aussi vous signaler une erreur de
+       syntaxe dans l'usage de la directive elle-même.</p>
+
+    <div class="example"><p><code>
+    [Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
+    </code></p></div>
+
+       <p>Dans ce cas, le message d'erreur sera spécifique à l'erreur
+       de syntaxe que vous avez commise.</p>
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/howto/htaccess.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
+<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)">&nbsp;pt-br&nbsp;</a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Authorisé 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>
\ No newline at end of file
diff --git a/docs/manual/howto/htaccess.xml.fr b/docs/manual/howto/htaccess.xml.fr
new file mode 100644 (file)
index 0000000..81e7437
--- /dev/null
@@ -0,0 +1,469 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 684332 -->
+<!-- French translation : Lucien GENTIS -->
+<!-- Reviewed by : Vincent Deffontaines -->
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<manualpage metafile="htaccess.xml.meta">
+<parentdocument href="./">Recettes / Tutoriels</parentdocument>
+
+<title>Tutoriel Apache : fichiers .htaccess</title>
+
+<summary>
+<p>Les fichiers <code>.htaccess</code> fournissent une m&eacute;thode pour
+modifier la configuration du serveur au niveau de chaque r&eacute;pertoire.</p>
+</summary>
+
+<section id="related"><title>Fichiers .htaccess</title>
+    <related>
+        <modulelist>
+            <module>core</module>
+            <module>mod_authn_file</module>
+            <module>mod_authz_groupfile</module>
+            <module>mod_cgi</module>
+            <module>mod_include</module>
+            <module>mod_mime</module>
+        </modulelist>
+
+        <directivelist>
+            <directive module="core">AccessFileName</directive>
+            <directive module="core">AllowOverride</directive>
+            <directive module="core">Options</directive>
+            <directive module="mod_mime">AddHandler</directive>
+            <directive module="core">SetHandler</directive>
+            <directive module="mod_authn_core">AuthType</directive>
+            <directive module="mod_authn_core">AuthName</directive>
+            <directive module="mod_authn_file">AuthUserFile</directive>
+            <directive module="mod_authz_groupfile">AuthGroupFile</directive>
+            <directive module="mod_authz_core">Require</directive>
+        </directivelist>
+
+    </related>
+</section>
+
+<section id="what">
+<title>Que sont ce fichiers, comment les utiliser ?</title>
+
+    <p>Les fichiers <code>.htaccess</code> (ou "fichiers de
+    configuration distribu&eacute;s") fournissent une m&eacute;thode pour modifier la
+    configuration du serveur au niveau d'un r&eacute;pertoire. Un fichier,
+    contenant une ou plusieurs directives de configuration, est plac&eacute;
+    dans un r&eacute;pertoire de documents particulier, et ses directives
+    s'appliquent &agrave; ce r&eacute;pertoire et &agrave; tous ses sous-r&eacute;pertoires.</p>
+
+    <note><title>Note :</title>
+      <p>Si vous voulez donner un autre nom &agrave; votre fichier
+      <code>.htaccess</code>, vous pouvez le faire en utilisant la
+      directive <directive module="core">AccessFileName</directive>. Par
+      exemple, si vous pr&eacute;f&eacute;rez nommer votre fichier
+      <code>.config</code>, vous pouvez mettre ceci dans le fichier de
+      configuration de votre serveur :</p>
+
+      <example>
+        AccessFileName .config
+      </example>
+    </note>
+
+    <p>En g&eacute;n&eacute;ral, les fichiers <code>.htaccess</code> utilisent la m&ecirc;me
+    syntaxe que les <a href="../configuring.html#syntax">fichiers de
+    configuration principaux</a>. Ce que vous pouvez mettre dans ces
+    fichier est d&eacute;termin&eacute; par la directive <directive
+    module="core">AllowOverride</directive>. Cette directive sp&eacute;cifie,
+    sous forme de cat&eacute;gories, quelles directives seront trait&eacute;es si
+    elles se trouvent dans un fichier <code>.htaccess</code>. Si une
+    directive est permise dans un fichier <code>.htaccess</code> file,
+    la documentation de cette directive contiendra une section Override,
+    sp&eacute;cifiant quelle valeur doit prendre <directive
+    module="core">AllowOverride</directive> pour que cette directive
+    soit trait&eacute;e.</p>
+
+    <p>Par exemple, si vous regardez la documentation de la directive
+    <directive module="core">AddDefaultCharset</directive>, vous verrez
+    que cette derni&egrave;re est permise dans les fichiers
+    <code>.htaccess</code> (Voir la ligne de contexte dans le r&eacute;sum&eacute; de
+    la directive). La ligne <a
+    href="../mod/directive-dict.html#Context">Override</a> indique
+    <code>FileInfo</code>. Vous devez donc avoir au moins
+    <code>AllowOverride FileInfo</code> pour que cette directive soit
+    trait&eacute;e dans les fichiers <code>.htaccess</code>.</p>
+
+    <example><title>Exemple :</title>
+      <table>
+        <tr>
+          <td><a
+          href="../mod/directive-dict.html#Context">Contexte :</a></td>
+          <td>configuration du serveur, serveur virtuel, directory, .htaccess</td>
+        </tr>
+
+        <tr>
+          <td><a
+          href="../mod/directive-dict.html#Override">Override:</a></td>
+          <td>FileInfo</td>
+        </tr>
+      </table>
+    </example>
+
+    <p>Si vous n'&ecirc;tes pas s&ucirc;r qu'une directive particuli&egrave;re soit permise
+    dans un fichier <code>.htaccess</code>, lisez la documentation de
+    cette directive, et consultez la ligne de contexte pour
+    ".htaccess".</p>
+    </section>
+
+    <section id="when"><title>Quand doit-on (ne doit-on pas) utiliser
+    les fichiers .htaccess ?</title>
+
+    <p>En principe, vous ne devriez utiliser les fichiers
+    <code>.htaccess</code> que si vous n'avez pas acc&egrave;s au fichier de
+    configuration du serveur principal. Par exemple, la fausse id&eacute;e
+    selon laquelle l'authentification de l'utilisateur devrait toujours
+    &ecirc;tre faite dans les fichiers <code>.htaccess</code> est tr&egrave;s
+    r&eacute;pandue. Ceci est tout simplement faux. Vous pouvez configurer
+    l'authentification des utilisateurs au niveau de la configuration du
+    serveur principal, et c'est en fait cette m&eacute;thode qui doit &ecirc;tre
+    privil&eacute;gi&eacute;e.</p>
+
+    <p>Les fichiers <code>.htaccess</code> ne devraient &ecirc;tre utilis&eacute;s
+    que dans le cas o&ugrave; les fournisseurs de contenu ont besoin de
+    modifier la configuration du serveur au niveau d'un r&eacute;pertoire, mais
+    ne poss&egrave;dent pas l'acc&egrave;s root sur le syst&egrave;me du serveur. Si
+    l'administrateur du serveur ne souhaite pas effectuer des
+    modifications de configuration incessantes, il peut &ecirc;tre int&eacute;ressant
+    de permettre aux utilisateurs isol&eacute;s d'effectuer eux-m&ecirc;mes ces
+    modifications par le biais de fichiers <code>.htaccess</code>. Ceci
+    est particuli&egrave;rement vrai dans le cas o&ugrave; le fournisseur d'acc&egrave;s &agrave;
+    Internet h&eacute;berge de nombreux sites d'utilisateurs sur un seul
+    serveur, et souhaite que ces utilisateurs puissent modifier
+    eux-m&ecirc;mes leurs configurations.</p>
+
+    <p>Cependant et d'une mani&egrave;re g&eacute;n&eacute;rale, il vaut mieux &eacute;viter
+    d'utiliser les fichiers <code>.htaccess</code>. Tout &eacute;l&eacute;ment de
+    configuration que vous pourriez vouloir mettre dans un fichier
+    <code>.htaccess</code>, peut aussi &ecirc;tre mis, et avec la m&ecirc;me
+    efficacit&eacute;, dans une section <directive module="core"
+    type="section">Directory</directive> du fichier de configuration de
+    votre serveur principal.</p>
+
+    <p>Il y a deux raisons principales d'&eacute;viter l'utilisation des
+    fichiers <code>.htaccess</code>.</p>
+
+    <p>La premi&egrave;re est li&eacute;e aux performances. Lorsque la directive
+    <directive module="core">AllowOverride</directive> est d&eacute;finie de
+    fa&ccedil;on &agrave; autoriser l'utilisation des fichiers <code>.htaccess</code>,
+    Apache va rechercher leur pr&eacute;sence dans chaque r&eacute;pertoire. Ainsi,
+    permettre l'utilisation des fichiers <code>.htaccess</code> est d&eacute;j&agrave;
+    en soi une cause de d&eacute;gradation des performances, que vous utilisiez
+    effectivement ces fichiers ou non ! De plus, le fichier
+    <code>.htaccess</code> est charg&eacute; en m&eacute;moire chaque fois qu'un
+    document fait l'objet d'une requ&ecirc;te.</p>
+
+    <p>Notez aussi qu'Apache doit rechercher les fichiers
+    <code>.htaccess</code> dans tous les r&eacute;pertoires de niveau
+    sup&eacute;rieur, afin de rassembler toutes les directives qui s'appliquent
+    au r&eacute;pertoire courant (Voir la section <a href="#how">comment sont
+    appliqu&eacute;es les directives</a>). Ainsi, si un fichier fait l'objet
+    d'une requ&ecirc;te &agrave; partir d'un r&eacute;pertoire
+    <code>/www/htdocs/exemple</code>, Apache doit rechercher les
+    fichiers suivants :</p>
+
+    <example>
+      /.htaccess<br />
+      /www/.htaccess<br />
+      /www/htdocs/.htaccess<br />
+      /www/htdocs/exemple/.htaccess
+    </example>
+
+    <p>En cons&eacute;quence, chaque acc&egrave;s &agrave; un fichier de ce r&eacute;pertoire
+    n&eacute;cessite 4 acc&egrave;s au syst&egrave;me de fichiers suppl&eacute;mentaires pour
+    rechercher des fichiers <code>.htaccess</code>, m&ecirc;me si
+    aucun de ces fichiers n'est pr&eacute;sent. Notez que cet exemple ne peut
+    se produire que si les fichiers <code>.htaccess</code> ont &eacute;t&eacute;
+    autoris&eacute;s pour le r&eacute;pertoire <code>/</code>, ce qui est rarement le
+    cas.</p>
+
+    <p>La seconde raison d'&eacute;viter l'utilisation des fichiers
+    <code>.htaccess</code> est li&eacute;e &agrave; la s&eacute;curit&eacute;. Si vous permettez aux
+    utilisateurs de modifier la configuration du serveur, il peut en
+    r&eacute;sulter des cons&eacute;quences sur lesquelles vous n'aurez aucun
+    contr&ocirc;le. R&eacute;fl&eacute;chissez bien avant de donner ce privil&egrave;ge &agrave; vos
+    utilisateurs. Notez aussi que ne pas donner aux utilisateurs les
+    privil&egrave;ges dont ils ont besoin va entra&icirc;ner une augmentation des
+    demandes de support technique. Assurez-vous d'avoir inform&eacute;
+    clairement vos utilisateurs du niveau de privil&egrave;ges que vous leur
+    avez attribu&eacute;. Indiquer exactement comment vous avez d&eacute;fini la
+    directive <directive module="core">AllowOverride</directive> et
+    diriger les utilisateurs vers la documentation correspondante vous
+    &eacute;vitera bien des confusions ult&eacute;rieures.</p>
+
+    <p>Notez que mettre un fichier <code>.htaccess</code> contenant une
+    directive dans un r&eacute;pertoire <code>/www/htdocs/exemple</code>
+    revient exactement au m&ecirc;me que mettre la m&ecirc;me directive dans une
+    section Directory <code>&lt;Directory /www/htdocs/exemple&gt;</code>
+    du fichier de configuration de votre serveur principal :</p>
+
+    <p>Fichier <code>.htaccess</code> dans
+    <code>/www/htdocs/exemple</code> :</p>
+
+    <example><title>Contenu du fichier .htaccess dans
+    <code>/www/htdocs/exemple</code></title>
+       AddType text/exemple .exm
+    </example>
+
+    <example><title>Section de votre fichier
+    <code>httpd.conf</code></title>
+      &lt;Directory /www/htdocs/exemple&gt;<br />
+      <indent>
+        AddType text/exemple .exm<br />
+      </indent>
+      &lt;/Directory&gt;
+    </example>
+
+    <p>Cependant, la perte de performances sera moindre si vous
+    d&eacute;finissez cette directive dans la configuration de
+    votre serveur principal, car cette derni&egrave;re ne sera charg&eacute;e qu'une
+    seule fois au moment du d&eacute;marrage du serveur, alors qu'elle le sera
+    &agrave; chaque acc&egrave;s dans le cas d'un fichier <code>.htaccess</code>.</p>
+
+    <p>L'utilisation des fichiers <code>.htaccess</code> peut &ecirc;tre
+    enti&egrave;rement d&eacute;sactiv&eacute;e en d&eacute;finissant la directive <directive
+    module="core">AllowOverride</directive> &agrave; <code>none</code> :</p>
+
+    <example>
+      AllowOverride None
+    </example>
+</section>
+
+<section id="how"><title>Comment sont appliqu&eacute;es les directives ?</title>
+
+    <p>Les directives de configuration situ&eacute;es dans un fichier
+    <code>.htaccess</code> s'appliquent au r&eacute;pertoire dans lequel ce
+    fichier <code>.htaccess</code> se trouve, ainsi qu'&agrave; tous ses
+    sous-r&eacute;pertoires. Cependant, il est important de garder &agrave; l'esprit
+    qu'il peut y avoir des fichiers <code>.htaccess</code> dans les
+    r&eacute;pertoires de niveau sup&eacute;rieur. Les directives sont appliqu&eacute;es
+    selon l'ordre dans lequel elles sont rencontr&eacute;es. Ainsi, les
+    directives d'un fichier <code>.htaccess</code> situ&eacute; dans un
+    r&eacute;pertoire particulier peuvent &eacute;craser les directives se trouvant
+    dans des fichiers <code>.htaccess</code> situ&eacute;s &agrave; un niveau
+    sup&eacute;rieur dans l'arborescence des r&eacute;pertoires. Et ces derni&egrave;res
+    peuvent elles-m&ecirc;mes avoir &eacute;cras&eacute; des directives d'un fichier
+    <code>.htaccess</code> situ&eacute; &agrave; un niveau encore plus haut, ou dans
+    le fichier de configuration du serveur principal.</p>
+
+    <p>Exemple :</p>
+
+    <p>Dans le r&eacute;pertoire <code>/www/htdocs/exemple1</code> se trouve un
+    fichier <code>.htaccess</code> contenant ce qui suit :</p>
+
+    <example>
+       Options +ExecCGI
+    </example>
+
+    <p>Note : "<code>AllowOverride Options</code>" doit &ecirc;tre pr&eacute;sent
+    pour permettre l'utilisation de la directive "<directive
+    module="core">Options</directive>"  dans les fichiers
+    <code>.htaccess</code>.</p>
+
+    <p>Dans le r&eacute;pertoire <code>/www/htdocs/exemple1/exemple2</code> se
+    trouve un fichier <code>.htaccess</code> contenant ce qui suit
+    :</p>
+
+    <example>
+       Options Includes
+    </example>
+
+    <p>Ainsi, &agrave; cause de ce second fichier <code>.htaccess</code> du
+    r&eacute;pertoire <code>/www/htdocs/exemple1/exemple2</code>, l'ex&eacute;cution
+    des CGI est interdite, car la derni&egrave;re d&eacute;finition d'options
+    <code>Options Includes</code> &eacute;crase toute autre d&eacute;finition
+    d'options d'un fichier <code>.htaccess</code> situ&eacute; dans un
+    r&eacute;pertoire de niveau sup&eacute;rieur.</p>
+
+    <section id="merge"><title>Interactions entre les fichiers .htaccess
+    et les fichiers de configuration du serveur principal</title>
+
+    <p>Comme indiqu&eacute; dans la documentation sur les <a
+    href="../sections.html">Sections de configuration</a>, les fichiers
+    <code>.htaccess</code> peuvent &eacute;craser les directives des sections
+    <directive type="section" module="core">Directory</directive> pour
+    le r&eacute;pertoire correspondant, mais peuvent eux-m&ecirc;mes &ecirc;tre &eacute;cras&eacute;s
+    par d'autres types de sections des fichiers de la
+    configuration principale. Cette possibilit&eacute; peut s'av&eacute;rer utile pour
+    forcer certaines configurations, m&ecirc;me en cas de pr&eacute;sence de l'option
+    lib&eacute;rale <directive module="core">AllowOverride</directive>. Par
+    exemple, pour interdire l'ex&eacute;cution de scripts en autorisant la
+    d&eacute;finition de toute autre option dans les fichiers
+    <code>.htaccess</code>, vous pouvez utiliser :</p>
+
+    <example>
+&lt;Directory /&gt;<br />
+<indent>
+Allowoverride All<br />
+</indent>
+&lt;/Directory&gt;<br />
+<br />
+&lt;Location /&gt;<br />
+<indent>
+Options +IncludesNoExec -ExecCGI<br />
+</indent>
+&lt;/Location&gt;
+    </example>
+</section>
+
+</section>
+
+<section id="auth"><title>Exemple d'authentification</title>
+
+    <p>Si vous acc&eacute;dez directement &agrave; ce point du document pour apprendre
+    &agrave; effectuer une authentification, il est important de noter ceci. Il
+    existe une fausse id&eacute;e selon laquelle il serait n&eacute;cessaire
+    d'utiliser les fichiers <code>.htaccess</code> pour impl&eacute;menter
+    l'authentification par mot de passe. Ceci est tout simplement faux.
+    Pour y parvenir, il est pr&eacute;f&eacute;rable de mettre les directives
+    d'authentification dans une section <directive module="core"
+    type="section">Directory</directive> du fichier de configuration de
+    votre serveur principal, et les fichiers <code>.htaccess</code> ne
+    devraient &ecirc;tre utilis&eacute;s que dans le cas o&ugrave; vous n'avez pas acc&egrave;s au
+    fichier de configuration du serveur principal. Voir <a
+    href="#when">ci-dessus</a> pour savoir dans quels cas vous devez ou
+    ne devez pas utiliser les fichiers <code>.htaccess</code>.</p>
+
+    <p>Ceci &eacute;tant dit, si vous pensez que vous devez quand-m&ecirc;me utiliser
+    un fichier <code>.htaccess</code>, vous pouvez utiliser la
+    configuration suivante :</p>
+
+    <p>Contenu du fichier <code>.htaccess</code> :</p>
+
+    <example>
+      AuthType Basic<br />
+      AuthName "Password Required"<br />
+      AuthUserFile /www/passwords/password.file<br />
+      AuthGroupFile /www/passwords/group.file<br />
+      Require Group admins
+    </example>
+
+    <p>Notez que <code>AllowOverride AuthConfig</code> doit &ecirc;tre pr&eacute;sent
+    pour que ces directives produisent leur effet.</p>
+
+    <p>Vous pouvez vous r&eacute;f&eacute;rer au <a href="auth.html">tutoriel sur
+    l'authentification</a> pour une description plus d&eacute;taill&eacute;e de
+    l'authentification et de l'autorisation.</p>
+</section>
+
+<section id="ssi"><title>Exemple d'Inclusion C&ocirc;t&eacute; Serveur (Server Side
+Includes - SSI)</title>
+
+    <p>Les fichiers <code>.htaccess</code> sont aussi couramment
+    utilis&eacute;s pour activer les SSI pour un r&eacute;pertoire particulier. Pour y
+    parvenir, on utilise les directives de configuration suivantes,
+    plac&eacute;es dans un fichier <code>.htaccess</code> enregistr&eacute; dans le
+    r&eacute;pertoire consid&eacute;r&eacute; :</p>
+
+    <example>
+       Options +Includes<br />
+       AddType text/html shtml<br />
+       AddHandler server-parsed shtml
+    </example>
+
+    <p>Notez que <code>AllowOverride Options</code> et <code>AllowOverride
+    FileInfo</code> doivent &ecirc;tre tous les deux pr&eacute;sents pour que ces
+    directives puissent produire leur effet.</p>
+
+    <p>Vous pouvez vous r&eacute;f&eacute;rer au <a href="ssi.html">tutoriel SSI</a>
+    pour une description plus d&eacute;taill&eacute;e des SSI.</p>
+</section>
+
+<section id="cgi"><title>Exemple de CGI</title>
+
+    <p>En fin de compte, vous avez d&eacute;cid&eacute; d'utiliser un fichier
+    <code>.htaccess</code> pour permettre l'ex&eacute;cution des programmes CGI
+    dans un r&eacute;pertoire particulier. Pour y parvenir, vous pouvez
+    utiliser la configuration suivante :</p>
+
+    <example>
+       Options +ExecCGI<br />
+       AddHandler cgi-script cgi pl
+    </example>
+
+    <p>Alternativement, si vous souhaitez que tous les fichiers d'un
+    r&eacute;pertoire donn&eacute; soient consid&eacute;r&eacute;s comme des programmes CGI, vous
+    pouvez utiliser la configuration suivante :</p>
+
+    <example>
+       Options +ExecCGI<br />
+       SetHandler cgi-script
+    </example>
+
+    <p>Notez que <code>AllowOverride Options</code> et <code>AllowOverride
+    FileInfo</code> doivent &ecirc;tre tous les deux pr&eacute;sents pour que ces
+    directives puissent produire leur effet.</p>
+
+    <p>Vous pouvez vous r&eacute;f&eacute;rer au <a href="cgi.html">tutoriel CGI</a>
+    pour une description plus d&eacute;taill&eacute;e de la configuration et de la
+    proprammation CGI.</p>
+
+</section>
+
+<section id="troubleshoot"><title>R&eacute;solution des probl&egrave;mes</title>
+
+    <p>De nombreuses raisons peuvent &ecirc;tre &agrave; l'origine du fait que
+    les directives que vous avez mises dans un fichier
+    <code>.htaccess</code> ne produisent pas l'effet d&eacute;sir&eacute;.</p>
+
+    <p>Le plus souvent, le probl&egrave;me vient du fait que la d&eacute;finition de
+    la directive <directive module="core">AllowOverride</directive>
+    ne permet pas l'activation des directives de votre fichier
+    <code>.htaccess</code>. V&eacute;rifiez si une directive
+    <code>AllowOverride None</code> n'affecte pas le r&eacute;pertoire o&ugrave; se
+    trouve votre fichier. Un bon test consiste &agrave; mettre des directives
+    dont la syntaxe est erron&eacute;e dans votre ficher <code>.htaccess</code>
+    et de red&eacute;marrer le serveur. Si aucune erreur n'est g&eacute;n&eacute;r&eacute;e par le
+    serveur, il est pratiquement certain qu'une directive
+    <code>AllowOverride None</code> affecte votre r&eacute;pertoire.</p>
+
+    <p>Par contre, si vous obtenez des erreurs de serveur lorsque vous
+    tentez d'acc&eacute;der &agrave; des documents, consultez votre journal des
+    erreurs d'Apache. Il vous indiquera probablement que la directive
+    utilis&eacute;e dans votre fichier <code>.htaccess</code> n'est pas
+    permise.</p>
+
+<example>
+       [Sat Aug 09 16:19:20 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteLog not allowed here
+</example>
+       <p>Cela signifie soit que vous utilisez une directive qui n'est
+       jamais permise dans les fichiers <code>.htaccess</code>, soit
+       que vous n'avez tout simplement pas d&eacute;fini la directive
+       <directive module="core">AllowOverride</directive> &agrave; un niveau
+       suffisant pour la directive que vous utilisez. Consultez la
+       documentation de cette directive pour d&eacute;terminer quel cas
+       s'applique.</p>
+
+       <p>Le journal des erreurs peut aussi vous signaler une erreur de
+       syntaxe dans l'usage de la directive elle-m&ecirc;me.</p>
+
+    <example>
+    [Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
+    </example>
+
+       <p>Dans ce cas, le message d'erreur sera sp&eacute;cifique &agrave; l'erreur
+       de syntaxe que vous avez commise.</p>
+</section>
+
+</manualpage>
index 078ff88accc66704a020c03ece7f86be96c5e831..a802cdafe70528b720bcd363cb8c5833a9f896e7 100644 (file)
@@ -8,6 +8,7 @@
 
   <variants>
     <variant>en</variant>
+    <variant>fr</variant>
     <variant outdated="yes">ja</variant>
     <variant outdated="yes">ko</variant>
     <variant outdated="yes">pt-br</variant>