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)