NAME

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

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.

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

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 1.

CleanOption

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

  PerlAddVar CleanOption shortertags
  PerlSetVar CleanOption whitespace

CleanOption has no 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

in particular, this module does not handle conditional GET requests properly.

SEE ALSO

perl(1), mod_perl(3), Apache(3), HTML::Clean(3), http://perl.apache.org/docs/2.0/user/handlers/filters.html

AUTHOR

Geoffrey Young <geoff@modperlcookbook.org>

COPYRIGHT

Copyright (c) 2003, 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/