Fichiers de configuration

Fichiers de configuration principaux

La configuration du serveur HTTP Apache est effectu�e en pla�ant des directives dans des fichiers de configuration au format texte. Le fichier de configuration principal se nomme en g�n�ral apache2.conf. La localisation de ce fichier est d�finie � la compilation, mais peut �tre red�finie � l'aide de l'option de ligne de commande -f. En outre, d'autres fichiers de configuration peuvent �tre ajout�s � l'aide de la directive Include, et des caract�res de remplacement peuvent �tre utilis�s pour inclure de nombreux fichiers de configuration. Des directives de tous types peuvent �tre plac�es dans chacun de ces fichiers de configuration. Les modifications dans les fichiers de configuration principaux ne sont prises en compte par httpd que lorsque le serveur est d�marr� ou red�marr�.

Le serveur lit aussi un fichier contenant les types de document mime; ce fichier est d�fini par la directive TypesConfig, et se nomme mime.types par d�faut.

Syntaxe des fichiers de configuration

Les fichiers de configuration de httpd contiennent une directive par ligne. On peut utiliser l'anti-slash "\" comme dernier caract�re d'une ligne pour indiquer que la directive continue � la ligne suivante. Il ne doit y avoir aucun caract�re ni espace entre l'anti-slash et la fin de la ligne.

Les arguments des directives sont s�par�s les uns des autres par des espaces. Si un argument contient des espaces, il doit �tre entour� de guillemets.

Les directives dans les fichiers de configuration ne sont pas sensibles � la casse, mais leurs arguments le sont souvent. Les lignes qui d�butent par le caract�re "#" sont interpr�t�es comme des commentaires, et sont ignor�es. Les commentaires ne doivent pas �tre inclus dans une ligne apr�s une directive de configuration. Les lignes vides et les espaces pr�c�dant une directive sont ignor�s; vous pouvez par cons�quent indenter les directives afin d'am�liorer la lisibilit�.

Les valeurs des variables d'environnement ou des variables d�finies via la directive Define peuvent �tre utilis�es dans le fichier de configuration en utilisant la syntaxe ${VAR}. Si "VAR" est le nom d'une variable valide, la valeur de la variable est alors substitu�e � la cha�ne ${VAR}, et le processus de lecture du fichier de configuration continue comme si la cha�ne correspondant � la valeur de la variable s'y �tait trouv�e litt�ralement. Les variables d�finies via la directive Define l'emportent sur les autres variables d'environnement du shell. Si la variable "VAR" n'est pas trouv�e, la cha�ne ${VAR} n'est pas modifi�e, et un avertissement est enregistr� dans le journal. Le caract�re ":" est interdit dans les noms de variables afin d'�viter tout conflit avec la syntaxe de la directive RewriteMap.

Seules les variables d'environnement du shell d�finies avant le d�marrage du serveur peuvent �tre utilis�es dans les extensions. Les variables d'environnement d�finies dans le fichier de configuration lui-m�me, par exemple avec SetEnv, prennent effet trop tard pour pouvoir �tre utilis�es dans les extensions au sein du fichier de configuration.

La longueur maximale d'une ligne dans un fichier de configuration normal, apr�s substitution des variables et fusion des lignes interrompues, est approximativement de 16 Mo. Dans les fichiers .htaccess, la longueur maximale est de 8190 caract�res.

Vous pouvez v�rifier l'absence d'erreurs de syntaxe dans vos fichiers de configuration sans d�marrer le serveur � l'aide de la commande apache2ctl configtest ou de l'option de ligne de commande -t.

Vous pouvez utiliser la d�finition -DDUMP_CONFIG de mod_info pour afficher la configuration avec tous les fichiers inclus et les variables d'environnement �valu�es, tous les commentaires et les sections <IfDefine> et <IfModule> non actives ayant �t� supprim�s. Cependant, la sortie ne refl�te pas les fusions ou �crasements pouvant intervenir en cas de d�finitions multiples de directives.

Modules

httpd est un serveur modulaire. Ceci implique que seules les fonctionnalit�s les plus courantes sont incluses dans le serveur de base. Les fonctionnalit�s �tendues sont fournies � l'aide de modules qui peuvent �tre charg�s dans httpd. Par d�faut, un jeu de modules de base est inclus dans le serveur � la compilation. Si le serveur est compil� de fa�on � utiliser les modules charg�s dynamiquement, alors les modules peuvent �tre compil�s s�par�ment et charg�s � n'importe quel moment � l'aide de la directive LoadModule. Dans le cas contraire, httpd doit �tre recompil� pour ajouter ou supprimer des modules. Les directives de configuration peuvent �tre incluses de mani�re conditionnelle selon la pr�sence ou l'absence d'un module particulier en les pla�ant dans un bloc <IfModule>.

Pour voir quels modules ont �t� compil�s avec le serveur, vous pouvez utiliser l'option de ligne de commande -l.

Port�e des directives

Les directives plac�es dans les fichiers de configuration principaux s'appliquent au serveur dans son ensemble. Si vous souhaitez modifier la configuration d'une partie du serveur seulement, vous pouvez limiter la port�e de vos directives en les pla�ant dans une section <Directory>, <DirectoryMatch>, <Files>, <FilesMatch>, <Location>, ou <LocationMatch>. Ces sections limitent le champ d'application des directives qu'elles contiennent � des URls ou des portions du syst�me de fichiers particuli�res. Elles peuvent aussi �tre imbriqu�es, ce qui permet une configuration tr�s fine.

httpd peut servir simultan�ment de nombreux sites web au travers des H�tes Virtuels. La port�e des directives peut ainsi �tre limit�e en les pla�ant dans des sections <VirtualHost>, afin qu'elles ne s'appliquent qu'aux requ�tes pour un site web particulier.

Bien que la plupart des directives puissent �tre plac�es dans chacune de ces sections, certaines d'entre elles n'ont aucun sens dans certains contextes. Par exemple, les directives qui contr�lent la cr�ation des processus n'ont de sens que dans le contexte du serveur principal. Pour d�terminer quelles directives peuvent �tre plac�es dans quelles sections, consultez le Contexte de la directive. Pour plus d'informations, nous fournissons des d�tails dans Comment fonctionnent les sections Directory, Location et Files.

Fichiers .htaccess

httpd permet la gestion d�centralis�e de la configuration via des fichiers sp�ciaux plac�s dans l'arborescence du site web. Ces fichiers sp�ciaux se nomment en g�n�ral .htaccess, mais tout autre nom peut �tre sp�cifi� � l'aide de la directive AccessFileName. Les directives plac�es dans les fichiers .htaccess s'appliquent au r�pertoire dans lequel vous avez plac� le fichier, ainsi qu'� tous ses sous-r�pertoires. La syntaxe des fichiers .htaccess est la m�me que celle des fichiers de configuration principaux. Comme les fichiers .htaccess sont lus � chaque requ�te, les modifications de ces fichiers prennent effet imm�diatement.

Pour d�terminer quelles directives peuvent �tre plac�es dans les fichiers .htaccess, consultez le Contexte de la directive. L'administrateur du serveur peut contr�ler quelles directives peuvent �tre plac�es dans les fichiers .htaccess en d�finissant la directive AllowOverride dans les fichiers de configuration principaux.

Pour plus d'informations sur les fichiers .htaccess, se r�f�rer au tutoriel .htaccess.