Developpement

Version 196 (Etienne Pallier, 12/20/2016 03:01 pm)

1 150 Etienne Pallier
h1. Labinvent 2 (cakephp3) - Développement
2 1 Etienne Pallier
3 148 Etienne Pallier
Cette page décrit le processus de développement du logiciel, ainsi que les outils utilisés.
4 148 Etienne Pallier
5 148 Etienne Pallier
[ [[Labinvent_nouvelle_version|Retour au sommmaire]] ]
6 148 Etienne Pallier
7 1 Etienne Pallier
8 1 Etienne Pallier
{{toc}}
9 1 Etienne Pallier
10 1 Etienne Pallier
---
11 1 Etienne Pallier
12 4 Etienne Pallier
h2. LIENS UTILES
13 94 Etienne Pallier
14 97 Etienne Pallier
* HOWTO Format Redmine Wiki : http://www.redmine.org/projects/redmine/wiki/FrRedmineWikiFormatting
15 94 Etienne Pallier
16 96 Etienne Pallier
* [[Installation|Page wiki pour l'installation]]
17 1 Etienne Pallier
18 162 Etienne Pallier
* Migrations plugin: http://book.cakephp.org/3.0/fr/migrations.html
19 162 Etienne Pallier
20 93 Etienne Pallier
* Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
21 93 Etienne Pallier
22 92 Etienne Pallier
* Liste complète des évolutions: https://gitlab.irap.omp.eu/epallier/labinvent/commits/master
23 1 Etienne Pallier
24 92 Etienne Pallier
* Browse files (gitlab): https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
25 1 Etienne Pallier
26 92 Etienne Pallier
* Inventirap 1.3 (prod): https://inventirap.irap.omp.eu
27 1 Etienne Pallier
28 92 Etienne Pallier
* Inventirap 1.3 (test): https://inventirap-test.irap.omp.eu/
29 92 Etienne Pallier
30 93 Etienne Pallier
* CakePhp:
31 92 Etienne Pallier
32 147 Etienne Pallier
 * ROADMAP: https://github.com/cakephp/cakephp/wiki
33 93 Etienne Pallier
 * Forum cakephp: http://discourse.cakephp.org
34 93 Etienne Pallier
 * Quickstart tutorial: http://book.cakephp.org/3.0/en/quickstart.html
35 93 Etienne Pallier
 * Bookmarker tutorial: https://github.com/cakephp/bookmarker-tutorial
36 93 Etienne Pallier
 * Cakephp CRUD: https://github.com/FriendsOfCake/crud
37 1 Etienne Pallier
38 1 Etienne Pallier
---
39 1 Etienne Pallier
40 1 Etienne Pallier
h2. TODOLIST
41 1 Etienne Pallier
42 1 Etienne Pallier
43 193 Etienne Pallier
*Besoins généraux*
44 193 Etienne Pallier
45 195 Etienne Pallier
* Pour la partie administrative, la validation doit permettre l'édition de la fiche officielle d'inventaire transmise à la tutelle. Permettre l'édition de cette fiche (demande urgente).
46 193 Etienne Pallier
* Désactiver (ou simplement "limiter") l'envoi de mail aux responsables thématiques ou métiers :
47 196 Etienne Pallier
(Déjà 2 resp. thématiques ont manifesté leur mécontentement : Olivier Forni et Marie Calvet => solution temporaire : on leur a enlevé temporairement la responsabilité de "resp. thématique" ; il faudra la rétablir quand le problème sera réglé)
48 194 Etienne Pallier
* Elodie B. a des soucis avec le script d'install (notamment pour créer la BD mysql, et aussi pour le fonctionnement en local SANS LDAP) : voir de plus près quel est le problème
49 193 Etienne Pallier
50 190 Etienne Pallier
*Demandes des utilisateurs (transmises par D. Rambaud le 19/12/16) :*
51 190 Etienne Pallier
52 190 Etienne Pallier
* Ca serait bien que le proprio de la fiche reçoive un email quand l'étiquette est imprimée, ou encore quand la fiche est validée => dans le but qu'il vérifie et complète cette fiche
53 190 Etienne Pallier
* Ca serait bien aussi que le proprio puisse modifier sa fiche, une fois créée, mais aussi même après qu'elle ait été validée
54 190 Etienne Pallier
55 190 Etienne Pallier
56 190 Etienne Pallier
*Suite à réunion du 27/10/16 avec le LATMOS, constat des modifs nécessaires:*
57 185 Etienne Pallier
58 189 Etienne Pallier
* L'étiqueteuse semble ne plus fonctionner alors qu'elle fonctionnait avant...
59 188 Etienne Pallier
* Ajouter un champ "Titre du mail" dans la liste des emails envoyés, pour qu'on puisse configurer le titre du mail envoyé (ex: [LABINVENT])
60 187 Etienne Pallier
* Check Date achat <= Date Livraison !!!
61 185 Etienne Pallier
* Ajouter un statut : ajouter un statut « désinventorié «  ou «amorti ? » (à réfléchir)
62 185 Etienne Pallier
* Ajouter colonne statut « hors service » dans la vue "liste des matériels"
63 185 Etienne Pallier
* N° série : à remettre dans la section informations (pour que tout le monde le voie)
64 185 Etienne Pallier
* Empêcher duplication d'une fiche matériel si même numéro de série
65 185 Etienne Pallier
* Importation depuis Excel
66 185 Etienne Pallier
* Le champ "Local de stockage" a-t-il disparu ??? => à remettre
67 185 Etienne Pallier
* Site : champ optionnel
68 185 Etienne Pallier
* Champs optionnels: de manière générale, il faudrait pouvoir configurer quelques champs comme optionnels (certains champs doivent bien sûr absolument rester obligatoires)
69 185 Etienne Pallier
* (temporairement, on peut se contenter de CACHER certains champs, comme par exemple le champ "Site")
70 185 Etienne Pallier
* Suivis par fournisseur: ajouter la colonne "fournisseur" dans Suivi pour pouvoir trier la vue par fournisseur
71 185 Etienne Pallier
* Suivis relance : trouver un moyen de relancer automatiquement les suivis périodiques (ou bien avec une date programmée)
72 185 Etienne Pallier
* Emprunt dates: afficher les dates d'emprunt et de retour (date emprunt doit être obligatoire)
73 185 Etienne Pallier
* Affiner la fonctionnalité d’envoi automatique des emails
74 185 Etienne Pallier
* Matériel gestionnaire: obliger la personne qui crée une fiche matériel à choisir un gestionnaire (via une liste) (et avertir automatiquement ce gestionnaire par mail)
75 185 Etienne Pallier
* supprimer profil AdminPlus, inutile
76 185 Etienne Pallier
77 185 Etienne Pallier
78 185 Etienne Pallier
79 192 Etienne Pallier
*Suite à l'installation à l'IRAP du 21/01/2016*:
80 1 Etienne Pallier
81 121 Alexandre Cases
- Si elle existe, supprimer table "fichiers"
82 120 Alexandre Cases
- Sauvegarder les utilisateurs
83 120 Alexandre Cases
- Transformer table "utilisateurs" en "users"
84 120 Alexandre Cases
- Ajout table "configuration"
85 120 Alexandre Cases
- Ajout clé étrangère emprunts (site_id)/suivis (type_suivi_id)
86 120 Alexandre Cases
- Transformation des données correspondantes
87 1 Etienne Pallier
- Suppression ancien champ emprunt (e_lieu_stockage), suivis (type_intervention)
88 120 Alexandre Cases
89 120 Alexandre Cases
90 192 Etienne Pallier
*Suite à l'installation à l'IAS du 09/03/2015*
91 120 Alexandre Cases
92 120 Alexandre Cases
- Ajout table "organismes", "type_suivis", "sites"
93 120 Alexandre Cases
- Ajout clé correspondante dans table "matériels"
94 120 Alexandre Cases
- Transformation des données correspondantes
95 120 Alexandre Cases
- Suppression anciens champs
96 120 Alexandre Cases
- Ajout table "documents"
97 120 Alexandre Cases
- Sauvegarder les utilisateurs
98 120 Alexandre Cases
- Transformer table "utilisateurs" en "users"
99 120 Alexandre Cases
- Ajout table "configuration"
100 120 Alexandre Cases
- Ajout clé étrangère emprunts (site_id)/suivis (type_suivi_id)
101 120 Alexandre Cases
- Transformation des données correspondantes
102 120 Alexandre Cases
- Suppression ancien champ emprunt (e_lieu_stockage), suivis (type_intervention)
103 1 Etienne Pallier
---
104 1 Etienne Pallier
105 101 Etienne Pallier
h2. Schéma de la base de données (v2.0.0)
106 9 Etienne Pallier
107 9 Etienne Pallier
108 180 Etienne Pallier
{{thumbnail(BDD_IRAP.png, size=2000, title=Pyros data model)}}
109 9 Etienne Pallier
110 174 Etienne Pallier
111 174 Etienne Pallier
112 174 Etienne Pallier
113 174 Etienne Pallier
114 174 Etienne Pallier
115 174 Etienne Pallier
---
116 174 Etienne Pallier
117 174 Etienne Pallier
h2. Cycle de vie du Matériel
118 174 Etienne Pallier
119 176 Etienne Pallier
120 182 Etienne Pallier
---
121 182 Etienne Pallier
122 176 Etienne Pallier
h3. Diagramme d'états-transitions
123 176 Etienne Pallier
124 179 Etienne Pallier
{{thumbnail(equipment_status_state_diagram.png, size=2000, title=Cycle de vie du matériel)}}
125 176 Etienne Pallier
126 182 Etienne Pallier
127 182 Etienne Pallier
---
128 176 Etienne Pallier
129 176 Etienne Pallier
h3. Diagramme de séquences
130 176 Etienne Pallier
131 178 Etienne Pallier
{{thumbnail(equipment_interactions_sequence_diagram.png, size=1500, title=Cycle de vie du matériel)}}
132 174 Etienne Pallier
133 174 Etienne Pallier
134 174 Etienne Pallier
135 9 Etienne Pallier
---
136 9 Etienne Pallier
137 181 Etienne Pallier
h2. ACL - Gestion des droits selon le profil
138 181 Etienne Pallier
139 184 Etienne Pallier
{{thumbnail(ACLs Droits selon les Roles.pdf, size=1500, title=Cycle de vie du matériel)}}
140 183 Etienne Pallier
141 183 Etienne Pallier
142 181 Etienne Pallier
143 181 Etienne Pallier
---
144 181 Etienne Pallier
145 12 Etienne Pallier
h2. ROADMAP - Plan de développement
146 12 Etienne Pallier
147 76 Etienne Pallier
Le stage se déroule de mi-avril à fin juin, soit sur 12 semaines (S1 à S12), ou 24 demi-semaines.
148 15 Etienne Pallier
_*(Ne pas oublier de rédiger le rapport de stage au fur et à mesure)*_
149 1 Etienne Pallier
150 12 Etienne Pallier
151 17 Etienne Pallier
Voir le détail de la roadmap: https://projects.irap.omp.eu/projects/inventirap/roadmap
152 17 Etienne Pallier
153 66 Etienne Pallier
|                    |   |_.Prévu |_.Réalisé |
154 155 Alexandre Cases
|/2=.S01 (11/4-15/4) |.1|/5=<."version 2.00 - Cakephp3 + Php5 (version de base from bake)":https://projects.irap.omp.eu/versions/105|/6=<.version 2.00|
155 84 Etienne Pallier
                     |.2|
156 86 Etienne Pallier
|/2=.S02 (18/4-22/4) |.1|
157 84 Etienne Pallier
                     |.2|
158 86 Etienne Pallier
|/2=.S03 (25/4-29/4) |.1|
159 154 Alexandre Cases
                     |.2|/4=<."version 2.01 - Implémentation complète du CRUD":https://projects.irap.omp.eu/versions/101|
160 154 Alexandre Cases
|/2=.S04 (02/5-06/5) |.1|/4=<.version 2.01|
161 107 Alexandre Cases
                     |.2|
162 105 Etienne Pallier
|/2=.S05 (09/5-13/5) |.1|
163 154 Alexandre Cases
                     |.2|/3=<."version 2.02 - Implémentation de toutes les autres actions":https://projects.irap.omp.eu/versions/106|
164 154 Alexandre Cases
|/2=.S06 (16/5-20/5) |.1|/2=<.version 2.02|
165 138 Etienne Pallier
                     |.2|
166 154 Alexandre Cases
|/2=.S07 (23/5-27/5) |.1|/2=<."version 2.03 - Implémentation du LDAP (vrai et fake)":https://projects.irap.omp.eu/versions/108|/2=<.version 2.03|
167 138 Etienne Pallier
                     |.2|
168 160 Alexandre Cases
|/2=.S08 (30/5-03/6) |.1|/2=<."version 2.04 - Implémentation des ACL (droits)":https://projects.irap.omp.eu/versions/107|_/10=<.version 2.04 (en cours)|
169 90 Etienne Pallier
                     |.2|
170 161 Etienne Pallier
|/2=.S09 (06/6-10/6) |.1|/2=<."version 2.05 - Documents attaches aux materiels (+ photos)":https://projects.irap.omp.eu/versions/99|
171 90 Etienne Pallier
                     |.2|
172 161 Etienne Pallier
|_/2=.S10 (13/6-17/6) |.1|/2=<."version 2.06 - Evolutions prévues dans 1.3 et 1.4":https://projects.irap.omp.eu/versions/110|
173 90 Etienne Pallier
                     |.2|
174 154 Alexandre Cases
|/2=.S11 (20/6-24/6) |.1|/1=<."version 2.07 - Corrections/Evolutions demandées par l'IAS":https://projects.irap.omp.eu/versions/124|
175 154 Alexandre Cases
                     |.2|/2=<."version 2.08 - Cakephp3 + Php7 (compatible Php5)":https://projects.irap.omp.eu/versions/98|
176 154 Alexandre Cases
|/2=.S12 (27/6-30/6) |.1|
177 154 Alexandre Cases
                     |.2|/1=<."version 2.10 - Autres ajouts (+ fin rédaction rapport de stage)":https://projects.irap.omp.eu/versions/100|
178 99 Etienne Pallier
179 1 Etienne Pallier
---
180 1 Etienne Pallier
181 151 Etienne Pallier
h2. PROCEDURE à suivre pour un COMMIT
182 102 Etienne Pallier
183 100 Etienne Pallier
Voici les différentes étapes à respecter au moment de chaque commit:
184 98 Etienne Pallier
185 100 Etienne Pallier
*1) S'assurer que tous les tests passent toujours...*
186 98 Etienne Pallier
187 100 Etienne Pallier
*2) Mettre à jour le fichier README (ceci est un exemple, un template)*
188 98 Etienne Pallier
189 98 Etienne Pallier
Date: 11/05/2016
190 98 Etienne Pallier
Version: 2.1.9
191 98 Etienne Pallier
Mise à jour doc install
192 98 Etienne Pallier
(Attention, changement structure BDD)
193 98 Etienne Pallier
Demande (terminée): https://projects.irap.omp.eu/issues/3542
194 98 Etienne Pallier
Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
195 98 Etienne Pallier
196 98 Etienne Pallier
Remarques:
197 98 Etienne Pallier
=> Version: 2.1.9 = 9ème commit sur la version 2.1
198 98 Etienne Pallier
=> préciser "(bugfix)" si c'est le cas
199 1 Etienne Pallier
=> ajouter "(Attention, changement structure BDD)" s'il y a eu une modif de la BDD
200 1 Etienne Pallier
=> "Demande (terminée)" ou "Demande (en cours)", ou pas de demande du tout (exceptionnellement)
201 1 Etienne Pallier
=> ces infos permettront de savoir quelle version (et date) exacte du projet on a actuellement sur son disque
202 1 Etienne Pallier
203 1 Etienne Pallier
204 151 Etienne Pallier
*[3) S'il y a eu un changement de structure de la BD]*
205 1 Etienne Pallier
206 151 Etienne Pallier
* Mettre à jour le schéma de la BD (avec Mysql Workbench) dans le projet et sur le wiki (page "Documentation technique")
207 151 Etienne Pallier
208 151 Etienne Pallier
209 151 Etienne Pallier
*[4) Si c'est la fin d'une version majeure (2.0, 2.1, 2.2, ...)]*
210 151 Etienne Pallier
211 100 Etienne Pallier
* On doit normalement avoir écrit quelques nouveaux tests pour cette version !!!
212 100 Etienne Pallier
* Ajouter cette version en tête de la section "MAIN CHANGES (MILESTONES)" dans le fichier README
213 100 Etienne Pallier
* Mettre à jour la doc install/INSTALLATION à partir du wiki (si nécessaire)
214 1 Etienne Pallier
* Tester une installation du logiciel from scratch 
215 100 Etienne Pallier
216 100 Etienne Pallier
217 151 Etienne Pallier
*5) pull*
218 1 Etienne Pallier
219 1 Etienne Pallier
(au cas où quelqu'un d'autre aurait fait un push)
220 98 Etienne Pallier
221 98 Etienne Pallier
222 151 Etienne Pallier
*6) commit*
223 1 Etienne Pallier
224 151 Etienne Pallier
Dans le message de commit, faire un simple copier/coller des infos du fichier README (sauf date):
225 1 Etienne Pallier
226 1 Etienne Pallier
Version: 2.1.9
227 98 Etienne Pallier
Mise à jour doc install (bugfix)
228 98 Etienne Pallier
Demande (terminée): https://projects.irap.omp.eu/issues/3542
229 98 Etienne Pallier
Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
230 98 Etienne Pallier
231 98 Etienne Pallier
232 151 Etienne Pallier
*[7) push]*
233 100 Etienne Pallier
234 100 Etienne Pallier
(seulement si le commit est important/urgent, ou suite à un ensemble de commits sur un même thème)
235 98 Etienne Pallier
236 104 Etienne Pallier
237 104 Etienne Pallier
---
238 104 Etienne Pallier
239 7 Etienne Pallier
h2. Installation from scratch (Sous UBuntu)
240 1 Etienne Pallier
241 1 Etienne Pallier
h3. Création projet avec Composer
242 1 Etienne Pallier
243 1 Etienne Pallier
* Télécharger composer.phar : 
244 1 Etienne Pallier
"curl -s https://getcomposer.org/installer | php"
245 1 Etienne Pallier
246 1 Etienne Pallier
* Avec le Composer créer un nouveau projet : 
247 1 Etienne Pallier
"php composer.phar create-project --prefer-dist cakephp/app labinvent_2.0"
248 1 Etienne Pallier
249 1 Etienne Pallier
> Voir structure projet : http://book.cakephp.org/3.0/fr/intro/cakephp-folder-structure.html
250 1 Etienne Pallier
251 1 Etienne Pallier
* On rempli la base de données avec le fichier sql
252 1 Etienne Pallier
253 1 Etienne Pallier
* On indique la BD utilisé à CakePHP dans le fichier config/app.php, propriété "Datasources".
254 1 Etienne Pallier
255 1 Etienne Pallier
* On se place à la racine du projet
256 1 Etienne Pallier
257 1 Etienne Pallier
* On génère le code Scaffold : 
258 1 Etienne Pallier
"bin/cake bake all nom_table" --> ça génére les modeles, les vues, et les controlleurs.
259 1 Etienne Pallier
260 1 Etienne Pallier
> Commande (en une fois) :
261 1 Etienne Pallier
> > bin/cake bake all categories && bin/cake bake all emprunts && bin/cake bake all groupes_metiers && bin/cake bake all groupes_thematiques && bin/cake bake all organismes && bin/cake bake all sites && bin/cake bake all sous_categories && bin/cake bake all suivis && bin/cake bake all sur_categories && bin/cake bake all type_suivis && bin/cake bake all documents && bin/cake bake all users && bin/cake bake all materiels
262 1 Etienne Pallier
263 1 Etienne Pallier
h3. Modification de la base de données 
264 1 Etienne Pallier
> Une version du sql corrigée au fur et à mesure est disponible dans le git :
265 22 Alexandre Cases
266 22 Alexandre Cases
> > Dans database/, le fichier labinvent_2.1_09-05-16 correspond à la création de la base.
267 1 Etienne Pallier
> > Dans database/, le fichier labinvent_2.0_insert-irap_19-04-16 correspond aux insertions propre à l'IRAP, fichier insertion uniquement pour les dévellopeurs.
268 1 Etienne Pallier
269 1 Etienne Pallier
* Création table "config"
270 22 Alexandre Cases
271 22 Alexandre Cases
> > Mise à jour dans le fichier de création de base
272 22 Alexandre Cases
> > Mise à jour à part : db-update-2016-05-09.sql
273 1 Etienne Pallier
274 153 Etienne Pallier
h3. Autres remarques lors du développement
275 1 Etienne Pallier
276 21 Alexandre Cases
* Suivre les conventions de CakePHP est le top pour ne pas avoir à refaire de la config (bidouiller), il faudrait vérifier réguliérement que c'est le cas (outil "cakephp-codesniffer")...
277 1 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/contributing/cakephp-coding-conventions.html
278 1 Etienne Pallier
279 1 Etienne Pallier
* La solution pour insérer un utilisateur directement dans la base et pouvoir se connecter avec dans l'application est de l'insérer avec un mot de passe haché de la méme façon.
280 1 Etienne Pallier
Le mot de passe "login" = "$2y$10$LZzpws3oDidBcqO/Fy1RTedLLk3ENTmplny5J7bZ6R1PqFoGOw3Ma".
281 131 Alexandre Cases
Le mot de passe vide "" = "$2y$10$nBQMNstgN.sgad1ZANznY.pbJI.ZG/.Q5qX4gC8SXCFQnDIZC8rcW".
282 1 Etienne Pallier
283 1 Etienne Pallier
* Vérifier que la migration vers la prochaine version de cakephp3 (3.3 ?) sera facile... (décrire la procédure à suivre)
284 1 Etienne Pallier
--> Une migration vers une version mineur 3.2 => 3.3, se réalise avec la mise à jour de CakePHP à l'aide de Composer
285 21 Alexandre Cases
--> Puis il faut regarder les changements dans la page migration correspondant à la version voulu et adapter les changements au code.
286 1 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/appendices/3-2-migration-guide.html
287 21 Alexandre Cases
288 21 Alexandre Cases
* Outil (plugin) "DebugKit" de CakePHP3 : 
289 21 Alexandre Cases
--> DebugKit est un plugin qui fournit une toolbar pour aider à debugger les applications CakePHP plus facilement.
290 21 Alexandre Cases
--> Par défaut il est installé avec le squelette de l'application, pour l'activer, il faut se placer à la racine.
291 21 Alexandre Cases
--> Puis il faut éxécuter la ligne suivante : bin/cake plugin load DebugKit .
292 21 Alexandre Cases
--> La commande va aller modifier le fichier config bootstrap.php.
293 21 Alexandre Cases
--> Le fichier bootstrap.php actuel de l'application sur le git, est configuré pour charger le plugin lorsque l'application est en mode debug de CakePHP, je ne pense pas que exécuter la commande précédente soit utile vu la configuration de ce fichier dans notre application.
294 21 Alexandre Cases
--> Le plugin nécessite l'extension php5-sqlite par défaut (il supporte l'équivalent avec de la config).
295 20 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/debug-kit.html
296 24 Alexandre Cases
297 25 Alexandre Cases
298 91 Alexandre Cases
* Mode debug personnaliser : 
299 130 Alexandre Cases
> Faire $this->myDebug($var) dans un controlleur pour afficher le contenu de la variable si mode debug personnalisé actif, à condition que le mode debug soit activé.
300 91 Alexandre Cases
301 91 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/development/testing.html
302 31 Alexandre Cases
303 106 Alexandre Cases
* Pour charger une librairie (ex : phpqrcode, ...)
304 106 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/core-libraries/app.html#charger-les-fichiers-de-vendor
305 106 Alexandre Cases
306 1 Etienne Pallier
* Pour créer les fichiers pdf d'entrée et de sortie, on utilise fpdf 1.8.1, on pourrait utiliser le plugin développer pour CakePHP3.
307 129 Alexandre Cases
> Voir : https://github.com/FriendsOfCake/CakePdf
308 122 Alexandre Cases
309 129 Alexandre Cases
* Pour le JavaScript, le JS Helper a été retiré 
310 128 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/appendices/3-0-migration-guide.html#jshelper
311 128 Alexandre Cases
312 157 Alexandre Cases
* Pour pouvoir éxécuter les tests depuis eclipse : 
313 157 Alexandre Cases
> Voir : http://blog.loftdigital.com/running-phpunit-tests-in-eclipse-pdt
314 157 Alexandre Cases
315 125 Alexandre Cases
* Avant de déployer l'application sur le serveur de production, optimiser les performances
316 125 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/deployment.html#ameliorer-les-performances-de-votre-application
317 156 Etienne Pallier
318 156 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}Installation sur Mac (retour des pb)%
319 156 Etienne Pallier
320 156 Etienne Pallier
1) install.sh
321 156 Etienne Pallier
=> 
322 156 Etienne Pallier
chmod: Unable to change file mode on ./webroot/img//gqbee0pkerrl8h2rbekaa3t8j1.png: Operation not permitted
323 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/models/myapp_cake_model_default_configurations: Operation not permitted
324 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/models/myapp_cake_model_default_documents: Operation not permitted
325 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_cake_fr__f_r: Operation not permitted
326 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_debug_kit_fr__f_r: Operation not permitted
327 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_default_fr__f_r: Operation not permitted
328 156 Etienne Pallier
329 156 Etienne Pallier
330 156 Etienne Pallier
=> sudo chmod -R 777 ../webroot/img
331 156 Etienne Pallier
=> sudo chmod -R 777 ../tmp/
332 156 Etienne Pallier
(=> sudo chmod -R 777 ../vendor)
333 156 Etienne Pallier
334 156 Etienne Pallier
335 156 Etienne Pallier
2) connexion au site
336 156 Etienne Pallier
=> mauvais affichage pourri
337 156 Etienne Pallier
=> il faut configurer la BD dans app.php
338 156 Etienne Pallier
            'username' => 'labinvent2user',
