Apache HTTP Server Version 1.3

Termes Utilisés pour Décrire les Directives Apache

Chaque directive de configuration d'Apache est décrite selon un format de présentation commun ressemblant à ceci :

Syntaxe: nomDirective arguments
Défaut: nomDirective valeursParDéfaut
Contexte: listeDeContextes
Surcharge: DirectivesSurchargées
Statut: statut
Module: nomModule
Compatibilité: notes concernant la compatibilité

Chacun des attributs possibles pour les directives, avec toutes leurs valeurs possibles sont décrites dans ce document.

Syntaxe

Indique la forme dans laquelle la directive doit être inscrite dans les fichiers de configuration. Cette syntaxe est très spécifique pour chaque directive, et il faudra se référer au texte descriptif de la directive pour les détails.

Défaut

Si la directive a une valeur par défaut (c-à-d., si elle n'apparait pas du tout dans le fichier de configuration, Le serveur Apache se comportera comme si cette dorective avait été écrite en mentionnant cette valeur), elle est spécifiée ici. Si aucune valeur n'est définie par défaut, cette section précisera "Non précisé".

Contexte

Indique là ou l'implantation de la directive dans le fichier de configuration est licite. Il est exprimé comme une liste séparée par des virgules, et pouvant contenir les éléments suivants :

configuration serveur: La directive peut être utilisée dans le fichier de configuration du serveur (ex., httpd.conf, srm.conf, et access.conf), mais dans aucune des sections intérieures des containers <VirtualHost> ni <Directory>. Elle n'est pas permise dans aucun des fichiers .htaccess.
hôte virtuel: Dans ce contexte, la directive peut apparaître dans les containers <VirtualHost> écrits dans les fichiers de configuration du serveur.
répertoire: La directive peut apparaître dans les containers <Directory> écrits dans les fichiers de configuration du serveur.
.htaccess: La directive peut apparaître dans les fichiers .htaccess situé dans chacun des répertoires. Elle peut ou ne pas être interprétée, suivant la configuration des directives de surcharge.

Les directives ne sont autorisées que dans les contextes cités ; si vous essayez de les écrire ailleurs, vous provoquerez une erreur de configuration qui soit conduira le serveur à ignorer les requêtes dans le contexte spécifié, soit peut empêcher le serveur de fonctionner -- c-à-d., le serveur refusera de démarrer.

Les emplacements valides pour les directives sont le résultat d'un OU booléen de tous les contextes cités. En d'autres termes, une directive marquée comma étant valide dans le contexte "configuration serveur, .htaccess" peut être utilisée dans le fichier httpd.conf et dans les fichiers .htaccess, mais pas dans le container <Directory> ni <VirtualHost>.

Surcharge

Cet attribut de directive précise quelle surcharge doit être permise pour que la directive puisse être interprétée lorsqu'elle apparaît dans un fichier .htaccess. Si le contexte de directive ne permet pas une écriture dans les fichiers .htaccess, cet attribut doit mentionner "Non applicable".

Les surcharges sont gérées par la directive AllowOverrides, et ont une portée définie, par exemple un répertoire donné et tous ses descendants, sauf si la configuration de surcharge est changée à un endroit de la descendance par une directive AllowOverrides d'un niveau inférieur. La documentation pour cette directive liste aussi les noms possibles de surcharges disponibles.

Statut

Indique à quel module du serveur Apache Web la directive est rattachée ; en d'autres termes, vous devrez peut être recompiler le serveur en précisant un ensemble plus large de modules pour pouvoir bénéficier de cette fonctionnalité. Les valeurs possibles pour cet attribut sont :

Core: Il s'agit d'une directive du noyau d'Apache et est de ce fait toujours disponible.
Base: La directive est implémentée dans un module d'Apache faisant partie de l'ensemble de compilation de base, et est normallement disponible sauf si vous avez explicitement enlevé ce module à la compilation.
Extension: La directive est implémentée par un module faisant partie de l'Apache Server Kit, mais ce module n'est pas compilé par défaut. Pour activer cette directive, et rendre opérationnelle cette fonctionnalité, vous devrez modifier le fichier de configuration de compilation et recompiler Apache.
Expérimental: Le statut "Experimental" indique que la directive est disponible dans le Kit Apache, et que vous pouvez ne l'utiliser qu'à vos risques et périls. La directive est documenté dans un souci d'exhaustivité mais n'est pas forcément supportée. Le module qui donne accès à cette directive peut être oune pas être compilé par défaut ; reportez vous en tête de la page qui décrit la directive et le module pour toute remarque concernant sa disponibilité.

Module

Donne simplement le nom du module ou est implémentée cette fonctionnalité.

Compatibilité

Si la directive ne faisait pas partie du jeu original distribué dans la version 1, le numéro de version dans laquelle elle a été introduite doit apparaître ici. Si la directive a le même nom qu'une ancienne directive du serveur HTTPd du NCSA, toute différence de comportement y sera mentionnée. Dans les autres cas, cette rubrique affichera "Pas de remarques sur compatiblité."

Apache HTTP Server Version 1.3