blob: 44b5efda36f60c324ae8ec2e0d4741ba7f443808 [file] [log] [blame]
<?xml version="1.0"?>
<!DOCTYPE xml:manual [ <!ENTITY nbsp "&#160;"> ]>
<?xml-stylesheet type="text/xsl" href="../style/manual.xsl"?>
<modulesynopsis>
<name>mod_deflate</name>
<description>Compress content before
it is delivered to the client</description>
<status>experimental</status>
<sourcefile>mod_deflate.c</sourcefile>
<identifier>deflate_module</identifier>
<summary>
<p>The experimental <module>mod_deflate</module> module provides
the <code>DEFLATE</code> output filter that allows output from
your server to be compressed before being sent to the client over
the network.</p>
</summary>
<seealso><directive module="mod_mime">AddOutputFilter</directive></seealso>
<seealso><directive module="core">SetOutputFilter</directive></seealso>
<section><title>Enabling Compression</title>
<p>Compression is implemented by the <code>DEFLATE</code>
<a href="../filter.html">filter</a>. The following directive
will enable compression for documents in the container where it
is placed:</p>
<p><strong>Most popular browsers can not handle compression of all content
so you may want to enable the 'gzip-only-text/html' note (see below)
</strong></p>
<example>SetEnv gzip-only-text/html 1<br />
SetOutputFilter DEFLATE
</example>
<p>Here is an example of enabling compression for the Apache
documentation:</p>
<example>
&lt;Directory "/your-server-root/manual"&gt;<br />
SetEnv gzip-only-text/html 1<br />
SetOutputFilter DEFLATE<br />
&lt;/Directory&gt;
</example>
</section>
<directivesynopsis>
<name>DeflateFilterNote</name>
<description>Places the compression ratio in a note for logging</description>
<syntax>DeflateFilterNote <em>notename</em></syntax>
<contextlist><context>server config</context></contextlist>
<usage>
<p>The <directive>DeflateFilterNote</directive> directive
specifies that a note about compression ratios should be attached
to the request. The name of the note is the value specified for
the directive.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>DeflateWindowSize</name>
<description>Zlib compression window size</description>
<syntax>DeflateWindowSize <em>value</em></syntax>
<contextlist><context>server config</context></contextlist>
<usage>
<!-- XXX: Ummm... What unit??? -->
<p>The <directive>DeflateWindowSize</directive> directive specifies the
zlib compression window size.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>DeflateMemLevel</name>
<description>Amount of memory available to zlib for compression</description>
<syntax>DeflateMemLevel <em>value</em></syntax>
<contextlist><context>server config</context></contextlist>
<usage>
<!-- XXX: Ummm... What unit??? -->
<p>The <directive>DeflateMemLevel</directive> directive specifies
the amount of memory available to zlib for compression.</p>
</usage>
</directivesynopsis>
</modulesynopsis>