NAME

CGI::Builder::LogDispatch - integrated logging system for CGI::Builder

VERSION 0.01

INSTALLATION

Prerequisites

    CGI::Builder    >= 1.12
    Log::Dispatch   >= 2.0

SYNOPSIS

    # just include it in your build
    use CGI::Builder
    qw| CGI::Builder::LogDispatch
      |;
    
    # Logger can write to different "Log Levels". The default level is 
    # "warning". Messages of lesser importance will not be written. When
    # developing, you probably want this cranked to "debug":
    sub OH_init {
        my ($webapp) = @_;
        # This MUST be done before calling $webapp->logger or it will have no effect!
        $webapp->logger_config('min_level' => 'debug');
    }
    
    # Then use it to write nicely formatted messages to your web server log
    sub PH_AUTOLOAD {
        my ($webapp) = @_;
        # The default min_level
        $webapp->logger->debug("This message only gets logged if you set min_level=>debug.");
        if ( $webapp->page_error ) {
            $webapp->logger->error("Oh no! There is a problem!");
        }
    }

DESCRIPTION

The module should do what you want with no prodding. Just include it and start using the logger property to log things. If you are using Apache::CGI::Builder and Apache::Log, it will automatically use Apache's native log mechanism. Otherwise it prints log messages to STDERR (which goes to the web server error log), prepending them with a timestamp.

If you want to do anything fancier than this you can override the logger_new method in your build to construct the object any way you like. See Log::Dispatch for details.

SUPPORT

Support is provided via the CGI::Builder Users mailing list. You can join the CBF mailing list at this url:

    http://lists.sourceforge.net/lists/listinfo/cgi-builder-users

ACKNOWLEDGMENTS

Many thanks to Domizio Demichelis, author of the CGI::Builder framework, and Dave Rolsky, author of Log::Dispatch.

AUTHORS

Vince Veselosky (http://control-escape.com)

COPYRIGHT

(c) 2005 by Vincent Veselosky

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