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="<-" alt="<-" src="/images/left.gif" /></a></div> 21<div id="path"> 22<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.4</a> > <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"> en </a> | 25<a href="/fr/howto/htaccess.html" title="Fran�ais"> fr </a> | 26<a href="/ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 27<a href="/ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 28<a href="/pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Portugu�s (Brasil)"> pt-br </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"><Directory></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><Directory /www/htdocs/exemple></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"><Directory /www/htdocs/example> 224 AddType text/example .exm 225</Directory></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"><Directory></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"><Directory /www/htdocs> 300 AllowOverride All 301</Directory> 302 303<Location /> 304 Options +IncludesNoExec -ExecCGI<br /> 305</Location></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"><Directory></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"> en </a> | 447<a href="/fr/howto/htaccess.html" title="Fran�ais"> fr </a> | 448<a href="/ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 449<a href="/ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 450<a href="/pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Portugu�s (Brasil)"> pt-br </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&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>