docs/manual/mod/mod_buffer.xml.fr

<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1933747 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->

<!--
 Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.  See the NOTICE file distributed with
 this work for additional information regarding copyright ownership.
 The ASF licenses this file to You under the Apache License, Version 2.0
 (the "License"); you may not use this file except in compliance with
 the License.  You may obtain a copy of the License at

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

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<modulesynopsis metafile="mod_buffer.xml.meta">

<name>mod_buffer</name>
<description>Support de la mise en tampon des requêtes</description>
<status>Extension</status>
<sourcefile>mod_buffer.c</sourcefile>
<identifier>buffer_module</identifier>
<compatibility>Disponible depuis les versions 2.3 et supérieures
d'Apache</compatibility>

<summary>
    <p>Ce module fournit la possibilité de mettre en tampon les piles
    des filtres en entrée et sortie.</p>

    <p>Dans certaines situations, les générateurs de contenu créent des
    contenus composés de petits tronçons. Afin de permettre la
    réutilisation de la mémoire, les éléments de mémoire attribués aux
    tronçons ont toujours une taille de 8k, quelle que soit la taille du
    tronçon lui-même. Lorsqu'une requête génère de nombreux petits
    tronçons, une grande quantité de mémoire peut être mobilisée par le
    traitement de la requête, et une grande quantité de données
    transmises sans nécessité. Pour y remédier, l'utilisation d'un
    tampon rassemble la réponse en un nombre de tronçons le plus petit
    possible.</p>

    <p>Lorsque httpd est utilisé comme frontal d'un générateur de
    contenu consommant beaucoup de ressources, la mise en tampon de la
    réponse peut permettre à ce dernier d'effectuer le traitement et de
    libérer les ressources plus ou moins rapidement, en fonction de la
    manière dont il a été conçu.</p>

    <p>Le filtre de mise en tampon peut être ajouté aux piles des
    filtres en entrée ou en sortie, selon les besoins, à l'aide des
    directives <directive module="core">SetInputFilter</directive>,
    <directive module="core">SetOutputFilter</directive>, <directive
    module="mod_mime">AddOutputFilter</directive> ou <directive
    module="mod_filter">AddOutputFilterByType</directive>.</p>

      <example><title>Utilisation d'un tampon avec mod_include</title>
        <highlight language="config">
        AddOutputFilterByType INCLUDES;BUFFER text/html
        </highlight>
      </example>

    <note type="warning">Les filtres de mise en tampon lisent la
    requête/réponse en RAM, puis la reconditionnent sous la forme d'un
    nombre d'éléments mémoire le plus petit possible, au prix d'une
    consommation de temps CPU. Lorsque la requête/réponse est déjà
    conditionnée de manière satisfaisante, sa mise en tampon pourrait
    s'avérer encore plus lente qu'en l'absence d'utilisation de tampon.
    C'est pourquoi ces filtres doivent être utilisés avec précautions,
    et seulement si nécessaire.</note>

</summary>
<seealso><a href="../filter.html">Les filtres</a></seealso>

<directivesynopsis>
<name>BufferSize</name>
<description>Taille maximale en octets du filtre par tampon</description>
<syntax>BufferSize entier</syntax>
<default>BufferSize 131072</default>
<contextlist>
<context>directory</context>
<context>.htaccess</context>
</contextlist>

<usage>
    <p>La directive <directive
    module="mod_buffer">BufferSize</directive> permet de spécifier la
    quantité de données en octets qui sera mise en tampon avant d'être
    lue depuis ou écrite vers chaque requête. La valeur par défaut est
    128 ko.</p>
</usage>
</directivesynopsis>

</modulesynopsis>