Guide d'installation de Phenix
Principes de base
Pour créer ou mettre à jour les tables nécessaires au bon fonctionnement de
Phenix, vous devez utiliser le script install.php du répertoire
"install".
Il est important que l'utilisateur MySQL avec lequel
vous faites votre installation ait les droits classiques
(SELECT/INSERT/UPDATE/DELETE) mais également les droits pour créer ou modifier
une table (CREATE et ALTER) sans quoi la création ou la mise à jour ne pourra
pas se faire.
De plus vous devez définir des droits en écriture sur le sous-répertoire inc/
afin que le script d'installation puisse modifier votre fichier de configuration.
Si vous n'avez pas accès à ces options, téléchargez le
fichier suivant
qui contient tous les scripts SQL pour procéder à l'installation ou la mise à jour de Phenix
de façon manuelle. Tous les détails sont expliqués dans
ce topic.
Installer Phenix pour la première fois
"Dézippez" l'archive phenix.zip, téléchargée sur le site, dans le répertoire
racine de votre serveur HTTP. Cela a pour effet de créer un nouveau répertoire phenix
contenant les fichiers nécessaires au bon fonctionnement de Phenix.
Lancez le script d'installation, en appelant depuis votre navigateur
http://adresse_serveur_web/phenix/install/install.php
Sélectionnez alors "Installer Phenix pour la première fois" dans le menu déroulant puis
dans la page suivante indiquez les informations nécessaires à la connexion à votre base
de données.
Pour le reste laissez vous guidez, les options du fichier de configuration sont expliquées
plus bas...
Mettre à jour une version antérieure de Phenix
Si votre répertoire actuel de Phenix se nomme "phenix", renommez-le pour sauvegarder
temporairement vos fichiers (exemple appelez le phenix_avant_MAJ).
Effectuez une sauvegarde de votre base de données soit avec un script tel que
phpMyAdmin ou bien à partir
du script d'installation comme détaillé dans le chapitre suivant.
"Dézippez" l'archive phenix.zip, téléchargée sur le site dans le répertoire
racine de votre serveur HTTP. Cela a pour effet de créer un nouveau répertoire phenix
contenant les fichiers de la nouvelle version.
Copiez le fichier phenix_avant_MAJ/inc/conf.inc.php dans le répertoire
phenix/inc afin de ne pas avoir à ressaisir vos identifiants de connexions et
également pour conserver vos options d'environnement de Phenix (durée de sessions,
cookies...).
Copiez également le fichier phenix_avant_MAJ/inc/couleur.inc.php dans
le répertoire phenix/inc pour conserver vos couleurs associées aux notes, si vous
les avez personnalisées.
Si vous avez sauvegardé votre base de données, vous êtes maintenant prêt à lancer le script
d'installation, en appelant depuis votre navigateur
http://adresse_serveur_web/phenix/install/install.php
Sélectionnez alors "Mettre à jour votre version de Phenix" dans le menu déroulant puis
dans la page suivante indiquez la version de Phenix que vous utilisiez jusqu'à présent.
Pour le reste laissez vous guidez, les options du fichier de configuration sont expliquées
plus bas...
Une fois l'installation terminée et après s'être assuré que la nouvelle version fonctionne
bien, vous pouvez supprimer le répertoire phenix_avant_MAJ.
Sauvegarde de la base de données
Pour sauvegarder vos données avec le script d'installation, sélectionnez "Sauvegarder
la base de données" dans la liste déroulante. Les informations de connexions sont normalement
récupérées à partir de votre fichier de configuration, il ne vous reste alors plus qu'à
choisir les tables concernées, les options d'export (généralement celles par défaut
conviennent très bien) et à cliquer sur le bouton Sauver pour créer votre fichier
de sauvegarde.
Options du fichier de configuration
Le fichier inc/conf.inc.php est généré par le script d'installation.
Il contient différents paramètres nécessaires pour assurer le bon fonctionnement de
l'agenda :
$cfgHote = Adresse du serveur MySQL
$cfgUser = Nom de l'utilisateur
$cfgPass = Mot de passe
$cfgBase = Nom de la base sous MySQL
$PREFIX_TABLE permet de définir un prefixe au nom des tables.
Ainsi si vous ne disposez que d'une seule base de données, regroupant les tables de plusieurs
applications, cela permet de personnaliser le nom des tables que Phenix utilise.
Si votre site est hébergé sur Free, vous devrez renseigner ces mêmes
paramètres dans le fichier agenda_import.php3 car le script ne le fait pas
automatiquement.
$AUTORISE_SUPPR permet d'autoriser ou non la
suppression des notes affectées (true ou false) par les utilisateurs.
$DUREE_SESSION permet de définir la durée avant
l'expiration d'une session. Cette durée s'exprime en seconde (défaut 300).
$COOKIE_AUTH permet d'autoriser ou non l'identification
automatique via un cookie (true ou false).
$COOKIE_NOM permet de définir le nom du cookie permettant
de conserver les identifiants des utilisateurs. Utilisée seulement si $COOKIE_AUTH=true.
$COOKIE_DUREE permet de définir la durée en nombre de jours
pendant laquelle les identifiants sont conservés. Utilisée seulement si $COOKIE_AUTH=true.
$PUBLIC permet de définir si des nouveaux utilisateurs peuvent
se créer librement un compte (true ou false).
$RELOAD_PLANNING permet de définir la durée avant laquelle
les plannings se rechargent automatiquement. Cette durée s'exprime en seconde (O [zéro] permet
de désactiver cette option).
$AUTO_UPPERCASE permet de définir si le nom des utilisateurs est
automatiquement converti en majuscule ou non (true ou false).
$MODIF_PARTAGE permet d'autoriser ou non la gestion des contacts partagés
(modification et suppression) par d'autres utilisateurs (true ou false).
$AUTORISE_HTML permet d'autoriser ou non l'utilisation de balises HTML
dans les champs de saisies pour mettre en forme du texte (faille de
sécurité potentielle si TRUE) (true ou false).
$CHECK_VERSION permet d'autoriser ou non Phenix à se connecter sur le site
principal pour vérifier si une nouvelle version est disponible (Aucune
information vous concernant n'est transmise, seul un petit fichier de 3 octets est
téléchargé à partir du site phenix.gapi.fr) (true ou false).
Ne paramétrez les options suivantes que si
vous constatez que les alertes par mail ne fonctionnent pas
$SMTP_SERVER nom du serveur SMTP auquel Phenix doit se connecter (exemple smtp.wanadoo.fr).
$SMTP_PORT port de connexion au serveur SMTP (25 dans la grande majorité des cas).
$SMTP_LOGIN si votre serveur SMTP requiert une authentification, précisez ici votre identifiant.
$SMTP_PASSWORD si votre serveur SMTP requiert une authentification, précisez ici votre mot de passe.
Remarques
Cette application utilise les sessions de php4 (si disponible), si vous êtes chez Free
ou chez Online.net (Proxad), pensez à créer un répertoire "sessions" à la
racine de votre site.
Phenix a été développé et testé avec Internet Explorer version 6.0 et ultérieure,
Mozilla Firebird 1.0 et Opéra 7.54. J'ai fait tout mon possible pour le rendre compatible avec
d'autres navigateurs (JavaScript et feuille de style) mais sans en avoir la certitude, si
vous rencontrez quelques incompatibilités, merci de m'en tenir informé. J'essaierais dans
la mesure du possible de les corriger.
PS : si vous intégrez Phenix sur votre site, envoyez moi un petit mail pour mon livre d'or, merci.