httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From lgen...@apache.org
Subject svn commit: r1728984 [1/2] - in /httpd/httpd/branches/2.4.x/docs/manual/mod: mod_cgi.xml.fr mod_deflate.xml.fr mod_rewrite.xml.fr
Date Sun, 07 Feb 2016 16:26:46 GMT
Author: lgentis
Date: Sun Feb  7 16:26:46 2016
New Revision: 1728984

URL: http://svn.apache.org/viewvc?rev=1728984&view=rev
Log:
XML updates.

Modified:
    httpd/httpd/branches/2.4.x/docs/manual/mod/mod_cgi.xml.fr
    httpd/httpd/branches/2.4.x/docs/manual/mod/mod_deflate.xml.fr
    httpd/httpd/branches/2.4.x/docs/manual/mod/mod_rewrite.xml.fr

Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_cgi.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_cgi.xml.fr?rev=1728984&r1=1728983&r2=1728984&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_cgi.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_cgi.xml.fr Sun Feb  7 16:26:46 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: 1334011:1728020 (outdated) -->
+<!-- English Revision: 1728020 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -25,112 +25,141 @@
 <modulesynopsis metafile="mod_cgi.xml.meta">
 
 <name>mod_cgi</name>
-<description>Ex&eacute;cution des scripts CGI</description>
+<description>Exécution des scripts CGI</description>
 <status>Base</status>
 <sourcefile>mod_cgi.c</sourcefile>
 <identifier>cgi_module</identifier>
 
 <summary>
     <p>Tout fichier pris en compte par le gestionnaire
-    <code>cgi-script</code> sera trait&eacute; en tant que script CGI et
-    ex&eacute;cut&eacute; par le serveur, sa sortie &eacute;tant renvoy&eacute;e au client. Les
-    fichiers sont associ&eacute;s &agrave; ce gestionnaire soit parce qu'ils poss&egrave;dent
-    un nom contenant une extension d&eacute;finie par la directive <directive
+    <code>cgi-script</code> sera traité en tant que script CGI et
+    exécuté par le serveur, sa sortie étant renvoyée au client. Les
+    fichiers sont associés à ce gestionnaire soit parce qu'ils possèdent
+    un nom contenant une extension définie par la directive <directive
     module="mod_mime">AddHandler</directive>, soit parce qu'ils se
-    situent dans un r&eacute;pertoire d&eacute;fini par une directive <directive
+    situent dans un répertoire défini par une directive <directive
     module="mod_alias">ScriptAlias</directive>.</p>
 
-    <p>Comme introduction &agrave; l'utilisation des scripts CGI avec Apache,
+    <p>Comme introduction à l'utilisation des scripts CGI avec Apache,
     voir notre tutoriel <a href="../howto/cgi.html">Les contenus
     dynamiques avec CGI</a>.</p>
 
-    <p>Il est recommand&eacute; d'utiliser le module <module>mod_cgid</module>
-    &agrave; la place de <module>mod_cgi</module> lorsqu'on utilise un module MPM
-    multi-thread&eacute; sous Unix. Vus de l'utilisateur, les deux modules
+    <p>Il est recommandé d'utiliser le module <module>mod_cgid</module>
+    à la place de <module>mod_cgi</module> lorsqu'on utilise un module MPM
+    multi-threadé sous Unix. Vus de l'utilisateur, les deux modules
     sont pratiquement identiques.</p>
 
-    <p>&Agrave; des fins de compatibilit&eacute; ascendante, le gestionnaire
-    cgi-script sera aussi activ&eacute; pour tout fichier poss&eacute;dant le type
+    <p>À des fins de compatibilité ascendante, le gestionnaire
+    cgi-script sera aussi activé pour tout fichier possédant le type
     MIME <code>application/x-httpd-cgi</code>. L'utilisation du type
-    MIME magic est obsol&egrave;te.</p>
+    MIME magic est obsolète.</p>
 </summary>
 
 <seealso><directive module="core">AcceptPathInfo</directive></seealso>
 <seealso><directive module="core">Options</directive> ExecCGI</seealso>
 <seealso><directive module="mod_alias">ScriptAlias</directive></seealso>
 <seealso><directive module="mod_mime">AddHandler</directive></seealso>
-<seealso><a href="../suexec.html">Ex&eacute;cuter des programmes CGI sous des
-utilisateurs diff&eacute;rents</a></seealso>
-<seealso><a href="http://www.ietf.org/rfc/rfc3875">La sp&eacute;cification
+<seealso><a href="../suexec.html">Exécuter des programmes CGI sous des
+utilisateurs différents</a></seealso>
+<seealso><a href="http://www.ietf.org/rfc/rfc3875">La spécification
 CGI</a></seealso>
 
 <section id="env"><title>Les variables d'environnement CGI</title>
-    <p>Le serveur va d&eacute;finir les variables d'environnement CGI comme
-    d&eacute;crit dans la <a
-    href="http://www.ietf.org/rfc/rfc3875">Sp&eacute;cification CGI</a>, de la
-    mani&egrave;re suivante :</p>
+    <p>Le serveur va définir les variables d'environnement CGI comme
+    décrit dans la <a
+    href="http://www.ietf.org/rfc/rfc3875">Spécification CGI</a>, de la
+    manière suivante :</p>
 
     <dl>
       <dt>PATH_INFO</dt>
 
       <dd>Cette variable ne sera pas disponible si la directive
       <directive module="core">AcceptPathInfo</directive> est
