1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
4        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5              This file is generated from xml source: DO NOT EDIT
6        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7      -->
8<title>Tutoriel du serveur HTTP Apache : fichiers .htaccess - Serveur Apache HTTP</title>
9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
12<script src="/style/scripts/prettify.min.js" type="text/javascript">
13</script>
14
15<link href="/images/favicon.ico" rel="shortcut icon" /></head>
16<body id="manual-page"><div id="page-header">
17<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
18<p class="apache">Serveur Apache HTTP Version 2.4</p>
19<img alt="" src="/images/feather.gif" /></div>
20<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
21<div id="path">
22<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.4</a> &gt; <a href="./">Recettes / Tutoriels</a></div><div id="page-content"><div id="preamble"><h1>Tutoriel du serveur HTTP Apache : fichiers .htaccess</h1>
23<div class="toplang">
24<p><span>Langues Disponibles: </span><a href="/en/howto/htaccess.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
25<a href="/fr/howto/htaccess.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
26<a href="/ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
27<a href="/ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
28<a href="/pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Portugu�s (Brasil)">&nbsp;pt-br&nbsp;</a></p>
29</div>
30
31<p>Les fichiers <code>.htaccess</code> fournissent une m�thode pour
32modifier la configuration du serveur au niveau de chaque r�pertoire.</p>
33</div>
34<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#related">Fichiers .htaccess</a></li>
35<li><img alt="" src="/images/down.gif" /> <a href="#what">Que sont ce fichiers, comment les utiliser ?</a></li>
36<li><img alt="" src="/images/down.gif" /> <a href="#when">Quand doit-on (ne doit-on pas) utiliser
37    les fichiers .htaccess ?</a></li>
38<li><img alt="" src="/images/down.gif" /> <a href="#how">Comment sont appliqu�es les directives ?</a></li>
39<li><img alt="" src="/images/down.gif" /> <a href="#auth">Exemple d'authentification</a></li>
40<li><img alt="" src="/images/down.gif" /> <a href="#ssi">Exemple d'Inclusion C�t� Serveur (Server Side
41Includes - SSI)</a></li>
42<li><img alt="" src="/images/down.gif" /> <a href="#cgi">Exemple de CGI</a></li>
43<li><img alt="" src="/images/down.gif" /> <a href="#troubleshoot">R�solution des probl�mes</a></li>
44</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
45<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
46<div class="section">
47<h2><a name="related" id="related">Fichiers .htaccess</a></h2>
48    
49    <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>
50    <div class="note">Les fichiers <code>.htaccess</code> ne doivent �tre utilis�s
51    que si vous n'avez pas acc�s au fichier de configuration du serveur
52    principal. L'utilisation des fichiers <code>.htaccess</code>
53    ralentit le fonctionnement de votre serveur HTTP Apache. Il est toujours
54    pr�f�rable de d�finir les directives que vous pouvez inclure dans un
55    fichier <code>.htaccess</code> dans une section <code class="directive"><a href="/mod/core.html#directory">Directory</a></code>, car elles produiront le
56    m�me effet avec de meilleures performances.</div>
57</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
58<div class="section">
59<h2><a name="what" id="what">Que sont ce fichiers, comment les utiliser ?</a></h2>
60
61
62    <p>Les fichiers <code>.htaccess</code> (ou "fichiers de
63    configuration distribu�s") fournissent une m�thode pour modifier la
64    configuration du serveur au niveau d'un r�pertoire. Un fichier,
65    contenant une ou plusieurs directives de configuration, est plac�
66    dans un r�pertoire de documents particulier, et ses directives
67    s'appliquent � ce r�pertoire et � tous ses sous-r�pertoires.</p>
68
69    <div class="note"><h3>Note :</h3>
70      <p>Si vous voulez donner un autre nom � votre fichier
71      <code>.htaccess</code>, vous pouvez le faire en utilisant la
72      directive <code class="directive"><a href="/mod/core.html#accessfilename">AccessFileName</a></code>. Par
73      exemple, si vous pr�f�rez nommer votre fichier
74      <code>.config</code>, vous pouvez mettre ceci dans le fichier de
75      configuration de votre serveur :</p>
76
77      <pre class="prettyprint lang-config">AccessFileName .config</pre>
78
79    </div>
80
81    <p>En g�n�ral, les fichiers <code>.htaccess</code> utilisent la m�me
82    syntaxe que les <a href="/configuring.html#syntax">fichiers de
83    configuration principaux</a>. Ce que vous pouvez mettre dans ces
84    fichier est d�termin� par la directive <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code>. Cette directive sp�cifie,
85    sous forme de cat�gories, quelles directives seront trait�es si
86    elles se trouvent dans un fichier <code>.htaccess</code>. Si une
87    directive est permise dans un fichier <code>.htaccess</code> file,
88    la documentation de cette directive contiendra une section Override,
89    sp�cifiant quelle valeur doit prendre <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> pour que cette directive
90    soit trait�e.</p>
91
92    <p>Par exemple, si vous regardez la documentation de la directive
93    <code class="directive"><a href="/mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>, vous verrez
94    que cette derni�re est permise dans les fichiers
95    <code>.htaccess</code> (Voir la ligne de contexte dans le r�sum� de
96    la directive). La ligne <a href="/mod/directive-dict.html#Context">Override</a> indique
97    <code>FileInfo</code>. Vous devez donc avoir au moins
98    <code>AllowOverride FileInfo</code> pour que cette directive soit
99    trait�e dans les fichiers <code>.htaccess</code>.</p>
100
101    <div class="example"><h3>Exemple :</h3><table>
102        <tr>
103          <td><a href="/mod/directive-dict.html#Context">Contexte :</a></td>
104          <td>configuration du serveur, serveur virtuel, directory, .htaccess</td>
105        </tr>
106
107        <tr>
108          <td><a href="/mod/directive-dict.html#Override">Override:</a></td>
109          <td>FileInfo</td>
110        </tr>
111      </table></div>
112
113    <p>Si vous n'�tes pas s�r qu'une directive particuli�re soit permise
114    dans un fichier <code>.htaccess</code>, lisez la documentation de
115    cette directive, et consultez la ligne de contexte pour
116    ".htaccess".</p>
117    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
118<div class="section">
119<h2><a name="when" id="when">Quand doit-on (ne doit-on pas) utiliser
120    les fichiers .htaccess ?</a></h2>
121
122    <p>En principe, vous ne devriez utiliser les fichiers
123    <code>.htaccess</code> que lorsque vous n'avez pas acc�s au fichier de
124    configuration du serveur principal. Par exemple, la fausse
125    id�e
126    selon laquelle l'authentification de l'utilisateur devrait toujours
127    �tre faite dans les fichiers <code>.htaccess</code> est tr�s
128    r�pandue. Il est aussi souvent avanc�, ces derni�res
129    ann�es, que les directives de <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> doivent
130    �tre d�finies dans les fichiers <code>.htaccess</code>. Ceci est
131    tout simplement faux. Vous pouvez configurer
132    l'authentification des utilisateurs au niveau de la configuration du
133    serveur principal, et c'est en fait cette m�thode qui doit �tre
134    privil�gi�e. De m�me, les directives de
135    <code>mod_rewrite</code> fonctionneront mieux, � de nombreux �gards,
136    dans le contexte du serveur principal.</p>
137
138    <p>Les fichiers <code>.htaccess</code> ne devraient �tre utilis�s
139    que dans le cas o� les fournisseurs de contenu ont besoin de
140    modifier la configuration du serveur au niveau d'un r�pertoire, mais
141    ne poss�dent pas l'acc�s root sur le syst�me du serveur. Si
142    l'administrateur du serveur ne souhaite pas effectuer des
143    modifications de configuration incessantes, il peut �tre int�ressant
144    de permettre aux utilisateurs isol�s d'effectuer eux-m�mes ces
145    modifications par le biais de fichiers <code>.htaccess</code>. Ceci
146    est particuli�rement vrai dans le cas o� le fournisseur d'acc�s �
147    Internet h�berge de nombreux sites d'utilisateurs sur un seul
148    serveur, et souhaite que ces utilisateurs puissent modifier
149    eux-m�mes leurs configurations.</p>
150
151    <p>Cependant et d'une mani�re g�n�rale, il vaut mieux �viter
152    d'utiliser les fichiers <code>.htaccess</code>. Tout �l�ment de
153    configuration que vous pourriez vouloir mettre dans un fichier
154    <code>.htaccess</code>, peut aussi �tre mis, et avec la m�me
155    efficacit�, dans une section <code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code> du fichier de configuration de
156    votre serveur principal.</p>
157
158    <p>Il y a deux raisons principales d'�viter l'utilisation des
159    fichiers <code>.htaccess</code>.</p>
160
161    <p>La premi�re est li�e aux performances. Lorsque la directive
162    <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> est d�finie de
163    fa�on � autoriser l'utilisation des fichiers <code>.htaccess</code>,
164    httpd va rechercher leur pr�sence dans chaque r�pertoire. Ainsi,
165    permettre l'utilisation des fichiers <code>.htaccess</code> est d�j�
166    en soi une cause de d�gradation des performances, que vous utilisiez
167    effectivement ces fichiers ou non ! De plus, le fichier
168    <code>.htaccess</code> est charg� en m�moire chaque fois qu'un
169    document fait l'objet d'une requ�te.</p>
170
171    <p>Notez aussi que httpd doit rechercher les fichiers
172    <code>.htaccess</code> dans tous les r�pertoires de niveau
173    sup�rieur, afin de rassembler toutes les directives qui s'appliquent
174    au r�pertoire courant (Voir la section <a href="#how">comment sont
175    appliqu�es les directives</a>). Ainsi, si un fichier fait l'objet
176    d'une requ�te � partir d'un r�pertoire
177    <code>/www/htdocs/exemple</code>, httpd doit rechercher les
178    fichiers suivants :</p>
179
180    <div class="example"><p><code>
181      /.htaccess<br />
182      /www/.htaccess<br />
183      /www/htdocs/.htaccess<br />
184      /www/htdocs/exemple/.htaccess
185    </code></p></div>
186
187    <p>En cons�quence, chaque acc�s � un fichier de ce r�pertoire
188    n�cessite 4 acc�s au syst�me de fichiers suppl�mentaires pour
189    rechercher des fichiers <code>.htaccess</code>, m�me si
190    aucun de ces fichiers n'est pr�sent. Notez que cet exemple ne peut
191    se produire que si les fichiers <code>.htaccess</code> ont �t�
192    autoris�s pour le r�pertoire <code>/</code>, ce qui est rarement le
193    cas.</p>
194
195    <p>La seconde raison d'�viter l'utilisation des fichiers
196    <code>.htaccess</code> est li�e � la s�curit�. Si vous permettez aux
197    utilisateurs de modifier la configuration du serveur, il peut en
198    r�sulter des cons�quences sur lesquelles vous n'aurez aucun
199    contr�le. R�fl�chissez bien avant de donner ce privil�ge � vos
200    utilisateurs. Notez aussi que ne pas donner aux utilisateurs les
201    privil�ges dont ils ont besoin va entra�ner une augmentation des
202    demandes de support technique. Assurez-vous d'avoir inform�
203    clairement vos utilisateurs du niveau de privil�ges que vous leur
204    avez attribu�. Indiquer exactement comment vous avez d�fini la
205    directive <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> et
206    diriger les utilisateurs vers la documentation correspondante vous
207    �vitera bien des confusions ult�rieures.</p>
208
209    <p>Notez que mettre un fichier <code>.htaccess</code> contenant une
210    directive dans un r�pertoire <code>/www/htdocs/exemple</code>
211    revient exactement au m�me que mettre la m�me directive dans une
212    section Directory <code>&lt;Directory /www/htdocs/exemple&gt;</code>
213    du fichier de configuration de votre serveur principal :</p>
214
215    <p>Fichier <code>.htaccess</code> dans
216    <code>/www/htdocs/exemple</code> :</p>
217
218    <div class="example"><h3>Contenu du fichier .htaccess dans
219    <code>/www/htdocs/exemple</code></h3><pre class="prettyprint lang-config">AddType text/example .exm</pre>
220</div>
221
222    <div class="example"><h3>Section de votre fichier
223    <code>httpd.conf</code></h3><pre class="prettyprint lang-config">&lt;Directory /www/htdocs/example&gt;
224    AddType text/example .exm
225&lt;/Directory&gt;</pre>
226</div>
227
228    <p>Cependant, la perte de performances sera moindre si vous
229    d�finissez cette directive dans la configuration de
230    votre serveur principal, car cette derni�re ne sera charg�e qu'une
231    seule fois au moment du d�marrage du serveur, alors qu'elle le sera
232    � chaque acc�s dans le cas d'un fichier <code>.htaccess</code>.</p>
233
234    <p>L'utilisation des fichiers <code>.htaccess</code> peut �tre
235    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>
236
237    <pre class="prettyprint lang-config">AllowOverride None</pre>
238
239</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
240<div class="section">
241<h2><a name="how" id="how">Comment sont appliqu�es les directives ?</a></h2>
242
243    <p>Les directives de configuration situ�es dans un fichier
244    <code>.htaccess</code> s'appliquent au r�pertoire dans lequel ce
245    fichier <code>.htaccess</code> se trouve, ainsi qu'� tous ses
246    sous-r�pertoires. Cependant, il est important de garder � l'esprit
247    qu'il peut y avoir des fichiers <code>.htaccess</code> dans les
248    r�pertoires de niveau sup�rieur. Les directives sont appliqu�es
249    selon l'ordre dans lequel elles sont rencontr�es. Ainsi, les
250    directives d'un fichier <code>.htaccess</code> situ� dans un
251    r�pertoire particulier peuvent �craser les directives se trouvant
252    dans des fichiers <code>.htaccess</code> situ�s � un niveau
253    sup�rieur dans l'arborescence des r�pertoires. Et ces derni�res
254    peuvent elles-m�mes avoir �cras� des directives d'un fichier
255    <code>.htaccess</code> situ� � un niveau encore plus haut, ou dans
256    le fichier de configuration du serveur principal.</p>
257
258    <p>Exemple :</p>
259
260    <p>Dans le r�pertoire <code>/www/htdocs/exemple1</code> se trouve un
261    fichier <code>.htaccess</code> contenant ce qui suit :</p>
262
263    <pre class="prettyprint lang-config">Options +ExecCGI</pre>
264
265
266    <p>Note : "<code>AllowOverride Options</code>" doit �tre pr�sent
267    pour permettre l'utilisation de la directive "<code class="directive"><a href="/mod/core.html#options">Options</a></code>"  dans les fichiers
268    <code>.htaccess</code>.</p>
269
270    <p>Dans le r�pertoire <code>/www/htdocs/exemple1/exemple2</code> se
271    trouve un fichier <code>.htaccess</code> contenant ce qui suit
272    :</p>
273
274    <pre class="prettyprint lang-config">Options Includes</pre>
275
276
277    <p>Ainsi, � cause de ce second fichier <code>.htaccess</code> du
278    r�pertoire <code>/www/htdocs/exemple1/exemple2</code>, l'ex�cution
279    des CGI est interdite, car la derni�re d�finition d'options
280    <code>Options Includes</code> �crase toute autre d�finition
281    d'options d'un fichier <code>.htaccess</code> situ� dans un
282    r�pertoire de niveau sup�rieur.</p>
283
284    <h3><a name="merge" id="merge">Interactions entre les fichiers .htaccess
285    et les fichiers de configuration du serveur principal</a></h3>
286
287    <p>Comme indiqu� dans la documentation sur les <a href="/sections.html">Sections de configuration</a>, les fichiers
288    <code>.htaccess</code> peuvent �craser les directives des sections
289    <code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code> pour
290    le r�pertoire correspondant, mais peuvent eux-m�mes �tre �cras�s
291    par d'autres types de sections des fichiers de la
292    configuration principale. Cette possibilit� peut s'av�rer utile pour
293    forcer certaines configurations, m�me en cas de pr�sence de l'option
294    lib�rale <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code>. Par
295    exemple, pour interdire l'ex�cution de scripts en autorisant la
296    d�finition de toute autre option dans les fichiers
297    <code>.htaccess</code>, vous pouvez utiliser :</p>
298
299    <pre class="prettyprint lang-config">&lt;Directory /www/htdocs&gt;
300    AllowOverride All
301&lt;/Directory&gt;
302
303&lt;Location /&gt;
304    Options +IncludesNoExec -ExecCGI<br />
305&lt;/Location&gt;</pre>
306
307
308    <div class="note">Dans cet exemple, on consid�re que le chemin d�fini par la
309    directive <code class="directive"><a href="/mod/core.html#documentroot">DocumentRoot</a></code> est
310    <code>/www/htdocs</code>.</div>
311
312
313</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
314<div class="section">
315<h2><a name="auth" id="auth">Exemple d'authentification</a></h2>
316
317    <p>Si vous acc�dez directement � ce point du document pour apprendre
318    � effectuer une authentification, il est important de noter ceci. Il
319    existe une fausse id�e selon laquelle il serait n�cessaire
320    d'utiliser les fichiers <code>.htaccess</code> pour impl�menter
321    l'authentification par mot de passe. Ceci est tout simplement faux.
322    Pour y parvenir, il est pr�f�rable de mettre les directives
323    d'authentification dans une section <code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code> du fichier de configuration de
324    votre serveur principal, et les fichiers <code>.htaccess</code> ne
325    devraient �tre utilis�s que dans le cas o� vous n'avez pas acc�s au
326    fichier de configuration du serveur principal. Voir <a href="#when">ci-dessus</a> pour savoir dans quels cas vous devez ou
327    ne devez pas utiliser les fichiers <code>.htaccess</code>.</p>
328
329    <p>Ceci �tant dit, si vous pensez que vous devez quand-m�me utiliser
330    un fichier <code>.htaccess</code>, vous pouvez utiliser la
331    configuration suivante :</p>
332
333    <p>Contenu du fichier <code>.htaccess</code> :</p>
334
335    <pre class="prettyprint lang-config">AuthType Basic
336AuthName "Password Required"
337AuthUserFile /www/passwords/password.file
338AuthGroupFile /www/passwords/group.file
339Require Group admins</pre>
340
341
342    <p>Notez que <code>AllowOverride AuthConfig</code> doit �tre pr�sent
343    pour que ces directives produisent leur effet.</p>
344
345    <p>Vous pouvez vous r�f�rer au <a href="auth.html">tutoriel sur
346    l'authentification</a> pour une description plus d�taill�e de
347    l'authentification et de l'autorisation.</p>
348</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
349<div class="section">
350<h2><a name="ssi" id="ssi">Exemple d'Inclusion C�t� Serveur (Server Side
351Includes - SSI)</a></h2>
352
353    <p>Les fichiers <code>.htaccess</code> sont aussi couramment
354    utilis�s pour activer les SSI pour un r�pertoire particulier. Pour y
355    parvenir, on utilise les directives de configuration suivantes,
356    plac�es dans un fichier <code>.htaccess</code> enregistr� dans le
357    r�pertoire consid�r� :</p>
358
359    <pre class="prettyprint lang-config">Options +Includes
360AddType text/html shtml
361AddHandler server-parsed shtml</pre>
362
363
364    <p>Notez que <code>AllowOverride Options</code> et <code>AllowOverride
365    FileInfo</code> doivent �tre tous les deux pr�sents pour que ces
366    directives puissent produire leur effet.</p>
367
368    <p>Vous pouvez vous r�f�rer au <a href="ssi.html">tutoriel SSI</a>
369    pour une description plus d�taill�e des SSI.</p>
370</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
371<div class="section">
372<h2><a name="cgi" id="cgi">Exemple de CGI</a></h2>
373
374    <p>En fin de compte, vous avez d�cid� d'utiliser un fichier
375    <code>.htaccess</code> pour permettre l'ex�cution des programmes CGI
376    dans un r�pertoire particulier. Pour y parvenir, vous pouvez
377    utiliser la configuration suivante :</p>
378
379    <pre class="prettyprint lang-config">Options +ExecCGI
380AddHandler cgi-script cgi pl</pre>
381
382
383    <p>Alternativement, si vous souhaitez que tous les fichiers d'un
384    r�pertoire donn� soient consid�r�s comme des programmes CGI, vous
385    pouvez utiliser la configuration suivante :</p>
386
387    <pre class="prettyprint lang-config">Options +ExecCGI
388SetHandler cgi-script</pre>
389
390
391    <p>Notez que <code>AllowOverride Options</code> et <code>AllowOverride
392    FileInfo</code> doivent �tre tous les deux pr�sents pour que ces
393    directives puissent produire leur effet.</p>
394
395    <p>Vous pouvez vous r�f�rer au <a href="cgi.html">tutoriel CGI</a>
396    pour une description plus d�taill�e de la configuration et de la
397    proprammation CGI.</p>
398
399</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
400<div class="section">
401<h2><a name="troubleshoot" id="troubleshoot">R�solution des probl�mes</a></h2>
402
403    <p>De nombreuses raisons peuvent �tre � l'origine du fait que
404    les directives que vous avez mises dans un fichier
405    <code>.htaccess</code> ne produisent pas l'effet d�sir�.</p>
406
407    <p>Le plus souvent, le probl�me vient du fait que la d�finition de
408    la directive <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code>
409    ne permet pas l'activation des directives de votre fichier
410    <code>.htaccess</code>. V�rifiez si une directive
411    <code>AllowOverride None</code> n'affecte pas le r�pertoire o� se
412    trouve votre fichier. Un bon test consiste � mettre des directives
413    dont la syntaxe est erron�e dans votre ficher <code>.htaccess</code>
414    et de recharger la page. Si aucune erreur n'est g�n�r�e par le
415    serveur, il est pratiquement certain qu'une directive
416    <code>AllowOverride None</code> affecte votre r�pertoire.</p>
417
418    <p>Par contre, si vous obtenez des erreurs de serveur lorsque vous
419    tentez d'acc�der � des documents, consultez votre journal des
420    erreurs de httpd. Il vous indiquera probablement que la directive
421    utilis�e dans votre fichier <code>.htaccess</code> n'est pas
422    permise.</p>
423
424<div class="example"><p><code>
425	[Fri Sep 17 18:43:16 2010] [alert] [client 192.168.200.51] /var/www/html/.htaccess: DirectoryIndex not allowed here
426</code></p></div>
427	<p>Cela signifie soit que vous utilisez une directive qui n'est
428	jamais permise dans les fichiers <code>.htaccess</code>, soit
429	que vous n'avez tout simplement pas d�fini la directive
430	<code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> � un niveau
431	suffisant pour la directive que vous utilisez. Consultez la
432	documentation de cette directive pour d�terminer quel cas
433	s'applique.</p>
434
435	<p>Le journal des erreurs peut aussi vous signaler une erreur de
436	syntaxe dans l'usage de la directive elle-m�me.</p>
437
438    <div class="example"><p><code>
439    [Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
440    </code></p></div>
441
442	<p>Dans ce cas, le message d'erreur sera sp�cifique � l'erreur
443	de syntaxe que vous avez commise.</p>
444</div></div>
445<div class="bottomlang">
446<p><span>Langues Disponibles: </span><a href="/en/howto/htaccess.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
447<a href="/fr/howto/htaccess.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
448<a href="/ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
449<a href="/ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
450<a href="/pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Portugu�s (Brasil)">&nbsp;pt-br&nbsp;</a></p>
451</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>
452<script type="text/javascript"><!--//--><![CDATA[//><!--
453var comments_shortname = 'httpd';
454var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/htaccess.html';
455(function(w, d) {
456    if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
457        d.write('<div id="comments_thread"><\/div>');
458        var s = d.createElement('script');
459        s.type = 'text/javascript';
460        s.async = true;
461        s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
462        (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
463    }
464    else { 
465        d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
466    }
467})(window, document);
468//--><!]]></script></div><div id="footer">
469<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
470<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.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[//><!--
471if (typeof(prettyPrint) !== 'undefined') {
472    prettyPrint();
473}
474//--><!]]></script>
475</body></html>