339 156 Etienne Pallier
            'password' => 'labinvent2user',
340 156 Etienne Pallier
            'database' => 'labinvent2',
341 156 Etienne Pallier
342 156 Etienne Pallier
3) login
343 156 Etienne Pallier
=> epallier/login
344 156 Etienne Pallier
345 156 Etienne Pallier
346 163 Alexandre Cases
---
347 156 Etienne Pallier
348 163 Alexandre Cases
h2. Pour mettre à jour CakePHP
349 156 Etienne Pallier
350 165 Etienne Pallier
* Utiliser le composer : "php composer.phar update" à la racine de l'application
351 1 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/installation.html#rester-a-jour-avec-les-derniers-changements-de-cakephp
352 164 Alexandre Cases
353 164 Alexandre Cases
* Puis il faut modifier le fichier : ./vendor/cakephp/cakephp/src/View/Helper/PaginatorHelper.php
354 164 Alexandre Cases
  Ce fichier contient le template de l'helper "paginator" et il faut modifier le tableau "$_defaultConfig" et remplacer les balise "li" par des balises "span".
355 164 Alexandre Cases
  Enfin dans le même tableau, il faut remplacer la ligne suivante : 
356 164 Alexandre Cases
> 'current' => '<span class="active"><a href="">{{text}}</a></span>',
357 164 Alexandre Cases
358 164 Alexandre Cases
           Par : 
