Termes utilis�s pour la description des directives

Description

Une br�ve description des fonctions de cette directive.

Syntaxe

Ce terme introduit le format sous lequel la directive doit appara�tre dans le fichier de configuration. Cette syntaxe est tr�s sp�cifique � la directive et est d�crite en d�tail dans la d�finition de cette derni�re. En g�n�ral, le nom de la directive est suivi d'un ou plusieurs arguments s�par�s par des espaces. Si un argument contient un espace, il doit �tre entour� de guillemets. Les arguments optionnels sont entour�s de crochets. Lorsqu'un argument accepte une valeur parmi une liste de valeurs possibles, cette liste est sp�cifi�e en s�parant les valeurs par une barre verticale "|". Les textes litt�raux sont pr�sent�s dans la fonte par d�faut, alors que les types d'argument pour lesquels une substitution est n�cessaire sont en gras. La syntaxe des directives acceptant un nombre variable d'arguments se termine par "...", ce qui indique que le dernier argument peut �tre r�p�t�.

Les directives utilisent un grand nombre de types d'arguments diff�rents. Les plus courants sont d�finis ci-dessous.

URL

Un Localisateur de Ressource Uniforme (Uniform Resource Locator) complet comportant un protocole, un nom d'h�te et un nom de chemin optionnel comme dans http://www.example.com/chemin/vers/fichier.html

chemin-URL

La partie de l'url qui suit le protocole et le nom d'h�te comme dans /chemin/vers/fichier.html. Le chemin-URL repr�sente la ressource vue du web, et est diff�rente de la repr�sentation de cette m�me ressource vue du syst�me de fichiers.

chemin-fichier

Le chemin d'un fichier dans le syst�me de fichiers local commen�ant par le r�pertoire racine comme dans /usr/local/apache/htdocs/chemin/vers/fichier.html. Sauf mention contraire, un chemin-fichier qui ne commence pas par un slash sera consid�r� comme relatif au r�pertoire d�fini par la directive ServerRoot.

chemin-r�pertoire

Le chemin d'un r�pertoire dans le syst�me de fichiers local commen�ant par le r�pertoire racine comme dans /usr/local/apache/htdocs/chemin/vers/.

nom-fichier

Le nom d'un fichier sans son chemin comme dans fichier.html.

regex

Une expression rationnelle compatible Perl. La d�finition de la directive sp�cifiera � quoi regex sera compar�e.

extension

En g�n�ral, c'est la partie du nom de fichier qui suit le dernier point. Cependant, Apache reconna�t plusieurs extensions de noms de fichiers ; ainsi, si un nom de fichier contient plusieurs points, chacune des parties du nom de fichier s�par�es par des points et situ�es apr�s le premier point est une extension. Par exemple, le nom de fichier fichier.html.en comporte deux extensions : .html et .en. Pour les directives Apache, vous pouvez sp�cifier les extensions avec ou sans le point initial. Enfin, les extensions ne sont pas sensibles � la casse.

MIME-type

Une m�thode de description du format d'un fichier consistant en un type de format majeur et un type de format mineur s�par�s par un slash comme dans text/html.

env-variable

Le nom d'une variable d'environnement d�finie au cours du processus de configuration d'Apache. Notez qu'elle peut �tre diff�rente d'une variable d'environnement du syst�me d'exploitation. Voir la documentation sur les variables d'environnement pour plus de d�tails.

D�faut

