Installazione Php-Stats
Il primo passo per l'installazione dello script (dopo averlo scaricato e decompresso in una cartella opportuna) consiste nel modificare alcuni permessi.
- Dovete settare lettura, scrittura ed esecuzione per tutti (777) per la cartella option, qualora non abbiate la possibilità di modificare i permessi verranno automaticamente utilizzati dei files adatti al mancato supporto di scrittura tramite WEB.
La procedura è totalmente trasparente, quindi non dovrete fare nulla. Se, nel futuro, avrete la possibilità di modificare i permessi e quindi il supporto di scrittura da WEB, dovrete semplicemente copiare i files, presenti nella cartella files_Write, nella directory principale di Php-Stats e lanciare il file create-options. - Se volete utilizzare il Config Editor di Php-Stats dovrete dare i permessi di lettura e scrittura per tutti (666) al file config.php
Adesso, passiamo allo step successivo, dovete modificare i parametri di configurazione situati nel file config.php. Aprite questo file con un editor testuale (il blocco note per gli utenti Windows va benissimo).
Iniziamo a modificare le variabili essenziali (e fondamentali) per il corretto funzionamento dello script, come è riassunto nella seguente tabella:
Ci sono poi tutta una serie di variabili il cui settaggio è riservato a settaggi non essenziali per il funzionamento dello script, ma utili per chi desidera settaggi avanzati (utili ad esempio all'ottimizzazione delle prestazioni ecc).
| $option['prefix']='xxx'; | xxx rappresenta il prefisso con cui verranno create le tabelle di Php-Stats |
| $option['callviaimg']=X; | 1 (default dalla 0.1.8) richiama lo script attraverso una immagine trasparente di dimensione 1x1 pixel, 0 attraverso un Javascript. Il richiamo attraverso una immagine presenta alcuni vantaggi in termine di velocità (il JS potrebbe causare rallentamenti nelle pagine monitorate). Qualora inseriate la stringa satellite tra i tag <head></head> dovete settare questo parametro a 0. |
| $option['php_stats_safe']=X; | Impostare 0 se avete MySQL 3.23 o superiore oppure 1 per MySQL 3.22. Impostando il valore 1 viene inoltre saltato il check delle tabelle. |
| $option['out_compress']=X; | Impostare 1 se si intende abilitare la compressione dell'html generato dallo script (richiede Php>4.0.4), 0 altrimenti. |
| $option['persistent_conn']=X; | Impostare 1 per utilizzare una connessione persistente a MySQL, 0 altrimenti. E' consigliato il valore 0. |
| $option['autorefresh']=X; | X rappresenta il valore in minuti di refresh delle pagine di amministrazione. |
| $option['show_server_details']=X; | Impostare a 1 per visualizzare informazioni sul server nella pagina principale di amministrazione, 0 altrimenti. |
| $option['show_average_user']=X; | Impostare a 1 per visualizzare informazioni sull'utente medio nella pagina principale di amministrazione, 0 altrimenti. |
| $option['short_url']=X; | Impostare a 1 per usare url abbreviate quando possibile, 0 altrimenti. |
| $option['lock_not_valid_url']=X; | Impostare a 1 per bloccare tutti gli url non presenti nelle preferenze di php-stats, 0 altrimenti. |
| $option['full_recn']=X; | Se impostato a 1 php-stats riconoscerà ad ogni hit i motori di ricerca anzichè ad ogni accesso unico (modalità 0), ma lo script potrebbe risultare leggermente più lento. |
| $option['ext_whois']=""; | La stringa vuota ("") comporta l'uso del whois interno dello script. Se si vuole usare un whois esterno immettere l'url (http://www....). la variabile contenente l'IP dovrà essere scritta come %IP%. |
| $option['online_timeout']=X; | Impostare a 0 per utilizzare la determinazione automatica del tempo di permanenza per il calcolo degli utenti on-line oppure impostare il numero di minuti da considerare come time-out. Di default questo parametro è impostato a 5 minuti. |
| $option['page_title']=X; | Impostare a 1 per memorizzare il titolo delle pagine visualizzate, 0 altrimenti. |
| $option['refresh_page_title']=X; | Impostare a 0 per impedire il refresh continuio dei titoli delle pagine già memorizzate. Impostare a 1 per abilitare il refresh continuo dei titoli. |
| $option['log_host']=X; | Impostare a 1 per memorizzare l'host nei dettagli ATTENZIONE: ciò può rallentare il riconoscimento. Impostare a 0 per disabilitare tale opzione. |
| $option['clear_cache']=X; | Impostare a 1 per effettuare il riconoscimento continuo dei dati in cache ATTENZIONE: ciò può rallentare il riconoscimento. Impostare a 0 per disabilitare tale opzione. |
| $option['full_recn']=X; | Impostare a 1 per effettuare il riconoscimento continuo dei motori di ricerca e dei refers ad ogni pagina ATTENZIONE: ciò può rallentare il riconoscimento. Impostare a 0 per disabilitare tale opzione. |
| $option['logerrors']=X; | Impostare a 1 per loggare nel file php-stats.log gli errori generati dalla query effettuate da Php-Stats oppure 0 per non loggare questi errori. Di default il parametro è settato a 0. Da notare che se impostate il valore 1 il file php-stats.log deve avere i permessi in scrittura. |
| $option['check_new_version']=X; | Impostare a 1 per attivare la notifica automatica della disponibilità di una nuova versione di php-stats, 0 altrimenti. |
| $option['www_trunc']=X; | Impostare a 1 per considerare univoche gli url con suffisso http://www. in http:// evitando un doppio conteggio nel caso di domini che ammettono entrambe le estensioni, 0 altrimenti. |
| $option['accept_ssi']=X; | Impostare a 1 per accettare le chiamate tramite Server Side Include Impostare a 0 per disabilitare tale opzione. |
| $option['compatibility_mode']=X; | Impostare a 1 qualora abbiate problemi con la stringa di include in PHP. |
| $default_pages=array(....) | E' un array che contiene le pagine interpretate di default dal vostro server. In questo modo pagine come http/tuosito.it, http/tuosito.it/index.htm o http/tuosito.it/index.php saranno considerate come la stessa pagina (come in realtà avviene) |
Dopo aver modificato e salvato il file config.php, possiamo procedere all'upload dello script sullo spazio web che lo ospiterà. E'chiaro che per "pulizia" vi conviene creare una cartella (ad esempio stats ma qualunque nome va bene) destinata allo script.
Tenete presente che se non dovete effettuare l'update da versioni precedenti dello script, non è necessario l'upload della cartella update_files e del file update.php che possono essere quindi cancellati, inoltre, se non avete i permessi di scrittura tramite web potete eliminare anche la cartella files_Write.
Una volta effettuato l'upload, apriamo il nostro browser e digitiamo l'indirizzo:
http://www.tuosito.it/stats/setup.php (opportunamente modificato)
Al termine dell'operazione vi verrà chiesto di scegliere una password per accedere allo script e verrete rimandati alla pagina delle opzioni dello script. Le voci che raccomando di modificare sono il campo "mail" e il campo "url del sito" che sono fondamentali per il corretto funzionamento dello script. Tutte le altre opzioni andranno scelte con il buon senso, specialmente le opzioni attivabili e i pruning, ovvero le limitazioni allo spazio del database dedicato allo script.
I pruning sono "allettanti", ma raccomando fin da subito di attivare solo ciò che realmente serve per il vostro monitoraggio: tabelle di dimensioni enormi causeranno rallentamenti abissali dello script! Tenete presente che più opzioni e pruning si attivano, maggiori sono le richieste di dati verso il vostro database. Nel caso di dubbi o incertezze a riguardo, chiedete senza problemi sul forum.
Bene, lo script adesso è funzionante e possiamo procedere al monitoraggio delle pagine.
Terminata l'installazione è necessario rimuovere la cartella setup_files e il file setup.php che non sono più necessari (e occupano anche spazio inutile).