359 164 Alexandre Cases
360 164 Alexandre Cases
> 'current' => '<span class="current">{{text}}</span>',
361 164 Alexandre Cases
362 172 Alexandre Cases
* Puis il faut vider le cache de l'application (et du navigateur) pour que debug_kit fonctionne.
363 172 Alexandre Cases
364 156 Etienne Pallier
365 156 Etienne Pallier
---
366 156 Etienne Pallier
367 167 Alexandre Cases
h2. Rappel d'intervention par mail
368 167 Alexandre Cases
369 170 Alexandre Cases
* Il faut définir un attribut *"rappel" de type "int"* dans la table suivis.
370 171 Alexandre Cases
Cet attribut peut avoir *4 valeurs* : 
371 169 Alexandre Cases
<pre>
372 169 Alexandre Cases
0 ==> Pas d'envoi de rappel programmé
373 169 Alexandre Cases
1 ==> Rappel programmé 1 mois avant
374 169 Alexandre Cases
2 ==> Rappel programmé 15 jours avant
375 169 Alexandre Cases
3 ==> Rappel programmé 2 jours avant
376 169 Alexandre Cases
</pre>
377 1 Etienne Pallier
378 173 Alexandre Cases
* Dans *l'AppController*, il faut définir une fonction "rappelIntervention()" qui :
379 173 Alexandre Cases
- Parcourt tous les suivis et garde ceux qui ont une date inferieur à 1 mois de la date du jour et qui ont un attribut "rappel" à "0".
380 173 Alexandre Cases
- Met cette attribut à 1
381 173 Alexandre Cases
- 
382 1 Etienne Pallier
383 170 Alexandre Cases
...........................
384 170 Alexandre Cases
385 170 Alexandre Cases
* Dans *l'UsersController*, il faut executer la fonction précédente une fois que l'utilisateur est connecté (dans fonction login()).
386 167 Alexandre Cases
387 167 Alexandre Cases
---
388 167 Alexandre Cases
389 8 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}NOTES FOR ECLIPSE USERS%
390 1 Etienne Pallier
391 1 Etienne Pallier
0) Install Eclipse (if necessary)
392 1 Etienne Pallier
393 1 Etienne Pallier
Get the Eclipse version for Php
394 1 Etienne Pallier
395 1 Etienne Pallier
396 1 Etienne Pallier
1) Deactivate CA certificate verification
397 1 Etienne Pallier
398 1 Etienne Pallier
Window -> Preferences -> Team -> git -> configuration -> Add entry
399 1 Etienne Pallier
400 1 Etienne Pallier
Key = http.sslVerify
401 1 Etienne Pallier
Value = false
402 1 Etienne Pallier
403 1 Etienne Pallier
2) Fetch the project
404 1 Etienne Pallier
405 1 Etienne Pallier
File/Import project from git
406 1 Etienne Pallier
407 1 Etienne Pallier
Select repository source: Clone URI: https://gitlab.irap.omp.eu/epallier/labinvent.git
408 1 Etienne Pallier
409 1 Etienne Pallier
Directory: 
410 1 Etienne Pallier
- par défaut, il propose : /Users/epallier/git/labinvent
411 1 Etienne Pallier
- mais on peut le mettre n'importe où ailleurs, 
412 1 Etienne Pallier
par exemple, on pourrait le mettre directement dans le repertoire web de Apache:
413 1 Etienne Pallier
/Applications/XAMPP/xamppfiles/htdocs 
414 1 Etienne Pallier
(si on veut que le projet s'execute directement dans le dossier web apache htdocs, mais ca n'est pas obligatoire...)
415 1 Etienne Pallier
416 1 Etienne Pallier
initial branch: master
417 1 Etienne Pallier
remote name: origin
418 1 Etienne Pallier
419 1 Etienne Pallier
Import as general project
420 1 Etienne Pallier
421 1 Etienne Pallier
Project name: LABINVENT
422 1 Etienne Pallier
423 1 Etienne Pallier
424 1 Etienne Pallier
425 1 Etienne Pallier
426 1 Etienne Pallier
3) Configure the project
427 1 Etienne Pallier
428 1 Etienne Pallier
a) S'assurer que le projet est bien reconnu comme un projet PHP (il doit y avoir un petit "P" sur le dossier racine du projet)
429 1 Etienne Pallier
Si ça n'est pas le cas, vérifier que le fichier .project (à la racine) contient bien
430 1 Etienne Pallier
	<natures>
