granicus.if.org Git - apache/blob - docs/manual/mod/mod_buffer.xml.fr

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision : 1330964 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <modulesynopsis metafile="mod_buffer.xml.meta">
  26
  27 <name>mod_buffer</name>
  28 <description>Support de la mise en tampon des requ&ecirc;tes</description>
  29 <status>Extension</status>
  30 <sourcefile>mod_buffer.c</sourcefile>
  31 <identifier>buffer_module</identifier>
  32 <compatibility>Disponible depuis les versions 2.3 et sup&eacute;rieures
  33 d'Apache</compatibility>
  34
  35 <summary>
  36     <p>Ce module fournit la possibilit&eacute; de mettre en tampon les piles
  37     des filtres en entr&eacute;e et sortie.</p>
  38
  39     <p>Dans certaines situations, les g&eacute;n&eacute;rateurs de contenu cr&eacute;ent des
  40     contenus compos&eacute;s de petits tron&ccedil;ons. Afin de permettre la
  41     r&eacute;utilisation de la m&eacute;moire, les &eacute;l&eacute;ments de m&eacute;moire attribu&eacute;s aux
  42     tron&ccedil;ons ont toujours une taille de 8k, quelle que soit la taille du
  43     tron&ccedil;on lui-m&ecirc;me. Lorsqu'une requ&ecirc;te g&eacute;n&egrave;re de nombreux petits
  44     tron&ccedil;ons, une grande quantit&eacute; de m&eacute;moire peut &ecirc;tre mobilis&eacute;e par le
  45     traitement de la requ&ecirc;te, et une grande quantit&eacute; de donn&eacute;es
  46     transmises sans n&eacute;cessit&eacute;. Pour y rem&eacute;dier, l'utilisation d'un
  47     tampon rassemble la r&eacute;ponse en un nombre de tron&ccedil;ons le plus petit
  48     possible.</p>
  49
  50     <p>Lorsque httpd est utilis&eacute; comme frontal d'un g&eacute;n&eacute;rateur de
  51     contenu consommant beaucoup de ressources, la mise en tampon de la
  52     r&eacute;ponse peut permettre &agrave; ce dernier d'effectuer le traitement et de
  53     lib&eacute;rer les ressources plus ou moins rapidement, en fonction de la
  54     mani&egrave;re dont il a &eacute;t&eacute; con&ccedil;u.</p>
  55
  56     <p>Le filtre de mise en tampon peut &ecirc;tre ajout&eacute; aux piles des
  57     filtres en entr&eacute;e ou en sortie, selon les besoins, &agrave; l'aide des
  58     directives <directive module="core">SetInputFilter</directive>,
  59     <directive module="core">SetOutputFilter</directive>, <directive
  60     module="mod_mime">AddOutputFilter</directive> ou <directive
  61     module="mod_filter">AddOutputFilterByType</directive>.</p>
  62
  63       <example><title>Utilisation d'un tampon avec mod_include</title>
  64         <highlight language="config">
  65         AddOutputFilterByType INCLUDES;BUFFER text/html
  66         </highlight>
  67       </example>
  68
  69     <note type="warning">Les filtres de mise en tampon lisent la
  70     requ&ecirc;te/r&eacute;ponse en RAM, puis la reconditionnent sous la forme d'un
  71     nombre d'&eacute;l&eacute;ments m&eacute;moire le plus petit possible, au prix d'une
  72     consommation de temps CPU. Lorsque la requ&ecirc;te/r&eacute;ponse est d&eacute;j&agrave;
  73     conditionn&eacute;e de mani&egrave;re satisfaisante, sa mise en tampon pourrait
  74     s'av&eacute;rer encore plus lente qu'en l'absence d'utilisation de tampon.
  75     C'est pourquoi ces filtres doivent &ecirc;tre utilis&eacute;s avec pr&eacute;cautions,
  76     et seulement si n&eacute;cessaire.</note>
  77
  78 </summary>
  79 <seealso><a href="../filter.html">Les filtres</a></seealso>
  80
  81 <directivesynopsis>
  82 <name>BufferSize</name>
  83 <description>Taille maximale en octets du filtre par tampon</description>
  84 <syntax>BufferSize entier</syntax>
  85 <default>BufferSize 131072</default>
  86 <contextlist><context>server config</context>
  87 <context>virtual host</context>
  88 <context>directory</context>
  89 <context>.htaccess</context>
  90 </contextlist>
  91
  92 <usage>
  93     <p>La directive <directive
  94     module="mod_buffer">BufferSize</directive> permet de sp&eacute;cifier la
  95     quantit&eacute; de donn&eacute;es en octets qui sera mise en tampon avant d'&ecirc;tre
  96     lue depuis ou &eacute;crite vers chaque requ&ecirc;te. La valeur par d&eacute;faut est
  97     128 ko.</p>
  98 </usage>
  99 </directivesynopsis>
 100
 101 </modulesynopsis>