-      explicitement d&eacute;finie &agrave; <code>off</code>. Par d&eacute;faut, si la
-      directive <directive>AcceptPathInfo</directive> n'est pas d&eacute;finie,
+      explicitement définie à <code>off</code>. Par défaut, si la
+      directive <directive>AcceptPathInfo</directive> n'est pas définie,
       <module>mod_cgi</module> acceptera des informations de chemin (en
-      ajoutant /infos/chemin apr&egrave;s le nom du script dans l'URI), alors
+      ajoutant /infos/chemin après le nom du script dans l'URI), alors
       que le serveur de base retournera une erreur 404 NOT FOUND pour
-      les requ&ecirc;tes contenant des informations de chemin suppl&eacute;mentaires.
-      Ne pas d&eacute;finir la directive <directive>AcceptPathInfo</directive>
-      a le m&ecirc;me effet sur les requ&ecirc;tes avec <module>mod_cgi</module> que
-      de la d&eacute;finir &agrave; <code>On</code>.</dd>
+      les requêtes contenant des informations de chemin supplémentaires.
+      Ne pas définir la directive <directive>AcceptPathInfo</directive>
+      a le même effet sur les requêtes avec <module>mod_cgi</module> que
+      de la définir à <code>On</code>.</dd>
 
       <dt>REMOTE_HOST</dt>
 
-      <dd>Cette variable ne sera d&eacute;finie que si la directive <directive
-      module="core">HostnameLookups</directive> est d&eacute;finie &agrave;
-      <code>on</code> (elle est &agrave; <code>off</code> par d&eacute;faut), et si
-      une recherche DNS inverse sur l'adresse IP de l'h&ocirc;te client
-      aboutit effectivement &agrave; un nom d'h&ocirc;te.</dd>
+      <dd>Cette variable ne sera définie que si la directive <directive
+      module="core">HostnameLookups</directive> est définie à
+      <code>on</code> (elle est à <code>off</code> par défaut), et si
+      une recherche DNS inverse sur l'adresse IP de l'hôte client
+      aboutit effectivement à un nom d'hôte.</dd>
 
       <dt>REMOTE_IDENT</dt>
 
-      <dd>Cette variable ne sera d&eacute;finie que si la directive <directive
+      <dd>Cette variable ne sera définie que si la directive <directive
       module="mod_ident">IdentityCheck</directive>
-      est d&eacute;finie &agrave; <code>on</code>, et si l'h&ocirc;te client supporte le
+      est définie à <code>on</code>, et si l'hôte client supporte le
       protocole ident. Notez que l'on ne peut accorder une confiance
-      aveugle au contenu de cette variable car il peut &ecirc;tre ais&eacute;ment
-      falsifi&eacute;, et si un mandataire s'intercale entre le client et le
+      aveugle au contenu de cette variable car il peut être aisément
+      falsifié, et si un mandataire s'intercale entre le client et le
       serveur, il est totalement inutilisable.</dd>
 
       <dt>REMOTE_USER</dt>
 
-      <dd>Cette variable ne sera d&eacute;finie que si le script CGI fait
+      <dd>Cette variable ne sera définie que si le script CGI fait
       l'objet d'une authentification.</dd>
+
     </dl>
+    <p>Ce module utilise aussi les fonctions de base <a
+    href="https://ci.apache.org/projects/httpd/trunk/doxygen/group__APACHE__CORE__SCRIPT.html#ga0e81f9571a8a73f5da0e89e1f46d34b1">ap_add_common_vars</a>
+    et <a
+    href="https://ci.apache.org/projects/httpd/trunk/doxygen/group__APACHE__CORE__SCRIPT.html#ga6b975cd7ff27a338cb8752381a4cc14f">ap_add_cgi_vars</a>
+    pour ajouter des variables d'environnement comme :</p> 
+       <dl>
+           <dt>DOCUMENT_ROOT</dt>
+
+           <dd>Prend la valeur définie par la directive <directive
+	   module="core">DocumentRoot</directive>.</dd>
+
+           <dt>SERVER_NAME</dt>
+
+           <dd>Le nom de domaine pleinement qualifié pour la requête considérée</dd>
+
+           <dt>SERVER_ADDR</dt>
+
+           <dd>L'adresse IP du serveur virtuel qui traite la requête</dd>
+
+           <dt>SERVER_ADMIN</dt>
+
+           <dd>Prend la valeur définie par la directive <directive
+	   module="core">ServerAdmin</directive>.</dd>
+      </dl>
+    <p>Pour une liste exhaustive de ces variables, vous pouvez écrire un script
+    CGI basique qui extrait toutes les variables d'environnement passées par
+    Apache selon un format adapté.
+    </p>
 </section>
 
-<section id="cgi-debug"><title>D&eacute;bogage des scripts CGI</title>
-    <p>Le d&eacute;bogage des scripts CGI &eacute;tait difficile par le pass&eacute;,
-    principalement parce qu'il n'&eacute;tait pas possible d'&eacute;tudier la sortie
-    (sortie standard et erreurs) des scripts dont l'ex&eacute;cution &eacute;chouait.
-    Les directives qui suivent permettent une journalisation plus d&eacute;taill&eacute;e des
+<section id="cgi-debug"><title>Débogage des scripts CGI</title>
+    <p>Le débogage des scripts CGI était difficile par le passé,
+    principalement parce qu'il n'était pas possible d'étudier la sortie
+    (sortie standard et erreurs) des scripts dont l'exécution échouait.
+    Les directives qui suivent permettent une journalisation plus détaillée des
     erreurs.</p>
 
     <section><title>Format du fichier journal CGI</title>
-      <p>Lorsqu'il est configur&eacute;, le journal des erreurs CGI enregistre
-      la sortie de tout programme CGI dont l'ex&eacute;cution ne s'effectue pas
-      correctement. Un script CGI dont l'ex&eacute;cution &eacute;choue provoque la
-      journalisation d'une grande quantit&eacute; d'informations. Les deux
-      premi&egrave;res lignes poss&egrave;dent toujours le format suivant :</p>
+      <p>Lorsqu'il est configuré, le journal des erreurs CGI enregistre
+      la sortie de tout programme CGI dont l'exécution ne s'effectue pas
+      correctement. Un script CGI dont l'exécution échoue provoque la
+      journalisation d'une grande quantité d'informations. Les deux
+      premières lignes possèdent toujours le format suivant :</p>
 
       <example>
-        %% [<var>date</var>] <var>requ&ecirc;te</var><br />
-        %% <var>&eacute;tat HTTP</var> <var>nom du script CGI</var>
+        %% [<var>date</var>] <var>requête</var><br />
+        %% <var>état HTTP</var> <var>nom du script CGI</var>
       </example>
 
-      <p>Si le script CGI n'a pas pu d&eacute;marrer, le fichier journal
-      contiendra les deux lignes suppl&eacute;mentaires suivantes :</p>
+      <p>Si le script CGI n'a pas pu démarrer, le fichier journal
+      contiendra les deux lignes supplémentaires suivantes :</p>
 
       <example>
         %%erreur<br />
@@ -138,16 +167,16 @@ CGI</a></seealso>
       </example>
 
       <p>Par contre, si l'erreur provient du renvoi par le script
-      d'informations incorrectes dans les en-t&ecirc;tes (d&ucirc; souvent &agrave; une
-      bogue du script), les informations suivantes sont journalis&eacute;es
+      d'informations incorrectes dans les en-têtes (dû souvent à une
+      bogue du script), les informations suivantes sont journalisées
       :</p>
 
       <example>