431 1 Etienne Pallier
		<nature>org.eclipse.php.core.PHPNature</nature>
432 1 Etienne Pallier
	</natures>
433 1 Etienne Pallier
NB : Le fichier .project est normalement versionné et donc le projet labinvent devrait être reconnu automatiquement comme projet PHP
434 1 Etienne Pallier
435 1 Etienne Pallier
436 1 Etienne Pallier
b) S'assurer que les fichiers de vue de cakephp ("*.ctp") sont bien reconnus comme des fichiers PHP.
437 1 Etienne Pallier
Pour tester cela, ouvrir le fichier de vue cakephp/app/View/Categories/get_all.ctp
438 1 Etienne Pallier
Si ce fichier s'ouvre comme un simple fichier texte, c'est qu'il n'est pas reconnu par Eclipse comme un fichier Php. 
439 1 Etienne Pallier
Il faut donc associer l'editeur Php a l'extension de fichier "*.ctp" :
440 1 Etienne Pallier
- Preferences/General/Content types
441 1 Etienne Pallier
- Dans la liste "Content types", ouvrir la section "Text", selectionner PHP
442 1 Etienne Pallier
- Ajouter l'extension "*.ctp"
443 1 Etienne Pallier
444 1 Etienne Pallier
c) Vérifier la version de php utilisée (il serait préférable d'utiliser la meme version que celle officiellement utilisée par le logiciel, c'est à dire php 5.6, mais attention, le serveur IRAP utilise toujours une version 5.3 pour inventirap) :
445 1 Etienne Pallier
- Clic-droit sur le projet, Propriétés
446 1 Etienne Pallier
- PHP
447 1 Etienne Pallier
- Interpreter
448 1 Etienne Pallier
- Enable project specific settings, PHP Version : "PHP 5.6"
449 1 Etienne Pallier
450 1 Etienne Pallier
d) S'assurer que le texte est bien encodé en UTF-8 par défaut :
451 1 Etienne Pallier
clic-droit sur le dossier racine du projet (dans PHP Explorer), Properties, Resource : dans la zone "Text file encoding" cocher "Other" et sélectionner UTF-8
452 1 Etienne Pallier
(
453 1 Etienne Pallier
Il faudrait commiter ça mais je ne sais pas trop si c'est risqué ou pas.
454 1 Etienne Pallier
Les fichiers concernés sont :
455 1 Etienne Pallier
- .project (déjà versionné) : car il commence par la ligne "<?xml version="1.0" encoding="UTF-8"?>"
456 1 Etienne Pallier
- mais c'est surtout celui-ci qui compte (actuellement ignoré de git) : .settings/org.eclipse.core.resources.prefs : car sa 2eme ligne est "encoding/<project>=UTF-8"
457 1 Etienne Pallier
)
458 1 Etienne Pallier
459 1 Etienne Pallier
Les éléments suivants sont normalement DEJA ignorés par git, à vérifier :
460 1 Etienne Pallier
- .settings/
461 1 Etienne Pallier
- cakephp/app/tmp/ : tout sauf 
462 1 Etienne Pallier
	- documents/
