Apache::GzipChain - compress HTML (or anything) in the OutputChain
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>
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.
This handler sets the header Content-Encoding to gzip whenever it sends gzipped data.
Content-Encoding
gzip
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.
Vary
Accept-Encoding
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);
Compress::Zlib, Apache::OutputChain
Andreas Koenig, based on code by Jan Pazdziora
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Apache::GzipChain, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Apache::GzipChain
CPAN shell
perl -MCPAN -e shell install Apache::GzipChain
For more information on module installation, please visit the detailed CPAN module installation guide.