Fichiers de configuration

Fichiers de configuration principaux

La configuration d'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 httpd.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 Apache 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 d'Apache 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 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�.

On peut utiliser les variables d'environnement du shell dans les lignes du fichier de configuration en utilisant la syntaxe ${ENVVAR}. Si "ENVVAR" est le nom d'une variable d'environnement valide, sa valeur remplace l'expression ${ENVVAR} dans la ligne du fichier de configuration, et le traitement continue comme si cette valeur avait �t� inscrite directement dans le fichier de configuration. Si la variable ENVVAR n'est pas trouv�e, l'expression "${ENVVAR}" est conserv�e tel quel pour une utilisation ult�rieure dans le traitement du fichier de configuration.

La longueur maximale d'une ligne du fichier de configuration, apr�s substitution des variables d'environnement, reconstitution des lignes fragment�es et suppression des espaces de d�but et de fin, est de 8192 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 apachectl configtest ou de l'option de ligne de commande -t.

Modules

Apache 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 Apache. 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, Apache 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.

Apache 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

Apache 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.