granicus.if.org Git - apache/blob - docs/manual/mod/mod_alias.xml.fr

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision : 1042758 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <modulesynopsis metafile="mod_alias.xml.meta">
  26
  27 <name>mod_alias</name>
  28 <description>Permet d'atteindre différentes parties du système de
  29 fichiers depuis l'arborescence des documents du site web, ainsi que la
  30 redirection d'URL</description>
  31 <status>Base</status>
  32 <sourcefile>mod_alias.c</sourcefile>
  33 <identifier>alias_module</identifier>
  34
  35 <summary>
  36     <p>Les directives fournies par ce module permettent de manipuler et
  37     de contrôler les URLs à l'arrivée des requêtes sur le serveur. Les
  38     directives <directive module="mod_alias">Alias</directive> et
  39     <directive module="mod_alias">ScriptAlias</directive> permettent de
  40     faire correspondre des URLs avec des chemins du système de fichiers.
  41     Ceci permet de servir des contenus qui ne sont pas situés dans
  42     l'arborescence de <directive
  43     module="core">DocumentRoot</directive> comme s'ils y étaient
  44     réellement. La directive <directive
  45     module="mod_alias">ScriptAlias</directive> a pour effet
  46     supplémentaire de marquer le répertoire cible comme conteneur de
  47     scripts CGI.</p>
  48
  49     <p>Les directives <directive module="mod_alias">Redirect</directive>
  50     indiquent aux clients qu'ils doivent effectuer une nouvelle requête
  51     avec une URL différente. Elles sont souvent utilisées lorsqu'une
  52     ressource a été déplacée.</p>
  53
  54     <p><module>mod_alias</module> est conçu pour traiter des tâches
  55     simples de manipulation d'URL. Pour des tâches plus complexes comme
  56     la manipulation des chaînes d'arguments des requêtes, utilisez
  57     plutôt les outils fournis par le module <module>mod_rewrite</module></p>
  58
  59 </summary>
  60
  61 <seealso><module>mod_rewrite</module></seealso> <seealso><a
  62 href="../urlmapping.html">Mise en correspondance des URLs avec le
  63 système de fichiers</a></seealso>
  64
  65 <section id="order"><title>Chronologie du traitement</title>
  66
  67     <p>Les alias et redirections apparaissant dans différents contextes
  68     sont traités comme les autres directives en respectant les <a
  69     href="../sections.html#mergin">règles de fusion</a> standards. Par
  70     contre, ils sont traités selon une chronologie particulière
  71     lorsqu'ils apparaissent dans le même contexte (par exemple, dans la
  72     même section <directive type="section"
  73     module="core">VirtualHost</directive>).</p>
  74
  75     <p>Premièrement, toutes les redirections sont traitées avant les
  76     alias, et ainsi, une requête qui correspond à une directive
  77     <directive module="mod_alias">Redirect</directive> ou <directive
  78     module="mod_alias">RedirectMatch</directive> ne se verra jamais
  79     appliquer d'alias. Deuxièmement, les alias et redirections sont
  80     traités selon l'ordre dans lequel ils apparaissent dans le fichier
  81     de configuration, seule la première correspondance étant prise en
  82     compte.</p>
  83
  84     <p>Ainsi, lorsqu'une ou plusieurs de ces directives s'appliquent au
  85     même sous-répertoire, vous devez classer les chemins du plus précis
  86     au moins précis afin que toutes les directives puissent
  87     éventuellement s'appliquer, comme dans l'exemple suivant :</p>
  88
  89     <example>
  90     Alias /foo/bar /baz<br />
  91     Alias /foo /gaq
  92     </example>
  93
  94     <p>Si l'ordre des directives était inversé, la directive <directive
  95     module="mod_alias">Alias</directive> ayant pour argument
  96     <code>/foo</code> serait toujours appliquée avant la directive
  97     <directive module="mod_alias">Alias</directive> ayant pour argument
  98     <code>/foo/bar</code>, et cette dernière serait toujours
  99     ignorée.</p>
 100
 101 </section>
 102
 103 <directivesynopsis>
 104 <name>Alias</name>
 105 <description>Met en correspondance des URLs avec des chemins du système
 106 de fichiers</description>
 107 <syntax>Alias <var>chemin URL</var>
 108 <var>chemin fichier</var>|<var>chemin répertoire</var></syntax>
 109 <contextlist><context>server config</context><context>virtual host</context>
 110 </contextlist>
 111
 112 <usage>
 113
 114     <p>La directive <directive>Alias</directive> permet de stocker des
 115     documents (destinés à être servis) dans des zones du système de
 116     fichiers situées en dehors de l'arborescence du site web <directive
 117     module="core">DocumentRoot</directive>. Les URLs dont le chemin
 118     (décodé avec caractères %) commence par <var>chemin URL</var> seront
 119     mises en correspondance avec des fichiers locaux dont le chemin
 120     commence par <var>chemin répertoire</var>. Le <var>chemin URL</var>
 121     est sensible à la casse, même sur les systèmes de fichiers
 122     insensibles à la casse.</p>
 123
 124     <example><title>Exemple :</title>
 125       Alias /image /ftp/pub/image
 126     </example>
 127
 128     <p>Une requête pour <code>http://myserver/image/foo.gif</code> fera
 129     renvoyer par le serveur le fichier
 130     <code>/ftp/pub/image/foo.gif</code>. Seuls les éléments de chemin
 131     complets sont testés ; ainsi l'alias précédent ne conviendra pas
 132     pour une requête du style <code>http://myserver/imagefoo.gif</code>.
 133     Pour des mises en correspondance plus complexes faisant intervenir
 134     les expressions rationnelles, veuillez vous reporter à la directive
 135     <directive module="mod_alias">AliasMatch</directive>.</p>
 136
 137     <p>Notez que si vous ajoutez un slash de fin au <var>chemin
 138     URL</var>, vous devrez aussi ajouter un slash de fin au chemin de la
 139     requête. Autrement dit, si vous définissez</p>
 140
 141     <dl><dd><code>Alias /icons/ /usr/local/apache/icons/</code></dd></dl>
 142
 143     <p>l'alias précédent ne s'appliquera pas à l'url
 144     <code>/icons</code>.</p>
 145
 146     <p>Notez qu'il pourra s'avérer nécessaire de définir des sections
 147     <directive type="section" module="core">Directory</directive>
 148     supplémentaires qui couvriront la  <em>destination</em> des alias.
 149     Le traitement des alias intervenant avant le traitement des sections
 150     <directive type="section" module="core">Directory</directive>,
 151     seules les cibles des alias sont affectées (Notez cependant
 152     que les sections <directive type="section"
 153     module="core">Location</directive> sont traitées avant les alias, et
 154     s'appliqueront donc).</p>
 155
 156     <p>En particulier, si vous créez un alias ayant pour cible un
 157     répertoire situé en dehors de l'arborescence de votre site web
 158     <directive module="core">DocumentRoot</directive>, vous devrez
 159     probablement permettre explicitement l'accès à ce répertoire.</p>
 160
 161     <example><title>Exemple :</title>
 162         Alias /image /ftp/pub/image<br />
 163         &lt;Directory /ftp/pub/image&gt;<br />
 164         <indent>
 165             Require all granted<br />
 166         </indent>
 167         &lt;/Directory&gt;
 168     </example>
 169
 170 </usage>
 171 </directivesynopsis>
 172
 173 <directivesynopsis>
 174 <name>AliasMatch</name>
 175 <description>Met en correspondance des URLs avec le système de fichiers
 176 en faisant intervenir les expressions rationnelles</description>
 177 <syntax>AliasMatch <var>regex</var>
 178 <var>chemin fichier</var>|<var>chemin répertoire</var></syntax>
 179 <contextlist><context>server config</context><context>virtual host</context>
 180 </contextlist>
 181
 182 <usage>
 183     <p>Cette directive est identique à la directive <directive
 184     module="mod_alias">Alias</directive>, mais fait appel aux <glossary
 185     ref="regex">expressions rationnelles</glossary>, à la place d'une
 186     simple mise en correspondance de préfixe. L'expression rationnelle
 187     fournie est mise en correspondance avec le chemin URL, et si elle
 188     correspond, le serveur va substituer toute partie de chemin
 189     correspondant à l'expression entre parenthèses dans la chaîne
 190     fournie et l'utiliser comme nom de fichier.
 191     Par exemple, pour activer le répertoire <code>/icons</code>, on peut
 192     utiliser :</p>
 193
 194     <example>
 195       AliasMatch ^/icons(.*) /usr/local/apache/icons$1
 196     </example>
 197
 198     <p>Toute la puissance des <glossary ref="regex">expressions
 199     rationnelles</glossary> peut être mise à contribution. Par exemple,
 200     il est possible de construire un alias avec un modèle de chemin URL
 201     insensible à la casse :</p>
 202
 203     <example>
 204       AliasMatch (?i)^/image(.*) /ftp/pub/image$1
 205     </example>
 206
 207     <p>Il existe une différence subtile entre <directive
 208     module="mod_alias">Alias</directive> et <directive
 209     module="mod_alias">AliasMatch</directive> : <directive
 210     module="mod_alias">Alias</directive> copie automatiquement toute
 211     portion supplémentaire de l'URI située après la partie du modèle qui
 212     correspond, à la fin du chemin du fichier de la partie droite, alors
 213     que <directive module="mod_alias">AliasMatch</directive> ne le fait
 214     pas. Cela signifie qu'il sera préférable dans la plupart des cas de
 215     comparer l'expression rationnelle du modèle à la totalité de l'URI
 216     de la requête, et d'utiliser les substitutions dans la partie
 217     droite.</p>
 218
 219     <p>En d'autres termes, le remplacement d'<directive
 220     module="mod_alias">Alias</directive> par <directive
 221     module="mod_alias">AliasMatch</directive> ne produira pas le même
 222     résultat. Au minimum, vous devez ajouter <code>^</code> au début de
 223     l'expression rationnelle, <code>(.*)$</code> à sa fin et
 224     <code>$1</code> à la fin de la chaîne de remplacement.</p>
 225
 226     <p>Par exemple, supposons que nous voulions reformuler cet alias
 227     avec AliasMatch :</p>
 228
 229     <example>
 230       Alias /image/ /ftp/pub/image/
 231     </example>
 232
 233     <p>Le simple remplacement d'Alias par AliasMatch ne produira pas le
 234     même résultat. Ainsi, ce qui suit va rediriger toutes les requêtes
 235     qui contiennent /image/ vers /ftp/pub/image/ :</p>
 236
 237     <example>
 238       AliasMatch /image/ /ftp/pub/image/
 239     </example>
 240
 241     <p>Voici la directive AliasMatch qui produira le même résultat que
 242     la directive Alias ci-dessus :</p>
 243
 244     <example>
 245       AliasMatch ^/image/(.*)$ /ftp/pub/image/$1
 246     </example>
 247
 248     <p>Bien entendu, il n'y a aucune raison d'utiliser <directive
 249     module="mod_alias">AliasMatch</directive> dans le cas où <directive
 250     module="mod_alias">Alias</directive> suffit. <directive
 251     module="mod_alias">AliasMatch</directive> 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     <example>
 257       AliasMatch ^/image/(.*)\.jpg$ /fichiers/jpg.images/$1.jpg<br/>
 258       AliasMatch ^/image/(.*)\.gif$ /fichiers/gif.images/$1.gif
 259     </example>
 260
 261 </usage>
 262 </directivesynopsis>
 263
 264 <directivesynopsis>
 265 <name>Redirect</name>
 266 <description>Envoie une redirection externe demandant au client
 267 d'effectuer une autre requête avec une URL différente</description>
 268 <syntax>Redirect [<var>statut</var>] <var>chemin URL</var>
 269 <var>URL</var></syntax>
 270 <contextlist><context>server config</context><context>virtual host</context>
 271 <context>directory</context><context>.htaccess</context></contextlist>
 272 <override>FileInfo</override>
 273
 274 <usage>
 275     <p>La directive Redirect permet de faire correspondre une ancienne
 276     URL à une nouvelle en demandant au client d'aller chercher la ressource à
 277     une autre localisation.</p>
 278
 279     <p>L'ancien <em>chemin URL</em> est un chemin sensible à la casse
 280     (décodé à l'aide de caractères %) commençant par un slash. Les
 281     chemins relatifs ne sont pas autorisés.</p>
 282
 283     <p>La nouvelle <em>URL</em>
 284     peut être une URL absolue commençant par un protocole et un nom
 285     d'hôte, mais on peut aussi utiliser un chemin URL commençant par un
 286     slash, auquel cas le protocole et le nom d'hôte du serveur local
 287     seront ajoutés.</p>
 288
 289     <p>Ensuite, toute requête commençant par <em>chemin URL</em> va
 290     renvoyer une redirection au client vers l'<em>URL</em> cible. Tout
 291     élément de chemin supplémentaire situé en aval du <em>chemin
 292     URL</em> sera ajouté à l'URL cible.</p>
 293
 294     <example><title>Exemple :</title>
 295       # Redirige vers une URL sur un serveur différent<br />
 296       Redirect /service http://foo2.example.com/service<br />
 297       <br />
 298       # Redirige vers une URL sur le même serveur<br />
 299       Redirect /one /two
 300     </example>
 301
 302     <p>Si le client effectue une requête pour l'URL
 303     <code>http://example.com/service/foo.txt</code>, il lui sera demandé
 304     d'en effectuer une autre pour l'URL
 305     <code>http://foo2.example.com/service/foo.txt</code>. Ceci concerne
 306     les requêtes avec paramètres <code>GET</code>, comme
 307     <code>http://example.com/service/foo.pl?q=23&amp;a=42</code>, qui
 308     seront redirigées vers
 309     <code>http://foo2.example.com/service/foo.pl?q=23&amp;a=42</code>.
 310     Notez que les <code>POST</code>s seront ignorés.<br />
 311     Seuls les
 312     éléments de chemin complets sont testés, si bien que l'exemple
 313     précédent ne s'appliquera pas à l'URL
 314     <code>http://example.com/servicefoo.txt</code>. Pour des mises en
 315     correspondance plus complexes faisant intervenir les expressions
 316     rationnelles, veuillez vous reporter à la directive <directive
 317     module="mod_alias">RedirectMatch</directive>.</p>
 318
 319
 320     <note><title>Note</title>
 321     <p>Les directives de redirection ont priorité sur les directives
 322     Alias et ScriptAlias, quel que soit leur ordre d'apparition dans le
 323     fichier de configuration.</p></note>
 324
 325     <p>Si aucun argument <var>statut</var> n'est spécifié, la
 326     redirection sera temporaire (statut HTTP 302). Le client est alors
 327     informé que la ressource a été temporairement déplacée. On peut
 328     utiliser l'argument <var>statut</var> pour renvoyer d'autres codes
 329     de statut HTTP :</p>
 330
 331     <dl>
 332       <dt>permanent</dt>
 333
 334       <dd>Renvoie un statut de redirection permanente (301), indiquant
 335       que la ressource a été définitivement déplacée.</dd>
 336
 337       <dt>temp</dt>
 338
 339       <dd>Renvoie un statut de redirection temporaire (302). C'est le
 340       comportement par défaut.</dd>
 341
 342       <dt>seeother</dt>
 343
 344       <dd>Renvoie un statut "See Other" (303) indiquant que la ressource
 345       a été remplacée par une autre.</dd>
 346
 347       <dt>gone</dt>
 348
 349       <dd>Renvoie un statut "Gone" (410) indiquant que la ressource a
 350       été définitivement supprimée. Lorsque ce statut est défini, on ne
 351       doit pas utiliser l'argument <var>URL</var>.</dd>
 352     </dl>
 353
 354     <p>On peut renvoyer d'autres codes de statut en spécifiant le code
 355     de statut numérique comme valeur de l'argument of <var>statut</var>.
 356     Si le code de statut est compris entre 300 et 399, l'argument
 357     <var>URL</var> doit être présent, sinon il ne doit pas être utilisé.
 358     Notez que le statut doit être connu du code d'Apache (voir la
 359     fonction <code>send_error_response</code> dans
 360     http_protocol.c).</p>
 361
 362     <example><title>Exemple :</title>
 363       Redirect permanent /un http://example.com/deux<br />
 364       Redirect 303 /trois http://example.com/autre
 365     </example>
 366
 367 </usage>
 368 </directivesynopsis>
 369
 370 <directivesynopsis>
 371 <name>RedirectMatch</name>
 372 <description>Envoie une redirection externe faisant appel aux
 373 expressions rationnelles pour la mise en correspondance de l'URL
 374 courante</description>
 375 <syntax>RedirectMatch [<var>statut</var>] <var>regex</var>
 376 <var>URL</var></syntax>
 377 <contextlist><context>server config</context><context>virtual host</context>
 378 <context>directory</context><context>.htaccess</context></contextlist>
 379 <override>FileInfo</override>
 380
 381 <usage>
 382     <p>Cette directive est identique à la directive <directive
 383     module="mod_alias">Redirect</directive>, mais fait appel aux
 384     <glossary ref="regex">expressions rationnelles</glossary>, à la
 385     place d'une simple mise en correspondance de préfixe. L'expression
 386     rationnelle fournie est mise en correspondance avec le chemin URL,
 387     et si elle correspond, le serveur va substituer toute partie de
 388     chemin correspondante entre parenthèses dans la chaîne spécifiée et
 389     l'utiliser comme nom de fichier. Par exemple, pour rediriger tous
 390     les fichiers GIF vers les fichiers JPEG de même nom sur un autre
 391     serveur, on peut utiliser :</p>
 392
 393     <example>
 394       RedirectMatch (.*)\.gif$ http://autre.example.com$1.jpg
 395     </example>
 396
 397     <p>Les remarques à propos de la différence entre <directive
 398     module="mod_alias">Alias</directive> et <directive
 399     module="mod_alias">AliasMatch</directive> s'appliquent aussi à la
 400     différence entre les directives <directive
 401     module="mod_alias">Redirect</directive> et <directive
 402     module="mod_alias">RedirectMatch</directive>. Voir la directive
 403     <directive module="mod_alias">AliasMatch</directive> pour plus de
 404     détails.</p>
 405
 406 </usage>
 407 </directivesynopsis>
 408
 409 <directivesynopsis>
 410 <name>RedirectTemp</name>
 411 <description>Envoie une redirection externe temporaire demandant au
 412 client d'effectuer une nouvelle requête avec une URL
 413 différente</description>
 414 <syntax>RedirectTemp <var>chemin URL</var> <var>URL</var></syntax>
 415 <contextlist><context>server config</context><context>virtual host</context>
 416 <context>directory</context><context>.htaccess</context></contextlist>
 417 <override>FileInfo</override>
 418
 419 <usage>
 420     <p>Cette directive informe le client que la redirection n'est
 421     que temporaire (statut 302). Son comportement est exactement le même
 422     que celui de <code>Redirect temp</code>.</p>
 423 </usage>
 424 </directivesynopsis>
 425
 426 <directivesynopsis>
 427 <name>RedirectPermanent</name>
 428 <description>Envoie une redirection externe permanente demandant au
 429 client d'effectuer une nouvelle requête avec une URL
 430 différente</description>
 431 <syntax>RedirectPermanent <var>chemin URL</var> <var>URL</var></syntax>
 432 <contextlist><context>server config</context><context>virtual host</context>
 433 <context>directory</context><context>.htaccess</context></contextlist>
 434 <override>FileInfo</override>
 435
 436 <usage>
 437     <p>Cette directive informe le client que la redirection est
 438     permanente (statut 301). Son comportement est exactement le même
 439     que celui de <code>Redirect permanent</code>.</p>
 440 </usage>
 441 </directivesynopsis>
 442
 443 <directivesynopsis>
 444 <name>ScriptAlias</name>
 445 <description>Fait correspondre une URL à une zone du système de fichiers
 446 et désigne la cible comme script CGI</description>
 447 <syntax>ScriptAlias <var>chemin URL</var>
 448 <var>chemin fichier</var>|<var>chemin répertoire</var></syntax>
 449 <contextlist><context>server config</context><context>virtual host</context>
 450 </contextlist>
 451
 452 <usage>
 453     <p>La directive <directive>ScriptAlias</directive> présente le même
 454     comportement que la directive <directive
 455     module="mod_alias">Alias</directive>, mais désigne en plus le
 456     répertoire cible comme conteneur de scripts CGI qui seront traitées
 457     par le gestionnaire cgi-script du module <module>mod_cgi</module>.
 458     Les URLs dont le chemin URL sensible à la casse (décodé avec
 459     caractères %) commence par <var>chemin URL</var> seront mises en
 460     correspondance avec les scripts dont le chemin commence par le
 461     second argument, qui est un chemin complet dans le système de
 462     fichiers local.</p>
 463
 464     <example><title>Exemple :</title>
 465       ScriptAlias /cgi-bin/ /web/cgi-bin/
 466     </example>
 467
 468     <p>Une requête pour <code>http://mon-serveur/cgi-bin/foo</code>
 469     ferait exécuter par le serveur le script
 470     <code>/web/cgi-bin/foo</code>. Cette configuration est sensiblement
 471     équivalente à :</p>
 472     <example>
 473       Alias /cgi-bin/ /web/cgi-bin/<br />
 474       &lt;Location /cgi-bin &gt;<br />
 475       <indent>
 476       SetHandler cgi-script<br />
 477       Options +ExecCGI<br />
 478       </indent>
 479       &lt;/Location&gt;
 480     </example>
 481
 482         <p>Vous pouvez aussi utiliser <directive>ScriptAlias</directive>
 483         avec un script ou gestionnaire de votre cru. Par exemple :</p>
 484
 485         <example>
 486           ScriptAlias /cgi-bin/ /web/cgi-handler.pl
 487     </example>
 488
 489     <p>Dans ce scénario, tous les fichiers faisant l'objet d'une requête
 490     dans <code>/cgi-bin/</code> seront traités par le fichier que vous
 491     avez spécifié, ce qui vous permet d'utiliser votre propre
 492     gestionnaire. Vous pouvez l'utiliser comme enveloppe (wrapper) pour
 493     les scripts CGI afin d'ajouter du contenu, ou autre action "maison".</p>
 494
 495     <note type="warning">Il est préférable d'éviter de placer les
 496     scripts CGI dans l'arborescence de <directive
 497     module="core">DocumentRoot</directive> afin d'éviter de révéler
 498     accidentellement leur code source lors d'une modification de
 499     configuration. On y parvient aisément avec
 500     <directive>ScriptAlias</directive> en mettant en correspondance une
 501     URL et en désignant la cible comme scripts CGI par la même occasion.
 502     Si vous choisissez de placer vos scripts CGI dans un répertoire
 503     accessible depuis le web, n'utilisez pas
 504     <directive>ScriptAlias</directive>. Utilisez plutôt <directive
 505     module="core" type="section">Directory</directive>, <directive
 506     module="core">SetHandler</directive>, et <directive
 507     module="core">Options</directive> comme dans l'exemple suivant :
 508     <example>
 509       &lt;Directory /usr/local/apache2/htdocs/cgi-bin &gt;<br />
 510       <indent>
 511       SetHandler cgi-script<br />
 512       Options ExecCGI<br />
 513       </indent>
 514       &lt;/Directory&gt;
 515     </example>
 516     Ceci est nécessaire car plusieurs <var>chemins URL</var> peuvent
 517     correspondre à la même zone du système de fichiers, court-circuitant
 518     ainsi la directive <directive>ScriptAlias</directive> et révélant le
 519     code source des scripts CGI s'ils ne sont pas protégés par une
 520     section <directive module="core">Directory</directive>.</note>
 521
 522 </usage>
 523 <seealso><a href="../howto/cgi.html">Tutoriel CGI</a></seealso>
 524 </directivesynopsis>
 525
 526 <directivesynopsis>
 527 <name>ScriptAliasMatch</name>
 528 <description>Fait correspondre une URL à une zone du système de fichiers
 529 en faisant appel aux expressions rationnelles et en désignant la cible
 530 comme un script CGI</description>
 531 <syntax>ScriptAliasMatch <var>regex</var>
 532 <var>chemin fichier</var>|<var>chemin répertoire</var></syntax>
 533 <contextlist><context>server config</context><context>virtual host</context>
 534 </contextlist>
 535
 536 <usage>
 537     <p>Cette directive est équivalente à la directive <directive
 538     module="mod_alias">ScriptAlias</directive>, mais fait appel aux
 539     <glossary ref="regex">expressions rationnelles</glossary>, à la
 540     place d'une simple mise en correspondance de préfixe. L'expression
 541     rationnelle fournie est mise en correspondance avec le chemin URL,
 542     et si elle correspond, le serveur va substituer toute partie de
 543     chemin entre parenthèses dans la chaîne spécifiée et l'utiliser
 544     comme nom de fichier. Par exemple, pour activer le répertoire
 545     standard <code>/cgi-bin</code>, on peut utiliser :</p>
 546
 547     <example>
 548       ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1
 549     </example>
 550
 551     <p>Comme dans le cas d'AliasMatch, toute la puissance des <glossary
 552     ref="rexex">expressions rationnelles</glossary> peut être mise à
 553     contribution. Par exemple, il est possible de construire un alias
 554     avec une comparaison du modèle du chemin URL insensible à la casse :</p>
 555
 556     <example>
 557       ScriptAliasMatch (?i)^/cgi-bin(.*) /usr/local/apache/cgi-bin$1
 558     </example>
 559
 560     <p>Les remarques à propos de la différence entre <directive
 561     module="mod_alias">Alias</directive> et <directive
 562     module="mod_alias">AliasMatch</directive> s'appliquent aussi à la
 563     différence entre les directives <directive
 564     module="mod_alias">ScriptAlias</directive> et <directive
 565     module="mod_alias">ScriptAliasMatch</directive>. Voir la directive
 566     <directive module="mod_alias">AliasMatch</directive> pour plus de
 567     détails.</p>
 568
 569 </usage>
 570 </directivesynopsis>
 571
 572 </modulesynopsis>