granicus.if.org Git - apache/blob - docs/manual/mod/mod_buffer.html.en

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>mod_buffer - Apache HTTP Server</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  12 <script src="../style/scripts/prettify.js" type="text/javascript">
  13 </script>
  14
  15 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  16 <body>
  17 <div id="page-header">
  18 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
  19 <p class="apache">Apache HTTP Server Version 2.5</p>
  20 <img alt="" src="../images/feather.gif" /></div>
  21 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  22 <div id="path">
  23 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
  24 <div id="page-content">
  25 <div id="preamble"><h1>Apache Module mod_buffer</h1>
  26 <div class="toplang">
  27 <p><span>Available Languages: </span><a href="../en/mod/mod_buffer.html" title="English">&nbsp;en&nbsp;</a> |
  28 <a href="../fr/mod/mod_buffer.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a></p>
  29 </div>
  30 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Support for request buffering</td></tr>
  31 <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  32 <tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>buffer_module</td></tr>
  33 <tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_buffer.c</td></tr>
  34 <tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.3 and later</td></tr></table>
  35 <h3>Summary</h3>
  36
  37     <p>This module provides the ability to buffer the input and output
  38     filter stacks.</p>
  39
  40     <p>Under certain circumstances, content generators might create
  41     content in small chunks. In order to promote memory reuse, in
  42     memory chunks are always 8k in size, regardless of the size of the
  43     chunk itself. When many small chunks are generated by a request,
  44     this can create a large memory footprint while the request is
  45     being processed, and an unnecessarily large amount of data on the
  46     wire. The addition of a buffer collapses the response into the
  47     fewest chunks possible.</p>
  48
  49     <p>When httpd is used in front of an expensive content generator,
  50     buffering the response may allow the backend to complete
  51     processing and release resources sooner, depending on how the
  52     backend is designed.</p>
  53
  54     <p>The buffer filter may be added to either the input or the
  55     output filter stacks, as appropriate, using the
  56     <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code>,
  57     <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code>,
  58     <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code> or
  59     <code class="directive"><a href="../mod/mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></code> directives.</p>
  60
  61       <div class="example"><h3>Using buffer with mod_include</h3><pre class="prettyprint lang-config">
  62         AddOutputFilterByType INCLUDES;BUFFER text/html
  63         </pre>
  64 </div>
  65
  66     <div class="warning">The buffer filters read the request/response into
  67         RAM and then repack the request/response into the fewest memory
  68         buckets possible, at the cost of CPU time. When the request/response
  69         is already efficiently packed, buffering the request/response could
  70         cause the request/response to be slower than not using a buffer at
  71         all. These filters should be used with care, and only where
  72         necessary.</div>
  73
  74 </div>
  75 <div id="quickview"><h3 class="directives">Directives</h3>
  76 <ul id="toc">
  77 <li><img alt="" src="../images/down.gif" /> <a href="#buffersize">BufferSize</a></li>
  78 </ul>
  79 <h3>See also</h3>
  80 <ul class="seealso">
  81 <li><a href="../filter.html">Filters</a></li>
  82 </ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
  83
  84 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  85 <div class="directive-section"><h2><a name="BufferSize" id="BufferSize">BufferSize</a> <a name="buffersize" id="buffersize">Directive</a></h2>
  86 <table class="directive">
  87 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Maximum size in bytes to buffer by the buffer filter</td></tr>
  88 <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>BufferSize integer</code></td></tr>
  89 <tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>BufferSize 131072</code></td></tr>
  90 <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
  91 <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
  92 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_buffer</td></tr>
  93 </table>
  94     <p>The <code class="directive"><a href="#buffersize">BufferSize</a></code>
  95     directive specifies the amount of data in bytes that will be
  96     buffered before being read from or written to each request.
  97     The default is 128 kilobytes.</p>
  98
  99 </div>
 100 </div>
 101 <div class="bottomlang">
 102 <p><span>Available Languages: </span><a href="../en/mod/mod_buffer.html" title="English">&nbsp;en&nbsp;</a> |
 103 <a href="../fr/mod/mod_buffer.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a></p>
 104 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>This section is experimental!</strong><br />Comments placed here should not be expected
 105 to last beyond the testing phase of this system, nor do we in any way guarantee that we'll read them.</div>
 106 <script type="text/javascript"><!--//--><![CDATA[//><!--
 107 var lang = 'en';
 108 var disqus_shortname = 'httpd';
 109 var disqus_identifier = window.location.href.replace(/(current|trunk)/, "2.4").replace(/\/[a-z]{2}\//, "/").replace(window.location.protocol, "http:") + '.' + lang;
 110 if (disqus_identifier.indexOf("httpd.apache.org") == -1) {
 111     document.write('<div id="disqus_thread">\n</div>');
 112     (function() {
 113                 var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
 114                 dsq.src = window.location.protocol + '//' + disqus_shortname + '.disqus.com/embed.js';
 115             (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
 116         })();
 117 } else {
 118     document.write("Comments have been disabled for offline viewing.");
 119 }
 120 //--><!]]></script></div><div id="footer">
 121 <p class="apache">Copyright 2012 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 122 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 123 if (typeof(prettyPrint) !== undefined) {
 124     prettyPrint();
 125 }
 126 //--><!]]></script>
 127 </body></html>