<-
Apache > Serveur HTTP > Documentation > Version 2.4

Fichiers de configuration

Langues Disponibles:  de  |  en  |  fr  |  ja  |  ko  |  tr 

Ce document d´┐Żcrit les fichiers utilis´┐Żs pour configurer le Serveur HTTP Apache.

top

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.

top

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.

top

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.

top

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.

top

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.

Langues Disponibles:  de  |  en  |  fr  |  ja  |  ko  |  tr 

top

Commentaires

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.