Update French translation

<?xml version="1.0" encoding="ISO-8859-1" ?>

<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">

<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>

<!-- English Revision: 151405 -->

<!-- French translation by Vincent Deffontaines, review by alain B -->

<!--

 Copyright 2005 The Apache Software Foundation or its licensors, as

 applicable.

 Licensed under the Apache License, Version 2.0 (the "License");

 you may not use this file except in compliance with the License.

 You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software

 distributed under the License is distributed on an "AS IS" BASIS,

 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 See the License for the specific language governing permissions and

 limitations under the License.

-->

<manualpage metafile="bind.xml.meta">

  <title>Liaison</title>

  <summary>

    <p>Configuration des adresses et ports sur lesquels Apache écoute.</p>

  </summary>

  <seealso><a href="vhosts/">Serveurs Virtuels</a></seealso>

  <seealso><a href="dns-caveats.html">Problèmes DNS</a></seealso>

  <section id="overview">

    <title>Informations générales</title>

    <related>

      <modulelist>

        <module>core</module>

        <module>mpm_common</module>

      </modulelist>

      <directivelist>

        <directive module="core" type="section">VirtualHost</directive>

        <directive module="mpm_common">Listen</directive>

      </directivelist>

    </related>

    <p>Au moment de son démarrage, Apache se lie à un port et à une 

    adresse sur la machine et se met en attente de requêtes entrantes.

    Par défaut, toutes les adresses de la machine se retrouvent

    à l'écoute. Dans tous les cas, Apache accepte d'écouter sur un

    ou plusieurs ports spécifiques, ou sur une seule ou plusieurs 

    adresses, ou encore une combinaison des deux.

    Il est fréquent d'utiliser ces possibilités avec les fonctionnalités

    de Serveurs Virtuels, qui permettent de faire répondre Apache de

    manière différente en fonction de l'adresse IP, du nom ou du port.</p>

    <p>Le serveur utilise la directive 

    <directive module="mpm_common">Listen</directive>

    pour n'accepter que des requêtes provenant de ports spécifiques ou 

    d'une combinaison adresse IP + port passés en argument. 

    Dans le cas où seul un port est spécifié avec la directive 

    <directive module="mpm_common">Listen</directive>,

    le serveur se met à l'écoute sur le port spécifié, sur toutes

    les interfaces et adresses de la machine. Si une adresse IP est 

    précisée en plus du port, le serveur n'écoute que sur l'adresse 

    et le port spécifiés. Il est possible de configurer plusieurs 

    directives <directive module="mpm_common">Listen</directive>, 

    afin qu'Apache écoute sur plusieurs adresses 

    et ports. Dans ce cas, le serveur répondra aux requêtes faites 

    sur tous les adresses et ports énumérés.</p>

    <p>Par exemple, pour que le serveur accepte les connexions à la fois sur

    les ports 80 et 8000, spécifiez&nbsp;:</p>

    <example>

      Listen 80<br />

      Listen 8000

    </example>

    <p>Pour qu'Apache accepte les connexions sur deux combinaisons

    adresses + ports, spécifiez&nbsp;:</p>

    <example>

      Listen 192.170.2.1:80<br />

      Listen 192.170.2.5:8000

    </example>

    <p>Les adresses IPv6 sont acceptées, pourvu qu'elles soient entourées 

    entre crochets de la façon suivante&nbsp;:</p>

    <example>

      Listen [fe80::a00:20ff:fea7:ccea]:80

    </example>

  </section>

  <section id="ipv6">

    <title>Précisions au sujet d'IPv6</title>

    <p>De plus en plus de plates-formes implémentent IPv6, et APR

    supporte IPv6 sur la plupart d'entre elles, si bien qu'Apache

    peut utiliser des sockets IPv6 et répondre aux requêtes envoyées

    en IPv6.</p>

    <p>Une complication possible pour les administrateurs Apache est de

    savoir si un socket IPv6 est capable de gérer les connexions IPv4

    aussi bien qu'IPv6. Gérer les connexions IPv4 sur une socket IPv6

    suppose l'utilisation d'adresses IPv6 mappées en IPv4, ce qui est

    le cas sur la plupart des plates-formes, mais pas sur FreeBSD, NetBSD

    et OpenBSD, en raison des politiques systèmes de ces plates-formes.

    Même sur des systèmes où cette fonctionnalité n'est pas activée par

    défaut, un paramètre de compilation pour <program>configure</program> 

    permet de changer ce comportement pour Apache.</p>

    <p>Pour qu'Apache puisse gérer à la fois les connexions IPv4 et IPv6

    avec un minimum de sockets, il faut permettre l'utilisation des adresses 

    IPv6 mappées en IPv4, ce qui est faisable en spécifiant l'option

    de compilation <code>--enable-v4-mapped</code> et en utilisant la

    directive générique <directive module="mpm_common">Listen</directive> 

    comme suit&nbsp;:</p>

    <example>

      Listen 80

    </example>

    <p>Si <code>--enable-v4-mapped</code> a été spécifié à la compilation,

    les directives Listen de la configuration par défaut sont de la forme

    ci-dessus. <code>--enable-v4-mapped</code> est l'option de compilation

    par défaut sur toutes les plates-formes, sauf pour FreeBSD, NetBSD, et 

    OpenBSD, donc il est probable que votre Apache ait été compilé avec

    cette option.</p>

    <p>Pour qu'Apache ne gère que les connexions IPv4, en ignorant l'éventuel

    support IPv6 de la plate-forme ou d'APR, une adresse IPv4 peut être

    donnée dans toutes les directives 

    <directive module="mpm_common">Listen</directive>, comme dans les 

    exemples suivants&nbsp;:</p>

    <example>

      Listen 0.0.0.0:80<br />

      Listen 192.170.2.1:80

    </example>

    <p>Pour qu'Apache gère les connexions IPv4 et IPv6 sur des sockets

    différents (i.e., pour ne pas accepter les adresses IPv6 mappées

    en IPv4), spécifiez l'option de compilation 

    <code>--disable-v4-mapped</code> et utilisez des directives 

    Listen spécifiques telles que&nbsp;:</p>

    <example>

      Listen [::]:80<br />

      Listen 0.0.0.0:80

    </example>

    <p>Si le paramètre <code>--disable-v4-mapped</code> a été défini 

    au moment de la compilation, les directives Listen de la 

    configuration par défaut sont de la forme ci-dessus.

    <code>--disable-v4-mapped</code> est l'option de 

    compilation par défaut sous FreeBSD, NetBSD, et OpenBSD.</p>

  </section>

  <section id="virtualhost">

    <title>Faire fonctionner tout ceci avec les Serveurs Virtuels</title>

    <p>La directive <directive module="mpm_common">Listen</directive> 

    n'implémente aucun Serveur Virtuel. Elle sert simplement à 

    indiquer au serveur principal sur quels adresses et ports écouter.

    Dans le cas où aucune section 

    <directive module="core" type="section">VirtualHost</directive>

    n'est utilisée, le serveur répondra de la même manière pour toutes

    les requêtes qu'il recevra.

    Des sections 

    <directive module="core" type="section">VirtualHost</directive>

    peuvent être utilisées pour qu'Apache réagisse différemment selon que la

    requête est destinée à telle adresse ou à tel port. Avant d'implémenter

    un Serveur Virtuel au moyen de la directive VirtualHost, la directive

    Listen doit être configurée pour que le serveur écoute sur l'adresse

    ou le port utilisé. Ensuite, une section 

    <directive module="core" type="section">VirtualHost</directive>

    devrait être utilisée pour qu'Apache réagisse différemment selon

    l'adresse ou le port.

    À noter que si un Serveur Virtuel 

    <directive module="core" type="section">VirtualHost</directive> 

    est configuré sur une adresse et un port sur lesquels le serveur 

    n'est pas à l'écoute, le Serveur Virtuel ne sera pas accessible.</p>

  </section>