463 1 Etienne Pallier
- cakephp/app/Config/ :
464 1 Etienne Pallier
	- database.php
465 1 Etienne Pallier
	- labinvent.php
466 1 Etienne Pallier
467 1 Etienne Pallier
468 1 Etienne Pallier
469 1 Etienne Pallier
470 1 Etienne Pallier
471 1 Etienne Pallier
<pre>
472 1 Etienne Pallier
*********************************************************
473 1 Etienne Pallier
REMARQUES INTERRESSANTES (MAIS VOUS POUVEZ LES IGNORER)
474 1 Etienne Pallier
475 1 Etienne Pallier
// DEBUT DES REMARQUES
476 1 Etienne Pallier
477 1 Etienne Pallier
A la racine du projet, j'ai plusieurs éléments cachés de configuration Eclipse :
478 1 Etienne Pallier
479 1 Etienne Pallier
1) fichier .buildpath 
480 1 Etienne Pallier
Il est versionné puisque "svn status .buildpath" (depuis la console) ne donne rien
481 1 Etienne Pallier
Il contient :
482 1 Etienne Pallier
483 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
484 1 Etienne Pallier
<buildpath>
485 1 Etienne Pallier
        <buildpathentry kind="con" path="org.eclipse.php.core.LANGUAGE"/>
