----------------------------- CLOGS - Version 0.1 ----------------------------- ----------------------------- Installation et configuration ----------------------------- 1. Installation --------------- Clogs est composé de deux éléments complémentaires: une fonction d'enregistrement des logs, et une application en ligne d'exploration des logs. 1.a Installation de la partie exploration des logs -------------------------------------------------- - Récupérer sur le site du projet (http://jmtrivial.info/programmation/libre/clogs/) l'archive du projet. - Décompresser l'archive. - Placer l'archive sur le site qui sera loggué, à la racine du site (le répertoire de Clogs s'appelera par exemple clogs/) 1.b Installation de la partie sauvegarde des logs ------------------------------------------------- - Ajout de la fonction de log Afin que chacune des visites sur le site soit enregistrée par Clogs, il est nécessaire d'ajouter à chacune des pages PHP de votre site un appel à la fonction suivante: function logs_visite($rel) { global $_SERVER; $ip = getenv("REMOTE_ADDR"); $host = getenv("REQUEST_URI"); $referer = getenv("HTTP_REFERER"); $user_agent = getenv("HTTP_USER_AGENT"); $datepassage = Date("H:i:s"); $auth_user = $_SERVER["PHP_AUTH_USER"]; $fichier = $rel."/clogs/logs/log" . Date("dmY"); $fichier .= ".txt"; $fp = fopen($fichier,"a+"); $chaine = $ip."\t".$host."\t".$referer."\t".$datepassage."\t".$auth_user."\t".$user_agent."\n"; fputs($fp, $chaine); fclose($fp); } en lui passant en paramètre le chemin relatif pour atteindre la racine du site (par exemple logs_visite("../"); si l'appel de la fonction est placé dans un script situé dans le répertoire foo/ à la racine du site). - Adaptation de la fonction à la configuration Suivant le nom du répertoire où vous avez installé Clogs, vous devrez modifier légèrement le corps de la fonction ci-dessus en remplaçant "/clogs/" par le nom du répertoire où l'installation à été effectuée. 2. Configuration de l'outil d'exploration ----------------------------------------- L'ensemble des paramètres de configuration modifiables se trouvent dans le fichier config.inc.php - $URL_SITE : url du site, qui sert à reconstruire les liens de parcourt du site. Attention: Cette chaine de caractères ne contient pas de "/" final. - $BACK_TO_WEBSITE : chemin qui permet depuis l'outil d'exploration de revenir au site. Le plus souvent: "../" - $LANG : langage de l'interface. deux possibilités pour l'instant: "en" et "fr" - $TRACEROUTE_URL : adresse qui sera utilisée pour la fonction de traceroute. La chaine doit contenir "%s", qui sera remplacé par l'IP recherchée - $SEARCH_URL : adresse qui sera utilisée pour la recherche. La chaine doit contenir "%s", qui sera remplacé par le ou les mots à rechercher - $SEARCH_URLNAME : nom associé au moteur de recherche proposé par l'interface - $LARGEUR_TABLE_PAGE : nombre de caractères affichés des liens dans la colonne page du tableau principal - $LARGEUR_TABLE_REFERER : nombre de caractères affichés des liens dans la colonne referer du tableau principal - $LARGEUR_TABLE_USERCONTENT : nombre de caractères affichés des liens dans la colonne useragent du tableau principal 2. Sécurisation de l'accès à l'explorateur ------------------------------------------ Par défaut, Clogs ne propose aucun outil d'authentification, et l'outil d'exploration est donc en accès libre à tout internaute. Cependant, il est possible d'utiliser les htaccess de apache pour en restreindre l'accès (voir par exemple http://www.commentcamarche.net/apache/apacht.php3 pour plus d'informations).