Yoran Heling


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 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.


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( [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).

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.


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.