| <?xml version="1.0"?> |
| <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> |
| <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> |
| <!-- English Revision : 1334011 --> |
| <!-- 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>server config</context> |
| <context>virtual host</context> |
| <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> |