486 1 Etienne Pallier
        <buildpathentry kind="lib" path="docs/mockup/mockup_html.zip"/>
487 1 Etienne Pallier
        <buildpathentry kind="src" path="cakephp"/>
488 1 Etienne Pallier
</buildpath>
489 1 Etienne Pallier
490 1 Etienne Pallier
2) fichier .project
491 1 Etienne Pallier
Il est déjà versionné
492 1 Etienne Pallier
Il contient :
493 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
494 1 Etienne Pallier
<projectDescription>
495 1 Etienne Pallier
        <name>invirap</name>
496 1 Etienne Pallier
        <comment></comment>
497 1 Etienne Pallier
        <projects>
498 1 Etienne Pallier
        </projects>
499 1 Etienne Pallier
        <buildSpec>
500 1 Etienne Pallier
                <buildCommand>
501 1 Etienne Pallier
                        <name>org.eclipse.wst.common.project.facet.core.builder</name>
502 1 Etienne Pallier
                        <arguments>
503 1 Etienne Pallier
                        </arguments>
504 1 Etienne Pallier
                </buildCommand>
505 1 Etienne Pallier
                <buildCommand>
506 1 Etienne Pallier
                        <name>org.eclipse.wst.validation.validationbuilder</name>
507 1 Etienne Pallier
                        <arguments>
