Kävijälaskuri PHP:llä

Kävijälaskurin uusin versio on versio 2006-08-30. Oman PHP-kävijälaskurisi version näet "kavijat"-kansion "versiot.txt"-tiedostosta. Huom! Versiot.txt-tiedosto on lisätty vasta kävijälaskurin versioon 2004-05-15.

Mitä sovellus tekee?

Tässä esitetty kävijälaskuri tekee seuraavaa:

• Laskee sivujen lataukset
• Laskee kävijät yhteensä
• Laskee kävijät päivää kohden
• Laskee kävijät viikkoa kohden
• Laskee kävijät kuukautta kohden
• Laskee kävijät viikonpäiviä kohden
• Laskee kävijät tunteja kohden
• Kirjaa ylös kellonajan milloin kävijä tuli sivuille
• Kirjaa ylös kävijän IP-osoitteen
• Kirjaa ylös URL-osoitteen, josta kävijä tuli sivuille (referer)
• Kirjaa ylös sivun, jonka kävijä latasi ensin
• Kirjaa ylös kävijän internet-selaimen ja käyttöjärjestelmän tiedot
• Tietoja kävijöistä on helppo katsoa "Kävijätietojen hallinta" -sivulta käyttäen nettiselainta
• Piirtää graafisen kuvaajan halutun aikavälin kävijämääristä (esim. viimeisten 31 päivän kävijämääristä)

Miten sovelluksen saa toimimaan?

