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