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 https://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.