NAME

Plack::Middleware::FirePHP - Middleware for FirePHP::Dispatcher

SYNOPSIS

    # app.psgi
    use Plack::Builder;
 
    my $app = sub {
        my $env      = shift;
        my $fire_php = $env->{'plack.fire_php'};

        $fire_php->log('Hello from FirePHP');
        $fire_php->start_group('Levels:');
        $fire_php->info('Log informational message');
        $fire_php->warn('Log warning message');
        $fire_php->error('Log error message');
        $fire_php->end_group;

        $fire_php->start_group('Propably emtpy:');
        $fire_php->dismiss_group;

        return [ 200, [ 'Content-Type' => 'text/plain' ], [ 'Hello Foo' ] ];
    };
 
    builder {
        enable 'FirePHP';
        $app;
    };
 

DESCRIPTION

This is a Plack middleware component which enables FirePHP in your app using FirePHP::Dispatcher. Currently only the basic interface of supported. See The FirePHP::Dispatcher documentation for a list of supported methods.

Please do not call finalize on the FirePHP object yourself. The middleware takes care of that for you.

To enable the middleware, just use Plack::Builder in your .psgi file:

    use Plack::Builder;

    my $app = sub { ... };

    builder {
        enable 'FirePHP';
        $app;
    };

If you want to disable the FirePHP message (eg. for production usage) just set disabled to 1. In this case the middleware will use Class::Null instead of FirePHP::Dispatcher, which will silently dispatch all your calls:

    use Plack::Builder;

    my $app = sub { ... };

    builder {
        enable 'FirePHP', disabled => 1;
        $app;
    };
 

BUGS

All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to cpan-RT.

SEE ALSO

http://www.firephp.org, FirePHP::Dispatcher, Class::Null

AUTHOR

Florian Helmberger <fh@25th-floor.com>

Tatsuhiko Miyagawa

COPYRIGHT AND LICENSE

Copyright 2009 25th-floor - de Pretis & Helmberger KG

http://www.25th-floor.com

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