This article describes how to give public access to the AWstats web stastistical reporting tool that is available through cPanel.
To do this, perform the following steps:
Step 1: Create a new file with your favorite HTML editor called statistics.php.
Step 2: Cut and paste the following contents into your newly created statistics.php file.
<?php
/*
dv at josheli.com
Proxy for viewing Awstats outside of cpanel. I assume no liability.
1 out of 3 people ask me if it's "safe" to have their username and password
in this file. Here's my answer:
When you signed up with your web hosting provider, they probably provided
you with an email with your login/password, right? Do you ever use FTP
with your site? Do you login to your mail server, to hotmail, to yahoo, to
anywhere else? When you log in to cpanel or WHM, do you do it through SSL
or not? Have you installed any other web software like osCommerce or phpBB
or any other script?
In all cases, your user/password is either sent through dozens of
computers in plain text and is sitting in someone else's harddrive or
database, or is stored in plain text on some file on your webserver. You
are never safe.
So, if someone wants to steal ANY user/password, it's pretty easy. In
fact, probably half a dozen people could look at any password of yours
right now. But to answer what i think you're specifically asking about about
this script, no, not just anyone can find out the user/pass.
And besides that, there are other precautions you could take. Ask around.
*/
$user = 'username';//your cpanel username
$pass = 'password';//your cpanel password
$domain = 'mydomain.com';//do not include 'http://' or 'www.'
/*
If you don't know what you're doing, set $dynamic_images equal
to TRUE, and don't worry about the $image_directory variable.
Otherwise,
- Normally, this script will load images by proxy, i.e. awstats.php
is called for each <img> tag and will send the correct
image to the browser. This is not the way the web is designed
to work. So, if you wish to improve performance and lower
bandwidth, you can:
1. Set $dynamic_images to FALSE
2. Create an image directory in your webroot
3. Copy all of awstats image sub-directories to this new directory
4. Point the $image_directory variable to your new directory
You will get all the benefits of cached, static images.
In order to get the Awstats images and their directories, you will
probably need to download an awstats distribution from
awstats.sourceforge.net. The final layout will probably look like this:
awstats_imagedir/
browser/
clock/
cpu/
flags/
mime/
os/
other/
Under each of those sub-directories will be dozens of .png files.
*/
$dynamic_images = false;
$image_directory = './awstats_images/';
//lame attempt to combat referrer spam
$spam_words = array('mortgage', 'ebay', 'paypal', '.ro');
/***********
NO NEED TO TOUCH ANYTHING BELOW HERE
************/
//retrieves the file, either .pl or .png
function get_file($fileQuery)
{
global $user, $pass, $domain;
return file_get_contents("http://$user:$pass@$domain:2082/".$fileQuery);
}
$requesting_image = (strpos($_SERVER['QUERY_STRING'],'.png')===false)?false:true;
if($dynamic_images && $requesting_image) //it's a .png file...
{
if(!is_dir($image_directory))
{
exit;
}
$fileQuery = $_SERVER['QUERY_STRING'];
}
elseif(empty($_SERVER['QUERY_STRING']))//probably first time to access page...
{
$fileQuery = "awstats.pl?config=$domain";
}
else //otherwise, all other accesses
{
$fileQuery = 'awstats.pl?'.$_SERVER['QUERY_STRING'];
}
$file = get_file($fileQuery);
//check again to see if it was a .png file
//if it's not, replace the links
if(!$requesting_image)
{
$file = str_replace('awstats.pl', basename($_SERVER['PHP_SELF']), $file);
if($dynamic_images)
{
$imgsrc_search = '="/images';
$imgsrc_replace = '="'.basename($_SERVER['PHP_SELF']).'?images';
}
else
{
$imgsrc_search = 'src="/images/awstats/';
$imgsrc_replace = 'src="'.$image_directory;
}
$file = str_replace($imgsrc_search, $imgsrc_replace, $file);
$file = str_replace($spam_words, 'SPAM', $file);
}
else //if it is a png, output appropriate header
{
header("Content-type: image/png");
}
//output the file
echo $file;
?>
Step 3: Replace the values for username, password, and domain:
$user = 'username';//your cpanel username
$pass = 'password';//your cpanel password
$domain = 'mydomain.com';//do not include 'http://' or 'www.'
Step 4: Save the file and upload to your website via VTP.
Step 5: Run statistics.php by going to http://www.yourdomain.com/statistics.php!
Now your users can see your web statistics!
