NAME PerlIO::via::ToFirePHP - log to FirePHP via an PerlIO layer VERSION version 1.100860 SYNOPSIS use PerlIO::via::ToFirePHP; my $fire_php = FirePHP::Dispatcher->new(HTTP::Headers->new); open my $fh, '>:via(ToFirePHP)', $fire_php; # Everything you print on the filehandle will be sent to FirePHP DESCRIPTION This PerlIO layer sends everything it receives to FirePHP. When constructing a filehandle using this layer using "open()", you need to pass an object of type FirePHP::Dispatcher that has been initialized with a HTTP::Headers object. A typical use of this PerlIO layer is to send DBI trace output to FirePHP: use PerlIO::via::ToFirePHP; my $dbh = DBI->connect(...); open my $fh, '>:via(ToFirePHP)', FirePHP::Dispatcher->new($http_headers_object); $dbh->trace(2, $fh); Now the trace output of all calls to that database handle will be sent to FirePHP. The PerlIO layer is implemented in "PerlIO::via::ToFirePHP" instead of just "PerlIO::via::FirePHP" because of a bug in "PerlIO::via" in perl 5.10.0 and earlier versions. If we used just "PerlIO::via::FirePHP", we would not be able to use the shorthand layer notation of "open my $fh, ':"via(FirePHP), $fire_php>. "PerlIO::via" would look for a "PUSHED" method in package "FirePHP". There is no such method, but because "FirePHP::Dispatcher" has been loaded, the namespace "FirePHP" has been autovivified. So "PerlIO::via" would stop looking. This bug seems to be fixed in perl 5.10.1. METHODS PUSHED Called by PerlIO::via - read its documentation for details. OPEN Called by PerlIO::via - read its documentation for details. WRITE Called by PerlIO::via - read its documentation for details. "WRITE()" accumulates input until a newline is seen, only then will it remove the newline and send the accumulated input to the FirePHP::Dispatcher object. The motivation for this was that DBI's "trace()" method reports trace output in chunks, not necessarily whole lines. CLOSED Called by PerlIO::via - read its documentation for details. SEE ALSO HTTP::Engine::FirePHP The "get_fire_php_fh()" method it places in HTTP::Engine::Response returns a filehandle constructed with PerlIO::via::ToFirePHP. PerlIO::via See this module for how to implement PerlIO layers in Perl. INSTALLATION See perlmodinstall for information and options on installing Perl modules. BUGS AND LIMITATIONS No bugs have been reported. Please report any bugs or feature requests through the web interface at . AVAILABILITY The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit to find a CPAN site near you, or see . The development version lives at . Instead of sending patches, please fork this project using the standard git and github infrastructure. AUTHOR Marcel Gruenauer COPYRIGHT AND LICENSE This software is copyright (c) 2009 by Marcel Gruenauer. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.