Webalizer::Hist - Perl module to parse the webalizer.hist-file.
This document describes version 0.03 of Webalizer::Hist, released 2010-12-14.
use Webalizer::Hist; if(my $wh = Webalizer::Hist->new(source => "webalizer.hist")) { while(my $hashref = $dwh->month()) { printf "Got %d hits in month %s\n", $hashref->{totalhits}, $hashref->{month}; } if(my $totals = $dwh->totals()) { printf "This website used a total of %d kB\n", $totals->{kbytes}; } }
Webalizer - a popular web server log analysis program - uses a so-called webalizer.hist file to store (temporary) statistics. That file usually contains one year of monthly statistics about a website/webserver.
webalizer.hist
Webalizer::Hist can be used read and parse those data.
The following methods can be used:
Creates a new Webalizer::Hist object using the configuration passed to it in key/value-pairs. new returns zero or undef on error.
new
The following options can be passed to new:
This option is required, specifies the source of the webalizer.hist-data to be parsed. Can either be a scalar containing a filename or a scalarref to the actual data.
Optional, specifies the order in which the month method should return the data. Set to undef or zero to sort on the date in ascending order, (newest month last) or set to a positive value to sort in descending order, (newest month first) which is the default.
month
Returns a hashref containing the data for the month specified by the optional argument month (a number between 1 and 12), or the next month in de list. (The order is specified by the desc-option to new).
desc
The hashref contains the following keys:
month year firstday lastday totalhits totalfiles totalsites totalkbytes totalpages totalvisits avghits avgfiles avgsites avgkbytes avgpages avgvisits
Most keys are self-explainable, month and year specifies the month and the year of the data returned, and firstday and lastday specify the beginning and ending of the month (in days). The total* keys give the total of the month, and the avg* keys the daily average.
year
firstday
lastday
total*
avg*
Returns a hashref containing the sum of the statistics for all months found in the webalizer file. The hashref contains the following keys:
hits files sites kbytes pages visits
Website of The Webalizer: http://www.mrunix.net/webalizer/.
No known bugs, but that doesn't mean there aren't any. If you find a bug please report it at http://rt.cpan.org/Public/Dist/Display.html?Name=Webalizer::Hist or contact the author.
Y. Heling, <yorhel@cpan.org>, (http://yorhel.nl/)
Copyright (C) 2006-2010 by Y. Heling
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Webalizer::Hist, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Webalizer::Hist
CPAN shell
perl -MCPAN -e shell install Webalizer::Hist
For more information on module installation, please visit the detailed CPAN module installation guide.