NAME

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

SYNOPSIS

#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";

DESCRIPTION

The new method should be called by a server startup script or module. It will create a new log file or open a pipe to a program if the first character of the filename is a |. The last argument to new is optional, it is simply a name that can be used to retrive the filehandle via the handle method. 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");

Filenames can be absolute or relative to ServerRoot.

AUTHOR

Doug MacEachern

SEE ALSO

Apache(3), mod_perl(3)