Kopioi ensin kavijat.zip-tiedosto (koko noin 31 kt) ja pura se siten, että zip-tiedostossa olevat tiedostot ja kansiot ovat kansiossa nimeltä kavijat. Laita sitten kavijat-kansio kotisivusi juureen (eli esim. minun tapauksessani osoitteeseen http://www.mvnet.fi/kavijat). Kavijat-kansion sisällä pitäisi sitten olla kansiot: admin, graafit, ipEsto, kuukaudet, paivat, tunnit, viikonpaivat ja viikot sekä 6 tiedostoa. Alla olevassa taulukossa on selitetty, mitä zip-tiedostossa olevat tiedostot ja kansiot ovat. Minkään tiedoston sisältöä ei pidä muuttaa ellei alla ole toisin mainittu.

Joidenkin tiedostojen ja kansioiden käyttöoikeuksia pitää muuttaa (kts. ohjeet käyttöoikeuksien muuttamiseen), jotta PHP-koodi pystyisi niihin kirjoittamaan. Se, mihin muotoon tiedoston tai kansion käyttöoikeus pitää muuttaa, on kerrottu taulukon Chmod-kohdassa. Viiva tarkoittaa, ettei tiedoston/kansion käyttöoikeuksia pidä muuttaa.

Jotta kävijälaskuri toimisi, täytyy jokaisen HTML-dokumentin alkuun (.php-päätteinen) laittaa alla esitetty koodipätkä.

Jokaisen dokumentin alkuun

<?php /* ============================================================ Kävijälaskurin "Jokaisen dokumentin alkuun" -koodi Koodia muutettu viimeksi 30.08.2006 ============================================================*/ /* Laita kotisivunOsoite-muuttujan arvoksi kotisivujesi juuren osoite. Esim. jos kotisivusi ovat MBnetissä, laita muuttujan arvoksi "koti.mbnet.fi/tunnuksesi". MVnetin tapauksessa muuttujan arvo olisi "www.mvnet.fi". Älä laita kauttaviivaa osoitteen loppuun. */ $kotisivunOsoite = "www.kotisivusi_osoite.fi"; $kotisivunJuuri = $kotisivunOsoite."/"; /* Tallennetaan muuttujaan haettu sivun osoite (eli se mitä kirjoitettiin selaimen osoiteriville). */ $haettuURL = $_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI']; /* Muutetaan kaikki kaksoiskauttaviivat yksinkertaisiksi. WWW-palvelimet kun voivat hyväksyä osoitteen tyyliä: "http://koti.mbnet.fi/mvnet/kansio//sivu.php". Kaksoiskauttaviivat on korvattava, jotta alla oleva suhteellisen osoitteen määritys toimisi oikein. */ while (eregi("//", $haettuURL)) { $haettuURL = str_replace("//", "/", $haettuURL); } /* Määritellään suhteellinen osoite kavijat-kansioon laskemalla, montako kauttaviivaa on haetun sivun osoitteessa suhteessa kotisivun juureen. Tämän avulla voidaan määrittää suhteellinen osoite kavijat-kansioon, koska kavijat-kansio on sijoitettava kotisivun juureen. */ $osoiteSuhteessaJuureen = str_replace($kotisivunJuuri, "", $haettuURL); $kauttaviivat = substr_count($osoiteSuhteessaJuureen, "/"); $suhteellinenOsoite = str_repeat("../", $kauttaviivat); $kavijatURL = $suhteellinenOsoite."kavijat/"; /* Sisällytetään sivuun varsinainen kävijälaskuri. */ include($kavijatURL."laskuri.php"); ?>

Tältä näyttää kävijälaskurin ylläpidon hallintasivujen etusivu

Muuta yllä olevasta koodista kotisivunOsoite-muuttujan arvo vastaamaan oman kotisivusi juuren URL-osoitetta. Esim. jos kotisivusi ovat MBnetissä, laita muuttujan arvoksi "koti.mbnet.fi/tunnuksesi". MVnetin tapauksessa muuttujan arvo olisi "www.mvnet.fi". Älä laita kauttaviivaa osoitteen loppuun eikä http:tä osoitteen eteen.

Muuta myös tiedostosta peruskoodi.php seuraavat kursivoidut kohdat:

$kayttaja = "kayttajatunnuksesi";
$salasana = "salasanasi";

Eli laita kursivoitujen tekstien paikalle haluamasi käyttäjätunnus ja salasana. Näiden avulla pystyt katsomaan tietoja kävijöistä, tyhjentämään tiedot kävijöistä ja katsomaan tilastotietoja kävijöistä suoraan nettiselaimellasi. Käyttäjätunnuksen ja salasanan avulla varmistetaan se, ettei kukaan muu kuin sinä pysty lukemaan tietoja kävijöistä, tyhjentämään kavijatiedot.php -tiedostoa tai katsomaan tilastotietoja kävijöistä.

Kävijätietojen tarkastelu

Tiedot kävijöistä esitetään selkeästi taulukoituna kuvan kaltaisesti.

Kun joku nyt tulee sivuillesi, lisätään yksi kävijä lisää laskureihin ja kävijästä merkitään tiedot ylös kavijatiedot.php -tiedostoon jne. Voit lukea kavijatiedot.php-tiedoston tietoja menemällä selaimellasi admin-kansioon ja avaamalla sieltä sivu index.php ("Kävijätietojen hallinta" -sivu). Kirjoita sitten käyttäjätunnuksesi ja salasanasi vaadittuihin kenttiin, valitse toiminnoksi "Katso kävijätiedot" (oletusarvona) ja paina "Lähetä lomake". Tiedot kävijöistä on tallennettu selkeästi taulukko-muotoon. Taulukon ensimmäinen sarake kertoo kävijästä päivämäärän ja ajan, jolloin kävijä tuli sivulle. Toinen sarake kertoo kävijän ip-osoitteet. Kolmas sarake taasen kertoo www-osoitteen, josta kävijä tuli sivuille (referer). Jos kävijä ei tullut linkin kautta sivullesi, lukee osoitteen paikalla suora. Neljännessä sarakkeessa on sivu, jonka kävijä latasi ensin ja viimeisessä sarakkeessa ovat kävijän internet-selaimen ja käyttöjärjestelmän tiedot.

Jos taas haluat tyhjentää kavijatiedot.php -tiedoston manuaalisesti (se onkin hyvä silloin tällöin tyhjentää manuaalisesti, koska tietoja kävijöistä kasautuu melkoinen määrä ennen kun tiedosto tyhjenee automaattisesti) avaa "Kävijätietojen hallinta" -sivu ja toimi samoin kuten kävijätietoja katsoessasi, mutta valitse toiminnoksi "Tyhjennä kävijätiedot". Paina "Lähetä lomake" jolloin tiedot, jotka ovat kavijatiedot.php -tiedostossa tyhjentyvät.

Tilastotietojen tarkastelu

Tässä esimerkki MVnetin kävijämääristä tuotetuista tilastotiedoista

Jos haluat katsoa tilastotietoja kävijöistä, avaa taas "Kävijätietojen hallinta" -sivu ja valitse toiminnoksi "Katso tilastotiedot kävijöistä". Laita taas käyttäjätunnuksesi ja salasanasi niille vaadittuihin kenttiin ja paina "Lähetä lomake". Tilastotiedoissa on seuraavia tietoja kävijöistä taulukoituina: kävijät yhteensä, lataukset yhteensä, sivujen lataukset kävijää kohden, kävijät tänään ja eilen, kävijät tällä ja viime viikolla, kävijät tässä ja viime kuussa, kävijät tänä ja viime vuonna, tämän ja viime vuoden päivittäiset, viikoittaiset ja kuukausittaiset keskiarvot, kävijät viikonpäiviä kohden sekä kävijät kellonaikoja kohden.

Jos taas haluat katsoa tietyn vuoden kävijämäärät vuoden kaikkia päiviä, viikkoja tai kuukausia kohden, valitse "Kävijätietojen hallinta" -sivulta toiminnoksi "Katso kävijät/päivä vuodelta:" tai "Katso kävijät/viikko vuodelta:" tai "Katso kävijät/kuukausi vuodelta:", riippuen siitä mitä haluat katsoa. Laita sitten haluamasi toiminnon perään sen vuoden numero, josta haluat tietoja katsella (muotoa 2003 tai 2004 jne.). Katso, että käyttäjätunnuksesi ja salasanasi ovat oikein ja paina lopuksi "Lähetä" ja nyt näet tiedot kävijämääristä valitsemanasi vuonna.

Kävijämäärä näkyviin sivuille

Jos haluat sivullesi kävijämäärän tai sivunlataukset näkyviin, laita sivullesi haluamaasi kohtaan alla olevat koodipätkät (alla esitetyt koodipätkät toimivat vain sivulla, jossa on "Jokaisen dokumentin alkuun"-koodipätkä):

Kävijämäärä:

<?php include($kavijatURL."kavijat.txt"); ?>

Lataukset:

<?php include($kavijatURL."lataukset.txt"); ?>

Huom! Suosittelen ehdottomasti käyttämään kavijat-kansiossa htaccess-salausta, jolloin kukaan ei varmasti pääse urkkimaan luvatta tietoja kävijöistäsi. Htacces-salaus ei vaikuta PHP-koodin toimivuuteen. Kaikkia txt-päätteisiä tiedostoja voi kuka tahansa lukea, jos htaccess-salausta ei käytetä. Näitä ei voi suojata php:llä. Se miten htaccessia tarkalleen käytetään, riippuu kotisivutilan tarjoajasta. Yleensä näillä palvelimilla on tähän salaukseen selkeät ohjeet. Ilman htaccess-salaustakin kävijälaskuri toimii kyllä luotettavasti.

Graafinen kuvaaja kävijöistä

Tilastotiedot.php-sivun lopussa ovat kävijämääristä piirretyt graafiset kuvaajat. Tilastotiedot.php-sivulla on PHP-skripti, joka piirtää graafisen kuvaajan kävijämääristä aina, kun sivu luetaan selaimella. Kuvaajia on oletuksena kaksi kappaletta: kuvaaja viimeisten 31 päivän kävijämääristä ja kuvaaja sivuston kävijämääristä koko ajalta. Kuvaajan kävijämääristä voi piirtää mistä tahansa ajanjaksolta, esim. viime vuodelta. Kuvaajalta hahmottaa hyvin kävijämäärän kehityksen halutulta ajanjaksolta.

Tällaisen kuvaajan PHP-skripti piirsi MVnetin kävijämääristä

Jos haluat lisätä uuden kuvaajan, täytyy muokata hieman tilastotiedot.php-sivun PHP-koodia. Etsi sivulta kohta, jossa lukee /* KUVAAJIEN PIIRTO */. Tämän kommentin alla on funktiokutsuja, jotka kutsuvat piirraKuvaaja-funktiota tietyillä parametreilla, joka taasen suorittaa kuvaajan piirtämisen. Jos siis haluat tehdä uuden kuvaajan, lisäät vain uuden funktiokutsun. Funktiokutsu on aina seuraavanlainen:

piirraKuvaaja ($aloitusPaivamaara, $lopetusPaivamaara, 
	$kavijaTiedotKansio, $kuvanOsoite, $kuvanKokoX, $kuvanKokoY);

Funktion ensimmäinen parametri on siis se päivämäärä, josta kuvaajan piirto halutaan aloittaa ja toinen parametri taasen se päivämäärä, johon kuvaajan piirto halutaan lopettaa. Päivämäärät pitää antaa UNIX-timestamp -muodossa, jollaisen tuottaa esim. date- ja mktime-funktiot. Kolmas parametri kertoo kävijämääriä sisältävien tekstitiedostojen kansion osoitteen, jota ei tarvitse muuttaa. Neljäs parametri kertoo kuvatiedoston osoitteen, johon kuvaaja tallennetaan. Tämä pitää olla eri osoite jokaisella kuvaajalla. Lisäksi kyseinen kuvatiedosto pitää olla olemassa ja se pitää olla chmodattu muotoon 766. Viimeiset kaksi parametria kertovat kuvaajan kuvatiedoston koon pikseleinä. Uuden funktiokutsun lisäksi pitää tietysti lisätä kuva sivulle HTML-kielellä (img-tägi, jonka osoitteena äsken mainittu kuvatiedoston osoite), jotta kuvan saisi näkyviin.

Kuvaaja, joka piirtää graafin sivuston kävijämääristä koko ajalta, alkaa oletuksena päivämäärästä 01.01.2004. Tämä päivämäärä kannattaa muuttaa siihen päivämäärään, josta lähtien sinulla on kävijämäärät tallennettuina. Jos haluat, että kuvaajan piirto aloitetaan esimerkiksi päivämäärästä 15.05.2005, muuta kuvaajan funktiokutsu muotoon:

piirraKuvaaja(mktime(0, 0, 0, 05, 15, 2005), ...

Jos haluat muuttaa kuvaajan värejä, onnistuu se etsimällä tilastotiedot.php-sivulta kohta, jossa lukee /* Määritellään kuvaajan taustan, viivojen ja tekstien värit (RGB-muodossa). */. Tämän kommentin alla on määritelty mm. taustaväri ja graafin viivan värit RGB-muodossa. Kuvankäsittelyohjelmista näet yleensä valitsemasi värin RGB-lukemat.

Seuraava sivu (Palautelomake PHP:llä) >> << Edellinen sivu (Keskustelupalsta PHP:llä)