www/apache
1
0
Fork 0
mirror of https://github.com/apache/httpd.git synced 2025-11-03 17:53:20 +03:00
Code Activity
Files
b18fa49a7536b1ee88a8e63f3c58849e21c8e4f9
apache/docs/manual/mod/mod_alias.html.fr
Rich Bowen dd8bdc09d2 ye gods what have I done 
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1447971 13f79535-47bb-0310-9956-ffa450edef68
2013-02-19 23:48:41 +00:00

616 lines
35 KiB
Plaintext
Raw Blame History

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_alias - Serveur Apache HTTP</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<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" />
<script src="../style/scripts/prettify.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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>
<p class="apache">Serveur Apache HTTP Version 2.5</p>
<img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_alias</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_alias.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_alias.html" title="Fran<61>ais">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/mod_alias.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/mod/mod_alias.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="T<>rk<72>e">&nbsp;tr&nbsp;</a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Permet d'atteindre diff<66>rentes parties du syst<73>me de
fichiers depuis l'arborescence des documents du site web, ainsi que la
redirection d'URL</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur<75>de<64>Module:</a></th><td>alias_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier<65>Source:</a></th><td>mod_alias.c</td></tr></table>
<h3>Sommaire</h3>
<p>Les directives fournies par ce module permettent de manipuler et
de contr<74>ler les URLs <20> l'arriv<69>e des requ<71>tes sur le serveur. Les
directives <code class="directive"><a href="#alias">Alias</a></code> et
<code class="directive"><a href="#scriptalias">ScriptAlias</a></code> permettent de
faire correspondre des URLs avec des chemins du syst<73>me de fichiers.
Ceci permet de servir des contenus qui ne sont pas situ<74>s dans
l'arborescence de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> comme s'ils y <20>taient
r<>ellement. La directive <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> a pour effet
suppl<70>mentaire de marquer le r<>pertoire cible comme conteneur de
scripts CGI.</p>
<p>Les directives <code class="directive"><a href="#redirect">Redirect</a></code>
indiquent aux clients qu'ils doivent effectuer une nouvelle requ<71>te
avec une URL diff<66>rente. Elles sont souvent utilis<69>es lorsqu'une
ressource a <20>t<EFBFBD> d<>plac<61>e.</p>
<p><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> est con<6F>u pour traiter des t<>ches
simples de manipulation d'URL. Pour des t<>ches plus complexes comme
la manipulation des cha<68>nes d'arguments des requ<71>tes, utilisez
plut<75>t les outils fournis par le module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></p>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#alias">Alias</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#aliasmatch">AliasMatch</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirect">Redirect</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirectmatch">RedirectMatch</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirectpermanent">RedirectPermanent</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#redirecttemp">RedirectTemp</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#scriptalias">ScriptAlias</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#scriptaliasmatch">ScriptAliasMatch</a></li>
</ul>
<h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif" /> <a href="#order">Chronologie du traitement</a></li>
</ul><h3>Voir aussi</h3>
<ul class="seealso">
<li><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></li>
<li><a href="../urlmapping.html">Mise en correspondance des URLs avec le
syst<EFBFBD>me de fichiers</a></li>
</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="order" id="order">Chronologie du traitement</a></h2>
<p>Les alias et redirections apparaissant dans diff<66>rents contextes
sont trait<69>s comme les autres directives en respectant les <a href="../sections.html#mergin">r<>gles de fusion</a> standards. Par
contre, ils sont trait<69>s selon une chronologie particuli<6C>re
lorsqu'ils apparaissent dans le m<>me contexte (par exemple, dans la
m<>me section <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>).</p>
<p>Premi<6D>rement, toutes les redirections sont trait<69>es avant les
alias, et ainsi, une requ<71>te qui correspond <20> une directive
<code class="directive"><a href="#redirect">Redirect</a></code> ou <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code> ne se verra jamais
appliquer d'alias. Deuxi<78>mement, les alias et redirections sont
trait<69>s selon l'ordre dans lequel ils apparaissent dans le fichier
de configuration, seule la premi<6D>re correspondance <20>tant prise en
compte.</p>
<p>Ainsi, lorsqu'une ou plusieurs de ces directives s'appliquent au
m<>me sous-r<>pertoire, vous devez classer les chemins du plus pr<70>cis
au moins pr<70>cis afin que toutes les directives puissent
<20>ventuellement s'appliquer, comme dans l'exemple suivant :</p>
<pre class="prettyprint lang-config">
Alias /foo/bar /baz
Alias /foo /gaq
</pre>
<p>Si l'ordre des directives <20>tait invers<72>, la directive <code class="directive"><a href="#alias">Alias</a></code> ayant pour argument
<code>/foo</code> serait toujours appliqu<71>e avant la directive
<code class="directive"><a href="#alias">Alias</a></code> ayant pour argument
<code>/foo/bar</code>, et cette derni<6E>re serait toujours
ignor<6F>e.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="Alias" id="Alias">Alias</a> <a name="alias" id="alias">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en correspondance des URLs avec des chemins du syst<73>me
de fichiers</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Alias <var>chemin URL</var>
<var>chemin fichier</var>|<var>chemin r<>pertoire</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
<p>La directive <code class="directive">Alias</code> permet de stocker des
documents (destin<69>s <20> <20>tre servis) dans des zones du syst<73>me de
fichiers situ<74>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
(d<>cod<6F> avec caract<63>res %) commence par <var>chemin URL</var> seront
mises en correspondance avec des fichiers locaux dont le chemin
commence par <var>chemin r<>pertoire</var>. Le <var>chemin URL</var>
est sensible <20> la casse, m<>me sur les syst<73>mes de fichiers
insensibles <20> la casse.</p>
<pre class="prettyprint lang-config">
Alias /image /ftp/pub/image
</pre>
<p>Une requ<71>te pour <code>http://example.com/image/foo.gif</code> fera
renvoyer par le serveur le fichier
<code>/ftp/pub/image/foo.gif</code>. Seuls les <20>l<EFBFBD>ments de chemin
complets sont test<73>s ; ainsi l'alias pr<70>c<EFBFBD>dent ne conviendra pas
pour une requ<71>te du style <code>http://example.com/imagefoo.gif</code>.
Pour des mises en correspondance plus complexes faisant intervenir
les expressions rationnelles, veuillez vous reporter <20> la directive
<code class="directive"><a href="#aliasmatch">AliasMatch</a></code>.</p>
<p>Notez que si vous ajoutez un slash de fin au <var>chemin
URL</var>, vous devrez aussi ajouter un slash de fin au chemin de la
requ<71>te. Autrement dit, si vous d<>finissez</p>
<dl><dd><code>Alias /icons/ /usr/local/apache/icons/</code></dd></dl>
<p>l'alias pr<70>c<EFBFBD>dent ne s'appliquera pas <20> l'url
<code>/icons</code> <20> cause de l'absence du slash final. Ainsi, si
le slash final est absent du <var>chemin de l'URL</var>, il doit
aussi l'<27>tre du <var>chemin du fichier</var>.</p>
<p>Notez qu'il pourra s'av<61>rer n<>cessaire de d<>finir des sections
<code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>
suppl<70>mentaires qui couvriront la <em>destination</em> des alias.
Le traitement des alias intervenant avant le traitement des sections
<code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>,
seules les cibles des alias sont affect<63>es (Notez cependant
que les sections <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> sont trait<69>es avant les alias, et
s'appliqueront donc).</p>
<p>En particulier, si vous cr<63>ez un alias ayant pour cible un
r<>pertoire situ<74> en dehors de l'arborescence de votre site web
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, vous devrez
probablement permettre explicitement l'acc<63>s <20> ce r<>pertoire.</p>
<pre class="prettyprint lang-config">
Alias /image /ftp/pub/image
&lt;Directory /ftp/pub/image&gt;
Require all granted
&lt;/Directory&gt;
</pre>
<p>Le nombre de slashes dans le param<61>tre <var>chemin URL</var> doit
correspondre au nombre de slashes dans le chemin URL de la requ<71>te.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="AliasMatch" id="AliasMatch">AliasMatch</a> <a name="aliasmatch" id="aliasmatch">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en correspondance des URLs avec le syst<73>me de fichiers
en faisant intervenir les expressions rationnelles</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AliasMatch <var>regex</var>
<var>chemin fichier</var>|<var>chemin r<>pertoire</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
<p>Cette directive est identique <20> 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>, <20> la place d'une
simple mise en correspondance de pr<70>fixe. L'expression rationnelle
fournie est mise en correspondance avec le chemin URL, et si elle
correspond, le serveur va substituer toute partie de chemin
correspondant <20> l'expression entre parenth<74>ses dans la cha<68>ne
fournie et l'utiliser comme nom de fichier.
Par exemple, pour activer le r<>pertoire <code>/icons</code>, on peut
utiliser :</p>
<pre class="prettyprint lang-config">
AliasMatch ^/icons(.*) /usr/local/apache/icons$1
</pre>
<p>Toute la puissance des <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions
rationnelles</a> peut <20>tre mise <20> contribution. Par exemple,
il est possible de construire un alias avec un mod<6F>le de chemin URL
insensible <20> la casse :</p>
<pre class="prettyprint lang-config">
AliasMatch (?i)^/image(.*) /ftp/pub/image$1
</pre>
<p>Il existe une diff<66>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
portion suppl<70>mentaire de l'URI situ<74>e apr<70>s la partie du mod<6F>le qui
correspond, <20> la fin du chemin du fichier de la partie droite, alors
que <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> ne le fait
pas. Cela signifie qu'il sera pr<70>f<EFBFBD>rable dans la plupart des cas de
comparer l'expression rationnelle du mod<6F>le <20> la totalit<69> de l'URI
de la requ<71>te, et d'utiliser les substitutions dans la partie
droite.</p>
<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
r<>sultat. Au minimum, vous devez ajouter <code>^</code> au d<>but de
l'expression rationnelle, <code>(.*)$</code> <20> sa fin et
<code>$1</code> <20> la fin de la cha<68>ne de remplacement.</p>
<p>Par exemple, supposons que nous voulions reformuler cet alias
avec AliasMatch :</p>
<pre class="prettyprint lang-config">
Alias /image/ /ftp/pub/image/
</pre>
<p>Le simple remplacement d'Alias par AliasMatch ne produira pas le
m<>me r<>sultat. Ainsi, ce qui suit va rediriger toutes les requ<71>tes
qui contiennent /image/ vers /ftp/pub/image/ :</p>
<pre class="prettyprint lang-config">
AliasMatch /image/ /ftp/pub/image/
</pre>
<p>Voici la directive AliasMatch qui produira le m<>me r<>sultat que
la directive Alias ci-dessus :</p>
<pre class="prettyprint lang-config">
AliasMatch ^/image/(.*)$ /ftp/pub/image/$1
</pre>
<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
des choses beaucoup plus sophistiqu<71>es. Par exemple, vous pouvez
servir diff<66>rentes sortes de fichiers <20> partir de r<>pertoires
diff<66>rents :</p>
<pre class="prettyprint lang-config">
AliasMatch ^/image/(.*)\.jpg$ /fichiers/jpg.images/$1.jpg<br />
AliasMatch ^/image/(.*)\.gif$ /fichiers/gif.images/$1.gif
</pre>
<p>Les <20>ventuels slashes de t<>te multiples seront supprim<69>s par le
serveur avant que les directives de ce module n'effectuent des
comparaisons avec le chemin URL de la requ<71>te.
</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="Redirect" id="Redirect">Redirect</a> <a name="redirect" id="redirect">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe demandant au client
d'effectuer une autre requ<71>te avec une URL diff<66>rente</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Redirect [<var><3E>tat</var>] <var>chemin URL</var>
<var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
<p>La directive Redirect permet de faire correspondre une ancienne
URL <20> une nouvelle en demandant au client d'aller chercher la ressource <20>
une autre localisation.</p>
<p>L'ancien <em>chemin URL</em> est un chemin sensible <20> la casse
(d<>cod<6F> <20> l'aide de caract<63>res %) commen<65>ant par un slash. Les
chemins relatifs ne sont pas autoris<69>s.</p>
<p>La nouvelle <em>URL</em>
peut <20>tre une URL absolue commen<65>ant par un protocole et un nom
d'h<>te, mais on peut aussi utiliser un chemin URL commen<65>ant par un
slash, auquel cas le protocole et le nom d'h<>te du serveur local
seront ajout<75>s.</p>
<p>Ensuite, toute requ<71>te commen<65>ant par <em>chemin URL</em> va
renvoyer une redirection au client vers l'<em>URL</em> cible. Tout
<20>l<EFBFBD>ment de chemin suppl<70>mentaire situ<74> en aval du <em>chemin
URL</em> sera ajout<75> <20> l'URL cible.</p>
<pre class="prettyprint lang-config">
# Redirige vers une URL sur un serveur diff<66>rent
Redirect /service http://foo2.example.com/service
# Redirige vers une URL sur le m<>me serveur
Redirect /one /two
</pre>
<p>Si le client effectue une requ<71>te pour l'URL
<code>http://example.com/service/foo.txt</code>, il lui sera demand<6E>
d'en effectuer une autre pour l'URL
<code>http://foo2.example.com/service/foo.txt</code>. Ceci concerne
les requ<71>tes avec param<61>tres <code>GET</code>, comme
<code>http://example.com/service/foo.pl?q=23&amp;a=42</code>, qui
seront redirig<69>es vers
<code>http://foo2.example.com/service/foo.pl?q=23&amp;a=42</code>.
Notez que les <code>POST</code>s seront ignor<6F>s.<br />
Seuls les
<20>l<EFBFBD>ments de chemin complets sont test<73>s, si bien que l'exemple
pr<70>c<EFBFBD>dent ne s'appliquera pas <20> l'URL
<code>http://example.com/servicefoo.txt</code>. Pour des mises en
correspondance plus complexes faisant intervenir les expressions
rationnelles, veuillez vous reporter <20> la directive <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code>.</p>
<div class="note"><h3>Note</h3>
<p>Les directives de redirection ont priorit<69> sur les directives
Alias et ScriptAlias, quel que soit leur ordre d'apparition dans le
fichier de configuration.</p></div>
<p>Si aucun argument <var><3E>tat</var> n'est sp<73>cifi<66>, la
redirection sera temporaire (code HTTP 302). Le client est alors
inform<72> que la ressource a <20>t<EFBFBD> temporairement d<>plac<61>e. On peut
utiliser l'argument <var><3E>tat</var> pour renvoyer d'autres codes HTTP :</p>
<dl>
<dt>permanent</dt>
<dd>Renvoie un code de redirection permanente (301), indiquant
que la ressource a <20>t<EFBFBD> d<>finitivement d<>plac<61>e.</dd>
<dt>temp</dt>
<dd>Renvoie un code de redirection temporaire (302). C'est le
comportement par d<>faut.</dd>
<dt>seeother</dt>
<dd>Renvoie un code "See Other" (303) indiquant que la ressource
a <20>t<EFBFBD> remplac<61>e par une autre.</dd>
<dt>gone</dt>
<dd>Renvoie un code "Gone" (410) indiquant que la ressource a
<20>t<EFBFBD> d<>finitivement supprim<69>e. Lorsque
ce code est utilis<69>, on ne
doit pas utiliser l'argument <var>URL</var>.</dd>
</dl>
<p>On peut renvoyer d'autres codes en sp<73>cifiant le code
num<75>rique comme valeur de l'argument of <var><3E>tat</var>.
Si le code est compris entre 300 et 399, l'argument
<var>URL</var> doit <20>tre pr<70>sent. Si le code
n'est <em>pas</em> compris entre 300 et 399, l'argument
<var>URL</var> ne doit pas appara<72>tre. Le code doit <20>tre un code
HTTP valide, connu du serveur HTTP Apache (voir la
fonction <code>send_error_response</code> dans
http_protocol.c).</p>
<pre class="prettyprint lang-config">
Redirect permanent /one http://example.com/two
Redirect 303 /three http://example.com/other
</pre>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="RedirectMatch" id="RedirectMatch">RedirectMatch</a> <a name="redirectmatch" id="redirectmatch">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe faisant appel aux
expressions rationnelles pour la mise en correspondance de l'URL
courante</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectMatch [<var><3E>tat</var>] <var>regex</var>
<var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
<p>Cette directive est identique <20> la directive <code class="directive"><a href="#redirect">Redirect</a></code>, mais fait appel aux
<a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, <20> la
place d'une simple mise en correspondance de pr<70>fixe. L'expression
rationnelle fournie est mise en correspondance avec le chemin URL,
et si elle correspond, le serveur va substituer toute partie de
chemin correspondante entre parenth<74>ses dans la cha<68>ne sp<73>cifi<66>e et
l'utiliser comme nom de fichier. Par exemple, pour rediriger tous
les fichiers GIF vers les fichiers JPEG de m<>me nom sur un autre
serveur, on peut utiliser :</p>
<pre class="prettyprint lang-config">
RedirectMatch (.*)\.gif$ http://autre.example.com$1.jpg
</pre>
<p>Les remarques <20> propos de la diff<66>rence entre <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> s'appliquent aussi <20> la
diff<66>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
<code class="directive"><a href="#aliasmatch">AliasMatch</a></code> pour plus de
d<>tails.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="RedirectPermanent" id="RedirectPermanent">RedirectPermanent</a> <a name="redirectpermanent" id="redirectpermanent">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe permanente demandant au
client d'effectuer une nouvelle requ<71>te avec une URL
diff<EFBFBD>rente</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectPermanent <var>chemin URL</var> <var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
<p>Cette directive informe le client que la redirection est
permanente (code 301). Son comportement est exactement le m<>me
que celui de <code>Redirect permanent</code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="RedirectTemp" id="RedirectTemp">RedirectTemp</a> <a name="redirecttemp" id="redirecttemp">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe temporaire demandant au
client d'effectuer une nouvelle requ<71>te avec une URL
diff<EFBFBD>rente</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectTemp <var>chemin URL</var> <var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r<>pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
<p>Cette directive informe le client que la redirection n'est
que temporaire (code 302). Son comportement est exactement le m<>me
que celui de <code>Redirect temp</code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ScriptAlias" id="ScriptAlias">ScriptAlias</a> <a name="scriptalias" id="scriptalias">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre une URL <20> une zone du syst<73>me de fichiers
et d<>signe la cible comme script CGI</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAlias <var>chemin URL</var>
<var>chemin fichier</var>|<var>chemin r<>pertoire</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
<p>La directive <code class="directive">ScriptAlias</code> pr<70>sente le m<>me
comportement que la directive <code class="directive"><a href="#alias">Alias</a></code>, mais d<>signe en plus le
r<>pertoire cible comme conteneur de scripts CGI qui seront trait<69>es
par le gestionnaire cgi-script du module <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>.
Les URLs dont le chemin URL sensible <20> la casse (d<>cod<6F> avec
caract<63>res %) commence par <var>chemin URL</var> seront mises en
correspondance avec les scripts dont le chemin commence par le
second argument, qui est un chemin complet dans le syst<73>me de
fichiers local.</p>
<pre class="prettyprint lang-config">
ScriptAlias /cgi-bin/ /web/cgi-bin/
</pre>
<p>Une requ<71>te pour <code>http://example.com/cgi-bin/foo</code>
ferait ex<65>cuter par le serveur le script
<code>/web/cgi-bin/foo</code>. Cette configuration est sensiblement
<20>quivalente <20> :</p>
<pre class="prettyprint lang-config">
Alias /cgi-bin/ /web/cgi-bin/
&lt;Location /cgi-bin &gt;
SetHandler cgi-script
Options +ExecCGI
&lt;/Location&gt;
</pre>
<p>Vous pouvez aussi utiliser <code class="directive">ScriptAlias</code>
avec un script ou gestionnaire de votre cru. Par exemple :</p>
<pre class="prettyprint lang-config">
ScriptAlias /cgi-bin/ /web/cgi-handler.pl
</pre>
<p>Dans ce sc<73>nario, tous les fichiers faisant l'objet d'une requ<71>te
dans <code>/cgi-bin/</code> seront trait<69>s par le fichier que vous
avez sp<73>cifi<66>, ce qui vous permet d'utiliser votre propre
gestionnaire. Vous pouvez l'utiliser comme enveloppe (wrapper) pour
les scripts CGI afin d'ajouter du contenu, ou autre action "maison".</p>
<div class="warning">Il est pr<70>f<EFBFBD>rable d'<27>viter de placer les
scripts CGI dans l'arborescence de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> afin d'<27>viter de r<>v<EFBFBD>ler
accidentellement leur code source lors d'une modification de
configuration. On y parvient ais<69>ment avec
<code class="directive">ScriptAlias</code> en mettant en correspondance une
URL et en d<>signant la cible comme scripts CGI par la m<>me occasion.
Si vous choisissez de placer vos scripts CGI dans un r<>pertoire
accessible depuis le web, n'utilisez pas
<code class="directive">ScriptAlias</code>. Utilisez plut<75>t <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</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 :
<pre class="prettyprint lang-config">
&lt;Directory /usr/local/apache2/htdocs/cgi-bin &gt;
SetHandler cgi-script
Options ExecCGI
&lt;/Directory&gt;
</pre>
Ceci est n<>cessaire car plusieurs <var>chemins URL</var> peuvent
correspondre <20> la m<>me zone du syst<73>me de fichiers, court-circuitant
ainsi la directive <code class="directive">ScriptAlias</code> et r<>v<EFBFBD>lant le
code source des scripts CGI s'ils ne sont pas prot<6F>g<EFBFBD>s par une
section <code class="directive"><a href="../mod/core.html#directory">Directory</a></code>.</div>
<h3>Voir aussi</h3>
<ul>
<li><a href="../howto/cgi.html">Tutoriel CGI</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="ScriptAliasMatch" id="ScriptAliasMatch">ScriptAliasMatch</a> <a name="scriptaliasmatch" id="scriptaliasmatch">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre une URL <20> une zone du syst<73>me de fichiers
en faisant appel aux expressions rationnelles et en d<>signant la cible
comme un script CGI</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAliasMatch <var>regex</var>
<var>chemin fichier</var>|<var>chemin r<>pertoire</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr>
</table>
<p>Cette directive est <20>quivalente <20> la directive <code class="directive"><a href="#scriptalias">ScriptAlias</a></code>, mais fait appel aux
<a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, <20> la
place d'une simple mise en correspondance de pr<70>fixe. L'expression
rationnelle fournie est mise en correspondance avec le chemin URL,
et si elle correspond, le serveur va substituer toute partie de
chemin entre parenth<74>ses dans la cha<68>ne sp<73>cifi<66>e et l'utiliser
comme nom de fichier. Par exemple, pour activer le r<>pertoire
standard <code>/cgi-bin</code>, on peut utiliser :</p>
<pre class="prettyprint lang-config">
ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1
</pre>
<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 <20>tre mise <20>
contribution. Par exemple, il est possible de construire un alias
avec une comparaison du mod<6F>le du chemin URL insensible <20> la casse :</p>
<pre class="prettyprint lang-config">
ScriptAliasMatch (?i)^/cgi-bin(.*) /usr/local/apache/cgi-bin$1
</pre>
<p>Les remarques <20> propos de la diff<66>rence entre <code class="directive"><a href="#alias">Alias</a></code> et <code class="directive"><a href="#aliasmatch">AliasMatch</a></code> s'appliquent aussi <20> la
diff<66>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
<code class="directive"><a href="#aliasmatch">AliasMatch</a></code> pour plus de
d<>tails.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_alias.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_alias.html" title="Fran<61>ais">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/mod_alias.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../ko/mod/mod_alias.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="T<>rk<72>e">&nbsp;tr&nbsp;</a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_alias.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Autoris<69> sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>
View Git Blame Copy Permalink