</manualpage>

<?xml version='1.0' encoding='ISO-8859-1' ?>

<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">

<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>

<!-- English Revision: 151405 -->

<!-- french translation by Vincent Deffontaines, review by alain B -->

<!--

 Copyright 2005 The Apache Software Foundation or its licensors, as

 applicable.

 Licensed under the Apache License, Version 2.0 (the "License");

 you may not use this file except in compliance with the License.

 You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software

 distributed under the License is distributed on an "AS IS" BASIS,

 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 See the License for the specific language governing permissions and

 limitations under the License.

-->

<manualpage metafile="configuring.xml.meta">

  <title>Fichiers de Configuration</title>

<summary>

<p>Ce document présente les fichiers utilisés pour la configuration

du serveur HTTP Apache.</p>

</summary>

  <section id="main">

    <title>Fichiers de Configuration principaux</title>

    <related>

      <modulelist>

        <module>mod_mime</module>

      </modulelist>

      <directivelist>

        <directive module="core" type="section">IfDefine</directive>

        <directive module="core">Include</directive>

        <directive module="mod_mime">TypesConfig</directive>

      </directivelist>

    </related>

    <p>Apache se configure en positionnant des <a

    href="mod/directives.html">directives</a> dans des fichiers de

    configurations, au format texte. Le fichier de configuration principal 

    est habituellement nommé <code>httpd.conf</code>. 

    L'emplacement de ce fichier est défini lors de la compilation 

    mais il est possible de le modifier en ligne de commande au lancement 

    d'Apache au moyen de l'option <code>-f</code>.

    De plus, il est possible d'ajouter d'autres fichiers de configuration au

    moyen de la directive <directive module="core">Include</directive>,

    qui accepte des jokers, rendant possible la lecture de multiples 

    fichiers de configuration. Cette directive peut être incluse dans 

    n'importe quel fichier de configuration. Les changements apportés 

    aux fichiers de configuration principale ne seront pris en compte 

    qu'au démarrage d'Apache ou à son redémarrage.</p>

    <p>Le serveur lit également un fichier contenant les types de documents

    mime ; le nom de ce fichier est défini au moyen de la directive

    <directive module="mod_mime">TypesConfig</directive>, et son nom

    par défaut est <code>mime.types</code>.</p>

  </section>

  <section id="syntax">

    <title>Syntaxe des fichiers de configuration</title>

    <p>Les fichiers de configuration d'Apache contiennent une directive par

    ligne. Il est possible d'utiliser le caractère antislash "\" à la fin

    d'une ligne pour signaler que celle-ci se continue sur la ligne suivante.

    Dans ce cas l'antislash doit impérativement être le tout dernier 

    caractère de la ligne et ne doit pas être suivi d'espaces.</p>

    <p>Les directives placées dans les fichiers de configuration 

    ne sont pas sensibles à la casse, mais leurs arguments le sont. 

    Les lignes commençant par le caractère "#" sont considérées comme 

    des commentaires, et sont donc ignorées. Il <strong>n'</strong>est 

    <strong>pas</strong> possible d'ajouter un commentaire en fin de 

    ligne, après une directive. Les lignes vides, ainsi que les 

    espaces précédant les directives, sont ignorés, ce qui vous 

    permet d'indenter le fichier pour de simplifier sa lecture.</p>

    <p>Vous pouvez tester vos fichiers de configuration sans 

    avoir à démarrer le serveur en utilisant la commande 

    <code>apachectl configtest</code> ou en appelant Apache 

    avec l'option <code>-t</code>.</p>

  </section>

  <section id="modules">

    <title>Modules</title>

    <related>

      <modulelist>

        <module>mod_so</module>

      </modulelist>

      <directivelist>

        <directive module="core" type="section">IfModule</directive>

        <directive module="mod_so">LoadModule</directive>

      </directivelist>

    </related>

    <p>Apache est un serveur modulaire, ce qui signifie que le 

    noyau du serveur ne dispose que des fonctions des plus basiques. 

    Toutes les fonctions étendues sont possibles grâce à des <a 

    href="mod/">modules</a>, qui peuvent être chargés par Apache. 

    Par défaut, un <a href="mod/module-dict.html#Status">certain 

    nombre</a> de modules est fourni et compilé avec le serveur. 

    Dans le cas où le serveur a été compilé avec le <a href="dso.html">

    support dynamique des modules</a>, il est possible de compiler 

    des modules à part et de les charger au moyen de la directive 

    <directive module="mod_so">LoadModule</directive>. Dans le cas 

    contraire, il faudra recompiler tout Apache pour lui ajouter ou 

    lui enlever des modules. Des directives peuvent être incluses de 

    façon conditionnelle selon la présence d'un module particulier en 

    les positionnant dans un bloc <directive module="core" 

    type="section">IfModule</directive>.</p>

    <p>L'option <code>-l</code>, à passer en ligne de commande, provoque

    l'affichage des modules qui sont compilés dans Apache.</p>

  </section>

  <section id="scope">

    <title>Directives Possibles</title>

    <related>

      <directivelist>

        <directive module="core" type="section">Directory</directive>

        <directive module="core" type="section">DirectoryMatch</directive>

        <directive module="core" type="section">Files</directive>

        <directive module="core" type="section">FilesMatch</directive>

        <directive module="core" type="section">Location</directive>

        <directive module="core" type="section">LocationMatch</directive>

        <directive module="core" type="section">VirtualHost</directive>

      </directivelist>

    </related>

    <p>Les directives positionnées dans les fichiers de configuration principaux

    s'appliquent au serveur dans son ensemble. Pour spécifier des directives

    spécifiques à une partie du serveur, il est possible de les positionner à

    l'intérieur d'une des sections <directive module="core"

    type="section">Directory</directive>, <directive module="core"

    type="section">DirectoryMatch</directive>, <directive module="core"

    type="section">Files</directive>, <directive module="core"

    type="section">FilesMatch</directive>, <directive module="core"

    type="section">Location</directive>, ou <directive module="core"

    type="section">LocationMatch</directive>.

    Chacune de ces sections limite la validité des directives qu'elle

    contient à la partie du système de fichier ou de l'URL qu'elle

    contient. Ces sections peuvent également se contenir les unes les autres,

    ce qui permet une configuration très fine.</p>

    <p>Il est possible d'utiliser un seul serveur Apache pour servir plusieurs 

    sites web, ce qu'on appelle des <a href="vhosts/">Serveurs Virtuels</a>.

    Les différentes directives peuvent être positionnées à l'intérieur de

    sections <directive module="core" type="section">VirtualHost</directive>,

    afin qu'elles régulent le fonctionnement d'un site (dit virtuel)

    particulier.</p>

    <p>La plupart des directives peuvent être positionnées dans toutes les

    sections présentées ci-dessus, sauf dans certains cas. Par exemple, 

    les directives qui contrôlent la création du processus Apache ne

    peuvent être placées que dans le contexte du serveur principal. Les

    sections possibles pour chaque directive sont décrites au niveau du <a

    href="mod/directive-dict.html#Context">Contexte</a> de celle-ci.

    Des informations plus complètes au sujet du fonctionnement des sections

    <a href="sections.html">Directory, Location et Files</a> 

    sont disponibles ailleurs.</p>

  </section>

  <section id="htaccess">

    <title>Fichiers .htaccess</title>

    <related>

      <directivelist>

        <directive module="core">AccessFileName</directive>

        <directive module="core">AllowOverride</directive>

      </directivelist>

    </related>

    <p>Apache permet de délocaliser la gestion de la configuration, au

    moyen de fichiers spéciaux, placés directement dans l'arborescence Web.

    Ces fichiers spéciaux portent le plus souvent le nom <code>.htaccess</code>,

    mais il est bien sûr possible de changer ce nom au moyen de la directive

    <directive module="core">AccessFileName</directive>.

    Les directives positionnées dans un fichier <code>.htaccess</code>

    s'appliquent au répertoire le contenant ainsi qu'à tous ses

    sous-répertoires. La syntaxe à employer dans un fichier

    <code>.htaccess</code> est identique à la syntaxe des fichiers de

    configuration principaux. De plus, les fichiers <code>.htaccess</code> 

    étant lus au moment de chaque requête les concernant, toute 

    modification de ces fichiers prend effet immédiatement sans qu'il soit

    nécessaire de redémarrer le serveur.</p>

    <p>Pour savoir si une directive peut être placée dans un fichier

    <code>.htaccess</code>, il suffit de vérifier son <a

    href="mod/directive-dict.html#Context">Contexte</a>. Il est possible à

    l'administrateur du serveur de spécifier quelles directives sont 

    autorisées ou non dans les fichiers <code>.htaccess</code>, au moyen 

    de la directive <directive module="core">AllowOverride</directive>, 

    positionnée dans les fichiers de configuration principaux.</p>

    <p>Des informations plus complètes concernant les fichiers 

    <code>.htaccess</code> sont disponible dans le 

    <a href="howto/htaccess.html">tutoriel .htaccess</a>.</p>

  </section>

</manualpage>