0066eddda7203f6345b56f77d146a759298dc635gryzor<?xml version="1.0"?>
0066eddda7203f6345b56f77d146a759298dc635gryzor<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
0066eddda7203f6345b56f77d146a759298dc635gryzor<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>
e2f05529a1835546e17527f56074c023e6a47366lgentis<!-- English Revision : 1330964 -->
0066eddda7203f6345b56f77d146a759298dc635gryzor<!-- French translation : Lucien GENTIS -->
0066eddda7203f6345b56f77d146a759298dc635gryzor<!-- Reviewed by : Vincent Deffontaines -->
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor<!--
0066eddda7203f6345b56f77d146a759298dc635gryzor Licensed to the Apache Software Foundation (ASF) under one or more
0066eddda7203f6345b56f77d146a759298dc635gryzor contributor license agreements. See the NOTICE file distributed with
0066eddda7203f6345b56f77d146a759298dc635gryzor this work for additional information regarding copyright ownership.
0066eddda7203f6345b56f77d146a759298dc635gryzor The ASF licenses this file to You under the Apache License, Version 2.0
0066eddda7203f6345b56f77d146a759298dc635gryzor (the "License"); you may not use this file except in compliance with
0066eddda7203f6345b56f77d146a759298dc635gryzor the License. You may obtain a copy of the License at
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor http://www.apache.org/licenses/LICENSE-2.0
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor Unless required by applicable law or agreed to in writing, software
0066eddda7203f6345b56f77d146a759298dc635gryzor distributed under the License is distributed on an "AS IS" BASIS,
0066eddda7203f6345b56f77d146a759298dc635gryzor WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0066eddda7203f6345b56f77d146a759298dc635gryzor See the License for the specific language governing permissions and
0066eddda7203f6345b56f77d146a759298dc635gryzor limitations under the License.
0066eddda7203f6345b56f77d146a759298dc635gryzor-->
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor<modulesynopsis metafile="mod_buffer.xml.meta">
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor<name>mod_buffer</name>
0066eddda7203f6345b56f77d146a759298dc635gryzor<description>Support de la mise en tampon des requ&ecirc;tes</description>
0066eddda7203f6345b56f77d146a759298dc635gryzor<status>Extension</status>
0066eddda7203f6345b56f77d146a759298dc635gryzor<sourcefile>mod_buffer.c</sourcefile>
0066eddda7203f6345b56f77d146a759298dc635gryzor<identifier>buffer_module</identifier>
0066eddda7203f6345b56f77d146a759298dc635gryzor<compatibility>Disponible depuis les versions 2.3 et sup&eacute;rieures
0066eddda7203f6345b56f77d146a759298dc635gryzord'Apache</compatibility>
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor<summary>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Ce module fournit la possibilit&eacute; de mettre en tampon les piles
0066eddda7203f6345b56f77d146a759298dc635gryzor des filtres en entr&eacute;e et sortie.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Dans certaines situations, les g&eacute;n&eacute;rateurs de contenu cr&eacute;ent des
0066eddda7203f6345b56f77d146a759298dc635gryzor contenus compos&eacute;s de petits tron&ccedil;ons. Afin de permettre la
0066eddda7203f6345b56f77d146a759298dc635gryzor r&eacute;utilisation de la m&eacute;moire, les &eacute;l&eacute;ments de m&eacute;moire attribu&eacute;s aux
0066eddda7203f6345b56f77d146a759298dc635gryzor tron&ccedil;ons ont toujours une taille de 8k, quelle que soit la taille du
0066eddda7203f6345b56f77d146a759298dc635gryzor tron&ccedil;on lui-m&ecirc;me. Lorsqu'une requ&ecirc;te g&eacute;n&egrave;re de nombreux petits
0066eddda7203f6345b56f77d146a759298dc635gryzor tron&ccedil;ons, une grande quantit&eacute; de m&eacute;moire peut &ecirc;tre mobilis&eacute;e par le
0066eddda7203f6345b56f77d146a759298dc635gryzor traitement de la requ&ecirc;te, et une grande quantit&eacute; de donn&eacute;es
0066eddda7203f6345b56f77d146a759298dc635gryzor transmises sans n&eacute;cessit&eacute;. Pour y rem&eacute;dier, l'utilisation d'un
0066eddda7203f6345b56f77d146a759298dc635gryzor tampon rassemble la r&eacute;ponse en un nombre de tron&ccedil;ons le plus petit
0066eddda7203f6345b56f77d146a759298dc635gryzor possible.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Lorsque httpd est utilis&eacute; comme frontal d'un g&eacute;n&eacute;rateur de
0066eddda7203f6345b56f77d146a759298dc635gryzor contenu consommant beaucoup de ressources, la mise en tampon de la
0066eddda7203f6345b56f77d146a759298dc635gryzor r&eacute;ponse peut permettre &agrave; ce dernier d'effectuer le traitement et de
0066eddda7203f6345b56f77d146a759298dc635gryzor lib&eacute;rer les ressources plus ou moins rapidement, en fonction de la
0066eddda7203f6345b56f77d146a759298dc635gryzor mani&egrave;re dont il a &eacute;t&eacute; con&ccedil;u.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Le filtre de mise en tampon peut &ecirc;tre ajout&eacute; aux piles des
0066eddda7203f6345b56f77d146a759298dc635gryzor filtres en entr&eacute;e ou en sortie, selon les besoins, &agrave; l'aide des
0066eddda7203f6345b56f77d146a759298dc635gryzor directives <directive module="core">SetInputFilter</directive>,
0066eddda7203f6345b56f77d146a759298dc635gryzor <directive module="core">SetOutputFilter</directive>, <directive
0066eddda7203f6345b56f77d146a759298dc635gryzor module="mod_mime">AddOutputFilter</directive> ou <directive
1f8ff58254f12b4a0756dc2bd173fcd4a401d3e2lgentis module="mod_filter">AddOutputFilterByType</directive>.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor <example><title>Utilisation d'un tampon avec mod_include</title>
e2f05529a1835546e17527f56074c023e6a47366lgentis <highlight language="config">
e2f05529a1835546e17527f56074c023e6a47366lgentis AddOutputFilterByType INCLUDES;BUFFER text/html
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
0066eddda7203f6345b56f77d146a759298dc635gryzor </example>
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor <note type="warning">Les filtres de mise en tampon lisent la
0066eddda7203f6345b56f77d146a759298dc635gryzor requ&ecirc;te/r&eacute;ponse en RAM, puis la reconditionnent sous la forme d'un
0066eddda7203f6345b56f77d146a759298dc635gryzor nombre d'&eacute;l&eacute;ments m&eacute;moire le plus petit possible, au prix d'une
0066eddda7203f6345b56f77d146a759298dc635gryzor consommation de temps CPU. Lorsque la requ&ecirc;te/r&eacute;ponse est d&eacute;j&agrave;
0066eddda7203f6345b56f77d146a759298dc635gryzor conditionn&eacute;e de mani&egrave;re satisfaisante, sa mise en tampon pourrait
0066eddda7203f6345b56f77d146a759298dc635gryzor s'av&eacute;rer encore plus lente qu'en l'absence d'utilisation de tampon.
0066eddda7203f6345b56f77d146a759298dc635gryzor C'est pourquoi ces filtres doivent &ecirc;tre utilis&eacute;s avec pr&eacute;cautions,
0066eddda7203f6345b56f77d146a759298dc635gryzor et seulement si n&eacute;cessaire.</note>
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor</summary>
0066eddda7203f6345b56f77d146a759298dc635gryzor<seealso><a href="/filter.html">Les filtres</a></seealso>
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor<directivesynopsis>
0066eddda7203f6345b56f77d146a759298dc635gryzor<name>BufferSize</name>
0066eddda7203f6345b56f77d146a759298dc635gryzor<description>Taille maximale en octets du filtre par tampon</description>
0066eddda7203f6345b56f77d146a759298dc635gryzor<syntax>BufferSize entier</syntax>
0066eddda7203f6345b56f77d146a759298dc635gryzor<default>BufferSize 131072</default>
0066eddda7203f6345b56f77d146a759298dc635gryzor<contextlist><context>server config</context>
0066eddda7203f6345b56f77d146a759298dc635gryzor<context>virtual host</context>
0066eddda7203f6345b56f77d146a759298dc635gryzor<context>directory</context>
0066eddda7203f6345b56f77d146a759298dc635gryzor<context>.htaccess</context>
0066eddda7203f6345b56f77d146a759298dc635gryzor</contextlist>
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor<usage>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>La directive <directive
0066eddda7203f6345b56f77d146a759298dc635gryzor module="mod_buffer">BufferSize</directive> permet de sp&eacute;cifier la
0066eddda7203f6345b56f77d146a759298dc635gryzor quantit&eacute; de donn&eacute;es en octets qui sera mise en tampon avant d'&ecirc;tre
0066eddda7203f6345b56f77d146a759298dc635gryzor lue depuis ou &eacute;crite vers chaque requ&ecirc;te. La valeur par d&eacute;faut est
0066eddda7203f6345b56f77d146a759298dc635gryzor 128 ko.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor</usage>
0066eddda7203f6345b56f77d146a759298dc635gryzor</directivesynopsis>
0066eddda7203f6345b56f77d146a759298dc635gryzor
0066eddda7203f6345b56f77d146a759298dc635gryzor</modulesynopsis>