NAME

Apache::Clean - mod_perl interface into HTML::Clean

SYNOPSIS

httpd.conf:

PerlModule Apache::Clean

<Location /clean>
   PerlOutputFilterHandler Apache::Clean

   PerlSetVar  CleanLevel 3

   PerlSetVar  CleanOption shortertags
   PerlAddVar  CleanOption whitespace
</Location>  

DESCRIPTION

Apache::Clean uses HTML::Clean to tidy up large, messy HTML, saving bandwidth. It is particularly useful with Apache::Compress for ultimate savings.

Only documents with a content type of "text/html" are affected - all others are passed through unaltered.

Apache::Clean also tries to be intelligent about setting proper caching headers. For the moment, it only considers the modification time of itself in the header calculations. Future versions may consider things like httpd.conf and .htaccess files. Note that the core Apache content handler takes care of updating cache headers for static files - if you are using a dynamic content handler you need to do that one yourself.

OPTIONS

Apache::Clean supports few options - all of which are based on options from HTML::Clean. Apache::Clean will only tidy up whitespace (via $h->strip) and will not perform other options of HTML::Clean (such as browser compatibility). See the HTML::Clean manpage for details.

CleanLevel

sets the clean level, which is passed to the level() method in HTML::Clean.

PerlSetVar CleanLevel 9

CleanLevel defaults to 3.

CleanOption

specifies the set of options which are passed to the options() method in HTML::Clean.

PerlAddVar CleanOption shortertags
PerlSetVar CleanOption whitespace

CleanOption has do default.

NOTES

This is alpha software, and as such has not been tested on multiple platforms or environments.

FEATURES/BUGS

probably lots - this is the preliminary port to mod_perl 2.0

SEE ALSO

perl(1), mod_perl(3), Apache(3), HTML::Clean(3)

AUTHORS

Geoffrey Young <geoff@modperlcookbook.org>

COPYRIGHT

Copyright (c) 2002, Geoffrey Young All rights reserved.

This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.

HISTORY

This code is derived from the Cookbook::Clean and Cookbook::TestMe modules available as part of "The mod_perl Developer's Cookbook".

For more information, visit http://www.modperlcookbook.org/