Le chat utilise les sessions pour fonctionner. Pour utiliser les sessions chez Free.fr il suffit de créer un répertoire “sessions” à la racine du site.
La commande ftp pour créer les répertoire est :
mkdir sessions
Attention : le FAI free.fr a désactivé la fonction php flock qui est utilisée par le chat. Le chat ne peut donc pas fonctionner sur cet hébergeur. Bien sur si un contributeur veut participer pour trouver une alternative, il est le benvenue.
(pour les utilisateur de Linux)
Pour ceux qui utilisent windows, jetez un oeil à ce lien ou ce lien.
Par défaut, les données du chat (les messages et les pseudonymes) sont stockées dans “phpfreechat/data/private/chat/” mais ce répertoire est paramétrable.
Linux permet , par le biais de tmpfs, de monter des disque dur sur de la mémoire vive. Les lecture/écriture sur un tel système de fichier seront accélérées de façon impressionnante mais vos données sont alors volatiles, c'est à dire qu'à chaque redémarrage de la machine elle disparaissent.
Sur ma machine personnelle (Linux debian, kernel-2.6.x), un système de fichier tmpfs est monté par défaut sur le répertoire ”/dev/shm”. Je vous suggère donc de paramétrer phpfreechat pour qu'il stock les données dans ce répertoire, par exemple :
$params["serverid"] = md5(__FILE__); $params["data_private_path"] = "/dev/shm/mychat"; $chat = new phpFreeChat($params); [...]
Pour avoir un ordre d'idée des performances, j'ai fait un petit test qui parle de lui même :
Sans tmpfs (HD) :
Avec tmpfs (RAM) :
(seulement pour la branche 0.x)
Par défaut, le paramètre “channel” est assigné automatiquement à partir du paramètre “title” (titre), mais il est tout à fait possible de le spécifier pour ainsi créer des salons complètement indépendants.
Exemple : pour gérer plusieurs salons indépendants en passant le nom du salon en paramètre de l'URL, il suffit de configurer son scripte comme ceci :
$params["serverid"] = md5(__FILE__); $params["channel"] = $_GET["channel"]; $chat = new phpFreeChat($params); [...]
En accédant le scripte avec une URL de cette forme “http://.../monchat.php?channel=monsalon”, un salon totalement indépendant des autres sera alors créé. Les données de ce salon seront alors stockées dans le répertoire “phpfreechat/data/private/chat/monsalon/”.
(seulement pour la branche 1.x)
Le rehash est necessaire lorsque vous changez une valeur d'un paramètre du chat. Si vous ne rehashez pas le chat, alors la vielles valeur de votre paramètre sera prise en compte car le chat utilise un cache.
Pour rehasher le chat, vous devez lancer la commande suivante:
/rehash
Par contre, il se peut que vous n'ayez pas le droit de la lancer si vous n'êtes pas administrateur. Pour vous donner les droits administrateurs, par défaut (si vous n'avez pas changé le mot de passe admin) voila les commandes à lancer:
/nick admin /identify
(par défaut l'utilisateur admin a un mot de passe vide, mais vous pouvez le changer)
(seulement pour la branche 1.x)
La liste des administrateurs (pseudonyme/mot de passe) est définie dans le paramètre “admins” (qui est un tableau).
Exemple : supposons que je veuille créer deux administrateurs nommés “bob” et “boby” avec les mots de passes respectifs “bob1” et “boby1”. Voila le paramètre que je dois ajouter :
$params['admins'] = array('bob' => 'bob1', 'boby' => 'boby1');
(Attention, n'oubliez pas de rehasher votre chat)