Dploiement dune instance de dmo sous windows Dploiement dune instance de production Gestion des services PHP Contact
Introduction Ce document dcrit la marche suivre pour installer correctement un environnement de dveloppement permeant de travailler sur la plateforme E-MEMORAe 2.0. lissue de cee installation vous aurez votre disposition un environnement vous permeant deectuer toutes les modications que vous souhaitez sur la plateforme et de dployer une version binaire testables sur votre serveur local. Nous aborderons galement les notions permeant de mere en uvre un dploiement de la plateforme depuis votre machine de test vers un serveur de production. Aention : aucun des chiers mis votre disposition en parallle de ce document nest utilisable tel quel en production. Pour ce faire vous serez oblig de repasser par une phase de compilation de la plateforme. 1
tienne Deparis Heudiasyc ICI
Guide pratique du dveloppeur pour E-MEMORAe 2.0
Prrequis Tout au long de ce document nous partons du principe que les logiciels suivants sont dj installs et fonctionnels sur votre machine. Si ce nest pas le cas, nous vous invitons les installer et vous reporter leur documentation respective.
Adobe Flash Builder Un serveur web local (nous vous conseillons EasyPHP ou Wamp) Un diteur de texte simple mais vous permeant de faire du rechercher / remplacer ecacement (Geany, Notepad++, Notepad 2, etc.)
Installation de la plateforme E-MEMORAe 2.0
Linstallation des chiers se passe en plusieurs grandes tapes. Les deux premires se passent du ct de votre serveur local, tandis que les deux suivantes concernent plus spciquement Flash Builder. Aention : ne PAS ouvrir Flash Builder avant que la phase de reconguration dcrite ci-dessous ne soit termine.
3.1 Cration de la base de donnes
Vous pouvez lancer votre logiciel de gestion de serveur web local et vous rendre dans linterface dadministration de votre base de donnes (que ce soit en console, dans phpmyadmin ou mysql-workbench). Crez une nouvelle base de donnes vide, ayant pour interclassement UTF-8 et importez le chier memflex_empty.sql
au sein de cee nouvelle base de donnes.
3.2 Installation sur le serveur local
1. Dzippez le contenu de larchive www.zip et copiez son contenu la racine web de votre serveur local (assez frquemment il sagit dun dossier www plac la racine de votre package serveur web). 2. Ouvrez le chier memflex/amf_config.ini et modiez la ligne webroot par le chemin complet vers la racine web de votre serveur local. 3. Ouvrez le chier memflex/services/class/bdd.class.inc.php et modiez les lignes 9, 10 et 11 pour reter les paramtres de connexion votre base de donne : ligne 9 hte et nom de la base tel que dni ltape prcdente (cf. section 3.1, Cration de la
base de donnes , p. 2) ; ligne 10 identiant de connexion la base ; ligne 11 mot de passe de connexion la base).
tienne Deparis Heudiasyc ICI
Guide pratique du dveloppeur pour E-MEMORAe 2.0
3.3 Installation dans le workspace Flash Builder
1. Dzippez le contenu de larchive flash_builder.zip et copiez son contenu lintrieur du workspace de Flash Builder. 2. Ouvrez le chier flash_builder/eMemorae/.flexProperties et modiez laribut serverRoot pour le faire pointer sur la racine web de votre serveur local. 3. Ouvrez le chier flash_builder/eMemorae/.actionScriptProperties et modiez laribut outputFolderLocation de la balise compiler pour le faire pointer sur la racine web de votre serveur
local. 4. Ouvrez le chier flash_builder/eMemorae/.fxpProperties et modiez votre convenance les aributs
location
des balises
linked
pour les faire pointer vers les chemins absolus de votre
installation. Si vous avez install Flash Builder normalement vous naurez qu modier le nom dutilisateur dans ces chemins. 5. Ouvrez le chier flash_builder/eMemorae/.project et modiez tous les chemins absolus pour quils pointent vers les chemins de linstallation de votre serveur local. Conseil : fates une recherche globale sur la chane D:/Applis/EasyPHP-5.3.8.0/ et remplacez l par le chemin vers votre dossier dinstallation de serveur local. 6. Ouvrez le chier flash_builder/eMemorae/.model/Kmap.fml. Direntes modications par lot doivent avoir lieu dans ce chier.
Recherchez et remplacez globalement la chane D:/Applis/EasyPHP-5.3.8.0/ par le chemin
vers votre dossier dinstallation de serveur local ;
Si votre serveur local ne reconnat pas lURL http://127.0.0.1 (cest le cas notemment dEasyPHP qui le dsactive par dfaut ou passe par un numro de port exotique), fates une recherche globale sur ce motif et remplacez le comme il se doit (de mme pour le chier flash_builder/ eMemorae/.flexProperties).
3.4 Importation dans Flash Builder
Une fois et seulement une fois que les tapes prcdentes ont t eectues, vous pouvez ouvrir Flash Builder. Dans le meilleur des cas, le projet ex doit tre automatiquement reconnu et import, mais dans le cas contraire, le mieux est de cliquer sur licne dimportation de projet et de spcier que lon importe un projet depuis un dossier, en refusant de le copier lintrieur du workspace (il y est dj). Il ny a normalement plus rien faire cee tape, si ce nest peut-tre rgl des dtails inhrents aux spcicit de votre plateforme. Mais normalement, tout devrait fonctionner.
tienne Deparis Heudiasyc ICI
Guide pratique du dveloppeur pour E-MEMORAe 2.0
Dploiement dune instance de dmo sous windows
Dans le cadre du dploiement dune instance de dmo tournant sous Microso Windows, vous devez suivre les mmes tapes que celles dcrites dans les sections 3.1 et 3.2. Les sections concernant Flash Builder ne sappliquent pas dans ce cas. Cee remarque ne sapplique nanmoins que dans le cadre dune dmo tournant au sein dun environnement type EasyPHP ou Wamp.
Dploiement dune instance de production
Le dploiement dune instance de production suit les mmes tapes que le dploiement dune instance de test ou de dmo dcrit dans la section 3. Ainsi il vous faudra au pralable modier tous les chiers pr-cits pour quils contiennent les adresses et les chemins rels de votre serveur de production, avant de lancer Flash Builder et compiler le projet Flash dans son ensemble an de gnrer un binaire ash qui aille taper sur les bonnes adresses de votre serveur de prod. Pour cela je vous conseille davoir en permanance une copie correctement paramtre des chiers ci-dessous (les autres nont en fait pas besoin dtre modi dans le cadre dun dploiement), an de pouvoir les inverser rapidement avant et aprs un dploiement en prod dans le but dviter la fastidieuse phase de recherche et remplacement global.
.exProperties models/Kmap.fml
Gestion des services PHP
Une fois linstallation termine, vous pouvez commencer hacker lenvironnement E-MEMORAe 2.0. Mis part la programmation en Action Script que nous naborderons pas ici, votre principal souci va rsider dans le maniement des services PHP. Les services PHP sappuient sur deux types de chiers :
la classe PHP dcrivant le service en lui mme, stocke dans le dossier memflex/services et dont le nom est de la forme NameService.php o Name est le nom du service en lui mme ;
la classe PHP dcrivant le modle de donne li ce service, stocke dans le dossier memflex/services/class
et dont le nom est de la forme name.class.inc.php o Name est toujours le nom
du service. Si la plateforme est correctement installe, la moindre modication eectue sur les services aura une rpercussion sur la vue service disponible au sein de Flash Builder si le service tait dj install. Si ce nest pas le cas, il vous faudra limporter en slectionnant dans le menu Donnes de Flash Builder lentre Connexion PHP. Vous devez slectionnez votre chier memflex/services/NameService.php dans la case Classe PHP. Laissez les valeurs par dfaut des champs suivants. tienne Deparis Heudiasyc ICI
Guide pratique du dveloppeur pour E-MEMORAe 2.0
Si le service est li un type de donne particulier, Flash Builder le dtectera automatiquement et fera tout le travail ncessaire. Si jamais il manque des informations, vous pouvez forcer leur gnration en slectionnant vous mme les types dentre et de retour des fonctions importes de votre nouveau service.
Contact Pour plus dinformation, nhsitez pas me contacter par mail ladresse etienne.deparis@utc.fr en prcisant dans lobjet du mail quil sagit dune question concernant memorae.
