You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2016/09/17 13:16:01 UTC
svn commit: r1761221 - in /httpd/httpd/branches/2.4.x/docs/manual:
install.xml.fr mod/mod_dbd.xml.fr mod/mod_proxy_html.xml.fr
rewrite/vhosts.xml.fr
Author: lgentis
Date: Sat Sep 17 13:16:00 2016
New Revision: 1761221
URL: http://svn.apache.org/viewvc?rev=1761221&view=rev
Log:
XML updates.
Modified:
httpd/httpd/branches/2.4.x/docs/manual/install.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_dbd.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_html.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/rewrite/vhosts.xml.fr
Modified: httpd/httpd/branches/2.4.x/docs/manual/install.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/install.xml.fr?rev=1761221&r1=1761220&r2=1761221&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/install.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/install.xml.fr Sat Sep 17 13:16:00 2016
@@ -1,9 +1,9 @@
-<?xml version="1.0" encoding="ISO-8859-1" ?>
+<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1685413:1760550 (outdated) -->
+<!-- English Revision: 1760550 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -30,37 +30,37 @@
<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
+ sur les systèmes Unix et similaires seulement. Pour la compilation et
l'installation sous Windows, voir <a
href="platform/windows.html">Utiliser le serveur HTTP Apache avec Microsoft
Windows</a> et <a href="platform/win_compiling.html">Compilation
d'Apache sous Microsoft Windows</a>. Pour les autres plateformes, se
- référer à la documentation par
+ référer à la documentation par
<a href="platform/">plateforme</a>.</p>
<p>Apache httpd utilise <code>libtool</code> et <code>autoconf</code>
- afin de créer un environnement de construction similaire à la plupart
+ afin de créer un environnement de construction similaire à la plupart
des projets Open Source .</p>
- <p>Si vous effectuez une mise à jour depuis une version mineure vers
- la suivante (par exemple, 2.4.9 à 2.4.10), veuillez passer à la section
- <a href="#upgrading">mise à jour</a>.</p>
+ <p>Si vous effectuez une mise à jour depuis une version mineure vers
+ la suivante (par exemple, 2.4.9 à 2.4.10), veuillez passer à la section
+ <a href="#upgrading">mise à jour</a>.</p>
</summary>
<seealso><a href="programs/configure.html">Configuration de l'arborescence
des sources</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>
+<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="overview"><title>Aperçu pour les plus pressés</title>
<table>
<columnspec><column width=".13"/><column width=".80"/></columnspec>
<tr>
- <td><a href="#download">Téléchargement</a></td>
+ <td><a href="#download">Téléchargement</a></td>
- <td><code>$ lynx http://httpd.apache.org/download.cgi</code>
+ <td>Téléchargez la dernière version depuis <a href="http://httpd.apache.org/download.cgi#apache24">http://httpd.apache.org/download.cgi</a>
</td>
</tr>
@@ -105,115 +105,115 @@
</tr>
</table>
- <p><em>NN</em> doit être remplacé par le numéro de version courant,
+ <p><em>NN</em> doit être remplacé par le numéro de version courant,
et <em>PREFIX</em> par le
- chemin du répertoire d'installation. Si
- <em>PREFIX</em> n'est pas spécifié, le chemin du répertoire
- d'installation prendra sa valeur par défaut, à savoir
+ chemin du répertoire d'installation. Si
+ <em>PREFIX</em> n'est pas spécifié, le chemin du répertoire
+ d'installation prendra sa valeur par défaut, à savoir
<code>/usr/local/apache2</code>.</p>
- <p>Chaque étape du processus de compilation et d'installation est
- décrite plus en détails ci-dessous, à commencer par les prérequis
+ <p>Chaque étape du processus de compilation et d'installation est
+ décrite plus en détails ci-dessous, à commencer par les prérequis
pour compiler et installer Apache httpd.</p>
</section>
-<section id="requirements"><title>Prérequis</title>
+<section id="requirements"><title>Prérequis</title>
- <p>Les prérequis pour la construction d'Apache httpd sont les suivants:</p>
+ <p>Les prérequis pour la construction d'Apache httpd sont les suivants:</p>
<dl>
<dt>APR et APR-Util</dt>
- <dd>APR et APR-Util doivent être déjà installés sur votre système.
- Si ce n'est pas le cas, ou si vous préférez ne pas utiliser les
- versions fournies par le système, téléchargez les dernières
+ <dd>APR et APR-Util doivent être déjà installés sur votre système.
+ Si ce n'est pas le cas, ou si vous préférez ne pas utiliser les
+ versions fournies par le système, téléchargez les dernières
versions d'APR et APR-Util depuis <a
- href="http://apr.apache.org/">Apache APR</a>, décompressez-les
+ href="http://apr.apache.org/">Apache APR</a>, décompressez-les
respectivement dans <code>/racine_sources_httpd/srclib/apr</code> et
- <code>/racine_sources_httpd/srclib/apr-util</code> (les noms des répertoires ne
- doivent pas comporter de numéros de versions ; par exemple, la
+ <code>/racine_sources_httpd/srclib/apr-util</code> (les noms des répertoires ne
+ doivent pas comporter de numéros de versions ; par exemple, la
distribution d'APR doit se trouver dans /racine_sources_httpd/srclib/apr/), et
utilisez l'option <code>--with-included-apr</code> du script
<code>./configure</code>. Sur certaines plateformes, vous devrez
- peut-être installer les paquets <code>-dev</code> correspondants
+ peut-être installer les paquets <code>-dev</code> correspondants
pour permettre la compilation de httpd avec les versions
- installées d'APR et APR-Util.</dd>
+ installées d'APR et APR-Util.</dd>
- <dt>Bibliothèque d'expressions rationnelles compatibles Perl
+ <dt>Bibliothèque d'expressions rationnelles compatibles Perl
(PCRE)</dt>
- <dd>Cette bibliothèque est nécessaire mais n'est plus fournie avec la
- distribution de httpd. Téléchargez le code source depuis <a
+ <dd>Cette bibliothèque est nécessaire mais n'est plus fournie avec la
+ distribution de httpd. Téléchargez le code source depuis <a
href="http://www.pcre.org/">http://www.pcre.org</a> ou installez
un portage du paquet. Si votre suite de compilation ne trouve pas
- le script pcre-config installé au cours du processus de
+ le script pcre-config installé au cours du processus de
construction de PCRE, indiquez son chemin via l'option
<code>--with-pcre</code> du script <code>./configure</code>. Sur
certaines plateformes, vous devrez
- peut-être installer les paquets <code>-dev</code> correspondants
+ peut-être installer les paquets <code>-dev</code> correspondants
pour permettre la compilation de httpd avec la version
- installée de PCRE.</dd>
+ installée de PCRE.</dd>
<dt>Espace disque</dt>
<dd>Assurez-vous d'avoir au moins 50 Mo d'espace disque disponible
- temporaire. Après l'installation le serveur occupe
- approximativement 10 Mo d'espace disque. L'espace disque réellement
- nécessaire va varier considérablement en fonction de vos options
- de configuration, de la présence éventuelle de
+ temporaire. Après l'installation le serveur occupe
+ approximativement 10 Mo d'espace disque. L'espace disque réellement
+ nécessaire va varier considérablement en fonction de vos options
+ de configuration, de la présence éventuelle de
modules tiers, et bien entendu de la taille de votre site web et
- des sites que vous hébergez sur votre serveur.</dd>
+ des sites que vous hébergez sur votre serveur.</dd>
- <dt>Compilateur ANSI-C et système de construction</dt>
+ <dt>Compilateur ANSI-C et système de construction</dt>
<dd>Vous devez disposer d'un compilateur ANSI-C. Le compilateur <a
href="http://gcc.gnu.org/">GNU C (GCC)</a> de la <a
href="http://www.gnu.org/">Free Software Foundation (FSF)</a>
- est recommandé. Si vous ne possédez pas GCC,
+ est recommandé. Si vous ne possédez pas GCC,
assurez-vous au moins que votre compilateur soit compatible ANSI.
En outre, votre <code>PATH</code> doit contenir
les outils de construction de base tels que <code>make</code>.</dd>
<dt>Connaissance de l'heure exacte</dt>
- <dd>Les éléments du protocole HTTP font référence à l'heure du jour.
- Par conséquent, il est nécessaire d'équiper votre système d'un
+ <dd>Les éléments du protocole HTTP font référence à l'heure du jour.
+ Par conséquent, il est nécessaire d'équiper votre système d'un
dispositif de synchronisation du temps. Les programmes
- <code>ntpdate</code> ou <code>xntpd</code>, basés sur le protocole NTP,
- sont couramment utilisés à cet effet.
+ <code>ntpdate</code> ou <code>xntpd</code>, basés sur le protocole NTP,
+ sont couramment utilisés à cet effet.
Voir la <a href="http://www.ntp.org">page d'accueil de NTP</a>
- pour plus de détails à propos du logiciel NTP et des serveurs
+ pour plus de détails à propos du logiciel NTP et des serveurs
de temps publics.</dd>
<dt><a href="http://www.perl.org/">Perl 5</a>
[OPTIONNEL]</dt>
- <dd>L'interpréteur Perl 5 (les versions 5.003 ou supérieures conviennent)
- est nécessaire pour l'exécution de certains scripts comme
+ <dd>L'interpréteur Perl 5 (les versions 5.003 ou supérieures conviennent)
+ est nécessaire pour l'exécution de certains scripts comme
<program>apxs</program> ou <program>dbmmanage</program>
- (qui sont écrits en Perl).
- Si le script <program>configure</program> ne trouve pas d'interpréteur
+ (qui sont écrits en Perl).
+ Si le script <program>configure</program> ne trouve pas d'interpréteur
Perl 5, vous ne pourrez pas utiliser les scripts qui en ont besoin.
- Bien entendu, vous pourrez tout de même construire et utiliser
+ Bien entendu, vous pourrez tout de même construire et utiliser
Apache httpd.</dd>
</dl>
</section>
-<section id="download"><title>Téléchargement</title>
+<section id="download"><title>Téléchargement</title>
- <p>Le serveur HTTP Apache peut être téléchargé à partir du
- <a href="http://httpd.apache.org/download.cgi">site de téléchargement
+ <p>Le serveur HTTP Apache peut être téléchargé à partir du
+ <a href="http://httpd.apache.org/download.cgi">site de téléchargement
du serveur HTTP Apache</a>, qui fournit la liste de nombreux miroirs.
- Il sera plus commode à la plupart des utilisateurs d'Apache sur les
- systèmes UNIX ou similaires de télécharger et de compiler
- la version sources. Le processus de construction (décrit ci-dessous) est
+ Il sera plus commode à la plupart des utilisateurs d'Apache sur les
+ systèmes UNIX ou similaires de télécharger et de compiler
+ la version sources. Le processus de construction (décrit ci-dessous) est
simple, et vous permet de personnaliser votre serveur selon vos besoins.
En outre, les versions binaires sont souvent plus anciennes que les
- dernières versions sources. Si vous téléchargez une version binaire,
- suivez les instructions décrites dans le fichier
+ dernières versions sources. Si vous téléchargez une version binaire,
+ suivez les instructions décrites dans le fichier
<code>INSTALL.bindist</code> inclus dans la distribution.</p>
- <p>Après le téléchargement, il est important de vérifier que vous
- disposez d'une version complète et non modifiée du serveur HTTP Apache.
- Vous pouvez le faire en testant l'archive téléchargée à l'aide de
- la signature PGP. Vous trouverez les détails de cette opération sur la <a
+ <p>Après le téléchargement, il est important de vérifier que vous
+ disposez d'une version complète et non modifiée du serveur HTTP Apache.
+ Vous pouvez le faire en testant l'archive téléchargée à l'aide de
+ la signature PGP. Vous trouverez les détails de cette opération sur la <a
href="http://httpd.apache.org/download.cgi#verify"
- >page de téléchargement</a> ainsi qu'un exemple précis décrivant <a
+ >page de téléchargement</a> ainsi qu'un exemple précis décrivant <a
href="http://httpd.apache.org/dev/verification.html">l'utilisation de
PGP</a>.</p>
@@ -222,77 +222,77 @@
<section id="extract"><title>Extraction</title>
<p>L'extraction des sources depuis l'archive du serveur HTTP Apache consiste
- simplement à décompresser et à désarchiver cette dernière :</p>
+ simplement à décompresser et à désarchiver cette dernière :</p>
<example>
$ gzip -d httpd-<em>NN</em>.tar.gz<br />
$ tar xvf httpd-<em>NN</em>.tar
</example>
- <p>Ceci créera, dans le répertoire courant, un nouveau répertoire
+ <p>Ceci créera, dans le répertoire courant, un nouveau répertoire
contenant le code source de la distribution. Vous devrez vous positionner
- dans ce répertoire avant de procéder à la compilation du serveur.</p>
+ dans ce répertoire avant de procéder à la compilation du serveur.</p>
</section>
<section id="configure"><title>Configuration de l'arborescence des sources</title>
- <p>L'étape suivante consiste à configurer l'arborescence des sources
+ <p>L'étape suivante consiste à configurer l'arborescence des sources
d'Apache en fonction de votre plateforme et de vos besoins personnels.
- Le script <program>configure</program>, situé à la racine du
- répertoire de la distribution, a été conçu à cet effet
- (Les développeurs qui téléchargent
+ Le script <program>configure</program>, situé à la racine du
+ répertoire de la distribution, a été conçu à cet effet
+ (Les développeurs qui téléchargent
une version non officielle de l'arborescence des sources d'Apache
devront disposer de
<code>autoconf</code> et <code>libtool</code> et
- exécuter <code>buildconf</code> avant de passer à l'étape suivante,
- ce qui n'est pas nécessaire pour les versions officielles).</p>
+ exécuter <code>buildconf</code> avant de passer à l'étape suivante,
+ ce qui n'est pas nécessaire pour les versions officielles).</p>
- <p>Pour configurer l'arborescence des sources avec les valeurs par défaut
+ <p>Pour configurer l'arborescence des sources avec les valeurs par défaut
pour toutes les options, entrez simplement <code>./configure</code>.
Pour modifier les valeurs des options, <program>configure</program>
- accepte toute une variété de variables et
+ accepte toute une variété de variables et
d'options de ligne de commande.</p>
<p>L'option la plus importante <code>--prefix</code> est le chemin
- du répertoire d'installation d'Apache, car Apache doit être configuré
+ du répertoire d'installation d'Apache, car Apache doit être configuré
en fonction de ce chemin pour pouvoir fonctionner correctement.
- Il est possible de définir plus finement le chemin d'installation des fichiers
- à l'aide d'<a
+ Il est possible de définir plus finement le chemin d'installation des fichiers
+ à l'aide d'<a
href="programs/configure.html#installationdirectories">options
- supplémentaires de configure</a>.</p>
+ supplémentaires de configure</a>.</p>
- <p>À ce niveau, vous pouvez aussi spécifier de quelles <a
- href="programs/configure.html#optionalfeatures">fonctionnalités</a> vous
- voulez disposer dans Apache en activant ou désactivant des <a
+ <p>À ce niveau, vous pouvez aussi spécifier de quelles <a
+ href="programs/configure.html#optionalfeatures">fonctionnalités</a> vous
+ voulez disposer dans Apache en activant ou désactivant des <a
href="mod/">modules</a>. Apache est fourni avec un grand nombre de
- modules inclus par défaut. Ils seront compilés en tant qu'<a
- href="dso.html">objets partagés (DSOs)</a> qui pourront être chargés
- ou déchargés à l'exécution. Vous pouvez aussi choisir de compiler
+ modules inclus par défaut. Ils seront compilés en tant qu'<a
+ href="dso.html">objets partagés (DSOs)</a> qui pourront être chargés
+ ou déchargés à l'exécution. Vous pouvez aussi choisir de compiler
les modules statiquement via l'option
<code>--enable-<var>module</var>=static</code>.</p>
- <p>Des modules supplémentaires peuvent être activés à l'aide de l'option
- <code>--enable-<var>module</var></code>, où
- <var>module</var> est le nom du module sans la chaîne
- <code>mod_</code> et où tout caractère de soulignement est converti
- en tiret. D'une manière similaire,
- vous pouvez désactiver des modules à l'aide de l'option
- <code>--disable-<var>module</var></code>. Faites très attention
+ <p>Des modules supplémentaires peuvent être activés à l'aide de l'option
+ <code>--enable-<var>module</var></code>, où
+ <var>module</var> est le nom du module sans la chaîne
+ <code>mod_</code> et où tout caractère de soulignement est converti
+ en tiret. D'une manière similaire,
+ vous pouvez désactiver des modules à l'aide de l'option
+ <code>--disable-<var>module</var></code>. Faites très attention
en utilisant ces options, car <program>configure</program> n'est pas en
- mesure de vous avertir si le module que vous avez spécifié n'existe pas;
+ mesure de vous avertir si le module que vous avez spécifié n'existe pas;
il ignorera tout simplement l'option.</p>
- <p>En outre, vous devrez peut-être fournir au script
- <program>configure</program> des informations supplémentaires sur
- le chemin de votre compilateur, de vos bibliothèques, ou de vos fichiers
- d'en-têtes. A cet effet, vous pouvez passer des options de ligne de
+ <p>En outre, vous devrez peut-être fournir au script
+ <program>configure</program> des informations supplémentaires sur
+ le chemin de votre compilateur, de vos bibliothèques, ou de vos fichiers
+ d'en-têtes. A cet effet, vous pouvez passer des options de ligne de
commande ou des variables d'environnement au script
<program>configure</program>. Pour plus d'informations, voir la
page de manuel de <program>configure</program>, ou lancez le script
<program>configure</program> avec l'option <code>--help</code>.
</p>
- <p>Pour vous faire une idée des possibilités qui s'offrent à vous, voici
- un exemple typique de compilation d'Apache avec le répertoire
+ <p>Pour vous faire une idée des possibilités qui s'offrent à vous, voici
+ un exemple typique de compilation d'Apache avec le répertoire
d'installation <code>/sw/pkg/apache</code>, un compilateur et des drapeaux
particuliers et les deux modules additionnels <module>mod_ldap</module>
et <module>mod_lua</module> :</p>
@@ -304,113 +304,113 @@ $ tar xvf httpd-<em>NN</em>.tar
--enable-lua=shared
</example>
- <p>Plusieurs minutes peuvent être nécessaires à
- <program>configure</program> pour tester la disponibilité des
- fonctionnalités
- au sein de votre système, et construire les Makefiles qui seront utilisés
+ <p>Plusieurs minutes peuvent être nécessaires à
+ <program>configure</program> pour tester la disponibilité des
+ fonctionnalités
+ au sein de votre système, et construire les Makefiles qui seront utilisés
par la suite pour compiler le serveur.</p>
- <p>Vous trouverez une description détaillée des options de
+ <p>Vous trouverez une description détaillée des options de
<program>configure</program> dans sa page de manuel.</p>
</section>
<section id="compile"><title>Construction</title>
- <p>Vous pouvez maintenant construire les différents éléments qui
- composent le paquet Apache en lançant tout simplement la commande :</p>
+ <p>Vous pouvez maintenant construire les différents éléments qui
+ composent le paquet Apache en lançant tout simplement la commande :</p>
<example>$ make</example>
- <p>Vous devez être patient, car il faut plusieurs minutes pour compiler
- une configuration de base, et cette durée peut varier considérablement
- en fonction de votre matériel et du nombre de modules que vous avez activés.</p>
+ <p>Vous devez être patient, car il faut plusieurs minutes pour compiler
+ une configuration de base, et cette durée peut varier considérablement
+ en fonction de votre matériel et du nombre de modules que vous avez activés.</p>
</section>
<section id="install"><title>Installation</title>
- <p>Il est temps maintenant d'installer le paquet dans le répertoire
- d'installation défini par <em>PREFIX</em> (voir plus haut l'option
- <code>--prefix</code>) en lançant:</p>
+ <p>Il est temps maintenant d'installer le paquet dans le répertoire
+ d'installation défini par <em>PREFIX</em> (voir plus haut l'option
+ <code>--prefix</code>) en lançant:</p>
<example>$ make install</example>
- <p>Cette étape nécessite habituellement les privilèges
- de root, car <em>PREFIX</em> est en général un
- répertoire possèdant des droits en écriture
+ <p>Cette étape nécessite habituellement les privilèges
+ de root, car <em>PREFIX</em> est en général un
+ répertoire possèdant des droits en écriture
restreints.</p>
- <p>Si vous effectuez une mise à jour, l'installation n'écrasera pas
+ <p>Si vous effectuez une mise à jour, l'installation n'écrasera pas
vos fichiers de configuration ou autres documents.</p>
</section>
<section id="customize"><title>Personnalisation</title>
<p>Ensuite, vous pourrez personnaliser votre Serveur HTTP Apache en
- éditant les <a href="configuring.html">fichiers de configuration</a>
- situés dans <code><em>PREFIX</em>/conf/</code>.</p>
+ éditant les <a href="configuring.html">fichiers de configuration</a>
+ situés dans <code><em>PREFIX</em>/conf/</code>.</p>
<example>$ vi <em>PREFIX</em>/conf/httpd.conf</example>
- <p>Consultez le manuel d'Apache situé dans
+ <p>Consultez le manuel d'Apache situé dans
<code><em>PREFIX</em>/docs/manual/</code> ou
<a href="http://httpd.apache.org/docs/&httpd.docs;/"
>http://httpd.apache.org/docs/&httpd.docs;/</a> pour la version la plus
- récente de ce manuel et la liste complète des <a
+ récente de ce manuel et la liste complète des <a
href="mod/directives.html">directives de configuration</a> disponibles.</p>
</section>
<section id="test"><title>Test</title>
- <p>Vous pouvez maintenant <a href="invoking.html">démarrer</a> votre
- serveur HTTP Apache en lançant:</p>
+ <p>Vous pouvez maintenant <a href="invoking.html">démarrer</a> votre
+ serveur HTTP Apache en lançant:</p>
<example>$ <em>PREFIX</em>/bin/apachectl -k start</example>
- <p>Vous devriez alors pouvoir requérir votre premier document
- à l'aide de l'URL <code>http://localhost/</code>. La page web que vous
- voyez est située dans le répertoire défini par la directive
+ <p>Vous devriez alors pouvoir requérir votre premier document
+ à l'aide de l'URL <code>http://localhost/</code>. La page web que vous
+ voyez est située dans le répertoire défini par la directive
<directive module="core">DocumentRoot</directive>,
- qui est généralement <code><em>PREFIX</em>/htdocs/</code>.
- Pour <a href="stopping.html">arrêter</a> le serveur, lancez:</p>
+ qui est généralement <code><em>PREFIX</em>/htdocs/</code>.
+ Pour <a href="stopping.html">arrêter</a> le serveur, lancez:</p>
<example>$ <em>PREFIX</em>/bin/apachectl -k stop</example>
</section>
-<section id="upgrading"><title>Mise à jour</title>
+<section id="upgrading"><title>Mise à jour</title>
- <p>La première étape d'une mise à jour consiste à lire l'annonce de la
+ <p>La première étape d'une mise à jour consiste à lire l'annonce de la
sortie de la nouvelle version et le fichier <code>CHANGES</code>
- dans la distribution des sources afin de déceler toutes les modifications
+ dans la distribution des sources afin de déceler toutes les modifications
qui pourraient affecter votre site. Lors d'un changement majeur de version
- (par exemple de 2.0 à 2.2 ou de 2.2 à 2.4),
- il y aura certainement des différences importantes quant à la
- configuration de la compilation et de l'exécution qui nécessiteront des
+ (par exemple de 2.0 à 2.2 ou de 2.2 à 2.4),
+ il y aura certainement des différences importantes quant à la
+ configuration de la compilation et de l'exécution qui nécessiteront des
ajustements manuels. Tous les
- modules devront aussi être mis à jour pour qu'ils s'adaptent aux
+ modules devront aussi être mis à jour pour qu'ils s'adaptent aux
changements de l'API des modules.</p>
- <p>La mise à jour d'une version mineure à la suivante (par exemple, de
- 2.2.55 à 2.2.57) est plus aisée. Le processus <code>make install</code>
- n'écrasera aucun de vos documents existants, fichiers de log,
- ou fichiers de configuration. De plus, les développeurs font tout
- leur possible pour éviter les changements entraînant une
- incompatibilité dans les options de
- <program>configure</program>, la configuration de l'exécution, ou l'API
- des modules d'une version mineure à l'autre. Dans la plupart des cas,
+ <p>La mise à jour d'une version mineure à la suivante (par exemple, de
+ 2.2.55 à 2.2.57) est plus aisée. Le processus <code>make install</code>
+ n'écrasera aucun de vos documents existants, fichiers de log,
+ ou fichiers de configuration. De plus, les développeurs font tout
+ leur possible pour éviter les changements entraînant une
+ incompatibilité dans les options de
+ <program>configure</program>, la configuration de l'exécution, ou l'API
+ des modules d'une version mineure à l'autre. Dans la plupart des cas,
vous pourrez utiliser une ligne de commande
- <program>configure</program> identique, le même fichier de configuration,
+ <program>configure</program> identique, le même fichier de configuration,
et tous vos modules continueront de fonctionner.</p>
- <p>Pour effectuer une mise à jour entre deux versions mineures,
+ <p>Pour effectuer une mise à jour entre deux versions mineures,
commencez par trouver le fichier
- <code>config.nice</code> dans le répertoire de <code>construction</code>
- de votre serveur installé ou à la racine de l'arborescence des sources
+ <code>config.nice</code> dans le répertoire de <code>construction</code>
+ de votre serveur installé ou à la racine de l'arborescence des sources
de votre ancienne installation. Il contient la reproduction exacte de la
- ligne de commande <program>configure</program> que vous avez utilisée pour
- configurer l'arborescence des sources. Ensuite, pour mettre à jour
+ ligne de commande <program>configure</program> que vous avez utilisée pour
+ configurer l'arborescence des sources. Ensuite, pour mettre à jour
l'ancienne version vers la nouvelle,
il vous suffit de copier le fichier <code>config.nice</code> dans
- l'arborescence des sources de la nouvelle version, de l'éditer pour
- effectuer toute modification souhaitée, et de lancer :</p>
+ l'arborescence des sources de la nouvelle version, de l'éditer pour
+ effectuer toute modification souhaitée, et de lancer :</p>
<example>
$ ./config.nice<br />
@@ -422,14 +422,14 @@ $ tar xvf httpd-<em>NN</em>.tar
<note type="warning">Vous devez toujours effectuer un test de la nouvelle
version dans votre environnement avant de la mettre en production.
- Par exemple, vous pouvez installer et exécuter la nouvelle version
- en parallèle avec l'ancienne en utilisant une option
- <code>--prefix</code> et un port différents (en ajustant la directive
- <directive module="mpm_common">Listen</directive>) afin de déceler toute
- incompatibilité avant d'effectuer la mise à jour définitive.</note>
+ Par exemple, vous pouvez installer et exécuter la nouvelle version
+ en parallèle avec l'ancienne en utilisant une option
+ <code>--prefix</code> et un port différents (en ajustant la directive
+ <directive module="mpm_common">Listen</directive>) afin de déceler toute
+ incompatibilité avant d'effectuer la mise à jour définitive.</note>
- <p>Vous pouvez ajouter des arguments supplémentaires à
- <code>config.nice</code> ; ils seront alors ajoutés aux options de
+ <p>Vous pouvez ajouter des arguments supplémentaires à
+ <code>config.nice</code> ; ils seront alors ajoutés aux options de
votre script <program>configure</program> original :</p>
<example>
@@ -440,23 +440,23 @@ $ tar xvf httpd-<em>NN</em>.tar
<section id="thirdp"><title>Paquets tiers</title>
<p>De nombreux tiers fournissent leur propre distribution du
- serveur HTTP Apache à installer sur une plate-forme particulière. On
- peut citer les différentes distributions Linux, divers
+ serveur HTTP Apache à installer sur une plate-forme particulière. On
+ peut citer les différentes distributions Linux, divers
paquets tiers Windows, Mac OS X, Solaris et de nombreux autres.</p>
<p>Notre license logicielle non seulement permet, mais aussi
- encourage ce genre de redistribution. Cependant, ceci conduit à une
+ encourage ce genre de redistribution. Cependant, ceci conduit à une
situation ou l'organisation de la configuration et les valeurs par
- défaut de votre installation du serveur peuvent ne pas correspondre
- à ce qui est écrit dans la documentation. Bien que fâcheuse, cette
- situation n'est pas appelée à évoluer de sitôt.</p>
+ défaut de votre installation du serveur peuvent ne pas correspondre
+ à ce qui est écrit dans la documentation. Bien que fâcheuse, cette
+ situation n'est pas appelée à évoluer de sitôt.</p>
<p>Une <a
href="http://wiki.apache.org/httpd/DistrosDefaultLayout">description
de ces distributions tierces</a> est maintenue dans le wiki du
- serveur HTTP, et doit en refléter l'état actuel. Vous devrez
- cependant vous familiariser par vous-même avec la gestion du paquet
- de votre plate-forme particulière et les procédures d'installation.</p>
+ serveur HTTP, et doit en refléter l'état actuel. Vous devrez
+ cependant vous familiariser par vous-même avec la gestion du paquet
+ de votre plate-forme particulière et les procédures d'installation.</p>
</section>
</manualpage>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_dbd.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_dbd.xml.fr?rev=1761221&r1=1761220&r2=1761221&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_dbd.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_dbd.xml.fr Sat Sep 17 13:16:00 2016
@@ -1,7 +1,7 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1378507:1760182 (outdated) -->
+<!-- English Revision: 1760182 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -25,24 +25,24 @@
<modulesynopsis metafile="mod_dbd.xml.meta">
<name>mod_dbd</name>
-<description>Gestion des connexions à une base de données SQL</description>
+<description>Gestion des connexions à une base de données SQL</description>
<status>Extension</status>
<sourcefile>mod_dbd.c</sourcefile>
<identifier>dbd_module</identifier>
-<compatibility>Versions 2.1 and supérieures</compatibility>
+<compatibility>Versions 2.1 and supérieures</compatibility>
<summary>
- <p>Le module <module>mod_dbd</module> gère les connexions
- à une base de données SQL via <glossary>APR</glossary>. Il permet
- aux modules qui requièrent des fonctions liées aux bases de données
- SQL de se connecter à une base de données à la demande, et s'efforce
- de conférer aux bases de données une efficacité et une
- évolutivité optimales pour les MPMs threadés ou non threadés. Pour
- plus de détails, voir le site web <a
+ <p>Le module <module>mod_dbd</module> gère les connexions
+ à une base de données SQL via <glossary>APR</glossary>. Il permet
+ aux modules qui requièrent des fonctions liées aux bases de données
+ SQL de se connecter à une base de données à la demande, et s'efforce
+ de conférer aux bases de données une efficacité et une
+ évolutivité optimales pour les MPMs threadés ou non threadés. Pour
+ plus de détails, voir le site web <a
href="http://apr.apache.org/">APR</a>,
ainsi que cette vue d'ensemble de l'<a
href="http://people.apache.org/~niq/dbd.html">environnement de
- développement d'Apache DBD</a> par son développeur initial.
+ développement d'Apache DBD</a> par son développeur initial.
</p>
</summary>
@@ -50,20 +50,43 @@
passe</a></seealso>
<section id="pooling"><title>Regroupement des connexions</title>
- <p>Ce module gère de manière optimisée en fonction de la plate-forme
- les connexions aux bases de données. Sur les plates-formes non
- threadées, il maintient une connexion persistente à la manière d'un
+ <p>Ce module gère de manière optimisée en fonction de la plate-forme
+ les connexions aux bases de données. Sur les plates-formes non
+ threadées, il maintient une connexion persistente à la manière d'un
LAMP classique (Linux, Apache, Mysql, Perl/PHP/Python). Sur les
- plates-formes threadées, il maintient un <em>groupe de
- connexions</em> à la fois plus évolutif et plus efficace, comme
- décrit dans <a href="http://www.apachetutor.org/dev/reslist">cet
+ plates-formes threadées, il maintient un <em>groupe de
+ connexions</em> à la fois plus évolutif et plus efficace, comme
+ décrit dans <a href="http://www.apachetutor.org/dev/reslist">cet
article d'ApacheTutor</a>. Notez que <module>mod_dbd</module>
- remplace les modules présentés dans cet article.</p>
+ remplace les modules présentés dans cet article.</p>
+</section>
+
+<section id="connecting"><title>Connexion</title>
+
+ <p>Pour vous connecter à votre base de données, vous devez spécifier un
+ pilote et des paramètres de connexion qui diffèrent selon le moteur de base
+ de données. Par exemple, pour vous connecter à mysql, spécifiez ce qui suit
+ :</p>
+
+<highlight language="config">
+DBDriver mysql
+DBDParams host=localhost,dbname=pony,user=shetland,pass=appaloosa
+</highlight>
+
+ <p>Vous pourrez alors utiliser cette connexion dans de nombreux autres
+ modules comme <module>mod_rewrite</module>, <module>mod_authn_dbd</module>
+ et <module>mod_lua</module>. Vous trouverez des exemples d'utilisation dans
+ la documentation de ces modules.</p>
+
+ <p>Voir la syntaxe de la directive <directive>DBDParams</directive> pour les
+ informations à fournir dans la chaîne de connexion en fonction des
+ différents pilotes de base de données supportés.</p>
+
</section>
<section id="API"><title>API DBD d'Apache</title>
<p><module>mod_dbd</module> exporte cinq fonctions que d'autres
- modules pourront utiliser. L'API se présente comme suit :</p>
+ modules pourront utiliser. L'API se présente comme suit :</p>
<highlight language="c">
typedef struct {
@@ -72,9 +95,9 @@ typedef struct {
apr_hash_t *prepared;
} ap_dbd_t;
-/* Fonctions exportées pour accéder à la base de données */
+/* Fonctions exportées pour accéder à la base de données */
-/* ouvre une connexion qui DOIT avoir été explicitement fermée.
+/* ouvre une connexion qui DOIT avoir été explicitement fermée.
* Renvoie NULL en cas d'erreur
*/
AP_DECLARE(ap_dbd_t*) ap_dbd_open(apr_pool_t*, server_rec*);
@@ -82,24 +105,24 @@ AP_DECLARE(ap_dbd_t*) ap_dbd_open(apr_po
/* ferme une connexion ouverte avec ap_dbd_open */
AP_DECLARE(void) ap_dbd_close(server_rec*, ap_dbd_t*);
-/* acquiert une connexion qui aura la durée de vie de la requête et qui
- * NE DOIT PAS avoir été explicitement fermée. Renvoie NULL en cas
- * d'erreur. C'est la fonction recommandée pour la plupart des
+/* acquiert une connexion qui aura la durée de vie de la requête et qui
+ * NE DOIT PAS avoir été explicitement fermée. Renvoie NULL en cas
+ * d'erreur. C'est la fonction recommandée pour la plupart des
* applications.
*/
AP_DECLARE(ap_dbd_t*) ap_dbd_acquire(request_rec*);
-/* acquiert une connexion qui aura la durée de vie d'une connexion et
- * qui NE DOIT PAS avoir été explicitement fermée. Renvoie NULL en cas
+/* acquiert une connexion qui aura la durée de vie d'une connexion et
+ * qui NE DOIT PAS avoir été explicitement fermée. Renvoie NULL en cas
* d'erreur.
*/
AP_DECLARE(ap_dbd_t*) ap_dbd_cacquire(conn_rec*);
-/* Prépare une requête qu'un module client pourra utiliser */
+/* Prépare une requête qu'un module client pourra utiliser */
AP_DECLARE(void) ap_dbd_prepare(server_rec*, const char*, const char*);
-/* Exporte aussi ces fonctions à titre optionnel mour les modules qui
- * péfèreraient les utiliser */
+/* Exporte aussi ces fonctions à titre optionnel mour les modules qui
+ * péfèreraient les utiliser */
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_open, (apr_pool_t*, server_rec*));
APR_DECLARE_OPTIONAL_FN(void, ap_dbd_close, (server_rec*, ap_dbd_t*));
APR_DECLARE_OPTIONAL_FN(ap_dbd_t*, ap_dbd_acquire, (request_rec*));
@@ -108,108 +131,108 @@ APR_DECLARE_OPTIONAL_FN(void, ap_dbd_pre
</highlight>
</section>
-<section id="prepared"><title>Requêtes SQL préparées</title>
- <p><module>mod_dbd</module> supporte les requêtes SQL préparées à
- destination des modules qui pourraient les utiliser. Chaque requête
- préparée doit posséder un nom (étiquette), et est stockée dans un
- condensé (hash) : les condensés sont du type
- <code>apr_dbd_prepared_t</code> et s'utilisent dans toute requête
- SQL ou commande select préparée par apr_dbd.</p>
+<section id="prepared"><title>Requêtes SQL préparées</title>
+ <p><module>mod_dbd</module> supporte les requêtes SQL préparées à
+ destination des modules qui pourraient les utiliser. Chaque requête
+ préparée doit posséder un nom (étiquette), et est stockée dans un
+ condensé (hash) : les condensés sont du type
+ <code>apr_dbd_prepared_t</code> et s'utilisent dans toute requête
+ SQL ou commande select préparée par apr_dbd.</p>
<p>Il est du ressort des modules utilisateurs de dbd d'utiliser les
- requêtes préparées et de préciser quelles requêtes doivent être
- spécifiées dans httpd.conf, ou de fournir leurs propres directives
+ requêtes préparées et de préciser quelles requêtes doivent être
+ spécifiées dans httpd.conf, ou de fournir leurs propres directives
et d'utiliser <code>ap_dbd_prepare</code>.</p>
<note type="warning"><title>Avertissement</title>
- Lorsqu'on utilise des requêtes préparées avec des bases de
- données MySQL, il est préférable de définir
- <code>reconnect</code> à 0 dans la chaîne de connexion, afin
- d'éviter des erreurs provoquées par un client MySQL qui se
- reconnecterait sans réinitialiser correctement les requêtes
- préparées. Si <code>reconnect</code> est défini à 1, toute
- connexion défectueuse sera sensée être réparée, mais comme
- mod_dbd n'en est pas informé, les requêtes préparées seront
- invalidées.
+ Lorsqu'on utilise des requêtes préparées avec des bases de
+ données MySQL, il est préférable de définir
+ <code>reconnect</code> à 0 dans la chaîne de connexion, afin
+ d'éviter des erreurs provoquées par un client MySQL qui se
+ reconnecterait sans réinitialiser correctement les requêtes
+ préparées. Si <code>reconnect</code> est défini à 1, toute
+ connexion défectueuse sera sensée être réparée, mais comme
+ mod_dbd n'en est pas informé, les requêtes préparées seront
+ invalidées.
</note>
</section>
<section id="security">
<title>AVERTISSEMENT DE SECURITE</title>
- <p>Toute application web impliquant une base de données doit se
- protéger elle-même contre les attaques de type injection SQL. Dans
- la plupart des cas Apache DBD est sûr, car les applications
- utilisent des requêtes préparées, et les entrées non sures ne seront
- utilisées qu'à titre de données. Bien entendu, si vous l'utilisez
- via un module tiers, vous devez être au fait des précautions à
+ <p>Toute application web impliquant une base de données doit se
+ protéger elle-même contre les attaques de type injection SQL. Dans
+ la plupart des cas Apache DBD est sûr, car les applications
+ utilisent des requêtes préparées, et les entrées non sures ne seront
+ utilisées qu'à titre de données. Bien entendu, si vous l'utilisez
+ via un module tiers, vous devez être au fait des précautions à
prendre.</p>
<p>Cependant, le pilote <var>FreeTDS</var> est <strong>non
- sûr</strong> de par sa nature-même. Comme la bibliothèque
- sous-jacente ne supporte pas les requêtes préparées, le pilote en
- effectue une émulation, et les entrées non sûres sont fusionnées
- avec la requête SQL.</p>
- <p>Il peut être sécurisé en <em>décontaminant</em> toutes les
- entrées : un processus inspiré de la recherche de contaminations
+ sûr</strong> de par sa nature-même. Comme la bibliothèque
+ sous-jacente ne supporte pas les requêtes préparées, le pilote en
+ effectue une émulation, et les entrées non sûres sont fusionnées
+ avec la requête SQL.</p>
+ <p>Il peut être sécurisé en <em>décontaminant</em> toutes les
+ entrées : un processus inspiré de la recherche de contaminations
(<strong>taint mode</strong>) de
- Perl. Chaque entrée est comparée à une expression rationnelle, et
- seules les entrées qui correspondent sont utilisées, en accord avec
+ Perl. Chaque entrée est comparée à une expression rationnelle, et
+ seules les entrées qui correspondent sont utilisées, en accord avec
le langage Perl :</p>
<example>
<pre><code> $untrusted =~ /([a-z]+)/;
$trusted = $1;</code></pre>
</example>
<p>Pour utiliser ceci, les expressions rationnelles de
- décontamination doivent être incluses dans les requêtes préparées.
- L'expression rationnelle doit se situer immédiatement après le
- caractère % dans la requête préparée, et doit être entourée
- d'accolades {}. Par exemple, si votre application attend une entrée
- alphanumérique, vous pouvez utiliser :</p>
+ décontamination doivent être incluses dans les requêtes préparées.
+ L'expression rationnelle doit se situer immédiatement après le
+ caractère % dans la requête préparée, et doit être entourée
+ d'accolades {}. Par exemple, si votre application attend une entrée
+ alphanumérique, vous pouvez utiliser :</p>
<example>
<code>"SELECT foo FROM bar WHERE input = %s"</code>
</example>
- <p>avec d'autres pilotes, et ne risquer au pire qu'une requête
- échouée. Mais avec FreeTDS, vous devez utiliser :</p>
+ <p>avec d'autres pilotes, et ne risquer au pire qu'une requête
+ échouée. Mais avec FreeTDS, vous devez utiliser :</p>
<example>
<code>"SELECT foo FROM bar WHERE input = %{([A-Za-z0-9]+)}s"</code>
</example>
- <p>tout ce qui ne correspond pas à l'expression rationnelle est
- alors rejeté, et la requête est maintenant sûre.</p>
+ <p>tout ce qui ne correspond pas à l'expression rationnelle est
+ alors rejeté, et la requête est maintenant sûre.</p>
<p>Alternativement, vous pouvez utiliser le pilote ODBC tiers, qui
- offre la sécurité des requêtes préparées authentiques.</p>
+ offre la sécurité des requêtes préparées authentiques.</p>
</section>
<directivesynopsis>
<name>DBDriver</name>
-<description>Spécifie un pilote SQL</description>
+<description>Spécifie un pilote SQL</description>
<syntax>DBDriver <var>nom</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
- <p>Cette directive permet de spécifier un pilote apr_dbd par son
- nom. Le pilote doit être installé sur votre système (sur la plupart
- des systèmes, il s'agit d'un objet partagé ou d'une dll). Par
- exemple, <code>DBDriver mysql</code> va sélectionner le pilote MySQL
- dans la bibliothèque apr_dbd_mysql.so.</p>
+ <p>Cette directive permet de spécifier un pilote apr_dbd par son
+ nom. Le pilote doit être installé sur votre système (sur la plupart
+ des systèmes, il s'agit d'un objet partagé ou d'une dll). Par
+ exemple, <code>DBDriver mysql</code> va sélectionner le pilote MySQL
+ dans la bibliothèque apr_dbd_mysql.so.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>DBDParams</name>
-<description>Paramètres de la connexion à la base de
-données</description>
+<description>Paramètres de la connexion à la base de
+données</description>
<syntax>DBDParams
<var>param1</var>=<var>valeur1</var>[,<var>param2</var>=<var>valeur2</var>]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
- <p>Cette directive permet de spécifier des paramètres selon les
- besoins du pilote concerné. En général, les paramètres à passer
- concernent tout ce qui n'a pas de valeur par défaut comme le nom
- d'utilisateur, le mot de passe, le nom de la base de données, le nom
- d'hôte et le numéro de port de la connexion.</p>
- <p>Les paramètres de la chaîne de connexion en fonction des
- différents pilotes comprennent :</p>
+ <p>Cette directive permet de spécifier des paramètres selon les
+ besoins du pilote concerné. En général, les paramètres à passer
+ concernent tout ce qui n'a pas de valeur par défaut comme le nom
+ d'utilisateur, le mot de passe, le nom de la base de données, le nom
+ d'hôte et le numéro de port de la connexion.</p>
+ <p>Les paramètres de la chaîne de connexion en fonction des
+ différents pilotes comprennent :</p>
<dl>
<dt>FreeTDS (pour MSSQL et SyBase)</dt>
<dd>username, password, appname, dbname, host, charset, lang, server</dd>
@@ -218,13 +241,13 @@ données</description>
<dt>Oracle</dt>
<dd>user, pass, dbname, server</dd>
<dt>PostgreSQL</dt>
- <dd>La chaîne de connexion est passée directement à <code>PQconnectdb</code></dd>
+ <dd>La chaîne de connexion est passée directement à <code>PQconnectdb</code></dd>
<dt>SQLite2</dt>
- <dd>La chaîne de connexion est scindée avec comme séparateur le
- caractère ':', et <code>partie1:partie2</code> est utilisé dans
+ <dd>La chaîne de connexion est scindée avec comme séparateur le
+ caractère ':', et <code>partie1:partie2</code> est utilisé dans
<code>sqlite_open(partie1, atoi(partie2), NULL)</code></dd>
<dt>SQLite3</dt>
- <dd>La chaîne de connexion est passée directement à <code>sqlite3_open</code></dd>
+ <dd>La chaîne de connexion est passée directement à <code>sqlite3_open</code></dd>
<dt>ODBC</dt>
<dd>datasource, user, password, connect, ctimeout, stimeout, access, txmode, bufsize</dd>
</dl>
@@ -239,16 +262,16 @@ données</description>
</contextlist>
<usage>
- <p>Si cette directive est définie à Off, les connexions persistentes
- et les connexions groupées sont désactivées. À la demande d'un
- client, une nouvelle connexion à la base de données est ouverte, et
- fermée immédiatement à l'issue du traitement. Cette configuration ne
- doit être utilisée qu'à des fins de débogage, ou sur des serveurs à
+ <p>Si cette directive est définie à Off, les connexions persistentes
+ et les connexions groupées sont désactivées. À la demande d'un
+ client, une nouvelle connexion à la base de données est ouverte, et
+ fermée immédiatement à l'issue du traitement. Cette configuration ne
+ doit être utilisée qu'à des fins de débogage, ou sur des serveurs à
charge faible.</p>
- <p>Par défaut, les groupes de connexions persistentes sont activés
+ <p>Par défaut, les groupes de connexions persistentes sont activés
(ou une seule connexion persistente du style LAMP pour les serveurs
- non threadés), et c'est la configuration qui devrait être utilisée
+ non threadés), et c'est la configuration qui devrait être utilisée
dans la plupart des cas sur un serveur en production.</p>
<p>Avant la version 2.2.2, cette directive n'acceptait que les
@@ -259,17 +282,17 @@ données</description>
<directivesynopsis>
<name>DBDPrepareSQL</name>
-<description>Définit une requête SQL préparée</description>
-<syntax>DBDPrepareSQL <var>"requête SQL"</var> <var>étiquette</var></syntax>
+<description>Définit une requête SQL préparée</description>
+<syntax>DBDPrepareSQL <var>"requête SQL"</var> <var>étiquette</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
<p>Pour les modules tels que les modules d'authentification, qui
- utilisent de manière répétée la même requête SQL, on peut optimiser
- les performances en préparant la requête une fois pour toutes au
- démarrage, plutôt qu'à chaque utilisation. Cette directive permet de
- préparer une requête SQL et de lui assigner une étiquette.</p>
+ utilisent de manière répétée la même requête SQL, on peut optimiser
+ les performances en préparant la requête une fois pour toutes au
+ démarrage, plutôt qu'à chaque utilisation. Cette directive permet de
+ préparer une requête SQL et de lui assigner une étiquette.</p>
</usage>
</directivesynopsis>
@@ -282,8 +305,8 @@ données</description>
</contextlist>
<usage>
- <p>Cette directive permet de définir le nombre minimum de connexions
- par processus (plates-formes threadées uniquement).</p>
+ <p>Cette directive permet de définir le nombre minimum de connexions
+ par processus (plates-formes threadées uniquement).</p>
</usage>
</directivesynopsis>
@@ -296,9 +319,9 @@ données</description>
</contextlist>
<usage>
- <p>Cette directive permet de définir le nombre maximum de connexions
- à maintenir par processus, en dehors de celles servant à gérer les
- pics de demandes (plates-formes threadées uniquement).</p>
+ <p>Cette directive permet de définir le nombre maximum de connexions
+ à maintenir par processus, en dehors de celles servant à gérer les
+ pics de demandes (plates-formes threadées uniquement).</p>
</usage>
</directivesynopsis>
@@ -311,39 +334,39 @@ données</description>
</contextlist>
<usage>
- <p>Cette directive permet de définir le nombre maximum effectif de
- connexions par processus (plates-formes threadées uniquement).</p>
+ <p>Cette directive permet de définir le nombre maximum effectif de
+ connexions par processus (plates-formes threadées uniquement).</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>DBDExptime</name>
-<description>Durée de vie des connexions inactives</description>
-<syntax>DBDExptime <var>durée en secondes</var></syntax>
+<description>Durée de vie des connexions inactives</description>
+<syntax>DBDExptime <var>durée en secondes</var></syntax>
<default>DBDExptime 300</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
- <p>Cette directive permet de définir la durée de vie des connexions
- inactives lorsque le nombre de connexions spécifié par la directive
- DBDKeep a été dépassé (plates-formes threadées uniquement).</p>
+ <p>Cette directive permet de définir la durée de vie des connexions
+ inactives lorsque le nombre de connexions spécifié par la directive
+ DBDKeep a été dépassé (plates-formes threadées uniquement).</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>DBDInitSQL</name>
-<description>Exécute une instruction SQL après connexion à une base de
-données</description>
+<description>Exécute une instruction SQL après connexion à une base de
+données</description>
<syntax>DBDInitSQL <var>"instruction SQL"</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
- <p>Les modules qui le souhaitent peuvent exécuter une ou plusieurs
- instructions SQL après connexion à une base de données. Par exemple
- initialiser certaines valeurs, ou ajouter une entrée dans le journal
- lors d'une nouvelle connexion à la base de données.</p>
+ <p>Les modules qui le souhaitent peuvent exécuter une ou plusieurs
+ instructions SQL après connexion à une base de données. Par exemple
+ initialiser certaines valeurs, ou ajouter une entrée dans le journal
+ lors d'une nouvelle connexion à la base de données.</p>
</usage>
</directivesynopsis>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_html.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_html.xml.fr?rev=1761221&r1=1761220&r2=1761221&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_html.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_html.xml.fr Sat Sep 17 13:16:00 2016
@@ -1,7 +1,7 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1530513:1760479 (outdated) -->
+<!-- English Revision: 1760479 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -145,7 +145,9 @@ liens HTML. Lors de l'interprétation
lien correspond à <var>modèle-source</var>, la partie du lien concernée
sera réécrite en <var>modèle-cible</var>, en tenant compte des
modifications induites par les drapeaux éventuellement spécifiés et par
-la directive <directive>ProxyHTMLExtended</directive>.</p>
+la directive <directive module="mod_proxy_html">ProxyHTMLExtended</directive>.
+Ne seront considérés comme des liens HTML que les éléments spécifiés via la
+directive <directive module="mod_proxy_html">ProxyHTMLLinks</directive>.</p>
<p>Le troisième argument optionnel permet de féfinir un des drapeaux
suivants (les drapeaux sont sensibles à la casse) :</p>
@@ -447,18 +449,35 @@ HTML 4 et XHTML 1.</p>
<compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
<usage>
-<p>Cette directive permet de spécifier les éléments dont les attributs
-d'URL doivent être réécrits en utilisant les règles standards
-<directive>ProxyHTMLURLMap</directive>. Vous devez définir une directive
-ProxyHTMLLinks pour chaque élément, mais chacune d'entre elles peut
-spécifier un nombre quelconque d'attributs</p>
-<p>Normalement, cette directive est définie globalement. Si vous
-définissez ProxyHTMLLinks à plusieurs niveaux, certains niveaux
-l'emportant sur d'autres, vous devrez spécifier un jeu complet
-de liens pour chaque niveau.</p>
-<p>Le fichier <var>proxy-html.conf</var> fournit une configuration par
-défaut et définit les liens HTML selon les standards
-HTML 4 et XHTML 1.</p>
+<p>Cette directive permet de spécifier les éléments dont les attributs d'URL
+doivent être réécrits en utilisant les règles standards <directive
+module="mod_proxy_html">ProxyHTMLURLMap</directive>. Vous devez définir une
+directive ProxyHTMLLinks pour chaque élément, mais chacune d'entre elles peut
+spécifier un nombre quelconque d'attributs</p> <p>Normalement, cette directive
+est définie globalement. Si vous définissez ProxyHTMLLinks à plusieurs niveaux,
+certains niveaux l'emportant sur d'autres, vous devrez spécifier un jeu complet
+de liens pour chaque niveau.</p> <p>Le fichier <var>proxy-html.conf</var>
+fournit une configuration par défaut et définit les liens HTML selon les
+standards HTML 4 et XHTML 1.</p>
+<example>
+<title>Exemples issus de proxy-html.conf</title>
+<highlight language="config">
+ProxyHTMLLinks a href
+ProxyHTMLLinks area href
+ProxyHTMLLinks link href
+ProxyHTMLLinks img src longdesc usemap
+ProxyHTMLLinks object classid codebase data usemap
+ProxyHTMLLinks q cite
+ProxyHTMLLinks blockquote cite
+ProxyHTMLLinks ins cite
+ProxyHTMLLinks del cite
+ProxyHTMLLinks form action
+ProxyHTMLLinks input src usemap
+ProxyHTMLLinks head profile
+ProxyHTMLLinks base href
+ProxyHTMLLinks script src for
+</highlight>
+</example>
</usage>
</directivesynopsis>
Modified: httpd/httpd/branches/2.4.x/docs/manual/rewrite/vhosts.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/rewrite/vhosts.xml.fr?rev=1761221&r1=1761220&r2=1761221&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/rewrite/vhosts.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/rewrite/vhosts.xml.fr Sat Sep 17 13:16:00 2016
@@ -1,7 +1,7 @@
-<?xml version="1.0" encoding="ISO-8859-1" ?>
+<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1673563 -->
+<!-- English Revision: 1760976 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -25,50 +25,50 @@
<manualpage metafile="vhosts.xml.meta">
<parentdocument href="./">Rewrite</parentdocument>
-<title>Hébergement virtuel de masse avec mod_rewrite</title>
+<title>Hébergement virtuel de masse avec mod_rewrite</title>
<summary>
-<p>Ce document est un complément à la <a
-href="../mod/mod_rewrite.html">documentation de référence</a> du module
-<module>mod_rewrite</module>. Il décrit comment créer des serveurs
-virtuels dynamiquement configurés en utilisant
+<p>Ce document est un complément à la <a
+href="../mod/mod_rewrite.html">documentation de référence</a> du module
+<module>mod_rewrite</module>. Il décrit comment créer des serveurs
+virtuels dynamiquement configurés en utilisant
<module>mod_rewrite</module>.</p>
<note type="warning">L'utilisation de mod_rewrite n'est pas la meilleure
-méthode pour configurer des serveurs virtuels. Vous devez dans un
-premier temps tenter de résoudre votre problème via ces <a
-href="../vhosts/mass.html">d'autres méthodes</a> avant d'avoir
-recours à mod_rewrite. Voir aussi le document <a
-href="avoid.html#vhosts">Comment éviter l'utilisation de
+méthode pour configurer des serveurs virtuels. Vous devez dans un
+premier temps tenter de résoudre votre problème via ces <a
+href="../vhosts/mass.html">d'autres méthodes</a> avant d'avoir
+recours à mod_rewrite. Voir aussi le document <a
+href="avoid.html#vhosts">Comment éviter l'utilisation de
mod_rewrite</a>.</note>
</summary>
<seealso><a href="../mod/mod_rewrite.html">Documentation du module</a></seealso>
-<seealso><a href="intro.html">Introduction à mod_rewrite</a></seealso>
+<seealso><a href="intro.html">Introduction à mod_rewrite</a></seealso>
<seealso><a href="remapping.html">Redirection et remise en
correspondance</a></seealso>
-<seealso><a href="access.html">Contrôle d'accès</a></seealso>
+<seealso><a href="access.html">Contrôle d'accès</a></seealso>
<!--<seealso><a href="vhosts.html">Serveurs virtuels</a></seealso>-->
<seealso><a href="proxy.html">Serveurs mandataires</a></seealso>
<seealso><a href="rewritemap.html">Utilisation de RewriteMap</a></seealso>
-<seealso><a href="advanced.html">Techniques avancées</a></seealso>
+<seealso><a href="advanced.html">Techniques avancées</a></seealso>
<seealso><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></seealso>
<section id="per-hostname">
- <title>Serveurs virtuels pour des noms d'hôtes arbitraires</title>
+ <title>Serveurs virtuels pour des noms d'hôtes arbitraires</title>
<dl>
<dt>Description :</dt>
<dd>
- <p>Nous voulons créer automatiquement un serveur virtuel pour tout
- nom d'hôte qui peut être résolu dans notre domaine, sans avoir à
- créer de nouvelle section VirtualHost.</p>
+ <p>Nous voulons créer automatiquement un serveur virtuel pour tout
+ nom d'hôte qui peut être résolu dans notre domaine, sans avoir à
+ créer de nouvelle section VirtualHost.</p>
- <p>Dans cet exemple, nous supposons que nous utilisons le nom d'hôte
+ <p>Dans cet exemple, nous supposons que nous utilisons le nom d'hôte
<code>www.<strong>SITE</strong>.example.com</code> pour chaque
utilisateur, et que nous servons leur contenu depuis
<code>/home/<strong>SITE</strong>/www</code>.</p>
@@ -90,31 +90,31 @@ RewriteRule "^(.*)" "/home/<strong>%1<
<dt>Discussion</dt>
<dd>
- <note type="warning">Vous devez vérifier le bon fonctionnement de la
- résolution DNS - Apache ne gère pas la résolution de nom. Vous
- devrez créer soit des enregistrements CNAME pour chaque nom d'hôte,
- soit un enregistrement DNS avec caractères génériques. La création
+ <note type="warning">Vous devez vérifier le bon fonctionnement de la
+ résolution DNS - Apache ne gère pas la résolution de nom. Vous
+ devrez créer soit des enregistrements CNAME pour chaque nom d'hôte,
+ soit un enregistrement DNS avec caractères génériques. La création
des enregistrements DNS est en dehors du sujet de ce document.</note>
<p>La directive RewriteMap interne <code>tolower</code> permet de
-s'assurer que les noms d'hôtes utilisés seront tous en minuscules, de
-façon à éviter toute ambiguité dans la structure des répertoires qui
-doit être créée.</p>
-
-<p>Les contenus des parenthèses utilisées dans une directive <directive
-module="mod_rewrite">RewriteCond</directive> sont enregistrés dans les
-références arrières <code>%1</code>, <code>%2</code>, etc..., alors que
-les contenus des parenthèses utilisées dans une directive <directive
+s'assurer que les noms d'hôtes utilisés seront tous en minuscules, de
+façon à éviter toute ambiguité dans la structure des répertoires qui
+doit être créée.</p>
+
+<p>Les contenus des parenthèses utilisées dans une directive <directive
+module="mod_rewrite">RewriteCond</directive> sont enregistrés dans les
+références arrières <code>%1</code>, <code>%2</code>, etc..., alors que
+les contenus des parenthèses utilisées dans une directive <directive
module="mod_rewrite">RewriteRule</directive> le sont dans les
-références arrières <code>$1</code>, <code>$2</code>, etc...</p>
+références arrières <code>$1</code>, <code>$2</code>, etc...</p>
<p>
-Comme c'est le cas pour de nombreuses techniques discutées dans ce
-document, mod_rewrite n'est vraiment pas la meilleure méthode pour
-accomplir cette tâche. Vous devez plutôt vous tourner vers
-<module>mod_vhost_alias</module>, car ce dernier sera bien plus à même
-de gérer tout ce qui est au delà du domaine des fichiers statiques,
-comme les contenus dynamiques et la résolution des alias.
+Comme c'est le cas pour de nombreuses techniques discutées dans ce
+document, mod_rewrite n'est vraiment pas la meilleure méthode pour
+accomplir cette tâche. Vous devez plutôt vous tourner vers
+<module>mod_vhost_alias</module>, car ce dernier sera bien plus à même
+de gérer tout ce qui est au delà du domaine des fichiers statiques,
+comme les contenus dynamiques et la résolution des alias.
</p>
</dd>
</dl>
@@ -125,24 +125,24 @@ comme les contenus dynamiques et la r&ea
virtuels via <module>mod_rewrite</module></title>
<p>Cet extrait du fichier <code>httpd.conf</code> permet d'obtenir
- le même résultat que <a href="#per-hostname">le premier exemple</a>.
- La première moitié est très similaire à la partie correspondante
- ci-dessus, excepté quelques modifications requises à des fins de
- compatibilité ascendante et pour faire en sorte que la partie
- <code>mod_rewrite</code> fonctionne correctement ; la seconde moitié
+ le même résultat que <a href="#per-hostname">le premier exemple</a>.
+ La première moitié est très similaire à la partie correspondante
+ ci-dessus, excepté quelques modifications requises à des fins de
+ compatibilité ascendante et pour faire en sorte que la partie
+ <code>mod_rewrite</code> fonctionne correctement ; la seconde moitié
configure <code>mod_rewrite</code> pour effectuer le travail
proprement dit.</p>
- <p>Comme <code>mod_rewrite</code> s'exécute avant tout autre module
+ <p>Comme <code>mod_rewrite</code> s'exécute avant tout autre module
de traduction d'URI (comme <code>mod_alias</code>), il faut lui
- ordonner explicitement d'ignorer toute URL susceptible d'être
- traitée par ces autres modules. Et comme ces règles auraient sinon
- court-circuité toute directive <code>ScriptAlias</code>, nous devons
- faire en sorte que <code>mod_rewrite</code> déclare explicitement
+ ordonner explicitement d'ignorer toute URL susceptible d'être
+ traitée par ces autres modules. Et comme ces règles auraient sinon
+ court-circuité toute directive <code>ScriptAlias</code>, nous devons
+ faire en sorte que <code>mod_rewrite</code> déclare explicitement
ces correspondances.</p>
<highlight language="config">
-# extrait le nom de serveur de l'en-tête Host:
+# extrait le nom de serveur de l'en-tête Host:
UseCanonicalName Off
# journaux dissociables
@@ -150,18 +150,18 @@ LogFormat "%{Host}i %h %l %u %t \"%r\" %
CustomLog "logs/access_log" vcommon
<Directory "/www/hosts">
- # ExecCGI est nécessaire ici car on ne peut pas forcer l'exécution
- # des CGI à la manière de ScriptAlias
+ # ExecCGI est nécessaire ici car on ne peut pas forcer l'exécution
+ # des CGI à la manière de ScriptAlias
Options FollowSymLinks ExecCGI
</Directory>
RewriteEngine On
-# un nom de serveur extrait d'un en-tête Host: peut être dans n'importe
+# un nom de serveur extrait d'un en-tête Host: peut être dans n'importe
# quelle casse
## on s'occupe tout d'abord des documents normaux :<br />
-# permet à Alias "/icons/" de fonctionner - répéter pour les autres
+# permet à Alias "/icons/" de fonctionner - répéter pour les autres
RewriteCond "%{REQUEST_URI}" "!^/icons/"
# permet aux CGIs de fonctionner
RewriteCond "%{REQUEST_URI}" "!^/cgi-bin/"
@@ -177,15 +177,15 @@ RewriteRule "^/(.*)$" "/www/hosts/${low
</section>
<section id="xtra-conf"><title>Utilisation d'un fichier de configuration
-du serveur virtuel séparé</title>
+du serveur virtuel séparé</title>
- <p>Cette construction utilise des fonctionnalités plus avancées de
+ <p>Cette construction utilise des fonctionnalités plus avancées de
<module>mod_rewrite</module> pour effectuer la traduction depuis le
- serveur virtuel vers la racine des documents, à partir d'un fichier
- de configuration séparé. Elle est plus souple mais nécessite une
- configuration plus compliquée.</p>
+ serveur virtuel vers la racine des documents, à partir d'un fichier
+ de configuration séparé. Elle est plus souple mais nécessite une
+ configuration plus compliquée.</p>
- <p>Le fichier <code>vhost.map</code> devrait ressembler à ceci :</p>
+ <p>Le fichier <code>vhost.map</code> devrait ressembler à ceci :</p>
<example>
www.client-1.example.com /www/clients/1<br />
@@ -194,28 +194,28 @@ www.client-2.example.com /www/clients/2
www.client-N.example.com /www/clients/N<br />
</example>
- <p>On doit ajouter à <code>httpd.conf</code> :</p>
+ <p>On doit ajouter à <code>httpd.conf</code> :</p>
<highlight language="config">
RewriteEngine on
RewriteMap lowercase int:tolower
-# définit le fichier de correspondances
+# définit le fichier de correspondances
RewriteMap vhost "txt:/www/conf/vhost.map"
# on s'occupe des alias comme ci-dessus
RewriteCond "%{REQUEST_URI}" "!^/icons/"
RewriteCond "%{REQUEST_URI}" "!^/cgi-bin/"
RewriteCond "${lowercase:%{SERVER_NAME}}" "^(.+)$"
-# on effectue ici la remise en correspondance à base de fichier
+# on effectue ici la remise en correspondance à base de fichier
RewriteCond "${vhost:%1}" "^(/.*)$"
RewriteRule "^/(.*)$" "%1/docs/$1"
RewriteCond "%{REQUEST_URI}" "^/cgi-bin/"
RewriteCond "${lowercase:%{SERVER_NAME}}" "^(.+)$"
RewriteCond "${vhost:%1}" "^(/.*)$"
-RewriteRule "^/(.*)$" "%1/cgi-bin/$1" [H=cgi-script]
+RewriteRule "^/cgi-bin/(.*)$" "%1/cgi-bin/$1" [H=cgi-script]
</highlight>
</section>