NAME

Prancer::Plugin::Log4perl

SYNOPSIS

This plugin connects your Prancer application to Log::Log4perl and exports a keyword to access the configured logger. You don't need this module to log things but it certainly makes it easier.

There is very minimal configuration required to get started with this module. To enable the logger you only need to do this:

use Prancer::Plugin::Log4perl qw(logger);

Prancer::Plugin::Log4perl->load();

logger->info("hello, logger here");
logger->fatal("something done broke");

By default, this plugin will initialize Log::Log4perl with a very basic configuration to avoid warnings when used. You can override the configuration by loading your own before calling load on this plugin. This plugin's load implementation simply calls Log::Log4perl->initialized() to see if it should load its own. For example, you might do this:

use Prancer::Plugin::Log4perl qw(logger);

Log::Log4perl::init('/etc/log4perl.conf');
Prancer::Plugin::Log4perl->load();

The logger keyword gets you direct access to an instance of the logger and you can always call static methods on Log::Log4perl and interact with the logger that way, too.

COPYRIGHT

Copyright 2014 Paul Lockaby. All rights reserved.

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

SEE ALSO

Prancer =item Log::Log4perl =item Log::Dispatch =item Log::Dispatch::Screen