Plack::Middleware::LogErrors(3pm)

Usage

Using a logger you have already configured (using Log::Dispatch as an example):

    use Log::Dispatch;
    my $logger = Log::Dispatch->new;
    $logger->add( Log::Dispatch::File->new(...) );
    builder {
        enable 'LogDispatch', logger => $logger;
        enable 'LogErrors';
        $app;
    }

Using an explicitly defined logger:

    builder {
        enable 'LogErrors', logger => sub {
            my $args = shift;
            $logger->log(%$args);
        };
        $app;
    }

Version

version 0.003

Overview

"psgi.errors" defaults to "STDERR" in most backends, which results in content going somewhere unhelpful like the server console.

This middleware simply remaps the "psgi.errors" stream to the "psgix.logger" stream, or an explicit logger that you provide.

This is especially handy when used in combination with other middlewares such as Plack::Middleware::LogWarn (which diverts Perl warnings to "psgi.errors"); Plack::Middleware::HTTPExceptions (which diverts uncaught exceptions to "psgi.errors"); and Plack::Middleware::AccessLog, which defaults to "psgi.errors" when not passed a logger -- which is also automatically applied via plackup (so if you provided no "--access-log" option indicating a filename, "psgi.errors" is used).

Configuration

"logger"

A code reference for logging messages, that conforms to the psgix.logger specification. If not provided, "psgix.logger" is used, or the application will generate an error at runtime if there is no such logger configured.

Support

Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=Plack-Middleware-LogErrors> (or [email protected] <mailto:[email protected]>).

There is also a mailing list available for users of this distribution, at <https://groups.google.com/forum/#!forum/psgi-plack>.

There is also an irc channel available for users of this distribution, at "#plack" on "irc.perl.org" <irc://irc.perl.org/#plack>.

I am also usually active on irc, as 'ether' at "irc.perl.org".

Copyright and licence

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

Releases

5 releases since Debian 9 (Stretch); the text changed 1 time.

9
10–13