508 1 Etienne Pallier
                        </arguments>
509 1 Etienne Pallier
                </buildCommand>
510 1 Etienne Pallier
                <buildCommand>
511 1 Etienne Pallier
                        <name>org.eclipse.dltk.core.scriptbuilder</name>
512 1 Etienne Pallier
                        <arguments>
513 1 Etienne Pallier
                        </arguments>
514 1 Etienne Pallier
                </buildCommand>
515 1 Etienne Pallier
        </buildSpec>
516 1 Etienne Pallier
        <natures>
517 1 Etienne Pallier
                <nature>org.eclipse.php.core.PHPNature</nature>
518 1 Etienne Pallier
                <nature>org.eclipse.wst.common.project.facet.core.nature</nature>
519 1 Etienne Pallier
        </natures>
520 1 Etienne Pallier
</projectDescription>
521 1 Etienne Pallier
522 1 Etienne Pallier
3) dossier .settings/ (exclus de svn)
523 1 Etienne Pallier
Il contient 3 fichiers :
524 1 Etienne Pallier
525 1 Etienne Pallier
- org.eclipse.core.resources.prefs : bizarrement, il ne contient que quelques références seulement :
526 1 Etienne Pallier
eclipse.preferences.version=1
527 1 Etienne Pallier
encoding//cakephp/app/Controller/MaterielsController.php=UTF-8
528 1 Etienne Pallier
encoding//cakephp/app/View/Elements/menu_view.ctp=UTF-8
529 1 Etienne Pallier
encoding//cakephp/app/View/Layouts/default.ctp=UTF-8
530 1 Etienne Pallier
encoding//cakephp/app/View/Materiels/index.ctp=UTF-8
531 1 Etienne Pallier
encoding//cakephp/app/View/Materiels/scaffold.view.ctp=UTF-8
532 1 Etienne Pallier
encoding//database/Upd_TableConstraints.sql=UTF-8
533 1 Etienne Pallier
encoding//database/update/README.txt=UTF-8
534 1 Etienne Pallier
encoding//docs/HOWTO.txt=UTF-8
535 1 Etienne Pallier
encoding//install/HOWTO.txt=UTF-8
536 1 Etienne Pallier
encoding/<project>=UTF-8
537 1 Etienne Pallier
538 1 Etienne Pallier
- org.eclipse.php.core.prefs
539 1 Etienne Pallier
eclipse.preferences.version=1
540 1 Etienne Pallier
include_path=0;/invirap\u00051;/invirap/docs/mockup/mockup_html.zip
541 1 Etienne Pallier
542 1 Etienne Pallier
- org.eclipse.wst.common.project.facet.core.xml : sans doute inutile ? (lié à "Faceted Project Validation Builder" dans Properties/Builders)
543 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
544 1 Etienne Pallier
<faceted-project>
545 1 Etienne Pallier
  <fixed facet="php.core.component"/>
