diff options
author | Ken Coar <coar@apache.org> | 2015-04-15 19:46:53 +0200 |
---|---|---|
committer | Ken Coar <coar@apache.org> | 2015-04-15 19:46:53 +0200 |
commit | 57ef10245b3cf962dcbe40d205d94c241bed7f0e (patch) | |
tree | 596b4aacaa742456ddd5a457f712481ae85dffc2 /docs/manual/mod/mod_deflate.html.fr | |
parent | Mention which indexoptions need fancyindexing. Rsesolves bz56985 (diff) | |
download | apache2-57ef10245b3cf962dcbe40d205d94c241bed7f0e.tar.xz apache2-57ef10245b3cf962dcbe40d205d94c241bed7f0e.zip |
Enclose parameters in quotation marks for <{Files,Directory,Location}{,Match}>
containers.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1673892 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod/mod_deflate.html.fr')
-rw-r--r-- | docs/manual/mod/mod_deflate.html.fr | 296 |
1 files changed, 148 insertions, 148 deletions
diff --git a/docs/manual/mod/mod_deflate.html.fr b/docs/manual/mod/mod_deflate.html.fr index 14c4b9a7ca..14c08348f0 100644 --- a/docs/manual/mod/mod_deflate.html.fr +++ b/docs/manual/mod/mod_deflate.html.fr @@ -42,7 +42,12 @@ client</td></tr> sortie <code>DEFLATE</code> qui permet de comprimer la sortie de votre serveur avant de l'envoyer au client sur le réseau.</p> </div> -<div id="quickview"><h3 class="directives">Directives</h3> +<div id="quickview"><h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#recommended">Exemples de configurations</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#enable">Activation de la compression</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#proxies">Prise en compte des serveurs mandataires</a></li> +</ul><h3 class="directives">Directives</h3> <ul id="toc"> <li><img alt="" src="../images/down.gif" /> <a href="#deflatealteretag">DeflateAlterETag</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#deflatebuffersize">DeflateBufferSize</a></li> @@ -54,16 +59,152 @@ client</td></tr> <li><img alt="" src="../images/down.gif" /> <a href="#deflatememlevel">DeflateMemLevel</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#deflatewindowsize">DeflateWindowSize</a></li> </ul> -<h3>Sujets</h3> -<ul id="topics"> -<li><img alt="" src="../images/down.gif" /> <a href="#recommended">Exemples de configurations</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#enable">Activation de la compression</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#proxies">Prise en compte des serveurs mandataires</a></li> -</ul><h3>Voir aussi</h3> +<h3>Voir aussi</h3> <ul class="seealso"> <li><a href="../filter.html">Les filtres</a></li> </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="recommended" id="recommended">Exemples de configurations</a></h2> + <div class="warning"><h3>Compression et TLS</h3> + <p>Certaines applications web sont vulnérables à une attaque pour + vol d'informations lorsqu'une connexion TLS transporte des + données compressées par deflate. Pour plus de détails, + documentez-vous sur la famille d'attaques "BREACH".</p> + </div> + <p>Voici un exemple simple de configuration qui permet de comprimer + les types de contenu à base de texte.</p> + + <div class="example"><h3>Ne comprime que certains types de documents</h3><pre class="prettyprint lang-config">AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript</pre> +</div> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="enable" id="enable">Activation de la compression</a></h2> + <div class="warning"><h3>Compression et TLS</h3> + <p>Certaines applications web sont vulnérables à une attaque pour + vol d'informations lorsqu'une connexion TLS transporte des + données compressées par deflate. Pour plus de détails, + documentez-vous sur la famille d'attaques "BREACH".</p> + </div> + + <h3><a name="output" id="output">Compression de la sortie</a></h3> + <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ù elle est placée :</p> + + <pre class="prettyprint lang-config">SetOutputFilter DEFLATE +SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip</pre> + + + <p>Si vous voulez limiter la compression à certains types MIME + particuliers, vous pouvez utiliser la directive <code class="directive"><a href="../mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code>. Voici un exemple + où la compression n'est activée que pour les fichiers html de la + documentation d'Apache :</p> + + <pre class="prettyprint lang-config"><Directory "/your-server-root/manual"> + AddOutputFilterByType DEFLATE text/html +</Directory></pre> + + + <div class="note"><h3>Note</h3> + 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êtes internes. + </div> + <div class="note"><h3>Note</h3> + La variable d'environnement <code>force-gzip</code>, définie à + l'aide de la directive <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code>, permet d'ignorer la + configuration de votre navigateur quant aux codages acceptés, et + d'envoyer sans condition une sortie comprimée. + </div> + + + <h3><a name="inflate" id="inflate">Décompression de la sortie</a></h3> + <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> fournit aussi un filtre + 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 <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code> ou + <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>, comme + dans l'exemple suivant :</p> + + <pre class="prettyprint lang-config"><Location /dav-area> + ProxyPass http://example.com/ + SetOutputFilter INFLATE +</Location></pre> + + + <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> + + + <h3><a name="input" id="input">Décompression de l'entrée</a></h3> + <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> 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 <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code> ou + <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>, comme + dans l'exemple suivant :</p> + + <pre class="prettyprint lang-config"><Location /dav-area> + SetInputFilter DEFLATE +</Location></pre> + + + <p>Désormais, si une requête contient un en-tête + <code>Content-Encoding: gzip</code>, son corps sera + 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> + + <div class="warning"><h3>Note à propos de l'en-tête + <code>Content-Length</code></h3> + <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> + </div> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="proxies" id="proxies">Prise en compte des serveurs mandataires</a></h2> + + <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> 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> + + <pre class="prettyprint lang-config">Header append Vary User-Agent</pre> + + + <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> + + <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">Header set Vary *</pre> +</div> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="deflatealteretag" id="deflatealteretag">Directive</a> <a name="DeflateAlterETag" id="DeflateAlterETag">DeflateAlterETag</a></h2> <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Comment l'en-tête sortant ETag doit être modifié au cours @@ -285,147 +426,6 @@ compression</td></tr> grand sera le taux de compression auquel on pourra s'attendre.</p> </div> -<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> -<div class="section"> -<h2><a name="recommended" id="recommended">Exemples de configurations</a></h2> - <div class="warning"><h3>Compression et TLS</h3> - <p>Certaines applications web sont vulnérables à une attaque pour - vol d'informations lorsqu'une connexion TLS transporte des - données compressées par deflate. Pour plus de détails, - documentez-vous sur la famille d'attaques "BREACH".</p> - </div> - <p>Voici un exemple simple de configuration qui permet de comprimer - les types de contenu à base de texte.</p> - - <div class="example"><h3>Ne comprime que certains types de documents</h3><pre class="prettyprint lang-config">AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript</pre> -</div> - -</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> -<div class="section"> -<h2><a name="enable" id="enable">Activation de la compression</a></h2> - <div class="warning"><h3>Compression et TLS</h3> - <p>Certaines applications web sont vulnérables à une attaque pour - vol d'informations lorsqu'une connexion TLS transporte des - données compressées par deflate. Pour plus de détails, - documentez-vous sur la famille d'attaques "BREACH".</p> - </div> - - <h3><a name="output" id="output">Compression de la sortie</a></h3> - <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ù elle est placée :</p> - - <pre class="prettyprint lang-config">SetOutputFilter DEFLATE -SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip</pre> - - - <p>Si vous voulez limiter la compression à certains types MIME - particuliers, vous pouvez utiliser la directive <code class="directive"><a href="../mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code>. Voici un exemple - où la compression n'est activée que pour les fichiers html de la - documentation d'Apache :</p> - - <pre class="prettyprint lang-config"><Directory "/your-server-root/manual"> - AddOutputFilterByType DEFLATE text/html -</Directory></pre> - - - <div class="note"><h3>Note</h3> - 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êtes internes. - </div> - <div class="note"><h3>Note</h3> - La variable d'environnement <code>force-gzip</code>, définie à - l'aide de la directive <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code>, permet d'ignorer la - configuration de votre navigateur quant aux codages acceptés, et - d'envoyer sans condition une sortie comprimée. - </div> - - - <h3><a name="inflate" id="inflate">Décompression de la sortie</a></h3> - <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> fournit aussi un filtre - 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 <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code> ou - <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code>, comme - dans l'exemple suivant :</p> - - <pre class="prettyprint lang-config"><Location /dav-area> - ProxyPass http://example.com/ - SetOutputFilter INFLATE -</Location></pre> - - - <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> - - - <h3><a name="input" id="input">Décompression de l'entrée</a></h3> - <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> 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 <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code> ou - <code class="directive"><a href="../mod/mod_mime.html#addinputfilter">AddInputFilter</a></code>, comme - dans l'exemple suivant :</p> - - <pre class="prettyprint lang-config"><Location /dav-area> - SetInputFilter DEFLATE -</Location></pre> - - - <p>Désormais, si une requête contient un en-tête - <code>Content-Encoding: gzip</code>, son corps sera - 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> - - <div class="warning"><h3>Note à propos de l'en-tête - <code>Content-Length</code></h3> - <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> - </div> - -</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> -<div class="section"> -<h2><a name="proxies" id="proxies">Prise en compte des serveurs mandataires</a></h2> - - <p>Le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> 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> - - <pre class="prettyprint lang-config">Header append Vary User-Agent</pre> - - - <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> - - <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">Header set Vary *</pre> -</div> -</div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_deflate.html" hreflang="en" rel="alternate" title="English"> en </a> | |