1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision : 1174747 -->
<!-- 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>
AddOutputFilterByType INCLUDES;BUFFER text/html<br />
</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>
|
