NAME
Apache::GzipChain - compress HTML (or anything) in the OutputChain
SYNOPSIS
In the configuration of your apache add something like
<Files *.html>
SetHandler perl-script
PerlHandler Apache::OutputChain Apache::GzipChain __your_handler__
PerlSetVar GzipForce on # optional
</Files>
DESCRIPTION
This module compresses any output from another perl handler if the browser requesting the document understands gzip encoding or if the config variable ForceGzip is set. To determine if the browser is able to understand us we check its Accept-Encoding header.
The module works without influencing the other handlers in the chain. The only thing that can be noticed by other handlers is that the response header 'Content-Encoding' has been set. If GzipChain decides not to do any compression, it just declines and doesn't even register itself for the output chain.
GzipChain compresses every single buffer content it receives via the output chain separately according to the GZIP specification (RFC 1952). The compression ratio therefore suffers if the other module sends its data in very small chunks. It is recommended that you use as few print statements as possible in conjunction with the GzipChain. One single print statement is recommended.
HEADERS
This handler sets the header Content-Encoding
to gzip
whenever it sends gzipped data.
It also sets or appends to the Vary
header the values Accept-Encoding
unless the config variable GzipForce is set, in which case the output is the same for all user agents.
Unicode
To use this module under perl-5.8 or higher with Unicode data you have to convert to octets before printing them. Something like this will do:
Encode::encode_utf8($res);
PREREQUISITES
Compress::Zlib, Apache::OutputChain
AUTHOR
Andreas Koenig, based on code by Jan Pazdziora
LICENSE
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.