Apache::LogRegex - Parse a line from an Apache logfile into a hash

This document refers to version 1.5 of Apache::LogRegex, released November 20th 2008

Designed as a simple class to parse Apache log files. It will construct a regex that will parse the given log file format and can then parse lines from the log file line by line returning a hash of each line.

The field names of the hash are derived from the log file format. Thus if the format is '%a %t \"%r\" %s %b %T \"%{Referer}i\" ...' then the keys of the hash will be %a, %t, %r, %s, %b, %T and %{Referer}i.

Should these key names be unusable, as I guess they probably are, then subclass and provide an override rename_this_name() method that can rename the keys before they are added in the array of field names.

INSTALLATION

% perl Makefile.PL
% make
% make test
% sudo make install

TEST FAILURES

The tests are there to make sure that I have broken nothing when I fiddle with the code and will teach you very little about how to use the code.

TO DO

Pretty much finished, unless there are some 'must have' features

BUGS

None so far

REQUIREMENTS

• Developed under 5.6.1 but should work on anything 5+.
• Written completely in Perl. XS is not required.

AUTHOR

Peter Hickman <peterhi@ntlworld.com>

Copyright (c) 2004-2006, Peter Hickman. All rights reserved.

This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.

CHANGES IN THIS RELEASE

V1.0:

• First release to CPAN

V1.1

• Bug fix, can now handle \" as part of the %r element. Thanks to James March and mauke (from #perlhelp) for locating the bug and supplying the fix.

V1.2

• Bug fix. Because we allow \" in the %r element then we

  really should be allowing it in any of the Referer elements. Thanks to Damir Tresnjo for pointing this out.

V1.3

• Bug fix. Should allow for \" in the User-Agent. Thanks

  to Graeme J Sweeney for spotting this.

V1.4

• Bug fix. Changed the regex so that it could parse DOS line endings when running on a Unix based system. Thanks to Christian Glahn for reporting this one and supplying the patch to fix it.