Installation pas-à-pas du framework Copix, pour les vrais débutants

Installation pas-à-pas du framework Copix, pour les vrais débutants 1) Objet de ce didacticiel Calogero GIGANTE ( www.gigante.be ) 4 avril 2008. Document version 005. Ce didacticiel explique dans les détails l installation du framework PHP Copix sur un serveur local de type AMP (Apache-MySQL-PHP), en prévision d un futur déploiement sur un hébergement de type 60gp chez www.ovh.com. Requis pour ce didacticiel: - des connaissances de base sur le fonctionnement de PHP - avoir installé un serveur AMP localement sur votre PC (notre exemple utilisera Wampserver http://www.wampserver.com/ ). 2) Télécharger le zip de Copix Pour ça, rendez-vous sur le site de Copix ( www.copix.org ), dans la page des téléchargements. Au moment où ce didacticiel a été écrit, la dernière version était la 3.0.2. Prenez le zip version «light». Une fois que vous avez votre précieux zip, où va-t-on mettre son contenu? 3) Structure de votre serveur AMP : Si vous avez configuré votre système AMP comme moi, vous devriez avoir sur votre disque dur un dossier C:\wamp\www\ où vous mettez vos divers projets. 1 / 12

Le fichier index.php est le fichier qui présente la principale page d accueil de vos projets de votre serveur local. Vous y accédez en tapant http://localhost/ dans la barre d adresse de votre navigateur favori, si wampserver fonctionne correctement. 4) Mise en place des fichiers de Copix : Comme vous le voyez sur l image du paragraphe précédent, j ai déjà créé un répertoire nommé «projet_copix_01» dans lequel je vais maintenant aller dézipper le contenu de ce que nous avons téléchargé sur le site de Copix. (Vous pouvez utiliser l excellent logiciel 7-Zip pour ça, il est gratuit et performant.) Ce qui nous amène à avoir enfin le contenu suivant dans la racine de notre premier petit projet avec Copix : Vous avez certainement constaté que le répertoire www du zip contient le fameux fichier principal index.php qui sera l unique porte d entrée de votre futur site. 2 / 12

Maintenant, avant de se lancer dans la procédure d installation proprement dite, il faut ré-organiser ces dossiers dans le but d avoir une structure similaire à celle qui sera mise en production sur le serveur mutualisé de l hébergeur OVH. On pourrait laisser les choses ainsi pour continuer notre découverte de Copix, mais je trouve que ré-organiser les dossiers (comme nous allons le faire maintenant) nous rendra la vie plus simple quand il s agira de basculer le site enfin terminé sur le serveur de l hébergeur. A la racine du dossier C:\wamp\www\projet_copix_01\ créez un dossier nommé copix, dans lequel vous glissez les dossiers project, temp, utils, var et aussi dans la foulée les fichiers «install» et «licence». Vous arrivez à ceci : Maintenant, il faut modifier quelques lignes du fichier index.php contenu dans le répertoire www, car les chemins vers le framework sont donc différents depuis l ajout du répertoire copix. (Utilisez un éditeur qui supporte l utf-8 pour faire ces modifications, comme http://www.pspad.com/fr/ par exemple.) Ligne 14 : require ($path.'/../utils/copix/copix.inc.php'); devient : require ($path.'/../copix/utils/copix/copix.inc.php'); Ligne 15 : require ($path.'/../project/project.inc.php'); devient : require ($path.'/../copix/project/project.inc.php'); Ligne 18 : $coord = new ProjectController ($path.'/../project/config/copix.conf.php'); devient : $coord = new ProjectController ($path.'/../copix/project/config/copix.conf.php'); Il est possible également que le mode «prepend» des URL (voir la doc officielle de Copix si vous ne savez pas encore de quoi il s agit) ne fonctionne pas sur les hébergements de OVH. 3 / 12

Dans ce cas, il faut aller trouver le fichier./copix/projet/config/copix.conf.php et changer la ligne suivante ainsi : Ligne 16 : $config->significant_url_mode = 'prepend'; devient : $config->significant_url_mode = 'default'; Cette dernière manipulation sur les URL n est pas obligatoire si vous envisagez juste de tester Copix sur votre serveur local sans basculement ultérieur chez OVH. 5) Création de la base de données (BDD) pour Copix : Avant de passer à la procédure d installation proprement dite sur votre serveur local, il vous faut disposer d une BDD MySQL qui sera utilisée par le framework. Pour ma part, dans la série des dossiers qui représentent les différents projets PHP du serveur local, j aime bien donner aux BDD de chaque projet le même nom que le dossier général contenant les fichiers de l application. Donc, dans notre cas, je vais créer une BDD avec PhpMyAdmin que je nommerais projet_copix_01, mais vous êtes libre bien sûr de nommer cette BDD comme bon vous semble. Allons donc sur http://localhost/phpmyadmin et créons-la : 4 / 12

Etant donné que tous les scripts de Copix sont encodés en Utf-8, il est conseillé de mettre la collation utf8_general_ci à votre nouvelle BDD. Chez OVH, si vous vous rendez dans le PhpMyAdmin de votre hébergement 60gp http://60gp.ovh.net/phpmyadmin/, vous pouvez faire une petite requête SQL qui vous donnera des informations sur la collation de la BDD qui vous a été fournie. Essayez celles-ci : SHOW VARIABLES LIKE 'character_set%'; SHOW VARIABLES LIKE 'collation%'; La BDD que vous avez reçu avec votre hébergement 60gp sera probablement en latin1, mais cela ne devrait pas poser de problème si c est votre application (via Copix) qui va gérer les échanges avec votre BDD. Il est fortement conseillé de travailler avec l extension php_pdo_mysql de votre interpréteur PHP. Si vous faites un petit phpinfo() chez OVH, vous devriez constater qu il est activé (ouf!). Par contre, en local, sur votre serveur, il n est probablement pas actif par défaut. Pour l activer, cliquez sur l icône de Wampserver, puis PHP Settings > PHP Extensions > et cliquez sur php_pdo_mysql s il n y a pas une petite flèche devant. Restartez tous les services (Apache, MySQL, etc ) si cela ne se fait pas automatiquement. Remarque : jusqu à ce jour, votre hébergement 60gp n est pas en PHP5 par défaut. Il faut changer cela en allant mettre à la racine de votre hébergement un petit fichier texte nommé.htaccess contenant la simple instruction suivante : SetEnv PHP_VER 5 6) L installation peut enfin commencer Voilà, à ce stade-ci, nous sommes enfin parés pour l installation proprement dite. Pour ce faire, dirigeons-nous avec notre navigateur à l adresse où se trouve le fichier index.php du framework en passant par l interpréteur PHP : 5 / 12

http://localhost/projet_copix_01/www/ Directement, vous devriez constater que votre URL se transforme en : http://localhost/projet_copix_01/www/index.php?module=default&action=welcome et votre navigateur affiche la page suivante : OK. Nous sommes en très bonne voie! Tout se passe bien car ce que nous voyons là, c est la page d affichage du module «default» : et, comme son nom l indique, il s affiche par défaut quand vous appelez le fichier index.php du framework quand vous n avez encore rien fait comme programmation. Nous verrons dans quelques instants où se trouve cette indication d afficher le module par défaut. Maintenant, allons paramétrer la base de données (que nous avons créé précédemment) pour être utilisée par le Framework : cliquez sur la phrase «Configurer une base de données» sous le titre Bien commencer. Vous arrivez alors à un petit formulaire dans lequel vous allez pouvoir spécifier vos paramètres de connection : 6 / 12

Le champ Nom : il va contenir l identifiant de la connection qui vous servira dans vos scripts. Vous pouvez mettre ici autre chose que le vrai nom de la BDD utilisée. La liste déroulante Driver : si l extension est installée, il vaut mieux sélectionner l option «pdo_mysql». Le champ Chaine de connexion : Vous devez spécifier ici le vrai nom de la BDD et le nom du serveur SQL utilisé. Si vous êtes en local avec wampserver, vous pouvez mettre : dbname=projet_copix_01;host=localhost Remarque : host=localhost n est pas à écrire obligatoirement, car ce sera mis par défaut si rien n est spécifié pour host. Pour un serveur distant en hébergement (ex : serveur.sql.distant), on aura : dbname=projet_copix_01;host=serveur.sql.distant Les champs Utilisateur et Mot de passe : Ce sont les identifiants pour vous connecter à la BDD. En local, si vous n avez rien changé aux paramètres par défaut lors de l installation du système AMP de wampserver, tapez «root» pour l utilisateur et rien pour le mot de passe. (Notez qu il est fortement déconseillé de laisser votre wampserver ainsi!) Nous n allons pas faire compliqué : nous allons continuer notre explication en mettant donc les paramètres suivants : Nom : bddconn Driver : pdo_mysql Chaine de connexion : dbname=projet_copix_01 Utilisateur : root Mot de passe : 7 / 12

Remplissez les champs et cliquez ensuite sur le bouton «Tester» pour voir si tout va bien. Un petit V devrait apparaître à droite de la ligne d encodage. Cliquez alors sur le bouton «Enregistrer» qui est apparu à côté du bouton «Tester». Vous devriez obtenir les messages suivants : Quand vous cliquez alors sur «Retour», vous voyez apparaître un message qui vous signale que le compte administrateur a été créé. Notez sur un bout de papier le mot de passe qui a été généré aléatoirement par Copix durant l installation, dans ce cas-ci : 19055. Nous allons bien sûr nous rendre maintenant dans l interface d administration, en utilisant l identifiant admin fraîchement créé, et en cliquant sur l image de la petite clé. Nous arrivons à ce bel écran : 8 / 12

C est gai d avoir les pleins pouvoirs. Nous pouvons faire déjà beaucoup de choses à partir de cet écran. D abord, on va changer nos identifiants reçus par défaut dans le paragraphe précédent. Pour ça, on clique sur «Administration des utilisateurs» et on arrive ici : 9 / 12

Cliquez sur l icône du petit crayon (modifier), et nous pourrons ainsi changer les données du premier compte créé, c-à-d le vôtre : Vous pouvez même changer l identifiant de connexion, si vous trouvez que «admin» fait trop sérieux pour votre caractère de joyeux luron. Et bien sûr, changez votre mot de passe puisque celui généré aléatoirement vous sera probablement plus fastidieux à retenir. Remplacez aussi l e-mail bidon et validez le tout. Retournons maintenant au panneau général de l administration, et cliquons sur le menu «Définir la page d accueil». Nous arrivons à ceci : Comme annoncé précédemment, voici donc l endroit où vous pouvez indiquer à votre application par quel module et quel action elle doit démarrer (quand un internaute appelle le fichier index.php du répertoire www ). Une première boucle est bouclée! Maintenant, si on allait jeter un œil à ce qu est devenue la base de données? 10 / 12

Retournons sur http://localhost/phpmyadmin/ et allons voir l allure actuelle de la BDD projet_copix_01 : Nous voyons que 13 tables ont été créées. Certaines d entre elles ont déjà des informations, comme copixconfig par exemple Prenez un peu de temps pour voir ce qu elles contiennent déjà et vous comprendrez vite beaucoup de choses. Une dernière petite astuce : quand vous allez sur la page http://localhost/ page d index générale de votre serveur local, si vous cliquez sur le répertoire projet_copix_01, vous voyez ceci : 11 / 12

Vous n arrivez donc pas directement sur le fichier index.php du dossier www de copix. Ce n est pas très ennuyant, mais quand même. Alors une petite astuce sympa consiste à mettre le fichier index.html suivant à la racine du répertoire de votre projet, ce qui fera une redirection immédiate vers l entrée de service de votre application Copix. <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/tr/xhtml1/dtd/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <meta http-equiv="refresh" content="0; url=./www/" /> <title>redirection</title> </head> <body> </body> </html> Ce fichier de redirection ne sera pas utile lors du déploiement chez OVH, car l hébergement 60gp possède initalement une redirection vers le folder www déjà présent chez l hébergeur. Voilà pourquoi nous avions ré-arrangé les folders de Copix au début de ce didacticiel, pour répondre aux caractéristiques de l hébergeur en question. Et voilà la fin. Maintenant, avec le cas précis qui vous a été exposé, vous devriez être capable d installer le framework Copix dans n importe quel cas de figure. Merci de votre lecture, et bon développement avec Copix. 7) Remerciements : Calogero GIGANTE www.gigante.be Merci à Steevan du forum Copix http://forum.copix.org/ dont l aide précieuse m a permis de réaliser le petit didacticiel que vous venez de lire. REMARQUE : ce document est librement téléchargeable et vous pouvez le mettre sur n importe quel site web, pour peu que vous ne touchiez pas à son intégrité. Aucune responsabilité ne peut m être imputée pour l usage qui en sera fait. 12 / 12