Module Apache mod_alias

Alias Directive

La directive Alias permet de stocker des documents (destin�s � �tre servis) dans des zones du syst�me de fichiers situ�es en dehors de l'arborescence du site web DocumentRoot. Les URLs dont le chemin (d�cod� avec caract�res %) commence par chemin URL seront mises en correspondance avec des fichiers locaux dont le chemin commence par chemin r�pertoire. Le chemin URL est sensible � la casse, m�me sur les syst�mes de fichiers insensibles � la casse.

Alias /image /ftp/pub/image

Une requ�te pour http://example.com/image/foo.gif fera renvoyer par le serveur le fichier /ftp/pub/image/foo.gif. Seuls les �l�ments de chemin complets sont test�s ; ainsi l'alias pr�c�dent ne conviendra pas pour une requ�te du style http://example.com/imagefoo.gif. Pour des mises en correspondance plus complexes faisant intervenir les expressions rationnelles, veuillez vous reporter � la directive AliasMatch.

Notez que si vous ajoutez un slash de fin au chemin URL, vous devrez aussi ajouter un slash de fin au chemin de la requ�te. Autrement dit, si vous d�finissez

Alias /icons/ /usr/local/apache/icons/

l'alias pr�c�dent ne s'appliquera pas � l'url /icons � cause de l'absence du slash final. Ainsi, si le slash final est absent du chemin de l'URL, il doit aussi l'�tre du chemin du fichier.

Notez qu'il pourra s'av�rer n�cessaire de d�finir des sections <Directory> suppl�mentaires qui couvriront la destination des alias. Le traitement des alias intervenant avant le traitement des sections <Directory>, seules les cibles des alias sont affect�es (Notez cependant que les sections <Location> sont trait�es avant les alias, et s'appliqueront donc).

En particulier, si vous cr�ez un alias ayant pour cible un r�pertoire situ� en dehors de l'arborescence de votre site web DocumentRoot, vous devrez probablement permettre explicitement l'acc�s � ce r�pertoire.

Alias /image /ftp/pub/image
<Directory /ftp/pub/image>
    Require all granted
</Directory>

Le nombre de slashes dans le param�tre chemin URL doit correspondre au nombre de slashes dans le chemin URL de la requ�te.

AliasMatch Directive

Cette directive est identique � la directive Alias, mais fait appel aux expressions rationnelles, � la place d'une simple mise en correspondance de pr�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 � l'expression entre parenth�ses dans la cha�ne fournie et l'utiliser comme nom de fichier. Par exemple, pour activer le r�pertoire /icons, on peut utiliser :

AliasMatch ^/icons(.*) /usr/local/apache/icons$1

Toute la puissance des expressions rationnelles peut �tre mise � contribution. Par exemple, il est possible de construire un alias avec un mod�le de chemin URL insensible � la casse :

AliasMatch (?i)^/image(.*) /ftp/pub/image$1

Il existe une diff�rence subtile entre Alias et AliasMatch : Alias copie automatiquement toute portion suppl�mentaire de l'URI situ�e apr�s la partie du mod�le qui correspond, � la fin du chemin du fichier de la partie droite, alors que AliasMatch ne le fait pas. Cela signifie qu'il sera pr�f�rable dans la plupart des cas de comparer l'expression rationnelle du mod�le � la totalit� de l'URI de la requ�te, et d'utiliser les substitutions dans la partie droite.

En d'autres termes, le remplacement d'Alias par AliasMatch ne produira pas le m�me r�sultat. Au minimum, vous devez ajouter ^ au d�but de l'expression rationnelle, (.*)$ � sa fin et $1 � la fin de la cha�ne de remplacement.

Par exemple, supposons que nous voulions reformuler cet alias avec AliasMatch :

Alias /image/ /ftp/pub/image/

Le simple remplacement d'Alias par AliasMatch ne produira pas le m�me r�sultat. Ainsi, ce qui suit va rediriger toutes les requ�tes qui contiennent /image/ vers /ftp/pub/image/ :

AliasMatch /image/ /ftp/pub/image/

Voici la directive AliasMatch qui produira le m�me r�sultat que la directive Alias ci-dessus :

AliasMatch ^/image/(.*)$ /ftp/pub/image/$1

Bien entendu, il n'y a aucune raison d'utiliser AliasMatch dans le cas o� Alias suffit. AliasMatch vous permet d'effectuer des choses beaucoup plus sophistiqu�es. Par exemple, vous pouvez servir diff�rentes sortes de fichiers � partir de r�pertoires diff�rents :

      AliasMatch ^/image/(.*)\.jpg$ /fichiers/jpg.images/$1.jpg

      AliasMatch ^/image/(.*)\.gif$ /fichiers/gif.images/$1.gif

Les �ventuels slashes de t�te multiples seront supprim�s par le serveur avant que les directives de ce module n'effectuent des comparaisons avec le chemin URL de la requ�te.

Redirect Directive

La directive Redirect permet de faire correspondre une ancienne URL � une nouvelle en demandant au client d'aller chercher la ressource � une autre localisation.

L'ancien chemin URL est un chemin sensible � la casse (d�cod� � l'aide de caract�res %) commen�ant par un slash. Les chemins relatifs ne sont pas autoris�s.

La nouvelle URL peut �tre une URL absolue commen�ant par un protocole et un nom d'h�te, mais on peut aussi utiliser un chemin URL commen�ant par un slash, auquel cas le protocole et le nom d'h�te du serveur local seront ajout�s.

