NAME

Apache::LogFile - Interface to Apache's logging routines

SYNOPSIS

#in httpd.conf
PerlModule Apache::LogFile
PerlLogFile |perl/mylogger.pl My::Logger

#in a Perl script
print My::Logger "a message to the Log"

DESCRIPTION

The PerlLogFile directive can be used to hook a Perl filehandle to a piped logger or to a file open for appending. If the first character of the filename is a |, the file handle is opened as a pipe to the given program. The file or program can be relative to the ServerRoot.

The method interface was written before mod_perl directive handlers were introduced, but it still works so the documentation remains below:

The new method should be called by a server startup script or module.

The last argument to new is optional, it is simply a name that can be used to retrive the filehandle via the handle method.

#in a startup file
use Apache::LogFile ();
Apache::LogFile->new("|perl/mylogger.pl", "MyLogger");

#in a request-time file 
use Apache::LogFile ();
my $fh = Apache::LogFile->handle("MyLogger");
print $fh "a message to the log";

If this argument is not present, the filename will be used the handle key, which can also be retrived via the handle method. The new method will return a reference to the filehandle if you wish to store it elsewhere, e.g.:

$MyLog::Pipe = Apache::LogFile->new("|perl/mylogger.pl");

$MyLog::Append = Apache::LogFile->new("logs/my_log");

AUTHOR

Doug MacEachern

SEE ALSO

Apache(3), mod_perl(3)