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>mod_alias - 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.js" type="text/javascript"> 13</script> 14 15<link href="../images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<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> 19<p class="apache">Serveur Apache HTTP Version 2.4</p> 20<img alt="" src="../images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> 22<div id="path"> 23<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="./">Modules</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Module Apache mod_alias</h1> 26<div class="toplang"> 27<p><span>Langues Disponibles: </span><a href="../en/mod/mod_alias.html" hreflang="en" rel="alternate" title="English"> en </a> | 28<a href="../fr/mod/mod_alias.html" title="Fran�ais"> fr </a> | 29<a href="../ja/mod/mod_alias.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 30<a href="../ko/mod/mod_alias.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 31<a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 32</div> 33<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Permet d'atteindre diff�rentes parties du syst�me de 34fichiers depuis l'arborescence des documents du site web, ainsi que la 35redirection d'URL</td></tr> 36<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> 37<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>alias_module</td></tr> 38<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_alias.c</td></tr></table> 39<h3>Sommaire</h3> 40 41 <p>Les directives fournies par ce module permettent de manipuler et 42 de contr�ler les URLs � l'arriv�e des requ�tes sur le serveur. Les 43 directives <code class="directive"><a href="#alias">Alias</a></code> et 44 <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> permettent de 45 faire correspondre des URLs avec des chemins du syst�me de fichiers. 46 Ceci permet de servir des contenus qui ne sont pas situ�s dans 47 l'arborescence de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> comme s'ils y �taient 48 r�ellement. La directive <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> a pour effet 49 suppl�mentaire de marquer le r�pertoire cible comme conteneur de 50 scripts CGI.</p> 51 52 <p>Les directives <code class="directive"><a href="#redirect">Redirect</a></code> 53 indiquent aux clients qu'ils doivent effectuer une nouvelle requ�te 54 avec une URL diff�rente. Elles sont souvent utilis�es lorsqu'une 55 ressource a �t� d�plac�e.</p> 56 57 <p><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> est con�u pour traiter des t�ches 58 simples de manipulation d'URL. Pour des t�ches plus complexes comme 59 la manipulation des cha�nes d'arguments des requ�tes, utilisez 60 plut�t les outils fournis par le module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></p> 61 62</div> 63<div id="quickview"><h3 class="directives">Directives</h3> 64<ul id="toc"> 65<li><img alt="" src="../images/down.gif" /> <a href="#alias">Alias</a></li> 66<li><img alt="" src="../images/down.gif" /> <a href="#aliasmatch">AliasMatch</a></li> 67<li><img alt="" src="../images/down.gif" /> <a href="#redirect">Redirect</a></li> 68<li><img alt="" src="../images/down.gif" /> <a href="#redirectmatch">RedirectMatch</a></li> 69<li><img alt="" src="../images/down.gif" /> <a href="#redirectpermanent">RedirectPermanent</a></li> 70<li><img alt="" src="../images/down.gif" /> <a href="#redirecttemp">RedirectTemp</a></li> 71<li><img alt="" src="../images/down.gif" /> <a href="#scriptalias">ScriptAlias</a></li> 72<li><img alt="" src="../images/down.gif" /> <a href="#scriptaliasmatch">ScriptAliasMatch</a></li> 73</ul> 74<h3>Sujets</h3> 75<ul id="topics"> 76<li><img alt="" src="../images/down.gif" /> <a href="#order">Chronologie du traitement</a></li> 77</ul><h3>Voir aussi</h3> 78<ul class="seealso"> 79<li><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></li> 80<li><a href="../urlmapping.html">Mise en correspondance des URLs avec le 81syst�me de fichiers</a></li> 82</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> 83<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 84<div class="section"> 85<h2><a name="order" id="order">Chronologie du traitement</a></h2> 86 87 <p>Les alias et redirections apparaissant dans diff�rents contextes 88 sont trait�s comme les autres directives en respectant les <a href="../sections.html#mergin">r�gles de fusion</a> standards. Par 89 contre, ils sont trait�s selon une chronologie particuli�re 90 lorsqu'ils apparaissent dans le m�me contexte (par exemple, dans la 91 m�me section <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>).</p> 92 93 <p>Premi�rement, toutes les redirections sont trait�es avant les 94 alias, et ainsi, une requ�te qui correspond � une directive 95 <code class="directive"><a href="#redirect">Redirect</a></code> ou <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code> ne se verra jamais 96 appliquer d'alias. Deuxi�mement, les alias et redirections sont 97 trait�s selon l'ordre dans lequel ils apparaissent dans le fichier 98 de configuration, seule la premi�re correspondance �tant prise en 99 compte.</p> 100 101 <p>Ainsi, lorsqu'une ou plusieurs de ces directives s'appliquent au 102 m�me sous-r�pertoire, vous devez classer les chemins du plus pr�cis 103 au moins pr�cis afin que toutes les directives puissent 104 �ventuellement s'appliquer, comme dans l'exemple suivant :</p> 105 106 <pre class="prettyprint lang-config"> 107Alias /foo/bar /baz 108Alias /foo /gaq 109 </pre> 110 111 112 <p>Si l'ordre des directives �tait invers�, la directive <code class="directive"><a href="#alias">Alias</a></code> ayant pour argument 113 <code>/foo</code> serait toujours appliqu�e avant la directive 114 <code class="directive"><a href="#alias">Alias</a></code> ayant pour argument 115 <code>/foo/bar</code>, et cette derni�re serait toujours 116 ignor�e.</p> 117 118</div> 119<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 120<div class="directive-section"><h2><a name="Alias" id="Alias">Alias</a> <a name="alias" id="alias">Directive</a></h2> 121<table class="directive"> 122<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en correspondance des URLs avec des chemins du syst�me 123de fichiers</td></tr> 124<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Alias <var>chemin URL</var> 125<var>chemin fichier</var>|<var>chemin r�pertoire</var></code></td></tr> 126<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 127<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 128<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> 129</table> 130 131 <p>La directive <code class="directive">Alias</code> permet de stocker des 132 documents (destin�s � �tre servis) dans des zones du syst�me de 133 fichiers situ�es en dehors de l'arborescence du site web <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. Les URLs dont le chemin 134 (d�cod� avec caract�res %) commence par <var>chemin URL</var> seront 135 mises en correspondance avec des fichiers locaux dont le chemin 136 commence par <var>chemin r�pertoire</var>. Le <var>chemin URL</var> 137 est sensible � la casse, m�me sur les syst�mes de fichiers 138 insensibles � la casse.</p> 139 140 <pre class="prettyprint lang-config"> 141 Alias /image /ftp/pub/image 142 </pre> 143 144 145 <p>Une requ�te pour <code>http://example.com/image/foo.gif</code> fera 146 renvoyer par le serveur le fichier 147 <code>/ftp/pub/image/foo.gif</code>. Seuls les �l�ments de chemin 148 complets sont test�s ; ainsi l'alias pr�c�dent ne conviendra pas 149 pour une requ�te du style <code>http://example.com/imagefoo.gif</code>. 150 Pour des mises en correspondance plus complexes faisant intervenir 151 les expressions rationnelles, veuillez vous reporter � la directive 152 <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>.</p> 153 154 <p>Notez que si vous ajoutez un slash de fin au <var>chemin 155 URL</var>, vous devrez aussi ajouter un slash de fin au chemin de la 156 requ�te. Autrement dit, si vous d�finissez</p> 157 158 <dl><dd><code>Alias /icons/ /usr/local/apache/icons/</code></dd></dl> 159 160 <p>l'alias pr�c�dent ne s'appliquera pas � l'url 161 <code>/icons</code> � cause de l'absence du slash final. Ainsi, si 162 le slash final est absent du <var>chemin de l'URL</var>, il doit 163 aussi l'�tre du <var>chemin du fichier</var>.</p> 164 165 <p>Notez qu'il pourra s'av�rer n�cessaire de d�finir des sections 166 <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> 167 suppl�mentaires qui couvriront la <em>destination</em> des alias. 168 Le traitement des alias intervenant avant le traitement des sections 169 <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, 170 seules les cibles des alias sont affect�es (Notez cependant 171 que les sections <code class="directive"><a href="../mod/core.html#location"><Location></a></code> sont trait�es avant les alias, et 172 s'appliqueront donc).</p> 173 174 <p>En particulier, si vous cr�ez un alias ayant pour cible un 175 r�pertoire situ� en dehors de l'arborescence de votre site web 176 <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, vous devrez 177 probablement permettre explicitement l'acc�s � ce r�pertoire.</p> 178 179 <pre class="prettyprint lang-config"> 180Alias /image /ftp/pub/image 181<Directory /ftp/pub/image> 182 Require all granted 183</Directory> 184 </pre> 185 186 187 <p>Le nombre de slashes dans le param�tre <var>chemin URL</var> doit 188 correspondre au nombre de slashes dans le chemin URL de la requ�te.</p> 189 190 191</div> 192<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 193<div class="directive-section"><h2><a name="AliasMatch" id="AliasMatch">AliasMatch</a> <a name="aliasmatch" id="aliasmatch">Directive</a></h2> 194<table class="directive"> 195<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en correspondance des URLs avec le syst�me de fichiers 196en faisant intervenir les expressions rationnelles</td></tr> 197<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AliasMatch <var>regex</var> 198<var>chemin fichier</var>|<var>chemin r�pertoire</var></code></td></tr> 199<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 200<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 201<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> 202</table> 203 <p>Cette directive est identique � la directive <code class="directive"><a href="#alias">Alias</a></code>, mais fait appel aux <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, � la place d'une 204 simple mise en correspondance de pr�fixe. L'expression rationnelle 205 fournie est mise en correspondance avec le chemin URL, et si elle 206 correspond, le serveur va substituer toute partie de chemin 207 correspondant � l'expression entre parenth�ses dans la cha�ne 208 fournie et l'utiliser comme nom de fichier. 209 Par exemple, pour activer le r�pertoire <code>/icons</code>, on peut 210 utiliser :</p> 211 212 <pre class="prettyprint lang-config"> 213 AliasMatch ^/icons(.*) /usr/local/apache/icons$1 214 </pre> 215 216 217 <p>Toute la puissance des <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions 218 rationnelles</a> peut �tre mise � contribution. Par exemple, 219 il est possible de construire un alias avec un mod�le de chemin URL 220 insensible � la casse :</p> 221 222 <pre class="prettyprint lang-config"> 223 AliasMatch (?i)^/image(.*) /ftp/pub/image$1 224 </pre> 225 226 227 <p>Il existe une diff�rence subtile entre <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> : <code class="directive"><a href="#alias">Alias</a></code> copie automatiquement toute 228 portion suppl�mentaire de l'URI situ�e apr�s la partie du mod�le qui 229 correspond, � la fin du chemin du fichier de la partie droite, alors 230 que <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> ne le fait 231 pas. Cela signifie qu'il sera pr�f�rable dans la plupart des cas de 232 comparer l'expression rationnelle du mod�le � la totalit� de l'URI 233 de la requ�te, et d'utiliser les substitutions dans la partie 234 droite.</p> 235 236 <p>En d'autres termes, le remplacement d'<code class="directive"><a href="#alias">Alias</a></code> par <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> ne produira pas le m�me 237 r�sultat. Au minimum, vous devez ajouter <code>^</code> au d�but de 238 l'expression rationnelle, <code>(.*)$</code> � sa fin et 239 <code>$1</code> � la fin de la cha�ne de remplacement.</p> 240 241 <p>Par exemple, supposons que nous voulions reformuler cet alias 242 avec AliasMatch :</p> 243 244 <pre class="prettyprint lang-config"> 245 Alias /image/ /ftp/pub/image/ 246 </pre> 247 248 249 <p>Le simple remplacement d'Alias par AliasMatch ne produira pas le 250 m�me r�sultat. Ainsi, ce qui suit va rediriger toutes les requ�tes 251 qui contiennent /image/ vers /ftp/pub/image/ :</p> 252 253 <pre class="prettyprint lang-config"> 254 AliasMatch /image/ /ftp/pub/image/ 255 </pre> 256 257 258 <p>Voici la directive AliasMatch qui produira le m�me r�sultat que 259 la directive Alias ci-dessus :</p> 260 261 <pre class="prettyprint lang-config"> 262 AliasMatch ^/image/(.*)$ /ftp/pub/image/$1 263 </pre> 264 265 266 <p>Bien entendu, il n'y a aucune raison d'utiliser <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> dans le cas o� <code class="directive"><a href="#alias">Alias</a></code> suffit. <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> vous permet d'effectuer 267 des choses beaucoup plus sophistiqu�es. Par exemple, vous pouvez 268 servir diff�rentes sortes de fichiers � partir de r�pertoires 269 diff�rents :</p> 270 271 <pre class="prettyprint lang-config"> 272 AliasMatch ^/image/(.*)\.jpg$ /fichiers/jpg.images/$1.jpg<br /> 273 AliasMatch ^/image/(.*)\.gif$ /fichiers/gif.images/$1.gif 274 </pre> 275 276 277 <p>Les �ventuels slashes de t�te multiples seront supprim�s par le 278 serveur avant que les directives de ce module n'effectuent des 279 comparaisons avec le chemin URL de la requ�te. 280 </p> 281 282 283</div> 284<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 285<div class="directive-section"><h2><a name="Redirect" id="Redirect">Redirect</a> <a name="redirect" id="redirect">Directive</a></h2> 286<table class="directive"> 287<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe demandant au client 288d'effectuer une autre requ�te avec une URL diff�rente</td></tr> 289<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Redirect [<var>�tat</var>] <var>chemin URL</var> 290<var>URL</var></code></td></tr> 291<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 292<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 293<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 294<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> 295</table> 296 <p>La directive Redirect permet de faire correspondre une ancienne 297 URL � une nouvelle en demandant au client d'aller chercher la ressource � 298 une autre localisation.</p> 299 300 <p>L'ancien <em>chemin URL</em> est un chemin sensible � la casse 301 (d�cod� � l'aide de caract�res %) commen�ant par un slash. Les 302 chemins relatifs ne sont pas autoris�s.</p> 303 304 <p>La nouvelle <em>URL</em> 305 peut �tre une URL absolue commen�ant par un protocole et un nom 306 d'h�te, mais on peut aussi utiliser un chemin URL commen�ant par un 307 slash, auquel cas le protocole et le nom d'h�te du serveur local 308 seront ajout�s.</p> 309 310 <p>Ensuite, toute requ�te commen�ant par <em>chemin URL</em> va 311 renvoyer une redirection au client vers l'<em>URL</em> cible. Tout 312 �l�ment de chemin suppl�mentaire situ� en aval du <em>chemin 313 URL</em> sera ajout� � l'URL cible.</p> 314 315 <pre class="prettyprint lang-config"> 316# Redirige vers une URL sur un serveur diff�rent 317Redirect /service http://foo2.example.com/service 318 319# Redirige vers une URL sur le m�me serveur 320Redirect /one /two 321 </pre> 322 323 324 <p>Si le client effectue une requ�te pour l'URL 325 <code>http://example.com/service/foo.txt</code>, il lui sera demand� 326 d'en effectuer une autre pour l'URL 327 <code>http://foo2.example.com/service/foo.txt</code>. Ceci concerne 328 les requ�tes avec param�tres <code>GET</code>, comme 329 <code>http://example.com/service/foo.pl?q=23&a=42</code>, qui 330 seront redirig�es vers 331 <code>http://foo2.example.com/service/foo.pl?q=23&a=42</code>. 332 Notez que les <code>POST</code>s seront ignor�s.<br /> 333 Seuls les 334 �l�ments de chemin complets sont test�s, si bien que l'exemple 335 pr�c�dent ne s'appliquera pas � l'URL 336 <code>http://example.com/servicefoo.txt</code>. Pour des mises en 337 correspondance plus complexes faisant intervenir les expressions 338 rationnelles, veuillez vous reporter � la directive <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code>.</p> 339 340 341 <div class="note"><h3>Note</h3> 342 <p>Les directives de redirection ont priorit� sur les directives 343 Alias et ScriptAlias, quel que soit leur ordre d'apparition dans le 344 fichier de configuration.</p></div> 345 346 <p>Si aucun argument <var>�tat</var> n'est sp�cifi�, la 347 redirection sera temporaire (code HTTP 302). Le client est alors 348 inform� que la ressource a �t� temporairement d�plac�e. On peut 349 utiliser l'argument <var>�tat</var> pour renvoyer d'autres codes HTTP :</p> 350 351 <dl> 352 <dt>permanent</dt> 353 354 <dd>Renvoie un code de redirection permanente (301), indiquant 355 que la ressource a �t� d�finitivement d�plac�e.</dd> 356 357 <dt>temp</dt> 358 359 <dd>Renvoie un code de redirection temporaire (302). C'est le 360 comportement par d�faut.</dd> 361 362 <dt>seeother</dt> 363 364 <dd>Renvoie un code "See Other" (303) indiquant que la ressource 365 a �t� remplac�e par une autre.</dd> 366 367 <dt>gone</dt> 368 369 <dd>Renvoie un code "Gone" (410) indiquant que la ressource a 370 �t� d�finitivement supprim�e. Lorsque 371 ce code est utilis�, on ne 372 doit pas utiliser l'argument <var>URL</var>.</dd> 373 </dl> 374 375 <p>On peut renvoyer d'autres codes en sp�cifiant le code 376 num�rique comme valeur de l'argument of <var>�tat</var>. 377 Si le code est compris entre 300 et 399, l'argument 378 <var>URL</var> doit �tre pr�sent. Si le code 379 n'est <em>pas</em> compris entre 300 et 399, l'argument 380 <var>URL</var> ne doit pas appara�tre. Le code doit �tre un code 381 HTTP valide, connu du serveur HTTP Apache (voir la 382 fonction <code>send_error_response</code> dans 383 http_protocol.c).</p> 384 385 <pre class="prettyprint lang-config"> 386Redirect permanent /one http://example.com/two 387Redirect 303 /three http://example.com/other 388 </pre> 389 390 391 392</div> 393<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 394<div class="directive-section"><h2><a name="RedirectMatch" id="RedirectMatch">RedirectMatch</a> <a name="redirectmatch" id="redirectmatch">Directive</a></h2> 395<table class="directive"> 396<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe faisant appel aux 397expressions rationnelles pour la mise en correspondance de l'URL 398courante</td></tr> 399<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectMatch [<var>�tat</var>] <var>regex</var> 400<var>URL</var></code></td></tr> 401<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 402<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 403<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 404<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> 405</table> 406 <p>Cette directive est identique � la directive <code class="directive"><a href="#redirect">Redirect</a></code>, mais fait appel aux 407 <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, � la 408 place d'une simple mise en correspondance de pr�fixe. L'expression 409 rationnelle fournie est mise en correspondance avec le chemin URL, 410 et si elle correspond, le serveur va substituer toute partie de 411 chemin correspondante entre parenth�ses dans la cha�ne sp�cifi�e et 412 l'utiliser comme nom de fichier. Par exemple, pour rediriger tous 413 les fichiers GIF vers les fichiers JPEG de m�me nom sur un autre 414 serveur, on peut utiliser :</p> 415 416 <pre class="prettyprint lang-config"> 417 RedirectMatch (.*)\.gif$ http://autre.example.com$1.jpg 418 </pre> 419 420 421 <p>Les remarques � propos de la diff�rence entre <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> s'appliquent aussi � la 422 diff�rence entre les directives <code class="directive"><a href="#redirect">Redirect</a></code> et <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code>. Voir la directive 423 <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> pour plus de 424 d�tails.</p> 425 426 427</div> 428<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 429<div class="directive-section"><h2><a name="RedirectPermanent" id="RedirectPermanent">RedirectPermanent</a> <a name="redirectpermanent" id="redirectpermanent">Directive</a></h2> 430<table class="directive"> 431<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe permanente demandant au 432client d'effectuer une nouvelle requ�te avec une URL 433diff�rente</td></tr> 434<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectPermanent <var>chemin URL</var> <var>URL</var></code></td></tr> 435<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 436<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 437<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 438<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> 439</table> 440 <p>Cette directive informe le client que la redirection est 441 permanente (code 301). Son comportement est exactement le m�me 442 que celui de <code>Redirect permanent</code>.</p> 443 444</div> 445<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 446<div class="directive-section"><h2><a name="RedirectTemp" id="RedirectTemp">RedirectTemp</a> <a name="redirecttemp" id="redirecttemp">Directive</a></h2> 447<table class="directive"> 448<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe temporaire demandant au 449client d'effectuer une nouvelle requ�te avec une URL 450diff�rente</td></tr> 451<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectTemp <var>chemin URL</var> <var>URL</var></code></td></tr> 452<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 453<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr> 454<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 455<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> 456</table> 457 <p>Cette directive informe le client que la redirection n'est 458 que temporaire (code 302). Son comportement est exactement le m�me 459 que celui de <code>Redirect temp</code>.</p> 460 461</div> 462<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 463<div class="directive-section"><h2><a name="ScriptAlias" id="ScriptAlias">ScriptAlias</a> <a name="scriptalias" id="scriptalias">Directive</a></h2> 464<table class="directive"> 465<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre une URL � une zone du syst�me de fichiers 466et d�signe la cible comme script CGI</td></tr> 467<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAlias <var>chemin URL</var> 468<var>chemin fichier</var>|<var>chemin r�pertoire</var></code></td></tr> 469<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 470<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 471<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> 472</table> 473 <p>La directive <code class="directive">ScriptAlias</code> pr�sente le m�me 474 comportement que la directive <code class="directive"><a href="#alias">Alias</a></code>, mais d�signe en plus le 475 r�pertoire cible comme conteneur de scripts CGI qui seront trait�es 476 par le gestionnaire cgi-script du module <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>. 477 Les URLs dont le chemin URL sensible � la casse (d�cod� avec 478 caract�res %) commence par <var>chemin URL</var> seront mises en 479 correspondance avec les scripts dont le chemin commence par le 480 second argument, qui est un chemin complet dans le syst�me de 481 fichiers local.</p> 482 483 <pre class="prettyprint lang-config"> 484 ScriptAlias /cgi-bin/ /web/cgi-bin/ 485 </pre> 486 487 488 <p>Une requ�te pour <code>http://example.com/cgi-bin/foo</code> 489 ferait ex�cuter par le serveur le script 490 <code>/web/cgi-bin/foo</code>. Cette configuration est sensiblement 491 �quivalente � :</p> 492 <pre class="prettyprint lang-config"> 493Alias /cgi-bin/ /web/cgi-bin/ 494<Location /cgi-bin > 495 SetHandler cgi-script 496 Options +ExecCGI 497</Location> 498 </pre> 499 500 501 <p>Vous pouvez aussi utiliser <code class="directive">ScriptAlias</code> 502 avec un script ou gestionnaire de votre cru. Par exemple :</p> 503 504 <pre class="prettyprint lang-config"> 505 ScriptAlias /cgi-bin/ /web/cgi-handler.pl 506 </pre> 507 508 509 <p>Dans ce sc�nario, tous les fichiers faisant l'objet d'une requ�te 510 dans <code>/cgi-bin/</code> seront trait�s par le fichier que vous 511 avez sp�cifi�, ce qui vous permet d'utiliser votre propre 512 gestionnaire. Vous pouvez l'utiliser comme enveloppe (wrapper) pour 513 les scripts CGI afin d'ajouter du contenu, ou autre action "maison".</p> 514 515 <div class="warning">Il est pr�f�rable d'�viter de placer les 516 scripts CGI dans l'arborescence de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> afin d'�viter de r�v�ler 517 accidentellement leur code source lors d'une modification de 518 configuration. On y parvient ais�ment avec 519 <code class="directive">ScriptAlias</code> en mettant en correspondance une 520 URL et en d�signant la cible comme scripts CGI par la m�me occasion. 521 Si vous choisissez de placer vos scripts CGI dans un r�pertoire 522 accessible depuis le web, n'utilisez pas 523 <code class="directive">ScriptAlias</code>. Utilisez plut�t <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>, et <code class="directive"><a href="../mod/core.html#options">Options</a></code> comme dans l'exemple suivant : 524 <pre class="prettyprint lang-config"> 525<Directory /usr/local/apache2/htdocs/cgi-bin > 526 SetHandler cgi-script 527 Options ExecCGI 528</Directory> 529 </pre> 530 531 Ceci est n�cessaire car plusieurs <var>chemins URL</var> peuvent 532 correspondre � la m�me zone du syst�me de fichiers, court-circuitant 533 ainsi la directive <code class="directive">ScriptAlias</code> et r�v�lant le 534 code source des scripts CGI s'ils ne sont pas prot�g�s par une 535 section <code class="directive"><a href="../mod/core.html#directory">Directory</a></code>.</div> 536 537 538<h3>Voir aussi</h3> 539<ul> 540<li><a href="../howto/cgi.html">Tutoriel CGI</a></li> 541</ul> 542</div> 543<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> 544<div class="directive-section"><h2><a name="ScriptAliasMatch" id="ScriptAliasMatch">ScriptAliasMatch</a> <a name="scriptaliasmatch" id="scriptaliasmatch">Directive</a></h2> 545<table class="directive"> 546<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre une URL � une zone du syst�me de fichiers 547en faisant appel aux expressions rationnelles et en d�signant la cible 548comme un script CGI</td></tr> 549<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAliasMatch <var>regex</var> 550<var>chemin fichier</var>|<var>chemin r�pertoire</var></code></td></tr> 551<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> 552<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 553<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> 554</table> 555 <p>Cette directive est �quivalente � la directive <code class="directive"><a href="#scriptalias">ScriptAlias</a></code>, mais fait appel aux 556 <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, � la 557 place d'une simple mise en correspondance de pr�fixe. L'expression 558 rationnelle fournie est mise en correspondance avec le chemin URL, 559 et si elle correspond, le serveur va substituer toute partie de 560 chemin entre parenth�ses dans la cha�ne sp�cifi�e et l'utiliser 561 comme nom de fichier. Par exemple, pour activer le r�pertoire 562 standard <code>/cgi-bin</code>, on peut utiliser :</p> 563 564 <pre class="prettyprint lang-config"> 565 ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1 566 </pre> 567 568 569 <p>Comme dans le cas d'AliasMatch, toute la puissance des <a class="glossarylink" href="../glossary.html#rexex" title="voir glossaire">expressions rationnelles</a> peut �tre mise � 570 contribution. Par exemple, il est possible de construire un alias 571 avec une comparaison du mod�le du chemin URL insensible � la casse :</p> 572 573 <pre class="prettyprint lang-config"> 574 ScriptAliasMatch (?i)^/cgi-bin(.*) /usr/local/apache/cgi-bin$1 575 </pre> 576 577 578 <p>Les remarques � propos de la diff�rence entre <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> s'appliquent aussi � la 579 diff�rence entre les directives <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> et <code class="directive"><a href="#scriptaliasmatch">ScriptAliasMatch</a></code>. Voir la directive 580 <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> pour plus de 581 d�tails.</p> 582 583 584</div> 585</div> 586<div class="bottomlang"> 587<p><span>Langues Disponibles: </span><a href="../en/mod/mod_alias.html" hreflang="en" rel="alternate" title="English"> en </a> | 588<a href="../fr/mod/mod_alias.html" title="Fran�ais"> fr </a> | 589<a href="../ja/mod/mod_alias.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 590<a href="../ko/mod/mod_alias.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 591<a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 592</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> 593<script type="text/javascript"><!--//--><![CDATA[//><!-- 594var comments_shortname = 'httpd'; 595var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_alias.html'; 596(function(w, d) { 597 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 598 d.write('<div id="comments_thread"><\/div>'); 599 var s = d.createElement('script'); 600 s.type = 'text/javascript'; 601 s.async = true; 602 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 603 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 604 } 605 else { 606 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 607 } 608})(window, document); 609//--><!]]></script></div><div id="footer"> 610<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 611<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[//><!-- 612if (typeof(prettyPrint) !== 'undefined') { 613 prettyPrint(); 614} 615//--><!]]></script> 616</body></html>