Ensuite, toute requ�te commen�ant par chemin URL va renvoyer une redirection au client vers l'URL cible. Tout �l�ment de chemin suppl�mentaire situ� en aval du chemin URL sera ajout� � l'URL cible.

# Redirige vers une URL sur un serveur diff�rent
Redirect /service http://foo2.example.com/service

# Redirige vers une URL sur le m�me serveur
Redirect /one /two

Si le client effectue une requ�te pour l'URL http://example.com/service/foo.txt, il lui sera demand� d'en effectuer une autre pour l'URL http://foo2.example.com/service/foo.txt. Ceci concerne les requ�tes avec param�tres GET, comme http://example.com/service/foo.pl?q=23&a=42, qui seront redirig�es vers http://foo2.example.com/service/foo.pl?q=23&a=42. Notez que les POSTs seront ignor�s.
Seuls les �l�ments de chemin complets sont test�s, si bien que l'exemple pr�c�dent ne s'appliquera pas � l'URL http://example.com/servicefoo.txt. Pour des mises en correspondance plus complexes faisant intervenir les expressions rationnelles, veuillez vous reporter � la directive RedirectMatch.

Si aucun argument �tat n'est sp�cifi�, la redirection sera temporaire (code HTTP 302). Le client est alors inform� que la ressource a �t� temporairement d�plac�e. On peut utiliser l'argument �tat pour renvoyer d'autres codes HTTP :

permanent

Renvoie un code de redirection permanente (301), indiquant que la ressource a �t� d�finitivement d�plac�e.

temp

Renvoie un code de redirection temporaire (302). C'est le comportement par d�faut.

seeother

Renvoie un code "See Other" (303) indiquant que la ressource a �t� remplac�e par une autre.

gone

Renvoie un code "Gone" (410) indiquant que la ressource a �t� d�finitivement supprim�e. Lorsque ce code est utilis�, on ne doit pas utiliser l'argument URL.

On peut renvoyer d'autres codes en sp�cifiant le code num�rique comme valeur de l'argument of �tat. Si le code est compris entre 300 et 399, l'argument URL doit �tre pr�sent. Si le code n'est pas compris entre 300 et 399, l'argument URL ne doit pas appara�tre. Le code doit �tre un code HTTP valide, connu du serveur HTTP Apache (voir la fonction send_error_response dans http_protocol.c).

Redirect permanent /one http://example.com/two
Redirect 303 /three http://example.com/other

RedirectMatch Directive

Cette directive est identique � la directive Redirect, mais fait appel aux expressions rationnelles, � la place d'une simple mise en correspondance de pr�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�ses dans la cha�ne sp�cifi�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 :

RedirectMatch (.*)\.gif$ http://autre.example.com$1.jpg

Les remarques � propos de la diff�rence entre Alias et AliasMatch s'appliquent aussi � la diff�rence entre les directives Redirect et RedirectMatch. Voir la directive AliasMatch pour plus de d�tails.

RedirectPermanent Directive

Cette directive informe le client que la redirection est permanente (code 301). Son comportement est exactement le m�me que celui de Redirect permanent.

RedirectTemp Directive

Cette directive informe le client que la redirection n'est que temporaire (code 302). Son comportement est exactement le m�me que celui de Redirect temp.

ScriptAlias Directive

La directive ScriptAlias pr�sente le m�me comportement que la directive Alias, mais d�signe en plus le r�pertoire cible comme conteneur de scripts CGI qui seront trait�es par le gestionnaire cgi-script du module mod_cgi. Les URLs dont le chemin URL sensible � la casse (d�cod� avec caract�res %) commence par chemin URL seront mises en correspondance avec les scripts dont le chemin commence par le second argument, qui est un chemin complet dans le syst�me de fichiers local.

ScriptAlias /cgi-bin/ /web/cgi-bin/

Une requ�te pour http://example.com/cgi-bin/foo ferait ex�cuter par le serveur le script /web/cgi-bin/foo. Cette configuration est sensiblement �quivalente � :

Alias /cgi-bin/ /web/cgi-bin/
<Location /cgi-bin >
    SetHandler cgi-script
    Options +ExecCGI
</Location>

Vous pouvez aussi utiliser ScriptAlias avec un script ou gestionnaire de votre cru. Par exemple :

ScriptAlias /cgi-bin/ /web/cgi-handler.pl

Dans ce sc�nario, tous les fichiers faisant l'objet d'une requ�te dans /cgi-bin/ seront trait�s par le fichier que vous avez sp�cifi�, 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".

<Directory /usr/local/apache2/htdocs/cgi-bin >
    SetHandler cgi-script
    Options ExecCGI
</Directory>

Voir aussi

• Tutoriel CGI

ScriptAliasMatch Directive

Cette directive est �quivalente � la directive ScriptAlias, mais fait appel aux expressions rationnelles, � la place d'une simple mise en correspondance de pr�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�ses dans la cha�ne sp�cifi�e et l'utiliser comme nom de fichier. Par exemple, pour activer le r�pertoire standard /cgi-bin, on peut utiliser :

ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1

Comme dans le cas d'AliasMatch, toute la puissance des expressions rationnelles peut �tre mise � contribution. Par exemple, il est possible de construire un alias avec une comparaison du mod�le du chemin URL insensible � la casse :

ScriptAliasMatch (?i)^/cgi-bin(.*) /usr/local/apache/cgi-bin$1

Les remarques � propos de la diff�rence entre Alias et AliasMatch s'appliquent aussi � la diff�rence entre les directives ScriptAlias et ScriptAliasMatch. Voir la directive AliasMatch pour plus de d�tails.