NAME
    Catalyst::Plugin::Log::Handler - Catalyst Plugin for Log::Handler

VERSION
    Version 0.05

SYNOPSIS
        use Catalyst qw(Log::Handler);

    Catalyst configuration (e. g. in YAML format):

        Log::Handler:
            filename: /var/log/myapp.log
            fileopen: 1
            mode: append
            newline: 1

    To log a message:

        $c->log->debug('Greetings from the people of earth');
        $c->log->info ('This is an info message.');
        $c->log->warn ('This is the last warning.');
        $c->log->error('This is an error message.');
        $c->log->fatal('This is a fatal message.');
        $c->handler->crit('This is a critical message.');

DESCRIPTION
    If your Catalyst project logs many messages, logging via standard error
    to Apache's error log is not very clean: The log messages are mixed with
    other web applications' noise; and especially if you use mod_fastcgi,
    every line will be prepended with a long prefix.

    An alternative is logging to a file. But then you have to make sure that
    multiple processes won't corrupt the log file. The module Log::Handler
    by Jonny Schulz does exactly this, because it supports message-wise
    flocking.

    This module is a wrapper for said Log::Handler.

METHODS
  debug, info, warn, error, fatal
    These methods map to the Log::Handler methods with the same name, except
    for fatal, which maps to emergency, and warn, which maps to warning.
    This is because Catalyst and Log::Handler don't use the same names for
    log levels.

    To log a message with a level that is no common Catalyst log level, you
    can use the handler method (see SYNOPSIS).

  is_debug, is_info, ...
    These methods map to the Log::Handler methods would_log_debug,
    would_log_info, ...

  handler
    Returns the Log::Handler object.

CONFIGURATION
    All configuration options are passed verbatim to Log::Handler::new. See
    Log::Handler for explanation of the options. I think that the example
    configuration at the beginning of this document is very well-suited for
    a Catalyst application. (Except for the file name, of course.)

    To be consistent with Catalyst::Log, the options minlevel and maxlevel
    default to 0 and 7, respectively, i. e. all messages are logged. The
    other defaults are not touched.

    If you use Catalyst::Plugin::ConfigLoader, please load this module after
    Catalyst::Plugin::ConfigLoader.

AUTHOR
    Christoph Bussenius <pepe(at)cpan.org>

COPYRIGHT
    Copyright (C) 2007 Christoph Bussenius.

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.