546 1 Etienne Pallier
  <fixed facet="php.component"/>
547 1 Etienne Pallier
  <installed facet="php.core.component" version="1"/>
548 1 Etienne Pallier
  <installed facet="php.component" version="5.4"/>
549 1 Etienne Pallier
</faceted-project>
550 1 Etienne Pallier
551 1 Etienne Pallier
// FIN DES REMARQUES
552 1 Etienne Pallier
*********************************************************
553 1 Etienne Pallier
</pre>
554 1 Etienne Pallier
555 1 Etienne Pallier
4) (TODO:) Set Code style
556 1 Etienne Pallier
557 1 Etienne Pallier
Window/Preferences : PHP / Editor
558 1 Etienne Pallier
...
559 1 Etienne Pallier
560 1 Etienne Pallier
5) (TODO: virtualenv) Now, once the PHP5 virtual environment is installed (see above),
561 1 Etienne Pallier
set it in Eclipse as the project interpreter:
562 1 Etienne Pallier
563 1 Etienne Pallier
(cf http://virtphp.org)
564 1 Etienne Pallier
565 1 Etienne Pallier
...
566 1 Etienne Pallier
567 1 Etienne Pallier
6) (TODO:) Test
568 1 Etienne Pallier
569 1 Etienne Pallier
570 1 Etienne Pallier
7) (TODO:) Run
571 1 Etienne Pallier
572 1 Etienne Pallier
check http://localhost:8080/