Serveur HTTP Apache Version 2.4
Description: | Permet d'atteindre différentes parties du système de fichiers depuis l'arborescence des documents du site web, ainsi que la redirection d'URL |
---|---|
Statut: | Base |
Identificateur de Module: | alias_module |
Fichier Source: | mod_alias.c |
Les directives fournies par ce module permettent de manipuler et
de contrôler les URLs à l'arrivée des requêtes sur le serveur. Les
directives Alias
et
ScriptAlias
permettent de
faire correspondre des URLs avec des chemins du système de fichiers.
Ceci permet de servir des contenus qui ne sont pas situés dans
l'arborescence de DocumentRoot
comme s'ils y étaient
réellement. La directive ScriptAlias
a pour effet
supplémentaire de marquer le répertoire cible comme conteneur de
scripts CGI.
Les directives Redirect
indiquent aux clients qu'ils doivent effectuer une nouvelle requête
avec une URL différente. Elles sont souvent utilisées lorsqu'une
ressource a été déplacée.
Lorsque les directives Alias
, ScriptAlias
ou Redirect
sont définies au sein d'une
section <Location>
ou <LocationMatch>
, vous pouvez utiliser la syntaxe des expressions pour manipuler l'URL
ou le chemin de destination.
mod_alias
est conçu pour traiter des tâches
simples de manipulation d'URL. Pour des tâches plus complexes comme
la manipulation des chaînes d'arguments des requêtes, utilisez
plutôt les outils fournis par le module mod_rewrite
Les alias et redirections apparaissant dans différents contextes
sont traités comme les autres directives en respectant les règles de fusion standards. Par
contre, ils sont traités selon une chronologie particulière
lorsqu'ils apparaissent dans le même contexte (par exemple, dans la
même section <VirtualHost>
).
Premièrement, toutes les redirections sont traitées avant les
alias, et ainsi, une requête qui correspond à une directive
Redirect
ou RedirectMatch
ne se verra jamais
appliquer d'alias. Deuxièmement, les alias et redirections sont
traités selon l'ordre dans lequel ils apparaissent dans le fichier
de configuration, seule la première correspondance étant prise en
compte.
Ainsi, lorsqu'une ou plusieurs de ces directives s'appliquent au même sous-répertoire, vous devez classer les chemins du plus précis au moins précis afin que toutes les directives puissent éventuellement s'appliquer, comme dans l'exemple suivant :
Alias "/foo/bar" "/baz" Alias "/foo" "/gaq"
Si l'ordre des directives était inversé, la directive Alias
ayant pour argument
/foo
serait toujours appliquée avant la directive
Alias
ayant pour argument
/foo/bar
, et cette dernière serait toujours
ignorée.
La définition de directives Alias
, ScriptAlias
ou Redirect
au sein de sections
<Location>
ou
<LocationMatch>
l'emporte sur d'autres définitions éventuelles de ces mêmes
directives au niveau de la configuration générale du serveur.
Description: | Met en correspondance des URLs avec des chemins du système de fichiers |
---|---|
Syntaxe: | Alias [chemin URL]
chemin fichier|chemin répertoire |