</directivelist>
</related>
- <p>Le support DSO pour le chargement de modules individuels d'Apache est
+ <p>Le support DSO pour le chargement de modules individuels d'Apache
+ httpd est
assuré par un module nommé <module>mod_so</module> qui doit être compilé
- statiquement dans le coeur d'Apache. Il s'agit du seul module avec le
+ statiquement dans le coeur d'Apache httpd. Il s'agit du seul module avec le
module <module>core</module> à ne pas pouvoir être compilé en tant que
- module DSO lui-même. Pratiquement tous les autres modules d'Apache
+ module DSO lui-même. Pratiquement tous les autres modules
+ d'Apache httpd
distribués peuvent être compilés en tant que modules DSO en sélectionnant
pour chacun d'entre eux le mode de construction DSO à l'aide de l'option
- <code>--enable-<em>module</em>=shared</code> du script
+ <code>--enable-mods-shared</code> du script
<program>configure</program>, comme décrit dans la
<a href="install.html">Documentation de l'installation</a>. Une fois
compilé en tant que module DSO, un module peut être chargé en mémoire au
<module>mod_so</module>, placée
dans votre fichier <code>httpd.conf</code>.</p>
- <p>Un nouvel utilitaire a été introduit afin de simplifier la création de
- fichiers DSO pour les modules d'Apache
+ <p>Un utilitaire permet de simplifier la création de
+ fichiers DSO pour les modules d'Apache httpd
(particulièrement pour les modules tiers) ; il s'agit du programme nommé
<program>apxs</program> (<dfn>APache
eXtenSion</dfn>). On peut l'utiliser pour construire des modules de type
- DSO <em>en dehors</em> de l'arborescence des sources d'Apache. L'idée est
- simple : à l'installation d'Apache, la procédure <code>make install</code>
+ DSO <em>en dehors</em> de l'arborescence des sources d'Apache httpd. L'idée est
+ simple : à l'installation du serveur HTTP Apache, la procédure <code>make install</code>
du script <program>configure</program> installe les fichiers d'en-têtes
- d'Apache et positionne, pour la plateforme de compilation, les drapeaux du compilateur et de
+ d'Apache httpd et positionne, pour la plateforme de compilation, les drapeaux du compilateur et de
l'éditeur de liens à l'intérieur du programme
<program>apxs</program>, qui sera utilisé pour la construction de fichiers DSO.
Il est ainsi possible d'utiliser le programme <program>apxs</program>
- pour compiler ses sources de modules Apache sans avoir besoin de
+ pour compiler ses sources de modules Apache httpd sans avoir besoin de
l'arborescence des sources de la distribution d'Apache, et sans avoir à
régler les drapeaux du compilateur et de l'éditeur de liens pour le support DSO.</p>
</section>
<section id="usage"><title>Mode d'emploi succinct</title>
<p>Afin que vous puissiez vous faire une idée des fonctionnalités DSO
- d'Apache 2.x, en voici un résumé court et concis :</p>
+ du serveur HTTP Apache 2.x, en voici un résumé court et concis :</p>
<ol>
<li>
- Construire et installer un module Apache <em>faisant partie de la
+ <p>Construire et installer un module Apache httpd <em>faisant partie de la
distribution</em>, par exemple <code>mod_foo.c</code>,
- en tant que module DSO <code>mod_foo.so</code> :
+ en tant que module DSO <code>mod_foo.so</code> :</p>
<example>
$ ./configure --prefix=/chemin/vers/répertoire-installation
---enable-foo=shared<br />
+--enable-foo --enable-mods-shared=foo<br />
$ make install
</example>
</li>
-
+
<li>
- Construire et installer un module Apache <em>tiers</em>, par exemple
- <code>mod_foo.c</code>, en tant que module DSO <code>mod_foo.so</code> :
+ <p>Configure le serveur HTTP Apache pour une <em>installation
+ ultérieure</em> des modules partagés :</p>
<example>
-$ ./configure --add-module=<var>type_de_module</var>:
-/chemin/vers/module_tiers/mod_foo.c \<br />
-<indent>
- --enable-foo=shared<br />
-</indent>
+$ ./configure --enable-so<br />
$ make install
</example>
</li>
<li>
- Configurer Apache pour <em>pouvoir installer ultérieurement</em> des
- modules partagés :
+ <p>Configure le serveur HTTP Apache avec tous les modules
+ activés et chargés en tant qu'objets partagés. Vous pouvez
+ ensuite les désactiver un à un en commentant la directive <directive
+ module="mod_so">LoadModule</directive> correspondante dans le
+ fichier <code>httpd.conf</code>.</p>
<example>
-$ ./configure --enable-so<br />
+$ ./configure --enable-modules=most --enable-mods-shared=all<br />
$ make install
</example>
+
+ <p>L'argument <code>most</code> de l'option
+ <code>--enable-modules</code> indique que tous les modules
+ non-expérimentaux ou qui ne sont pas là à titre d'exemple seront
+ compilés.</p>
</li>
<li>
- Construire et installer un module Apache <em>tiers</em>, par exemple
+ Construire et installer un module Apache httpd <em>tiers</em>, par exemple
<code>mod_foo.c</code>, en tant que module DSO
<code>mod_foo.so</code> <em>en dehors</em> de l'arborescence des sources
- d'Apache à l'aide du programme <program>apxs</program> :
+ d'Apache
httpd à l'aide du programme <program>apxs</program> :
<example>
$ cd /chemin/vers/module_tiers<br />
-$ apxs -c mod_foo.c<br />
-$ apxs -i -a -n foo mod_foo.la
+$ apxs -cia mod_foo.c
</example>
</li>
</ol>
<p>Dans tous les cas, une fois le module partagé compilé, vous devez
ajouter une directive <directive module="mod_so">LoadModule</directive>
- dans le fichier <code>httpd.conf</code> pour qu'Apache active le module.</p>
+ dans le fichier <code>httpd.conf</code> pour qu'Apache httpd active le module.</p>
+
+ <p>Voir la <a href="programs/apxs.html">documentation sur apxs</a>
+ pour plus de détails.</p>
</section>
<section id="background"><title>Les dessous du fonctionnement des DSO</title>
système d'exploitation. Par contre, les objets partagés sont relativement
peu utilisés pour étendre les fonctionnalités d'un programme.</p>
- <p>En 1998, seule une poignée de logiciels distribués
- utilisaient le mécanisme DSO pour réellement étendre leurs fonctionnalités
- au moment de l'exécution : Perl 5 (via son mécanisme XS et le module
- DynaLoader), le serveur Netscape, <em>etc...</em> A partir de la
- version 1.3, Apache rejoignit ce groupe, car Apache
- présentait déjà un concept modulaire pour étendre ses fonctionnalités, et
- utilisait en interne une approche basée sur une liste de distribution pour
- relier des modules externes avec les fonctionnalités de base d'Apache.
- Ainsi, Apache était vraiment prédestiné à l'utilisation des DSO pour
- charger ses modules au moment de l'exécution.</p>
</section>
<section id="advantages"><title>Avantages et inconvénients</title>
<program>configure</program> à la compilation. Par exemple,
on peut ainsi exécuter différentes instances du serveur
(standard et version SSL, version minimale et version étoffée
- [mod_perl, PHP], <em>etc...</em>) à partir d'une seule installation
- d'Apache.</li>
+ [mod_perl, PHP3], <em>etc...</em>) à partir d'une seule installation
+ d'Apache httpd.</li>
<li>Le paquetage du serveur peut être facilement étendu avec des modules
tiers, même après l'installation. Ceci présente en tout cas un gros
avantage pour les mainteneurs de paquetages destinés aux distributions,
- car ils peuvent créer un paquetage Apache de base, et des paquetages
+ car ils peuvent créer un paquetage Apache httpd de base, et des paquetages
additionnels contenant des extensions telles que PHP, mod_perl, mod_fastcgi,
<em>etc...</em></li>
- <li>Une facilité de prototypage des modules Apache car la paire
+ <li>Une facilité de prototypage des modules Apache httpd car la paire
DSO/<program>apxs</program> vous permet d'une part de travailler en
- dehors de l'arborescence des sources d'Apache, et d'autre part de n'avoir
+ dehors de l'arborescence des sources d'Apache httpd, et d'autre part de n'avoir
besoin que de la commande <code>apxs -i</code>
suivie d'un <code>apachectl restart</code> pour introduire une nouvelle
- version de votre module fraîchement développé dans le serveur Apache
+ version de votre module fraîchement développé dans le serveur HTTP Apache
en cours d'exécution.</li>
</ul>
ELF le font), vous ne pouvez pas utiliser le mécanisme DSO pour tous les
types de modules. Ou en d'autres termes, les modules compilés comme
fichiers DSO sont contraints de n'utiliser que les symboles du coeur
- d'Apache, de la bibliothèque C
+ d'Apache httpd, de la bibliothèque C
(<code>libc</code>) et toutes autres bibliothèques statiques ou
- dynamiques utilisées par le coeur d'Apache, ou d'archives statiques
+ dynamiques utilisées par le coeur d'Apache httpd, ou d'archives statiques
(<code>libfoo.a</code>) contenant du code indépendant de la
position (PIC).
Il y a deux solutions pour utiliser un autre type de code : soit le
- coeur d'Apache contient déjà lui-même une référence au code, soit vous
+ coeur d'Apache httpd contient déjà lui-même une référence au code, soit vous
chargez le code vous-même via <code>dlopen()</code>.</li>
</ul>
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 924467:927376 (outdated) -->
+<!-- English Revision: 927376 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
<summary>
- <p>Ce document couvre l'installation et la compilation d'Apache
+ <p>Ce document couvre l'installation et la compilation du serveur
+ HTTP Apache
sur les systèmes Unix et similaires seulement. Pour la compilation et
l'installation sous Windows, voir <a
- href="platform/windows.html">Utiliser Apache avec Microsoft
+ href="platform/windows.html">Utiliser le serveur HTTP Apache avec Microsoft
Windows</a>. Pour les autres plateformes, se référer à la documentation par
<a href="platform/">plateforme</a>.</p>
<seealso><a href="programs/configure.html">Configuration de l'arborescence
des sources</a></seealso>
-<seealso><a href="invoking.html">Démarrer Apache</a></seealso>
+<seealso><a href="invoking.html">Démarrer Apache httpd</a></seealso>
<seealso><a href="stopping.html">Arrêt et redémarrage</a></seealso>
<section id="overview"><title>Aperçu pour les plus pressés</title>
<section id="requirements"><title>Prérequis</title>
- <p>Les prérequis pour la construction d'Apache sont les suivants:</p>
+ <p>Les prérequis pour la construction d'Apache httpd sont les suivants:</p>
<dl>
<dt>Espace disque</dt>
<dd>Assurez-vous d'avoir au moins 50 MB d'espace disque disponible
- temporaire. Après l'installation Apache occupe
+ temporaire. Après l'installation le serveur occupe
approximativement 10 MB d'espace disque. L'espace disque réellement
nécessaire va varier considérablement en fonction de vos options
de configuration et de la présence éventuelle de modules tiers.</dd>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 883878 -->
+<!-- English Revision : 926432 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
Lorsqu'un client a soumis une première requête, il peut garder la
connexion ouverte, et envoyer les requêtes suivantes en utilisant le
même socket. Ceci permet de réduire de manière significative la
- surcharge due à la création de connexions TCP. Cependant, Apache
+ surcharge due à la création de connexions TCP.
+ Cependant, le serveur HTTP Apache
mobilise en principe à cet effet un processus/thread enfant en
attente des données du client, ce qui amène son propre lot
d'inconvénients. Pour résoudre ce problème, <module>event</module>
<?xml version="1.0"?>
<!DOCTYPE moduleindex SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- LastChangedRevision English document : 420990 -->
+<!-- English Revision : 926432 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<summary>
<p>
Ci-dessous se trouve la liste de tous les modules qui font partie de
- la distribution Apache. Voir aussi la liste alphabétique complète
- de <a href="directives.html">toutes les directives Apache</a>.
+ la distribution du serveur HTTP Apache. Voir aussi la liste alphabétique complète
+ de <a href="directives.html">toutes les directives du serveur HTTP Apache</a>.
</p>
</summary>
<seealso><a href="../mpm.html">Modules multi-processus (MPMs)</a>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 825898 -->
+<!-- English Revision : 926436 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<status>Extension</status>
<sourcefile>mod_access_compat.c</sourcefile>
<identifier>access_compat_module</identifier>
-<compatibility>Disponible dans Apache 2.3 à des fins de compatibilité
-avec les précédentes versions d'Apache 2.x. Les directives fournies par
+<compatibility>Disponible dans la version 2.3 du serveur HTTP Apache
+à des fins de compatibilité
+avec les précédentes versions d'Apache httpd 2.x. Les directives fournies par
ce module sont devenues obsolètes depuis la refonte d'authz. Voir
<module>mod_authz_host</module></compatibility>
composantes entières du nom d'hôte doivent correspondre ; ainsi,
dans l'exemple ci-dessus, <code>foo.apache.org</code>
correspondra, mais <code>fooapache.org</code> ne conviendra pas.
- Avec cette configuration, Apache va effectuer une double recherche
+ Avec cette configuration, Apache httpd va effectuer une double recherche
DNS sur l'adresse IP du client, sans tenir compte de la
définition de la directive <directive
module="core">HostnameLookups</directive>. Tout d'abord, une
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 918997 -->
+<!-- English Revision : 926439 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<seealso><module>mod_cgi</module></seealso>
<seealso><a href="../howto/cgi.html">Contenu dynamique avec CGI</a></seealso>
<seealso><a href="../handler.html">Utilisation des gestionnaires
-d'Apache</a></seealso>
+d'Apache httpd</a></seealso>
<directivesynopsis>
<name>Action</name>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 420990 -->
+<!-- English Revision : 926536 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<summary>
<p>Ce module fournit le gestionnaire <code>send-as-is</code> qui
- permet à Apache d'envoyer le document sans ajouter la plupart des
+ permet au serveur HTTP Apache d'envoyer le document sans ajouter la plupart des
en-têtes HTTP habituels.</p>
<p>On peut l'utiliser pour envoyer tous types de données en
<seealso><module>mod_headers</module></seealso>
<seealso><module>mod_cern_meta</module></seealso>
<seealso><a href="../handler.html">Utilisation des gestionnaires
-d'Apache</a></seealso>
+d'Apache httpd</a></seealso>
<section id="usage"><title>Mode d'emploi</title>
<example>AddHandler send-as-is asis</example>
<p>Le contenu de tout fichier possédant l'extension
- <code>.asis</code> sera envoyé par Apache au client pratiquement tel
+ <code>.asis</code> sera envoyé par Apache httpd au client pratiquement tel
quel. En particulier, les en-têtes HTTP seront déduits du fichier
lui-même selon les règles du module <module>mod_cgi</module>, si
bien qu'un fichier asis doit inclure des en-têtes valides, et
<example>
Status: 301 Ou se trouve cette URL maintenant<br />
- Location: http://xyz.abc.com/foo/bar.html<br />
+ Location: http://xyz.example.com/foo/bar.html<br />
Content-type: text/html<br />
<br />
<html><br />
</head><br />
<body><br />
<h1>La merveilleuse page de Fred a été déplacée vers<br />
- <a href="http://xyz.abc.com/foo/bar.html">le site de
+ <a href="http://xyz.example.com/foo/bar.html">le site de
Joe</a>.<br />
</h1><br />
</body><br />
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 903057 -->
+<!-- English Revision : 926439 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<section id="query">
<title>Arguments de la requête d'autoindexation</title>
- <p>Apache 2.0.23 a réorganisé les arguments de requête pour le tri
+ <p>Le serveur HTTP Apache version 2.0.23 a réorganisé
+ les arguments de requête pour le tri
des colonnes, et intoduit un groupe complet de nouvelles options de
requête. Pour interdire effectivement au client tout contrôle sur
l'affichage, l'option <code><a
<dt><a name="indexoptions.charset"
id="indexoptions.charset"
>Charset=<var>jeu de caractères</var></a> (<em>Versions 2.0.61 et
- supérieures d'Apache</em>)</dt>
+ supérieures du serveur HTTP Apache</em>)</dt>
<dd>Le mot-clé <code>Charset</code> vous permet de spécifier le
jeu de caractères de la page générée. La valeur par défaut est
<dt><a name="indexoptions.descriptionwidth"
id="indexoptions.descriptionwidth"
>DescriptionWidth=[<var>n</var> | *]</a> (<em>Versions 2.0.23 et
- supérieures d'Apache</em>)</dt>
+ supérieures du serveur HTTP Apache</em>)</dt>
<dd>Le mot-clé <code>DescriptionWidth</code> vous permet de
spécifier la taille en caractères de la colonne description.</dd>
<dt><a name="indexoptions.foldersfirst"
id="indexoptions.foldersfirst">FoldersFirst</a> (<em>Versions 2.0.23 et
- supérieures d'Apache</em>)</dt>
+ supérieures du serveur HTTP Apache</em>)</dt>
<dd>Lorsque cette option est activée, la liste des
sous-répertoires apparaîtra <em>toujours</em> en premier, suivie
<dt><a name="indexoptions.htmltable"
id="indexoptions.htmltable">HTMLTable</a>
(<em>Expérimental, versions 2.0.23 et supérieures
- d'Apache</em>)</dt>
+ du serveur HTTP Apache</em>)</dt>
<dd>Cette option expérimentale pour l'affichage
<code>FancyIndexing</code> permet de construire une table simple
permettre au navigateur de prévoir les caractéristiques de la page
sans devoir attendre que toutes les images aient été chargées. En
l'absence de cette option, c'est la hauteur standard définie par
- le logiciel Apache qui est choisie comme valeur par défaut.</dd>
+ le logiciel Apache httpd qui est choisie comme valeur par défaut.</dd>
<dt><a name="indexoptions.iconwidth"
id="indexoptions.iconwidth">IconWidth[=<var
permettre au navigateur de prévoir les caractéristiques de la page
sans devoir attendre que toutes les images aient été chargées. En
l'absence de cette option, c'est la largeur standard définie par
- le logiciel Apache qui est choisie comme valeur par défaut.</dd>
+ le logiciel Apache httpd qui est choisie comme valeur par défaut.</dd>
<dt><a name="indexoptions.ignorecase"
id="indexoptions.ignorecase">IgnoreCase</a></dt>
<dt><a name="indexoptions.showforbidden"
id="indexoptions.showforbidden">ShowForbidden</a></dt>
- <dd>Si cette option est activée, Apache affichera les fichiers
+ <dd>Si cette option est activée, Apache httpd affichera les fichiers
normalement cachés suite au retour des valeurs
<code>HTTP_UNAUTHORIZED</code> ou <code>HTTP_FORBIDDEN</code> par
la sous-requête.</dd>
id="indexoptions.suppresscolumnsorting"
>SuppressColumnSorting</a></dt>
- <dd>Si cette option est activée, Apache supprimera les liens
+ <dd>Si cette option est activée, Apache httpd supprimera les liens
hyper-texte dans les en-têtes de colonnes dans le cas d'un
affichage "amélioré". Par défaut, ces en-têtes constituent des liens
hyper-texte, et la sélection de l'un d'entre eux va trier l'index
du répertoire en fonction des valeurs de la colonne
- correspondante. <strong>Avant
- Apache 2.0.23, cette option désactivait aussi l'interprétation des
+ correspondante. <strong>Avant la version 2.0.23 du serveur HTTP
+ Apache, cette option désactivait aussi l'interprétation des
informations de tri transmises via les arguments de la
- requête.</strong> Depuis Apache 2.0.23, ce comportement est
+ requête.</strong> Depuis la version 2.0.23 du serveur HTTP Apache, ce comportement est
contrôlé par <a
href="#indexoptions.ignoreclient"><code>IndexOptions
IgnoreClient</code></a>.</dd>
<dt><a name="indexoptions.suppressicon"
id="indexoptions.suppressicon">SuppressIcon</a>
- (<em>Versions 2.0.23 et supérieures d'Apache</em>)</dt>
+ (<em>Versions 2.0.23 et supérieures du serveur
+ HTTP Apache</em>)</dt>
<dd>L'activation de cette option supprime l'affichage des icônes
dans le cas d'un affichage "amélioré". La combinaison de
<dt><a name="indexoptions.suppressrules"
id="indexoptions.suppressrules">SuppressRules</a>
- (<em>Versions 2.0.23 et supérieures d'Apache</em>)</dt>
+ (<em>Versions 2.0.23 et supérieures du serveur HTTP Apache</em>)</dt>
<dd>L'activation de cette option supprime l'affichage des lignes
horizontales (éléments <code>hr</code>) dans les index de
<dt><a name="indexoptions.trackmodified"
id="indexoptions.trackmodified">TrackModified</a>
- (<em>Versions 2.0.23 et supérieures d'Apache</em>)</dt>
+ (<em>Versions 2.0.23 et supérieures du serveur
+ HTTP Apache</em>)</dt>
<dd>Cette option renvoie les valeurs <code>Last-Modified</code> et
<code>ETag</code> pour le répertoire indexé dans l'en-tête HTTP.
<dt><a name="indexoptions.type"
id="indexoptions.type"
>Type=<var>type MIME</var></a> (<em>Versions 2.0.61 et
- supérieures d'Apache</em>)</dt>
+ supérieures du serveur HTTP Apache</em>)</dt>
<dd>Le mot-clé <code>Type</code> vous permet de spécifier le type
MIME de la page générée. La valeur par défaut est
<dt><a name="indexoptions.versionsort"
id="indexoptions.versionsort">VersionSort</a>
- (<em>Apache 2.0a3 and later</em>)</dt>
+ (<em>Versions 2.0a3 et supérieures du serveur HTTP Apache</em>)</dt>
<dd>Le mot-clé <code>VersionSort</code> permet de trier les
fichiers contenant des numéros de version d'une manière
<dt><a name="indexoptions.xhtml"
id="indexoptions.xhtml">XHTML</a>
- (<em>Versions 2.0.49 et supérieures d'Apache</em>)</dt>
+ (<em>Versions 2.0.49 et supérieures du serveur HTTP Apache</em>)</dt>
<dd>Le mot-clé <code>XHTML</code> enjoint
<module>mod_autoindex</module> de générer du code XHTML 1.0 au
-->
<dl><dt>Options d'index incrémentales</dt>
<dd>
- <p>Apache 1.3.3 a apporté d'importantes modifications dans la
+ <p>Apache httpd 1.3.3 a apporté d'importantes modifications dans la
gestion des directives <directive>IndexOptions</directive>. En
particulier :</p>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 923952 -->
+<!-- English Revision : 926430 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
mais aussi pour l'Internet au sens large.</p>
</note>
- <p>Ce module implémente un mandataire/passerelle pour Apache. Il
+ <p>Ce module implémente un mandataire/passerelle pour le serveur
+ HTTP Apache. Il
implémente la fonctionnalité de mandataire pour <code>AJP13</code>
(Apache JServe Protocol version 1.3), <code>FTP</code>,
<code>CONNECT</code> (pour SSL), <code>HTTP/0.9</code>,
gèrent ces protocoles ou d'autres.</p>
<p>Les diverses fonctionnalités de
- mandataire d'Apache sont réparties entre plusieurs modules
+ mandataire d'Apache httpd sont réparties entre plusieurs modules
complémentaires de <module>mod_proxy</module> :
<module>mod_proxy_http</module>, <module>mod_proxy_ftp</module>,
<module>mod_proxy_ajp</module>, <module>mod_proxy_balancer</module>,
<section id="forwardreverse"><title>Mandataires directs et
mandataires/passerelles inverses</title>
- <p>Apache peut être configuré dans les deux modes mandataire
+ <p>Le serveur HTTP Apache peut être configuré dans les deux modes mandataire
<dfn>direct</dfn> et mandataire <dfn>inverse</dfn> (aussi nommé
mode <dfn>passerelle</dfn>).</p>
</section> <!-- /startup -->
<section id="intranet"><title>Mandataire en Intranet</title>
- <p>Un serveur mandataire Apache situé à l'intérieur d'un Intranet
+ <p>Un serveur mandataire Apache httpd situé à l'intérieur d'un Intranet
doit faire suivre les requêtes destinées à un serveur externe à
travers le pare-feu de l'entreprise (pour ce faire, définissez la
directive <directive module="mod_proxy">ProxyRemote</directive> de
implicite. Lorsque la directive <directive
module="mod_proxy">ProxyDomain</directive> est utilisée et si le
serveur est <a href="#proxyrequests">configuré comme
- mandataire</a>, Apache peut renvoyer une réponse de redirection et
+ mandataire</a>, Apache httpd peut renvoyer une réponse de redirection et
ainsi fournir au client l'adresse de serveur correcte,
entièrement qualifiée. C'est la méthode à privilégier car le
fichier des marque-pages de l'utilisateur contiendra alors des
<default>ProxyBadHeader IsError</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
-<compatibility>Disponible depuis la version 2.0.44 d'Apache</compatibility>
+<compatibility>Disponible depuis la version 2.0.44 du serveur HTTP Apache</compatibility>
<usage>
<p>La directive <directive>ProxyBadHeader</directive> permet de
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context>
</contextlist>
-<compatibility>Disponible depuis la version 2.0.31 d'Apache. Utilisable
+<compatibility>Disponible depuis la version 2.0.31 du serveur HTTP Apache. Utilisable
dans un contexte de répertoire depuis la version 2.3.3.</compatibility>
<usage>
<usage>
<p>Cette directive permet d'activer/désactiver la fonctionnalité de
- serveur mandataire direct d'Apache. Définir ProxyRequests à
+ serveur mandataire direct d'Apache httpd. Définir ProxyRequests à
<code>Off</code> n'interdit pas l'utilisation de la directive
<directive module="mod_proxy">ProxyPass</directive>.</p>
>clé=valeur [clé=valeur ...]]</var></syntax>
<contextlist><context>directory</context>
</contextlist>
-<compatibility>Disponible depuis la version 2.2 d'Apache.</compatibility>
+<compatibility>Disponible depuis la version 2.2 du serveur HTTP Apache.</compatibility>
<usage>
<p>Cette directive parmet d'ajouter un membre à un groupe de
répartition de charge. Elle peut se trouver dans un conteneur
<contextlist><context>directory</context>
</contextlist>
<compatibility>ProxySet n'est disponible que depuis la version 2.2
-d'Apache.</compatibility>
+du serveur HTTP Apache.</compatibility>
<usage>
<p>Cette directive propose une méthode alternative pour définir tout
paramètre relatif aux répartiteurs de charge et serveurs cibles de
générale.</p>
</note>
- <p>Depuis Apache 2.1, il est possible d'utiliser un jeu de
+ <p>Depuis la version 2.1 du serveur HTTP Apache, il est possible d'utiliser un jeu de
connexions vers un serveur d'arrière-plan. Il est possible de
personnaliser ce jeu de connexions à l'aide des paramètres
<code>clé=valeur</code>. La valeur par défaut du nombre maximum de
connexions pourront être créées à la demande à concurrence du
maximum relatif, soit <code>smax</code>. Toute
connexion au dessus de <code>smax</code> se verra attribuer une
- durée de vie <code>ttl</code>. Apache ne créera jamais plus de
+ durée de vie <code>ttl</code>. Apache httpd ne créera jamais plus de
connexions vers le serveur d'arrière-plan que le maximum absolu,
soit <code>max</code>.</p>
processus pour le MPM utilisé. Pour le MPM Prefork, la valeur
est toujours 1, alors que pour le MPM Worker, elle est contrôlée
par la directive <directive>ThreadsPerChild</directive>. Apache
- ne créera jamais plus de connexions vers le serveur
+ httpd ne créera jamais plus de connexions vers le serveur
d'arrière-plan que le maximum absolu.</td></tr>
<tr><td>smax</td>
<td>max</td>
<td>-</td>
<td>Cette clé permet de définir le délai maximum d'attente pour
une connexion libre dans le jeu de connexions, en millisecondes.
- S'il n'y a pas de connexion libre dans le jeu, Apache renverra
+ S'il n'y a pas de connexion libre dans le jeu, Apache httpd renverra
l'état <code>SERVER_BUSY</code> au client.
</td></tr>
<tr><td>connectiontimeout</td>
<td>timeout</td>
<td>Délai d'attente d'une connexion en secondes.
- La durée en secondes pendant laquelle Apache va attendre pour
+ La durée en secondes pendant laquelle Apache httpd va attendre pour
l'établissement d'une connexion vers le serveur d'arrière-plan.
Le délai peut être spécifié en millisecondes en ajoutant le
suffixe ms.
fermer immédiatement une connexion vers le serveur
d'arrière-plan après utilisation, et ainsi désactiver le jeu de
connexions permanentes vers ce serveur. Ceci peut s'avérer utile
- dans des situations où un pare-feu situé entre Apache et le
+ dans des situations où un pare-feu situé entre Apache httpd et le
serveur d'arrière-plan (quelque soit le protocole) interrompt
des connexions de manière silencieuse, ou lorsque le serveur
d'arrière-plan lui-même est accessible par rotation de DNS
<tr><td>keepalive</td>
<td>Off</td>
<td>Cette clé doit être utilisée lorsque vous avez un pare-feu
- entre Apache et le serveur d'arrière-plan, et si ce dernier tend
+ entre Apache httpd et le serveur d'arrière-plan, et si ce dernier tend
à interrompre les connexions inactives. Cette clé va faire en
sorte que le système d'exploitation envoie des messages
<code>KEEP_ALIVE</code> sur chacune des connexions inactives
<td>60</td>
<td>Délai entre deux essais du serveur cible du jeu de connexions en
secondes. Si le serveur cible du jeu de connexions vers le serveur
- d'arrière-plan est dans un état d'erreur, Apache ne redirigera
+ d'arrière-plan est dans un état d'erreur, Apache httpd ne redirigera
pas de requête vers ce serveur avant l'expiration du délai
spécifié. Ceci permet d'arrêter le serveur d'arrière-plan pour
maintenance, et de le remettre en ligne plus tard. Une valeur de
<tr><td>timeout</td>
<td><directive module="mod_proxy">ProxyTimeout</directive></td>
<td>Délai d'attente de la connexion en secondes. Le nombre de
- secondes pendant lesquelles Apache attend l'envoi de
+ secondes pendant lesquelles Apache httpd attend l'envoi de
données vers le serveur d'arrière-plan.
</td></tr>
<tr><td>ttl</td>
<td>-</td>
<td>Durée de vie des connexions inactives en surnombre par
rapport aux <code>smax</code> premières connexions en secondes.
- Apache fermera toutes les connexions qui n'ont pas été utilisées
+ Apache httpd fermera toutes les connexions qui n'ont pas été utilisées
pendant ce laps de temps.
</td></tr>
</contextlist>
<usage>
- <p>Cette directive permet de faire en sorte qu'Apache ajuste l'URL
+ <p>Cette directive permet de faire en sorte qu'Apache httpd ajuste l'URL
dans les en-têtes <code>Location</code>,
<code>Content-Location</code> et <code>URI</code> des réponses de
- redirection HTTP. Ceci est essentiel lorsqu'Apache est utilisé en
+ redirection HTTP. Ceci est essentiel lorsqu'Apache httpd est utilisé en
tant que mandataire inverse (ou passerelle), afin d'éviter de
court-circuiter le mandataire inverse suite aux redirections HTTP
sur le serveur d'arrière-plan qui restent derrière le mandataire
inverse.</p>
<p>Seuls les en-têtes de réponse HTTP spécialement mentionnés
- ci-dessus seront réécrits. Apache ne réécrira ni les autres en-têtes
+ ci-dessus seront réécrits. Apache httpd ne réécrira ni les autres en-têtes
de réponse, ni les références d'URLs dans les pages HTML. Cela
signifie que dans le cas où un contenu mandaté contient des
références à des URLs absolues, elles court-circuiteront le
<code>backend.example.com</code> envoie : lorsque
<code>http://backend.example.com/bar</code> est redirigé par
celui-ci vers <code>http://backend.example.com/quux</code>, Apache
- corrige ceci en <code>http://example.com/miroir/foo/quux</code>
+ httpd corrige ceci en <code>http://example.com/miroir/foo/quux</code>
avant de faire suivre la redirection HTTP au client. Notez que le
nom d'hôte utilisé pour construire l'URL est choisi en respectant la
définition de la directive <directive
<default>ProxyMaxForwards -1</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
-<compatibility>Disponible depuis Apache 2.0 ; comportement par défaut
+<compatibility>Disponible depuis la version 2.0 du serveur HTTP Apache ; comportement par défaut
modifié dans 2.2.7/2.3</compatibility>
<usage>
<directive>ProxyMaxForwards</directive> constitue une violation du
protocole HTTP/1.1 (RFC2616), qui interdit à un mandataire de
définir <code>Max-Forwards</code> si le client ne l'a pas fait
- lui-même. Les versions précédentes d'Apache la définissaient
+ lui-même. Les versions précédentes d'Apache httpd la définissaient
systématiquement. Une valeur négative de
<directive>ProxyMaxForwards</directive>, y compris la valeur par
défaut -1, implique un comportement compatible avec le protocole,
<usage>
<p>Cette directive n'a d'utilité que pour les serveurs mandataires
- Apache au sein d'Intranets. La directive
+ Apache httpd au sein d'Intranets. La directive
<directive>NoProxy</directive> permet de spécifier une liste de
sous-réseaux, d'adresses IP, de serveurs et/ou de domaines séparés
par des espaces. Une requête pour un serveur qui correspond à un ou
<p>Dans de nombreuses situations, il est plus efficace de
spécifier une <var><a href="#ipaddr">adresse IP</a></var> qu'un
<var>Nom de serveur</var> car cela évite d'avoir à effectuer une
- recherche DNS. La résolution de nom dans Apache peut prendre un
+ recherche DNS. La résolution de nom dans Apache httpd peut prendre un
temps très long lorsque la connexion avec le serveur de noms
utilise une liaison PPP lente.</p>
<p>Les comparaisons de <var>Nom de serveur</var> s'effectuent sans tenir
module="core">Timeout</directive></default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
-<compatibility>Disponible depuis la version 2.0.31 d'Apache</compatibility>
+<compatibility>Disponible depuis la version 2.0.31 du serveur HTTP Apache</compatibility>
<usage>
<p>Cette directive permet à l'utilisateur de spécifier un délai pour
<usage>
<p>Cette directive n'a d'utilité que pour les serveurs mandataires
- Apache au sein d'un Intranet. La directive
+ Apache httpd au sein d'un Intranet. La directive
<directive>ProxyDomain</directive> permet de spécifier le domaine
par défaut auquel le serveur mandataire apache appartient. Si le
serveur reçoit une requête pour un hôte sans nom de domaine, il va
serveur courant.</li>
<li>Si elle est définie à <code>Full</code>, chaque ligne d'en-tête
- <code>Via:</code> se verra ajouter la version du serveur Apache sous
- la forme d'un champ de commentaire <code>Via:</code>.</li>
+ <code>Via:</code> se verra ajouter la version du serveur Apache
+ httpd sous la forme d'un champ de commentaire <code>Via:</code>.</li>
<li>Si elle est définie à <code>Block</code>, chaque requête
mandatée verra ses lignes d'en-tête <code>Via:</code> supprimées.
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 658546 -->
+<!-- English Revision : 926416 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
</example>
</summary>
-<seealso><a href="../env.html">Les variables d'environnement dans
-Apache</a></seealso>
+<seealso><a href="../env.html">Les variables d'environnement et le
+serveur HTTP Apache</a></seealso>
<directivesynopsis>
<name>BrowserMatch</name>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>FileInfo</override>
-<compatibility>Versions 1.2 d'Apache et supérieures (dans Apache 1.2,
-cette directive se trouvait dans le module mod_browser devenu depuis
-obsolète)</compatibility>
<usage>
seconde forme, la variable sera supprimée si elle a été définie au
préalable, et dans la troisième forme, la variable sera définie à la
valeur littérale spécifiée par <code><em>valeur</em></code>. Depuis
- la version 2.0.51, Apache reconnaît les occurrences de variables
+ la version 2.0.51, Apache httpd reconnaît les occurrences de variables
<code>$1</code>..<code>$9</code> à l'intérieur de
<code><em>valeur</em></code>, et les remplace par les
sous-expressions entre parenthèses correspondantes de
jeu [a-z].</p>
</usage>
-<seealso><a href="../env.html">Les variables d'environnement dans
-Apache</a> pour des exemples supplémentaires.
+<seealso><a href="../env.html">Les variables d'environnement et le
+serveur HTTP Apache</a> pour des exemples supplémentaires.
</seealso>
</directivesynopsis>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>FileInfo</override>
-<compatibility>Versions 1.3 d'Apache et supérieures</compatibility>
<usage>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 420990 -->
+<!-- English Revision : 926413 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<summary>
<p>Sur les systèmes d'exploitation sélectionnés, ce module peut être
- utilisé pour charger des modules dans Apache en cours d'exécution
+ utilisé pour charger des modules dans le serveur HTTP Apache en cours d'exécution
grâce au mécanisme des <a
href="../dso.html">Dynamic Shared Object ou Objets Partagés
Dynamiquement</a> (DSO), et évite ainsi de devoir effectuer une
<code>.dll</code>.</p>
<note type="warning"><title>Avertissement</title>
- <p>Les modules Apache 1.3 ne peuvent pas être utilisés directement
- avec Apache 2.0 - ils doivent être modifiés pour pouvoir être
- chargés dynamiquement ou compilés dans Apache 2.0.</p>
+ <p>En général, les modules compilés pour une version majeure du
+ serveur HTTP Apache ne fonctionneront pas avec une autre (par
+ exemple de 1.3 à 2.0 ou 2.0 à 2.2). D'une version majeure à l'autre,
+ il y a souvent des modifications d'API qui nécessitent des
+ modifications du module pour qu'il puisse fonctionner avec la
+ nouvelle version.</p>
</note>
</summary>
<note><title>Note</title>
<p>Le format des noms de modules pour Windows a été modifié avec
- Apache 1.3.15 et 2.0 - les modules possèdent maintenant un nom du
- style "mod_foo.so".</p>
+ les version 1.3.15 et 2.0 du serveur HTTP Apache - les modules
+ possèdent maintenant un nom du style "mod_foo.so".</p>
<p>Bien que mod_so puisse encore charger des modules possèdant un
nom du style ApacheModuleFoo.dll, il est préférable d'utiliser la
chargeable pour la version 2.0, veuillez aussi modifier son nom pour
respecter cette nouvelle convention.</p></note>
- <p>Les API des modules Apache sous Unix et Windows sont identiques.
+ <p>Les API des modules Apache httpd sous Unix et Windows sont identiques.
Alors que certains modules s'appuient sur certains
aspects de l'architecture Unix non présents dans Windows, et ne
fonctionneront donc pas sur cette dernière plate-forme, de nombreux
<p>Lorsqu'un module fonctionne, il peut être ajouté au serveur de
deux manières. Sous Unix, il peut être compilé dans le serveur.
- Comme Apache pour Windows ne dispose pas du programme
- <code>Configure</code> propre à Apache pour Unix, le fichier source
+ Comme Apache httpd pour Windows ne dispose pas du programme
+ <code>Configure</code> propre à Apache httpd pour Unix, le fichier source
du module doit être ajouté au fichier projet Apache de base, et ses
symboles ajoutés au fichier <code>os\win32\modules.c</code>.</p>
serveur en cours d'exécution via la directive
<code><directive>LoadModule</directive></code>. Ces modules DLL
peuvent être distribués et exécutés sur toute installation d'Apache
- pour Windows, sans avoir à recompiler le serveur.</p>
+ httpd pour Windows, sans avoir à recompiler le serveur.</p>
<p>Pour créer un module DLL, il est nécessaire d'apporter une légère
modification à son fichier source : l'enregistrement du module doit
être exporté depuis la DLL (qui sera elle-même créée plus tard ;
voir plus loin). Pour ce faire, ajoutez la macro
<code>AP_MODULE_DECLARE_DATA</code> (définie dans les fichiers
- d'en-têtes d'Apache) à la définition de l'enregistrement de votre
+ d'en-têtes d'Apache httpd) à la définition de l'enregistrement de votre
module. Par exemple, si votre module est déclaré comme suit :</p>
<example>
d'export libhttpd.lib qui a été créée au cours de la compilation de
la bibliothèque partagée libhttpd.dll. Il sera peut-être aussi
nécessaire de modifier la configuration du compilateur pour
- s'assurer que les fichiers d'en-têtes d'Apache seront correctement
+ s'assurer que les fichiers d'en-têtes d'Apache httpd seront correctement
localisés. Vous trouverez cette bibliothèque à la racine du
répertoire des modules de votre serveur. Il est souhaitable
d'utiliser un fichier de module .dsp existant dans l'arborescence
requête (*)</li>
<li>Le pourcentage CPU instantané utilisé par chaque processus et
- par Apache tout entier (*)</li>
+ par l'ensemble des processus (*)</li>
<li>Les hôtes et requêtes actuellement en cours de traitement
(*)</li>
permet d'obtenir une version du fichier d'état lisible par une
machine. Ceci s'avère intéressant dans le cadre d'une exécution
automatique : voir le programme en Perl
- <code>log_server_status</code>situé dans le répertoire
- <code>/support</code> de la distribution d'Apache.</p>
+ <code>log_server_status</code> situé dans le répertoire
+ <code>/support</code> de votre distribution du serveur HTTP Apache.</p>
<note>
<strong>Veuillez noter que si <module>mod_status</module> a été
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 735922:926398 (outdated) -->
+<!-- English Revision: 927824 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
comprendre la différence entre les deux. Le système de fichiers est une vue
de vos disques tels qu'ils sont perçus par votre système d'exploitation.
Par exemple, avec une installation par défaut,
-Apache est situé dans <code>/usr/local/apache2</code> pour le système de
+Apache httpd est situé dans <code>/usr/local/apache2</code> pour le système de
fichiers UNIX, ou <code>"c:/Program Files/Apache Group/Apache2"</code> pour
le système de fichiers Windows. (Notez que des slashes directs doivent
-toujours être utilisés comme séparateur de chemin dans Apache, même sous
+toujours être utilisés comme séparateur de chemin
+dans les fichiers de configuration d'Apache httpd, même sous
Windows.) Quant à
l'arborescence du site web, il s'agit d'une vue de votre site
tel que présenté par le
serveur web et perçue par le client. Ainsi le chemin <code>/dir/</code> dans
l'arborescence du site web correspond au chemin
<code>/usr/local/apache2/htdocs/dir/</code> dans le système de fichiers pour
-une installation d'Apache par défaut sous UNIX.
+une installation d'Apache httpd par défaut sous UNIX.
En outre, l'arborescence du site web n'a pas besoin de correspondre en permanence au
système de fichiers, car les pages web peuvent être générées dynamiquement
à partir de bases de données ou d'autres emplacements.</p>
<p>Le conteneur <directive type="section" module="core">Location</directive>
n'a pas besoin de faire référence à un élément du système de fichiers.
Par exemple, l'exemple suivant montre comment faire référence à une URL
-particulière vers un gestionnaire interne d'Apache fourni par le module
+particulière vers un gestionnaire interne du serveur HTTP Apache fourni par le module
<module>mod_status</module>.
Il n'est pas nécessaire de trouver un fichier nommé <code>server-status</code>
dans le système de fichiers.</p>
</example>
</section>
+<section id="overlapping-webspace"><title>Espace web imbriqué</title>
+Pour contrôler deux URLs imbriquées, on doit tenir compte de l'ordre
+dans lequel certaines sections ou directives sont évaluées. Pour
+<directive type="section" module="core">Location</directive>, on doit
+avoir :
+<example>
+<Location /foo><br />
+</Location><br />
+<Location /foo/bar><br />
+</Location>
+</example>
+Les directives <directive type="section"
+module="core">Alias</directive>, quant à elles, sont évaluées vice-versa :
+<example>
+Alias /foo/bar /srv/www/uncommon/bar<br />
+Alias /foo /srv/www/common/foo<br />
+</example>
+Ceci est aussi vrai pour les directives <directive
+module="mod_proxy">ProxyPass</directive> :
+<example>
+ProxyPass /special-area http://special.example.com smax=5 max=10
+ProxyPass / balancer://mycluster/ stickysession=JSESSIONID|jsessionid nofailover=On
+</example>
+</section>
+
+
<section id="wildcards"><title>Caractères de remplacement
et expressions rationnelles</title>
projects / apache / commitdiff