Si la directive poss�de une valeur par d�faut (en d'autres termes, si le serveur Web Apache se comporte comme si vous l'aviez d�finie � une valeur particuli�re, alors que vous l'avez omise dans votre configuration), elle est sp�cifi�e ici. Si la directive ne poss�de pas de valeur par d�faut, cette section doit sp�cifier "Aucune". Notez que la valeur par d�faut dont il est question n'est pas n�cessairement la m�me que la valeur attribu�e � la directive dans le fichier apache2.conf par d�faut distribu� avec le serveur.

Contexte

Indique les parties des fichiers de configuration du serveur o� cette directive est valide. Il s'agit d'une liste d'une ou plusieurs des valeurs suivantes s�par�es par des virgules :

configuration du serveur

Signifie que la directive peut �tre utilis�e dans les fichiers de configuration du serveur (par exemple apache2.conf), mais pas � l'int�rieur d'un conteneur <VirtualHost> ou <Directory>. De m�me, elle n'est pas valide dans les fichiers .htaccess.

serveur virtuel

Signifie que la directive peut appara�tre � l'int�rieur d'un conteneur <VirtualHost> dans les fichiers de configuration du serveur.

r�pertoire

Une directive sp�cifi�e comme valide dans ce contexte peut �tre utilis�e � l'int�rieur de conteneurs <Directory>, <Location>, <Files>, <If>, et <Proxy> dans les fichiers de configuration du serveur, en tenant compte des restrictions pr�cis�es dans la documentation sur les Sections de configuration.

.htaccess

Si une directive est valide dans ce contexte, cela signifie qu'elle peut appara�tre � l'int�rieur de fichiers de configuration de niveau r�pertoire .htaccess. Elle sera ou ne sera pas trait�e, selon la d�finition de l'option overrides pour le contexte courant.

La directive n'est autoris�e que dans le contexte d�sign� ; si vous essayez de l'utiliser ailleurs, vous g�n�rerez une erreur de configuration qui va soit emp�cher le serveur de traiter les requ�tes correctement dans ce contexte, soit tout simplement emp�cher le serveur de fonctionner -- en d'autres termes, le serveur refusera de d�marrer.

Les lieux de d�finition valides pour une directive r�sultent en fait d'un OU logique de tous les contextes sp�cifi�s. En d'autres termes, une directive sp�cifi�e comme valide dans "configuration du serveur, .htaccess" peut �tre utilis�e dans le fichier apache2.conf et dans les fichiers .htaccess, mais pas dans un conteneur <Directory> ou <VirtualHost>.

Surcharge/�crasement

Ce terme indique quelle autorisation de surcharge ("override") doit �tre active pour que la directive puisse �tre trait�e lorsqu'elle appara�t dans un fichier .htaccess. Si le context de la directive ne lui permet pas d'appara�tre dans un fichier .htaccess, aucun contexte ne sera sp�cifi�.

Les autorisations de surcharge sont activ�es via la directive AllowOverride, et poss�dent une port�e particuli�re, comme un r�pertoire et tous ses sous-r�pertoires, sauf si une autre directive AllowOverride appara�t � un niveau inf�rieur. La documentation pour cette directive sp�cifie aussi les noms d'autorisations de surcharge disponibles.

Statut

Cet attribut indique le degr� de rapprochement de la directive du coeur d'Apache ; en d'autres termes, vous pouvez �tre amen� � recompiler le serveur avec un jeu de modules suppl�mentaires pour pouvoir utiliser la directive, et ainsi acc�der � ses fonctionnalit�s. Les valeurs possible pour cet attribut sont :

Core

Lorsqu'une directive a pour statut "Core", cela signifie qu'elle fait partie du coeur du serveur web Apache, et est de ce fait toujours disponible.

MPM

Une directive dont le statut est "MPM" est fournie par un module Multi-Processus. Ce type de directive sera disponible si et seulement si vous utilisez un des MPMs sp�cifi�s dans la ligne Module de la d�finition de la directive.

Base

Une directive dont le statut est "Base" est fournie par un des modules Apache standards qui sont compil�s dans le serveur par d�faut, et sont de ce fait toujours disponibles, sauf si vous avez fait en sorte de les supprimer de votre configuration.

Extension

Une directive dont le statut est "Extension" est fournie par un des modules inclus dans le kit du serveur Apache, mais qui ne sont pas compil�s dans le serveur par d�faut. Pour activer la directive et acc�der � ses fonctionnalit�s, vous devez modifier les fichiers de configuration de la compilation du serveur, et recompiler Apache.

Exp�rimental

Le statut "Exp�rimental" indique que la directive fait partie du kit Apache, mais que vous l'utilisez � vos risques et p�rils. La directive est document�e � titre d'exhaustivit�, et n'est pas obligatoirement support�e. Le module qui fournit la directive peut �tre compil� par d�faut dans le serveur ou non ; consultez le haut de la page qui d�crit la directive et son module pour v�rifier sa disponibilit�.

Module

Il s'agit d'une simple liste des noms des modules sources qui fournissent la directive.

Compatibilit�

Si la directive ne faisait pas partie de la distribution originale d'Apache version 2, la version dans laquelle elle a �t� introduite est indiqu�e ici. Cette section indique aussi si la directive n'est disponible que sur certaines plates-formes.