-        %requ&ecirc;te<br />
-        <var>Tous les en-t&ecirc;tes de requ&ecirc;te HTTP re&ccedil;us</var><br />
-        <var>Les entit&eacute;s POST ou PUT (s'il en existe)</var><br />
-        %r&eacute;ponse<br />
-        <var>Tous les en-t&ecirc;tes g&eacute;n&eacute;r&eacute;s par le script CGI</var><br />
+        %requête<br />
+        <var>Tous les en-têtes de requête HTTP reçus</var><br />
+        <var>Les entités POST ou PUT (s'il en existe)</var><br />
+        %réponse<br />
+        <var>Tous les en-têtes générés par le script CGI</var><br />
         %stdout<br />
         <var>la sortie standard CGI</var><br />
         %stderr<br />
@@ -155,7 +184,7 @@ CGI</a></seealso>
       </example>
 
       <p>(Les parties %stdout et %stderr seront absentes si le script
-      n'a rien envoy&eacute; sur la sortie standard ou la sortie
+      n'a rien envoyé sur la sortie standard ou la sortie
       d'erreurs).</p>
     </section>
 </section>
@@ -171,13 +200,13 @@ CGI</description>
 </modulelist>
 
 <usage>
-    <p>La directive <directive>ScriptLog</directive> permet de d&eacute;finir
+    <p>La directive <directive>ScriptLog</directive> permet de définir
     le chemin du fichier journal des erreurs du script CGI. Si cette
-    directive n'est pas d&eacute;finie, aucune journalisation des erreurs n'est
-    effectu&eacute;e. Si elle est d&eacute;finie, toute erreur CGI sera enregistr&eacute;e
+    directive n'est pas définie, aucune journalisation des erreurs n'est
+    effectuée. Si elle est définie, toute erreur CGI sera enregistrée
     dans le fichier dont le nom est fourni en argument. S'il s'agit d'un
-    chemin de fichier relatif, il est consid&eacute;r&eacute; par rapport au
-    r&eacute;pertoire d&eacute;fini par la directive <directive
+    chemin de fichier relatif, il est considéré par rapport au
+    répertoire défini par la directive <directive
     module="core">ServerRoot</directive>.
     </p>
 
@@ -188,23 +217,23 @@ CGI</description>
     </example>
 
     <p>Ce journal sera ouvert par l'utilisateur sous lequel les
-    processus enfants s'ex&eacute;cutent, c'est &agrave; dire l'utilisateur sp&eacute;cifi&eacute;
+    processus enfants s'exécutent, c'est à dire l'utilisateur spécifié
     par la directive du serveur <directive
     module="mod_unixd">User</directive>. Ceci implique que le
-    r&eacute;pertoire dans lequel se trouve le journal doit &ecirc;tre accessible en
-    &eacute;criture pour cet utilisateur, ou bien que le fichier est cr&eacute;&eacute;
-    manuellement et accessible en &eacute;criture pour cet utilisateur. Si vous
-    placez le journal du script dans votre r&eacute;pertoire principal des
+    répertoire dans lequel se trouve le journal doit être accessible en
+    écriture pour cet utilisateur, ou bien que le fichier est créé
+    manuellement et accessible en écriture pour cet utilisateur. Si vous
+    placez le journal du script dans votre répertoire principal des
     journaux, ne modifiez <strong>JAMAIS</strong> les permissions de ce
-    dernier afin de le le rendre accessible en &eacute;criture par
-    l'utilisateur sous lequel les processus enfants s'ex&eacute;cutent.</p>
+    dernier afin de le le rendre accessible en écriture par
+    l'utilisateur sous lequel les processus enfants s'exécutent.</p>
 
     <p>Notez que l'on ne doit activer la journalisation des scripts
-    qu'&agrave; des fins de d&eacute;bogage lors de l'&eacute;criture de scripts CGI, et non
-    de mani&egrave;re permanente sur un serveur en production. Elle n'est pas
-    optimis&eacute;e en terme de performances et d'efficacit&eacute;, et peut
-    pr&eacute;senter des probl&egrave;mes de s&eacute;curit&eacute; si on l'utilise dans un cadre
-    autre que celui pour lequel elle a &eacute;t&eacute; con&ccedil;ue.</p>
+    qu'à des fins de débogage lors de l'écriture de scripts CGI, et non
+    de manière permanente sur un serveur en production. Elle n'est pas
+    optimisée en terme de performances et d'efficacité, et peut
+    présenter des problèmes de sécurité si on l'utilise dans un cadre
+    autre que celui pour lequel elle a été conçue.</p>
 </usage>
 </directivesynopsis>
 
@@ -221,21 +250,21 @@ CGI</description>
 
 <usage>
     <p>La directive <directive>ScriptLogLength</directive> permet de
-    d&eacute;finir la taille maximale du fichier journal des scripts CGI. Comme
-    le fichier journal accumule une grande quantit&eacute; d'informations par
-    erreur CGI (tous les en-t&ecirc;tes de la requ&ecirc;te, toutes les sorties du
+    définir la taille maximale du fichier journal des scripts CGI. Comme
+    le fichier journal accumule une grande quantité d'informations par
+    erreur CGI (tous les en-têtes de la requête, toutes les sorties du
     script), il peut vite atteindre une grande taille. En limitant la
-    taille du fichier, cette directive permet d'&eacute;viter les probl&egrave;mes que
+    taille du fichier, cette directive permet d'éviter les problèmes que
     causerait sa croissance sans limites. Lorsque le fichier a atteint
     cette taille maximale, plus aucune information n'y est
-    enregistr&eacute;e.</p>
+    enregistrée.</p>
 </usage>
 </directivesynopsis>
 
 <directivesynopsis>
 <name>ScriptLogBuffer</name>
-<description>Taille maximale des requ&ecirc;tes PUT ou POST qui seront
-enregistr&eacute;es dans le journal du script</description>
+<description>Taille maximale des requêtes PUT ou POST qui seront
+enregistrées dans le journal du script</description>
 <syntax>ScriptLogBuffer <var>octets</var></syntax>
 <default>ScriptLogBuffer 1024</default>
 <contextlist><context>server config</context>
@@ -245,11 +274,11 @@ enregistr&eacute;es dans le journal du s
 
 <usage>
     <p>Cette directive permet de limiter la taille du corps de toute
-    entit&eacute; PUT ou POST qui sera enregistr&eacute;e dans le journal, afin
-    de pr&eacute;venir une croissance trop importante et trop rapide du fichier
-    journal due &agrave; la r&eacute;ception de corps de requ&ecirc;te de grandes tailles.
+    entité PUT ou POST qui sera enregistrée dans le journal, afin
+    de prévenir une croissance trop importante et trop rapide du fichier
+    journal due à la réception de corps de requête de grandes tailles.
     Cette directive permet de modifier cette taille maximale, dont la
-    valeur par d&eacute;faut est de 1024 octets.</p>
+    valeur par défaut est de 1024 octets.</p>
 </usage>
 </directivesynopsis>
 

Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_deflate.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_deflate.xml.fr?rev=1728984&r1=1728983&r2=1728984&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_deflate.xml.fr (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_deflate.xml.fr Sun Feb  7 16:26:46 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: 1724274:1728020 (outdated) -->
+<!-- English Revision: 1728020 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -32,29 +32,29 @@ client</description>
 <identifier>deflate_module</identifier>
 
 <summary>
-    <p>Le module <module>mod_deflate</module> impl&eacute;mente le filtre de
+    <p>Le module <module>mod_deflate</module> implémente le filtre de
     sortie <code>DEFLATE</code> qui permet de comprimer la sortie de
-    votre serveur avant de l'envoyer au client sur le r&eacute;seau.</p>
+    votre serveur avant de l'envoyer au client sur le réseau.</p>
 </summary>
 <seealso><a href="../filter.html">Les filtres</a></seealso>
 
-<section id="supportedencodings"><title>Codages support&eacute;s</title>
-  <p>Le seul codage support&eacute; est <code>gzip</code> afin d'assurer une compl&egrave;te
-  compatibilit&eacute; avec les anciens navigateurs. Le codage <code>deflate</code>
-  n'est donc pas support&eacute; ; voir &agrave; ce sujet la <a
+<section id="supportedencodings"><title>Codages supportés</title>
+  <p>Le seul codage supporté est <code>gzip</code> afin d'assurer une complète
+  compatibilité avec les anciens navigateurs. Le codage <code>deflate</code>
+  n'est donc pas supporté ; voir à ce sujet la <a
   href="http://www.gzip.org/zlib/zlib_faq.html#faq38">documentation de zlib</a>
-  pour une explication d&eacute;taill&eacute;e.
+  pour une explication détaillée.
   </p>
 </section>
 
 <section id="recommended"><title>Exemples de configurations</title>
     <note type="warning"><title>Compression et TLS</title>
-        <p>Certaines applications web sont vuln&eacute;rables aux attaques
+        <p>Certaines applications web sont vulnérables aux attaques
 	visant le vol d'information lorsqu'une connexion TLS transmet
-	des donn&eacute;es compress&eacute;es par deflate. Pour plus de d&eacute;tails,
-	&eacute;tudiez les attaques de la famille "BREACH".</p>
+	des données compressées par deflate. Pour plus de détails,
+	étudiez les attaques de la famille "BREACH".</p>
     </note>
-    <p>Voici une configuration simple qui comprime les contenus &agrave; base
+    <p>Voici une configuration simple qui comprime les contenus à base
     de texte courants.</p>
 
     <example><title>Ne comprime que certains types de documents</title>
@@ -68,27 +68,27 @@ client</description>
 <section id="enable"><title>Activation de la compression</title>
 
     <note type="warning"><title>Compression et TLS</title>
-        <p>Certaines applications web sont vuln&eacute;rables aux attaques pour
-	vol d'information lorsque la connexion TLS transmet des donn&eacute;es
-	compress&eacute;es par deflate. Pour plus d'informations, voir en
-	d&eacute;tails la famille d'attaques de type "BREACH".</p>
+        <p>Certaines applications web sont vulnérables aux attaques pour
+	vol d'information lorsque la connexion TLS transmet des données
+	compressées par deflate. Pour plus d'informations, voir en
+	détails la famille d'attaques de type "BREACH".</p>
     </note>
 
     <section id="output"><title>Compression de la sortie</title>
-      <p>La compression est impl&eacute;ment&eacute;e par le <a
+      <p>La compression est implémentée par le <a
       href="../filter.html">filtre</a> <code>DEFLATE</code>. La
       directive suivante active la compression des documents dans le
-      conteneur o&ugrave; elle est plac&eacute;e :</p>
+      conteneur où elle est placée :</p>
 
       <highlight language="config">
 SetOutputFilter DEFLATE
 SetEnvIfNoCase Request_URI "\.(?:gif|jpe?g|png)$" no-gzip        
 	</highlight>
 
-      <p>Si vous voulez limiter la compression &agrave; certains types MIME
+      <p>Si vous voulez limiter la compression à certains types MIME
       particuliers, vous pouvez utiliser la directive <directive
       module="mod_filter">AddOutputFilterByType</directive>. Voici un exemple
-      o&ugrave; la compression n'est activ&eacute;e que pour les fichiers html de la
+      où la compression n'est activée que pour les fichiers html de la
       documentation d'Apache :</p>
 
       <highlight language="config">
@@ -98,24 +98,24 @@ SetEnvIfNoCase Request_URI "\.(?:gif|jpe
       </highlight>
 
       <note><title>Note</title>
-        Le filtre <code>DEFLATE</code> est toujours ins&eacute;r&eacute; apr&egrave;s les
+        Le filtre <code>DEFLATE</code> est toujours inséré après les
 	filtres RESOURCE comme PHP ou SSI. Il n'affecte jamais les
-	sous-requ&ecirc;tes internes.
+	sous-requêtes internes.
       </note>
       <note><title>Note</title>
-        La variable d'environnement <code>force-gzip</code>, d&eacute;finie &agrave;
+        La variable d'environnement <code>force-gzip</code>, définie à
 	l'aide de la directive <directive
 	module="mod_env">SetEnv</directive>, permet d'ignorer la
-	configuration de votre navigateur quant aux codages accept&eacute;s, et
-	d'envoyer sans condition une sortie comprim&eacute;e.
+	configuration de votre navigateur quant aux codages acceptés, et
+	d'envoyer sans condition une sortie comprimée.
       </note>
 
     </section>
-    <section id="inflate"><title>D&eacute;compression de la sortie</title>
+    <section id="inflate"><title>Décompression de la sortie</title>
       <p>Le module <module>mod_deflate</module> fournit aussi un filtre
-      permettant de d&eacute;comprimer un corps de r&eacute;ponse comprim&eacute; par gzip.
-      Pour activer cette fonctionnalit&eacute;, vous devez ins&eacute;rer le filtre
-      <code>INFLATE</code> dans la cha&icirc;ne de filtrage en sortie via la
+      permettant de décomprimer un corps de réponse comprimé par gzip.
+      Pour activer cette fonctionnalité, vous devez insérer le filtre
+      <code>INFLATE</code> dans la chaîne de filtrage en sortie via la
       directive <directive module="core">SetOutputFilter</directive> ou
       <directive module="mod_mime">AddOutputFilter</directive>, comme
       dans l'exemple suivant :</p>
@@ -127,17 +127,17 @@ SetEnvIfNoCase Request_URI "\.(?:gif|jpe
 &lt;/Location&gt;
       </highlight>
 
-      <p>Dans cet exemple, les sorties comprim&eacute;es par gzip en
-      provenance de example.com seront d&eacute;comprim&eacute;es afin de pouvoir
-      &ecirc;tre &eacute;ventuellement trait&eacute;es par d'autres filtres.
+      <p>Dans cet exemple, les sorties comprimées par gzip en
+      provenance de example.com seront décomprimées afin de pouvoir
+      être éventuellement traitées par d'autres filtres.
       </p>
 
     </section>
-    <section id="input"><title>D&eacute;compression de l'entr&eacute;e</title>
-      <p>Le module <module>mod_deflate</module> fournit &eacute;galement un filtre
-      permettant de d&eacute;comprimer un corps de requ&ecirc;te comprim&eacute; par gzip.
-      Pour activer cette fonctionnalit&eacute;, vous devez ins&eacute;rer le filtre
-      <code>DEFLATE</code> dans la cha&icirc;ne de filtrage en entr&eacute;e via la
+    <section id="input"><title>Décompression de l'entrée</title>
+      <p>Le module <module>mod_deflate</module> fournit également un filtre
+      permettant de décomprimer un corps de requête comprimé par gzip.
+      Pour activer cette fonctionnalité, vous devez insérer le filtre
+      <code>DEFLATE</code> dans la chaîne de filtrage en entrée via la
       directive <directive module="core">SetInputFilter</directive> ou
       <directive module="mod_mime">AddInputFilter</directive>, comme
       dans l'exemple suivant :</p>
@@ -148,52 +148,52 @@ SetEnvIfNoCase Request_URI "\.(?:gif|jpe
 &lt;/Location&gt;
       </highlight>
 
-      <p>D&eacute;sormais, si une requ&ecirc;te contient un en-t&ecirc;te
+      <p>Désormais, si une requête contient un en-tête
       <code>Content-Encoding: gzip</code>, son corps sera
-      automatiquement d&eacute;comprim&eacute;. Peu de navigateurs sont actuellement
-      en mesure de comprimer les corps de requ&ecirc;tes. Cependant,
-      certaines applications sp&eacute;cialis&eacute;es supportent les requ&ecirc;tes
-      comprim&eacute;es, comme par exemple certains clients <a
+      automatiquement décomprimé. Peu de navigateurs sont actuellement
+      en mesure de comprimer les corps de requêtes. Cependant,
+      certaines applications spécialisées supportent les requêtes
+      comprimées, comme par exemple certains clients <a
       href="http://www.webdav.org">WebDAV</a>.</p>
 
-      <note type="warning"><title>Note &agrave; propos de l'en-t&ecirc;te
+      <note type="warning"><title>Note à propos de l'en-tête
       <code>Content-Length</code></title>
-        <p>Si vous &eacute;valuez vous-m&ecirc;me la taille du corps de requ&ecirc;te,
-	<em>ne faites pas confiance &agrave; l'en-t&ecirc;te
-	<code>Content-Length</code>!</em> L'en-t&ecirc;te
-	Content-Length indique la longueur des donn&eacute;es en provenance du
-	client, et <em>non</em> la quantit&eacute; d'octets que repr&eacute;sente le
-	flux de donn&eacute;es d&eacute;compress&eacute;.</p>
+        <p>Si vous évaluez vous-même la taille du corps de requête,
+	<em>ne faites pas confiance à l'en-tête
+	<code>Content-Length</code>!</em> L'en-tête
+	Content-Length indique la longueur des données en provenance du
+	client, et <em>non</em> la quantité d'octets que représente le
+	flux de données décompressé.</p>
       </note>
     </section>
 </section>
 
 <section id="proxies"><title>Prise en compte des serveurs mandataires</title>
 
-    <p>Le module <module>mod_deflate</module> envoie un en-t&ecirc;te de
-    r&eacute;ponse HTTP <code>Vary: Accept-Encoding</code> pour avertir les
-    mandataires qu'une r&eacute;ponse enregistr&eacute;e dans le cache ne doit &ecirc;tre
-    envoy&eacute;e qu'aux clients qui ont envoy&eacute; l'en-t&ecirc;te de requ&ecirc;te
-    <code>Accept-Encoding</code> appropri&eacute;. Ceci permet d'&eacute;viter l'envoi
-    d'un contenu comprim&eacute; &agrave; un client qui ne sera pas en mesure
-    de l'interpr&eacute;ter.</p>
-
-    <p>Si vous avez d&eacute;fini des exclusions sp&eacute;cifiques d&eacute;pendant, par
-    exemple, de l'en-t&ecirc;te <code>User-Agent</code>, vous devez
-    ajouter manuellement des donn&eacute;es &agrave; l'en-t&ecirc;te <code>Vary</code> afin
-    d'informer les mandataires des restrictions suppl&eacute;mentaires. Par
-    exemple, dans la configuration classique o&ugrave; l'addition du filtre
-    <code>DEFLATE</code> d&eacute;pend du contenu de l'en-t&ecirc;te
-    <code>User-Agent</code>, vous devez sp&eacute;cifier :</p>
+    <p>Le module <module>mod_deflate</module> envoie un en-tête de
+    réponse HTTP <code>Vary: Accept-Encoding</code> pour avertir les
+    mandataires qu'une réponse enregistrée dans le cache ne doit être
+    envoyée qu'aux clients qui ont envoyé l'en-tête de requête
+    <code>Accept-Encoding</code> approprié. Ceci permet d'éviter l'envoi
+    d'un contenu comprimé à un client qui ne sera pas en mesure
+    de l'interpréter.</p>
+
+    <p>Si vous avez défini des exclusions spécifiques dépendant, par
+    exemple, de l'en-tête <code>User-Agent</code>, vous devez
+    ajouter manuellement des données à l'en-tête <code>Vary</code> afin
+    d'informer les mandataires des restrictions supplémentaires. Par
+    exemple, dans la configuration classique où l'addition du filtre
+    <code>DEFLATE</code> dépend du contenu de l'en-tête
+    <code>User-Agent</code>, vous devez spécifier :</p>
 
     <highlight language="config">
       Header append Vary User-Agent
     </highlight>
 
-    <p>Si votre d&eacute;cision de comprimer le contenu d&eacute;pend d'autres
-    informations que celles contenues dans les en-t&ecirc;tes de la requ&ecirc;te
-    (par exemple la version HTTP), vous devez attribuer &agrave; l'en-t&ecirc;te
-    <code>Vary</code> la valeur <code>*</code>, ce qui permet d'emp&ecirc;cher
+    <p>Si votre décision de comprimer le contenu dépend d'autres
+    informations que celles contenues dans les en-têtes de la requête
+    (par exemple la version HTTP), vous devez attribuer à l'en-tête
+    <code>Vary</code> la valeur <code>*</code>, ce qui permet d'empêcher
     les mandataires compatibles de tout mettre en cache.</p>
 
     <example><title>Exemple</title>
@@ -203,30 +203,30 @@ SetEnvIfNoCase Request_URI "\.(?:gif|jpe
     </example>
 </section>
 
-<section id="precompressed"><title>Servir du contenu pr&eacute;compress&eacute;</title>
+<section id="precompressed"><title>Servir du contenu précompressé</title>
 
-    <p>Comme <module>mod_deflate</module> recompresse le contenu demand&eacute; &agrave;
-    chaque requ&ecirc;te, il est possible de gagner en performances en
-    pr&eacute;compressant ce contenu, et en for&ccedil;ant mod_deflate &agrave; servir ce
-    contenu pr&eacute;compress&eacute; sans avoir &agrave; le recompresser &agrave; chaque requ&ecirc;te.
+    <p>Comme <module>mod_deflate</module> recompresse le contenu demandé à
+    chaque requête, il est possible de gagner en performances en
+    précompressant ce contenu, et en forçant mod_deflate à servir ce
+    contenu précompressé sans avoir à le recompresser à chaque requête.
     Pour ce faire, utilisez une configuration du style :</p>
 
     <highlight language="config">
 &lt;IfModule mod_headers.c&gt;
-    # Servir des fichiers CSS compress&eacute;s avec gzip, s'ils existent, et
+    # Servir des fichiers CSS compressés avec gzip, s'ils existent, et
     # si le client accepte gzip.
     RewriteCond "%{HTTP:Accept-encoding}" "gzip"
     RewriteCond "%{REQUEST_FILENAME}\.gz" "-s"
     RewriteRule "^(.*)\.css"              "$1\.css\.gz" [QSA]
 
-    # Servir des fichiers JS compress&eacute;s avec gzip, s'ils existent, et
+    # Servir des fichiers JS compressés avec gzip, s'ils existent, et
     # si le client accepte gzip.
     RewriteCond "%{HTTP:Accept-encoding}" "gzip"
     RewriteCond "%{REQUEST_FILENAME}\.gz" "-s"
     RewriteRule "^(.*)\.js"               "$1\.js\.gz" [QSA]
 
 
-    # Servir des types de contenus corrects, et emp&ecirc;cher mod_deflate
+    # Servir des types de contenus corrects, et empêcher mod_deflate
     # d'effectuer un double gzip.
     RewriteRule "\.css\.gz$" "-" [T=text/css,E=no-gzip:1]
     RewriteRule "\.js\.gz$"  "-" [T=text/javascript,E=no-gzip:1]
@@ -236,8 +236,8 @@ SetEnvIfNoCase Request_URI "\.(?:gif|jpe
       # Servir le type de codage correct.
       Header append Content-Encoding gzip
 
-      # Force les mandataires &agrave; mettre en cache s&eacute;par&eacute;ment les fichiers
-      # css/js gzipp&eacute;s &amp; non gzipp&eacute;s.
+      # Force les mandataires à mettre en cache séparément les fichiers
+      # css/js gzippés &amp; non gzippés.
       Header append Vary Accept-Encoding
     &lt;/FilesMatch&gt;
 &lt;/IfModule&gt;
@@ -248,18 +248,18 @@ SetEnvIfNoCase Request_URI "\.(?:gif|jpe
 <directivesynopsis>
 <name>DeflateFilterNote</name>
 <description>Enregistre le taux de compression sous la forme d'une note
-&agrave; des fins de journalisation</description>
+à des fins de journalisation</description>
 <syntax>DeflateFilterNote [<var>type</var>] <var>nom de la note</var></syntax>
 <contextlist><context>server config</context><context>virtual host</context>
 </contextlist>
 
 <usage>
     <p>La directive <directive>DeflateFilterNote</directive> permet de
-    sp&eacute;cifier qu'une note &agrave; propos du taux de compression doit &ecirc;tre
-    attach&eacute;e &agrave; la requ&ecirc;te. Le nom de la note est pass&eacute; sous la forme
-    d'un argument de la directive. Vous pouvez utiliser cette note &agrave; des
+    spécifier qu'une note à propos du taux de compression doit être
+    attachée à la requête. Le nom de la note est passé sous la forme
+    d'un argument de la directive. Vous pouvez utiliser cette note à des
     fins statistiques en enregistrant sa valeur dans votre <a
-    href="../logs.html#accesslog">journal des acc&egrave;s</a>.</p>
+    href="../logs.html#accesslog">journal des accès</a>.</p>
 
     <example><title>Exemple</title>
       <highlight language="config">
@@ -270,14 +270,14 @@ SetEnvIfNoCase Request_URI "\.(?:gif|jpe
       </highlight>
     </example>
 
-    <p>Pour extraire des informations plus pr&eacute;cises de vos journaux,
-    vous pouvez utiliser l'argument <var>type</var> pour sp&eacute;cifier le
-    type de donn&eacute;es de la note enregistr&eacute;e dans le journal.
+    <p>Pour extraire des informations plus précises de vos journaux,
+    vous pouvez utiliser l'argument <var>type</var> pour spécifier le
+    type de données de la note enregistrée dans le journal.
     <var>type</var> peut prendre une des valeurs suivantes :</p>
 
     <dl>
       <dt><code>Input</code></dt>
-      <dd>Enregistre dans la note la taille en octets du flux en entr&eacute;e
+      <dd>Enregistre dans la note la taille en octets du flux en entrée
       du filtre.</dd>
 
       <dt><code>Output</code></dt>
@@ -285,15 +285,15 @@ SetEnvIfNoCase Request_URI "\.(?:gif|jpe
       du filtre.</dd>
 
       <dt><code>Ratio</code></dt>
-      <dd>Enregistre le taux de compression (<code>sortie/entr&eacute;e *
-      100</code>) dans la note. Il s'agit de la valeur par d&eacute;faut si
+      <dd>Enregistre le taux de compression (<code>sortie/entrée *
+      100</code>) dans la note. Il s'agit de la valeur par défaut si
       l'argument <var>type</var> est omis.</dd>
     </dl>
 
-    <p>Vous pouvez donc configurer votre journalisation de la mani&egrave;re
+    <p>Vous pouvez donc configurer votre journalisation de la manière
     suivante :</p>
 
-    <example><title>Journalisation d&eacute;taill&eacute;e</title>
+    <example><title>Journalisation détaillée</title>
       <highlight language="config">
 DeflateFilterNote Input instream
 DeflateFilterNote Output outstream
@@ -318,14 +318,23 @@ fois</description>
 
 <usage>
     <p>La directive <directive>DeflateBufferSize</directive> permet de
-    sp&eacute;cifier la taille en octets du fragment que zlib devra comprimer
-    en une seule fois.</p>
+    spécifier la taille en octets du fragment que zlib devra comprimer
+    en une seule fois. Si la taille de la réponse compressée est supérieure à
+    celle spécifiée par cette directive, httpd passera à un mode d'encodage
+    fragmenté (l'en-tête HTTP <code>Transfer-Encoding</code> prend la valeur
+    <code>Chunked</code>), ceci ayant comme effet de bord de ne définir aucun
+    en-tête HTTP <code>Content-Length</code>. Il est important de connaître ce
+    comportement, particulièrement lorsque httpd travaille derrière des
+    mandataires inverses avec mise en cache, ou lorsque httpd est configuré pour
+    utiliser <module>mod_cache</module> et <module>mod_cache_disk</module> car
+    les réponses HTTP sans en-tête <code>Content-Length</code> peuvent ne pas
+    être mises en cache.</p>
 </usage>
 </directivesynopsis>
 
 <directivesynopsis>
 <name>DeflateWindowSize</name>
-<description>Taille de la fen&ecirc;tre de compression zlib</description>
+<description>Taille de la fenêtre de compression zlib</description>
 <syntax>DeflateWindowSize <var>valeur</var></syntax>
 <default>DeflateWindowSize 15</default>
 <contextlist><context>server config</context><context>virtual host</context>
@@ -333,8 +342,8 @@ fois</description>
 
 <usage>
     <p>La directive <directive>DeflateWindowSize</directive> permet de
-    sp&eacute;cifier la fen&ecirc;tre de compression zlib (une valeur comprise entre
-    1 et 15). En g&eacute;n&eacute;ral, plus grande sera la taille de la fen&ecirc;tre, plus
+    spécifier la fenêtre de compression zlib (une valeur comprise entre
+    1 et 15). En général, plus grande sera la taille de la fenêtre, plus
     grand sera le taux de compression auquel on pourra s'attendre.</p>
 </usage>
 </directivesynopsis>
@@ -342,7 +351,7 @@ fois</description>
 <directivesynopsis>
 
 <name>DeflateMemLevel</name>
-<description>La quantit&eacute; de m&eacute;moire utilisable par zlib pour la
+<description>La quantité de mémoire utilisable par zlib pour la
 compression</description>
 <syntax>DeflateMemLevel <var>valeur</var></syntax>
 <default>DeflateMemLevel 9</default>
@@ -351,89 +360,89 @@ compression</description>
 
 <usage>
     <p>La directive <directive>DeflateMemLevel</directive> permet de
-    sp&eacute;cifier la quantit&eacute; de m&eacute;moire utilisable par zlib pour la
+    spécifier la quantité de mémoire utilisable par zlib pour la
     compression (une valeur comprise entre 1 et 9).</p>
 </usage>
 </directivesynopsis>
 
 <directivesynopsis>
 <name>DeflateCompressionLevel</name>
-<description>Le niveau de compression que nous appliquons &agrave; la
+<description>Le niveau de compression que nous appliquons à la
 sortie</description>
 <syntax>DeflateCompressionLevel <var>valeur</var></syntax>
-<default>La valeur par d&eacute;faut de zlib</default>
+<default>La valeur par défaut de zlib</default>
 <contextlist><context>server config</context><context>virtual host</context>
 </contextlist>
 
 <usage>
     <p>La directive <directive>DeflateCompressionLevel</directive>
-    permet de sp&eacute;cifier le niveau de compression &agrave; utiliser ; plus
+    permet de spécifier le niveau de compression à utiliser ; plus
     grande est la valeur, meilleure sera la compression, mais plus grand
-    sera aussi le temps CPU n&eacute;cessaire pour effectuer le
+    sera aussi le temps CPU nécessaire pour effectuer le
     traitement.</p>
-    <p>La valeur doit &ecirc;tre comprise entre 1 (compression minimale) et 9
+    <p>La valeur doit être comprise entre 1 (compression minimale) et 9
     (compression maximale).</p>
 </usage>
 </directivesynopsis>
 
 <directivesynopsis>
 <name>DeflateInflateLimitRequestBody</name>
-<description>Taille maximale des corps de requ&ecirc;te d&eacute;compress&eacute;s</description>
+<description>Taille maximale des corps de requête décompressés</description>
 <syntax>DeflateInflateLimitRequestBody<var>value</var></syntax>
-<default>Aucune limite, mais LimitRequestBody s'applique apr&egrave;s la
+<default>Aucune limite, mais LimitRequestBody s'applique après la
 compression</default>
 <contextlist><context>server config</context><context>virtual host</context>
 <context>directory</context><context>.htaccess</context></contextlist>
-<compatibility>Disponible &agrave; partir de la version 2.4.10 du serveur HTTP
+<compatibility>Disponible à partir de la version 2.4.10 du serveur HTTP
 Apache</compatibility>
 
 <usage>
     <p>La directive
     <directive>DeflateInflateLimitRequestBody</directive> permet de
-    sp&eacute;cifier la taille maximale d'un corps de requ&ecirc;te d&eacute;compress&eacute;. Si
-    elle n'est pas d&eacute;finie, c'est la valeur de la directive <directive
+    spécifier la taille maximale d'un corps de requête décompressé. Si
+    elle n'est pas définie, c'est la valeur de la directive <directive
     module="core">LimitRequestBody</directive> qui s'applique au corps
-    de requ&ecirc;te d&eacute;compress&eacute;.</p>
+    de requête décompressé.</p>
 </usage>
 </directivesynopsis>
 
 <directivesynopsis>
 <name>DeflateInflateRatioLimit</name>
-<description>Ratio de d&eacute;compression maximum pour les corps de requ&ecirc;tes</description>
+<description>Ratio de décompression maximum pour les corps de requêtes</description>
 <syntax>DeflateInflateRatioLimit <var>value</var></syntax>
 <default>200</default>
 <contextlist><context>server config</context><context>virtual host</context>
 <context>directory</context><context>.htaccess</context></contextlist>
-<compatibility>Disponible &agrave; partir de la version 2.4.10 du serveur HTTP
+<compatibility>Disponible à partir de la version 2.4.10 du serveur HTTP
 Apache</compatibility>
 
 <usage>
     <p>La directive <directive>DeflateInflateRatioLimit</directive>
-    permet de d&eacute;finir le ratio maximum entre la taille d'un corps de
-    requ&ecirc;te compress&eacute; et sa taille d&eacute;compress&eacute;e. Ce ratio est v&eacute;rifi&eacute; au
-    fur et &agrave; mesure de
-    l'arriv&eacute;e du corps de requ&ecirc;te, et s'il est d&eacute;pass&eacute; plus de
+    permet de définir le ratio maximum entre la taille d'un corps de
+    requête compressé et sa taille décompressée. Ce ratio est vérifié au
+    fur et à mesure de
+    l'arrivée du corps de requête, et s'il est dépassé plus de
     <directive>DeflateInflateRatioBurst</directive> fois, le traitement
-    de la requ&ecirc;te est interrompu.</p>
+    de la requête est interrompu.</p>
 </usage>
 </directivesynopsis>
 
 <directivesynopsis>
 <name>DeflateInflateRatioBurst</name>
-<description>Nombre maximal de fois que le ratio de d&eacute;compression d'un
-corps de requ&ecirc;te peut &ecirc;tre d&eacute;pass&eacute;</description>
+<description>Nombre maximal de fois que le ratio de décompression d'un
+corps de requête peut être dépassé</description>
 <syntax>DeflateInflateRatioBurst <var>value</var></syntax>
 <default>3</default>
 <contextlist><context>server config</context><context>virtual host</context>
 <context>directory</context><context>.htaccess</context></contextlist>
-<compatibility>Disponible &agrave; partir de la version 2.4.10 du serveur HTTP
+<compatibility>Disponible à partir de la version 2.4.10 du serveur HTTP
 Apache</compatibility>
 
 <usage>
     <p>La directive <directive>DeflateInflateRatioBurst</directive>
-    permet de sp&eacute;cifier le nombre maximal de fois que la valeur de la
-    directive <directive>DeflateInflateRatioLimit</directive> peut &ecirc;tre
-    d&eacute;pass&eacute; avant l'arr&ecirc;t du traitement de la requ&ecirc;te.</p>
+    permet de spécifier le nombre maximal de fois que la valeur de la
+    directive <directive>DeflateInflateRatioLimit</directive> peut être
+    dépassé avant l'arrêt du traitement de la requête.</p>
 </usage>
 </directivesynopsis>
 




Mime
View raw message