Directives conteneurs
Apache dispose d’un certain nombre de directives conteneurs, qui limitent la portée des directives qu’elles contiennent à des hôtes virtuels, des répertoires ou des fichiers particuliers. Ces conteneurs -- notamment <VirtualHost> -- jouent un rôle très important dans le fonctionnement d’un site web car ils définissent des blocs grâce auxquels le web-mestre peut mettre en place un grand nombre de serveurs distincts à l’aide d’un unique serveur Apache. Tout cela sera plus clair lorsque vous aurez lu la section Deux sites et Apache du chapitre 4).
Les sections qui suivent détaillent la syntaxe de ces directives conteneur.
<VirtualHost>
<VirtualHost hôte [: port ]>
...
</VirtualHost>
Configuration du serveur
Une directive <VirtualHost> d’un fichier de configuration agit comme un marqueur HTML : elle introduit un bloc contenant des directives concernant un seul hôte. Ce bloc se termine par </VirtualHost> :
....
<VirtualHost www.butterthlies.com>
ServerAdmin sales@butterthlies.com
DocumentRoot /usr/www/APACHE3/APACHE3/site.virtual/htdocs/customers
ServerName www.butterthlies.com
ErrorLog /usr/www/APACHE3/APACHE3/site.virtual/name-based/logs/error_log
TransferLog /usr/www/APACHE3/APACHE3/site.virtual/name-based/logs/access_log
</VirtualHost>
...
<VirtualHost> indique également l’adresse IP que l’on héberge et, éventuellement, le port. Si ce dernier n’est pas précisé, on suppose qu’il s’agit du port HTTP standard, 80, ou celui indiqué par la directive Port (sauf avec Apache 2). hôte peut également valoir _default_, auquel cas il correspond à tous les hôtes non capturés par les autres directives <VirtualHost>.
Pour un système réel, l’adresse IP sera le nom d’hôte de votre serveur. Il existe trois autres directives conteneurs, qui limitent également la portée de leurs contenus
- <Directory>
- <Files>
- <Location>
Ces conteneurs sont donnés dans l’ordre croissant de leurs priorités : <Directory> est donc surchargé par <Files> et <Files> par <Location>. Vous pouvez mettre des conteneurs <Files> dans un conteneur <Directory>. Leur exécution se fait par groupe, dans l’ordre suivant :
- <Directory> (sans expression régulière) et .htaccess sont exécutés en même temps. .htaccess surcharge <Directory>.
- <DirectoryMatch> et <Directory> (avec expressions régulières) sont exécutés simultanément.
- <Files> et <FilesMatch> sont exécutés simultanément.
- <Location> et <LocationMatch> sont exécutés simultanément.
Le groupe 1 est traité du chemin le plus court vers le plus long. Les autres groupes sont traités dans l’ordre de leur apparition dans le fichier de configuration. Les sections des conteneurs <VirtualHost> s’appliquent après les sections correspondantes situées à l’extérieur.
<Directory> et <DirectoryMatch>
<Directory répertoire >
...
</Directory>
La directive <Directory> permet d’appliquer des directives à un répertoire ou à un groupe de répertoires. Il est important de comprendre que répertoire désigne des répertoires absolus et que <Directory agit donc sur le système de fichiers global, pas uniquement sur l’arborescence DocumentRoot. répertoire peut contenir des caractères génériques -- ? correspond à un caractère unique, * à une suite de caractères éventuellement nulle, [] correspond à un caractère pris parmi l’ensemble indiqué ( [a-d] signifie « un caractère qui est soit a, soit b, soit c, soit d »). Si répertoire commence par ~, la suite peut être une expression régulière complète.
<DirectoryMatch> a le même effet que <Directory ~ > : il attend donc une expression régulière. Par exemple :
<Directory ~ /[a-d].*>
et :
<DirectoryMatch /[a-d].*>
signifient donc toutes deux « n’importe quel nom de répertoire sous la racine, commençant par a, b, c ou d ».
<Files> et <FilesMatch>
<Files fichier >
...
</Files>
La directive <Files> limite la portée des directives qu’elle contient au fichier indiqué, qui doit être spécifié au moyen d’un chemin relatif à DocumentRoot. Ce nom peut contenir des caractères génériques ou des expressions régulières complètes s’il est préfixé par ~. <FilesMatch> peut être suivi d’une expression régulière sans que ce ~ ne soit nécessaire. Ainsi :
<FilesMatch "\.(gif|jpe?g|png)$">
capture les extensions courantes pour les fichiers graphiques.
Si vous souhaitez que vos catalogues bénéficient d’un traitement spécial :
<FilesMatch catalogue.*>
À la différence de <Directory> et <Location>, <Files> peut apparaître dans un fichier .htaccess.
<Location> et <LocationMatch>
<Location URL >
...
</Location>
La directive <Location> limite la portée des directives qu’elle contient aux URL spécifiées, qui peuvent contenir des caractères génériques. Les URL préfixées par ~ peuvent contenir des expressions régulières. Pour suivre le traitement des expressions régulières par Apache 1.3, * et ? ne capturent plus /. La directive <LocationMatch> est suivie d’une expression régulière non préfixée par ~.
Quasiment tout ce qui est autorisé dans un conteneur <Directory> l’est également dans <Location>, mais bien que AllowOverride ne provoque pas d’erreur dans un conteneur <Location>, il n’a aucune raison de s’y trouver.
<IfDefine>
<IfDefine nom >
...
</IfDefine>
La directive <IfDefine> active un conteneur si l’option -D nom a été passée à Apache au démarrage. Cela permet d’avoir plusieurs configurations dans un même fichier. Cette directive est surtout utilisée pour les tests.
<IfModule>
<IfModule [!] fichier-module >
...
</IfModule>
La directive <IfModule> active un conteneur si le module indiqué a été compilé ou chargé dynamiquement dans Apache. Avec le préfixe !, le conteneur n’est activé que si le module n’a pas été compilé ou chargé. On peut imbriquer plusieurs directives <IfModule>. fichier-module doit être le nom du fichier source du module : mod_log_config.c, par exemple.