Developpement

Version 213 (Thibaud Ajas, 04/26/2017 10:34 am)

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 205 Etienne Pallier
44 198 Etienne Pallier
*Bugfixes*
45 198 Etienne Pallier
46 198 Etienne Pallier
* cf fiche buguée avec numéro inventaire IRAP-2070-0001, et date achat 1/1/70, ce qui ne devrait normalement pas être possible !! : https://inventirap.irap.omp.eu/materiels/view/11790
47 198 Etienne Pallier
48 193 Etienne Pallier
*Besoins généraux*
49 193 Etienne Pallier
50 205 Etienne Pallier
* Affiner la fonctionnalité d’envoi automatique des emails :
51 205 Etienne Pallier
 
52 205 Etienne Pallier
 * 1) (NEW) l'envoi d'emails doit être désactivé par défaut lors de l'installation
53 205 Etienne Pallier
 * 2) on doit pouvoir activer ou désactiver cette fonctionnalité (c'est déjà le cas)
54 205 Etienne Pallier
 * quand on active cette option:
55 205 Etienne Pallier
56 207 Etienne Pallier
  * on doit pouvoir entrer les paramètres nécessaires pour l'ENVOI (smtp) des mails (comme pour le LDAP)
57 207 Etienne Pallier
  * on doit pouvoir rentrer une liste d'emails qui RECEVRONT ces mails
58 205 Etienne Pallier
  * (NEW) on doit avoir une liste d'actions (qui déclenchent l'envoi d'un email) qui s'affiche et que l'on peut cocher ou pas (ex: "création d'un nouveau matériel", "modification d'un matériel", "création d'un suivi", ...)
59 213 Thibaud Ajas
* -Pouvoir changer le nombre de matériels affichés par page (par défaut, c'est 20 et c'est parfois insuffisant...-
60 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).
61 193 Etienne Pallier
* Désactiver (ou simplement "limiter") l'envoi de mail aux responsables thématiques ou métiers :
62 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é)
63 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
64 193 Etienne Pallier
65 190 Etienne Pallier
*Demandes des utilisateurs (transmises par D. Rambaud le 19/12/16) :*
66 190 Etienne Pallier
67 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
68 197 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. Attention, la modification post-validation ne peut porter que sur les renseignements techniques complémentaires.
69 190 Etienne Pallier
70 190 Etienne Pallier
71 190 Etienne Pallier
*Suite à réunion du 27/10/16 avec le LATMOS, constat des modifs nécessaires:*
72 185 Etienne Pallier
73 189 Etienne Pallier
* L'étiqueteuse semble ne plus fonctionner alors qu'elle fonctionnait avant...
74 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])
75 187 Etienne Pallier
* Check Date achat <= Date Livraison !!!
76 185 Etienne Pallier
* Ajouter un statut : ajouter un statut « désinventorié «  ou «amorti ? » (à réfléchir)
77 185 Etienne Pallier
* Ajouter colonne statut « hors service » dans la vue "liste des matériels"
78 185 Etienne Pallier
* N° série : à remettre dans la section informations (pour que tout le monde le voie)
79 185 Etienne Pallier
* Empêcher duplication d'une fiche matériel si même numéro de série
80 185 Etienne Pallier
* Importation depuis Excel
81 204 Etienne Pallier
* Le champ "Local de stockage" a-t-il disparu ??? => à remettre
82 204 Etienne Pallier
* Site : champ optionnel
83 204 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)
84 204 Etienne Pallier
* (temporairement, on peut se contenter de CACHER certains champs, comme par exemple le champ "Site")
85 204 Etienne Pallier
* Suivis par fournisseur: ajouter la colonne "fournisseur" dans Suivi pour pouvoir trier la vue par fournisseur
86 204 Etienne Pallier
* Suivis relance : trouver un moyen de relancer automatiquement les suivis périodiques (ou bien avec une date programmée)
87 204 Etienne Pallier
* Emprunt dates: afficher les dates d'emprunt et de retour (date emprunt doit être obligatoire)
88 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)
89 185 Etienne Pallier
* supprimer profil AdminPlus, inutile
90 185 Etienne Pallier
91 185 Etienne Pallier
92 185 Etienne Pallier
93 192 Etienne Pallier
*Suite à l'installation à l'IRAP du 21/01/2016*:
94 1 Etienne Pallier
95 121 Alexandre Cases
- Si elle existe, supprimer table "fichiers"
96 120 Alexandre Cases
- Sauvegarder les utilisateurs
97 120 Alexandre Cases
- Transformer table "utilisateurs" en "users"
98 120 Alexandre Cases
- Ajout table "configuration"
99 120 Alexandre Cases
- Ajout clé étrangère emprunts (site_id)/suivis (type_suivi_id)
100 120 Alexandre Cases
- Transformation des données correspondantes
101 1 Etienne Pallier
- Suppression ancien champ emprunt (e_lieu_stockage), suivis (type_intervention)
102 120 Alexandre Cases
103 120 Alexandre Cases
104 192 Etienne Pallier
*Suite à l'installation à l'IAS du 09/03/2015*
105 120 Alexandre Cases
106 120 Alexandre Cases
- Ajout table "organismes", "type_suivis", "sites"
107 120 Alexandre Cases
- Ajout clé correspondante dans table "matériels"
108 120 Alexandre Cases
- Transformation des données correspondantes
109 120 Alexandre Cases
- Suppression anciens champs
110 120 Alexandre Cases
- Ajout table "documents"
111 120 Alexandre Cases
- Sauvegarder les utilisateurs
112 120 Alexandre Cases
- Transformer table "utilisateurs" en "users"
113 120 Alexandre Cases
- Ajout table "configuration"
114 120 Alexandre Cases
- Ajout clé étrangère emprunts (site_id)/suivis (type_suivi_id)
115 120 Alexandre Cases
- Transformation des données correspondantes
116 120 Alexandre Cases
- Suppression ancien champ emprunt (e_lieu_stockage), suivis (type_intervention)
117 1 Etienne Pallier
---
118 1 Etienne Pallier
119 101 Etienne Pallier
h2. Schéma de la base de données (v2.0.0)
120 9 Etienne Pallier
121 9 Etienne Pallier
122 180 Etienne Pallier
{{thumbnail(BDD_IRAP.png, size=2000, title=Pyros data model)}}
123 9 Etienne Pallier
124 174 Etienne Pallier
125 174 Etienne Pallier
126 174 Etienne Pallier
127 174 Etienne Pallier
128 174 Etienne Pallier
129 174 Etienne Pallier
---
130 209 Thibaud Ajas
131 210 Thibaud Ajas
h2. Utilisation du serveur web de dev de CakePHP (à la place de apache)
132 1 Etienne Pallier
133 210 Thibaud Ajas
/!\ Votre serveur MySQL doit être lancé !!!
134 210 Thibaud Ajas
135 208 Thibaud Ajas
* Se placer à la racine du projet.
136 208 Thibaud Ajas
137 208 Thibaud Ajas
* Lancer la commande suivante :
138 208 Thibaud Ajas
139 1 Etienne Pallier
 <pre> bin/cake server </pre>
140 208 Thibaud Ajas
141 210 Thibaud Ajas
* Rendez-vous sur http://localhost:8765/
142 208 Thibaud Ajas
143 208 Thibaud Ajas
---
144 174 Etienne Pallier
145 174 Etienne Pallier
h2. Cycle de vie du Matériel
146 174 Etienne Pallier
147 176 Etienne Pallier
148 182 Etienne Pallier
---
149 182 Etienne Pallier
150 176 Etienne Pallier
h3. Diagramme d'états-transitions
151 176 Etienne Pallier
152 179 Etienne Pallier
{{thumbnail(equipment_status_state_diagram.png, size=2000, title=Cycle de vie du matériel)}}
153 176 Etienne Pallier
154 182 Etienne Pallier
155 182 Etienne Pallier
---
156 176 Etienne Pallier
157 176 Etienne Pallier
h3. Diagramme de séquences
158 176 Etienne Pallier
159 178 Etienne Pallier
{{thumbnail(equipment_interactions_sequence_diagram.png, size=1500, title=Cycle de vie du matériel)}}
160 174 Etienne Pallier
161 174 Etienne Pallier
162 174 Etienne Pallier
163 9 Etienne Pallier
---
164 9 Etienne Pallier
165 181 Etienne Pallier
h2. ACL - Gestion des droits selon le profil
166 181 Etienne Pallier
167 184 Etienne Pallier
{{thumbnail(ACLs Droits selon les Roles.pdf, size=1500, title=Cycle de vie du matériel)}}
168 183 Etienne Pallier
169 183 Etienne Pallier
170 181 Etienne Pallier
171 181 Etienne Pallier
---
172 181 Etienne Pallier
173 12 Etienne Pallier
h2. ROADMAP - Plan de développement
174 12 Etienne Pallier
175 76 Etienne Pallier
Le stage se déroule de mi-avril à fin juin, soit sur 12 semaines (S1 à S12), ou 24 demi-semaines.
176 15 Etienne Pallier
_*(Ne pas oublier de rédiger le rapport de stage au fur et à mesure)*_
177 1 Etienne Pallier
178 12 Etienne Pallier
179 17 Etienne Pallier
Voir le détail de la roadmap: https://projects.irap.omp.eu/projects/inventirap/roadmap
180 17 Etienne Pallier
181 66 Etienne Pallier
|                    |   |_.Prévu |_.Réalisé |
182 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|
183 84 Etienne Pallier
                     |.2|
184 86 Etienne Pallier
|/2=.S02 (18/4-22/4) |.1|
185 84 Etienne Pallier
                     |.2|
186 86 Etienne Pallier
|/2=.S03 (25/4-29/4) |.1|
187 154 Alexandre Cases
                     |.2|/4=<."version 2.01 - Implémentation complète du CRUD":https://projects.irap.omp.eu/versions/101|
188 154 Alexandre Cases
|/2=.S04 (02/5-06/5) |.1|/4=<.version 2.01|
189 107 Alexandre Cases
                     |.2|
190 105 Etienne Pallier
|/2=.S05 (09/5-13/5) |.1|
191 154 Alexandre Cases
                     |.2|/3=<."version 2.02 - Implémentation de toutes les autres actions":https://projects.irap.omp.eu/versions/106|
192 154 Alexandre Cases
|/2=.S06 (16/5-20/5) |.1|/2=<.version 2.02|
193 138 Etienne Pallier
                     |.2|
194 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|
195 138 Etienne Pallier
                     |.2|
196 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)|
197 90 Etienne Pallier
                     |.2|
198 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|
199 90 Etienne Pallier
                     |.2|
200 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|
201 90 Etienne Pallier
                     |.2|
202 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|
203 154 Alexandre Cases
                     |.2|/2=<."version 2.08 - Cakephp3 + Php7 (compatible Php5)":https://projects.irap.omp.eu/versions/98|
204 154 Alexandre Cases
|/2=.S12 (27/6-30/6) |.1|
205 154 Alexandre Cases
                     |.2|/1=<."version 2.10 - Autres ajouts (+ fin rédaction rapport de stage)":https://projects.irap.omp.eu/versions/100|
206 99 Etienne Pallier
207 1 Etienne Pallier
---
208 1 Etienne Pallier
209 151 Etienne Pallier
h2. PROCEDURE à suivre pour un COMMIT
210 102 Etienne Pallier
211 100 Etienne Pallier
Voici les différentes étapes à respecter au moment de chaque commit:
212 98 Etienne Pallier
213 100 Etienne Pallier
*1) S'assurer que tous les tests passent toujours...*
214 98 Etienne Pallier
215 100 Etienne Pallier
*2) Mettre à jour le fichier README (ceci est un exemple, un template)*
216 98 Etienne Pallier
217 98 Etienne Pallier
Date: 11/05/2016
218 98 Etienne Pallier
Version: 2.1.9
219 98 Etienne Pallier
Mise à jour doc install
220 98 Etienne Pallier
(Attention, changement structure BDD)
221 98 Etienne Pallier
Demande (terminée): https://projects.irap.omp.eu/issues/3542
222 98 Etienne Pallier
Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
223 98 Etienne Pallier
224 98 Etienne Pallier
Remarques:
225 98 Etienne Pallier
=> Version: 2.1.9 = 9ème commit sur la version 2.1
226 98 Etienne Pallier
=> préciser "(bugfix)" si c'est le cas
227 1 Etienne Pallier
=> ajouter "(Attention, changement structure BDD)" s'il y a eu une modif de la BDD
228 1 Etienne Pallier
=> "Demande (terminée)" ou "Demande (en cours)", ou pas de demande du tout (exceptionnellement)
229 1 Etienne Pallier
=> ces infos permettront de savoir quelle version (et date) exacte du projet on a actuellement sur son disque
230 1 Etienne Pallier
231 1 Etienne Pallier
232 151 Etienne Pallier
*[3) S'il y a eu un changement de structure de la BD]*
233 1 Etienne Pallier
234 151 Etienne Pallier
* Mettre à jour le schéma de la BD (avec Mysql Workbench) dans le projet et sur le wiki (page "Documentation technique")
235 151 Etienne Pallier
236 151 Etienne Pallier
237 151 Etienne Pallier
*[4) Si c'est la fin d'une version majeure (2.0, 2.1, 2.2, ...)]*
238 151 Etienne Pallier
239 100 Etienne Pallier
* On doit normalement avoir écrit quelques nouveaux tests pour cette version !!!
240 100 Etienne Pallier
* Ajouter cette version en tête de la section "MAIN CHANGES (MILESTONES)" dans le fichier README
241 100 Etienne Pallier
* Mettre à jour la doc install/INSTALLATION à partir du wiki (si nécessaire)
242 1 Etienne Pallier
* Tester une installation du logiciel from scratch 
243 100 Etienne Pallier
244 100 Etienne Pallier
245 151 Etienne Pallier
*5) pull*
246 1 Etienne Pallier
247 1 Etienne Pallier
(au cas où quelqu'un d'autre aurait fait un push)
248 98 Etienne Pallier
249 98 Etienne Pallier
250 151 Etienne Pallier
*6) commit*
251 1 Etienne Pallier
252 151 Etienne Pallier
Dans le message de commit, faire un simple copier/coller des infos du fichier README (sauf date):
253 1 Etienne Pallier
254 1 Etienne Pallier
Version: 2.1.9
255 98 Etienne Pallier
Mise à jour doc install (bugfix)
256 98 Etienne Pallier
Demande (terminée): https://projects.irap.omp.eu/issues/3542
257 98 Etienne Pallier
Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
258 98 Etienne Pallier
259 98 Etienne Pallier
260 151 Etienne Pallier
*[7) push]*
261 100 Etienne Pallier
262 100 Etienne Pallier
(seulement si le commit est important/urgent, ou suite à un ensemble de commits sur un même thème)
263 98 Etienne Pallier
264 104 Etienne Pallier
265 104 Etienne Pallier
---
266 104 Etienne Pallier
267 7 Etienne Pallier
h2. Installation from scratch (Sous UBuntu)
268 1 Etienne Pallier
269 1 Etienne Pallier
h3. Création projet avec Composer
270 1 Etienne Pallier
271 1 Etienne Pallier
* Télécharger composer.phar : 
272 1 Etienne Pallier
"curl -s https://getcomposer.org/installer | php"
273 1 Etienne Pallier
274 1 Etienne Pallier
* Avec le Composer créer un nouveau projet : 
275 1 Etienne Pallier
"php composer.phar create-project --prefer-dist cakephp/app labinvent_2.0"
276 1 Etienne Pallier
277 1 Etienne Pallier
> Voir structure projet : http://book.cakephp.org/3.0/fr/intro/cakephp-folder-structure.html
278 1 Etienne Pallier
279 1 Etienne Pallier
* On rempli la base de données avec le fichier sql
280 1 Etienne Pallier
281 203 Thibaud Ajas
* On indique la BD utiliser à CakePHP dans le fichier config/app.php, propriété "Datasources".
282 1 Etienne Pallier
283 1 Etienne Pallier
* On se place à la racine du projet
284 1 Etienne Pallier
285 1 Etienne Pallier
* On génère le code Scaffold : 
286 1 Etienne Pallier
"bin/cake bake all nom_table" --> ça génére les modeles, les vues, et les controlleurs.
287 1 Etienne Pallier
288 1 Etienne Pallier
> Commande (en une fois) :
289 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
290 1 Etienne Pallier
291 1 Etienne Pallier
h3. Modification de la base de données 
292 1 Etienne Pallier
> Une version du sql corrigée au fur et à mesure est disponible dans le git :
293 22 Alexandre Cases
294 22 Alexandre Cases
> > Dans database/, le fichier labinvent_2.1_09-05-16 correspond à la création de la base.
295 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.
296 1 Etienne Pallier
297 1 Etienne Pallier
* Création table "config"
298 22 Alexandre Cases
299 22 Alexandre Cases
> > Mise à jour dans le fichier de création de base
300 22 Alexandre Cases
> > Mise à jour à part : db-update-2016-05-09.sql
301 1 Etienne Pallier
302 153 Etienne Pallier
h3. Autres remarques lors du développement
303 1 Etienne Pallier
304 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")...
305 1 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/contributing/cakephp-coding-conventions.html
306 1 Etienne Pallier
307 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.
308 1 Etienne Pallier
Le mot de passe "login" = "$2y$10$LZzpws3oDidBcqO/Fy1RTedLLk3ENTmplny5J7bZ6R1PqFoGOw3Ma".
309 131 Alexandre Cases
Le mot de passe vide "" = "$2y$10$nBQMNstgN.sgad1ZANznY.pbJI.ZG/.Q5qX4gC8SXCFQnDIZC8rcW".
310 1 Etienne Pallier
311 1 Etienne Pallier
* Vérifier que la migration vers la prochaine version de cakephp3 (3.3 ?) sera facile... (décrire la procédure à suivre)
312 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
313 21 Alexandre Cases
--> Puis il faut regarder les changements dans la page migration correspondant à la version voulu et adapter les changements au code.
314 1 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/appendices/3-2-migration-guide.html
315 21 Alexandre Cases
316 21 Alexandre Cases
* Outil (plugin) "DebugKit" de CakePHP3 : 
317 21 Alexandre Cases
--> DebugKit est un plugin qui fournit une toolbar pour aider à debugger les applications CakePHP plus facilement.
318 21 Alexandre Cases
--> Par défaut il est installé avec le squelette de l'application, pour l'activer, il faut se placer à la racine.
319 21 Alexandre Cases
--> Puis il faut éxécuter la ligne suivante : bin/cake plugin load DebugKit .
320 21 Alexandre Cases
--> La commande va aller modifier le fichier config bootstrap.php.
321 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.
322 21 Alexandre Cases
--> Le plugin nécessite l'extension php5-sqlite par défaut (il supporte l'équivalent avec de la config).
323 20 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/debug-kit.html
324 24 Alexandre Cases
325 25 Alexandre Cases
326 91 Alexandre Cases
* Mode debug personnaliser : 
327 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é.
328 91 Alexandre Cases
329 91 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/development/testing.html
330 31 Alexandre Cases
331 106 Alexandre Cases
* Pour charger une librairie (ex : phpqrcode, ...)
332 106 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/core-libraries/app.html#charger-les-fichiers-de-vendor
333 106 Alexandre Cases
334 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.
335 129 Alexandre Cases
> Voir : https://github.com/FriendsOfCake/CakePdf
336 122 Alexandre Cases
337 129 Alexandre Cases
* Pour le JavaScript, le JS Helper a été retiré 
338 128 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/appendices/3-0-migration-guide.html#jshelper
339 128 Alexandre Cases
340 157 Alexandre Cases
* Pour pouvoir éxécuter les tests depuis eclipse : 
341 157 Alexandre Cases
> Voir : http://blog.loftdigital.com/running-phpunit-tests-in-eclipse-pdt
342 157 Alexandre Cases
343 125 Alexandre Cases
* Avant de déployer l'application sur le serveur de production, optimiser les performances
344 125 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/deployment.html#ameliorer-les-performances-de-votre-application
345 156 Etienne Pallier
346 156 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}Installation sur Mac (retour des pb)%
347 156 Etienne Pallier
348 156 Etienne Pallier
1) install.sh
349 156 Etienne Pallier
=> 
350 156 Etienne Pallier
chmod: Unable to change file mode on ./webroot/img//gqbee0pkerrl8h2rbekaa3t8j1.png: Operation not permitted
351 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/models/myapp_cake_model_default_configurations: Operation not permitted
352 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/models/myapp_cake_model_default_documents: Operation not permitted
353 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_cake_fr__f_r: Operation not permitted
354 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
355 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_default_fr__f_r: Operation not permitted
356 156 Etienne Pallier
357 156 Etienne Pallier
358 156 Etienne Pallier
=> sudo chmod -R 777 ../webroot/img
359 156 Etienne Pallier
=> sudo chmod -R 777 ../tmp/
360 156 Etienne Pallier
(=> sudo chmod -R 777 ../vendor)
361 156 Etienne Pallier
362 156 Etienne Pallier
363 156 Etienne Pallier
2) connexion au site
364 156 Etienne Pallier
=> mauvais affichage pourri
365 156 Etienne Pallier
=> il faut configurer la BD dans app.php
366 156 Etienne Pallier
            'username' => 'labinvent2user',
367 156 Etienne Pallier
            'password' => 'labinvent2user',
368 156 Etienne Pallier
            'database' => 'labinvent2',
369 156 Etienne Pallier
370 156 Etienne Pallier
3) login
371 156 Etienne Pallier
=> epallier/login
372 156 Etienne Pallier
373 156 Etienne Pallier
374 163 Alexandre Cases
---
375 156 Etienne Pallier
376 163 Alexandre Cases
h2. Pour mettre à jour CakePHP
377 156 Etienne Pallier
378 165 Etienne Pallier
* Utiliser le composer : "php composer.phar update" à la racine de l'application
379 1 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/installation.html#rester-a-jour-avec-les-derniers-changements-de-cakephp
380 164 Alexandre Cases
381 164 Alexandre Cases
* Puis il faut modifier le fichier : ./vendor/cakephp/cakephp/src/View/Helper/PaginatorHelper.php
382 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".
383 164 Alexandre Cases
  Enfin dans le même tableau, il faut remplacer la ligne suivante : 
384 164 Alexandre Cases
> 'current' => '<span class="active"><a href="">{{text}}</a></span>',
385 164 Alexandre Cases
386 164 Alexandre Cases
           Par : 
387 164 Alexandre Cases
388 164 Alexandre Cases
> 'current' => '<span class="current">{{text}}</span>',
389 164 Alexandre Cases
390 172 Alexandre Cases
* Puis il faut vider le cache de l'application (et du navigateur) pour que debug_kit fonctionne.
391 172 Alexandre Cases
392 156 Etienne Pallier
393 156 Etienne Pallier
---
394 156 Etienne Pallier
395 167 Alexandre Cases
h2. Rappel d'intervention par mail
396 167 Alexandre Cases
397 170 Alexandre Cases
* Il faut définir un attribut *"rappel" de type "int"* dans la table suivis.
398 171 Alexandre Cases
Cet attribut peut avoir *4 valeurs* : 
399 169 Alexandre Cases
<pre>
400 169 Alexandre Cases
0 ==> Pas d'envoi de rappel programmé
401 169 Alexandre Cases
1 ==> Rappel programmé 1 mois avant
402 169 Alexandre Cases
2 ==> Rappel programmé 15 jours avant
403 169 Alexandre Cases
3 ==> Rappel programmé 2 jours avant
404 169 Alexandre Cases
</pre>
405 1 Etienne Pallier
406 173 Alexandre Cases
* Dans *l'AppController*, il faut définir une fonction "rappelIntervention()" qui :
407 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".
408 173 Alexandre Cases
- Met cette attribut à 1
409 173 Alexandre Cases
- 
410 1 Etienne Pallier
411 170 Alexandre Cases
...........................
412 170 Alexandre Cases
413 170 Alexandre Cases
* Dans *l'UsersController*, il faut executer la fonction précédente une fois que l'utilisateur est connecté (dans fonction login()).
414 167 Alexandre Cases
415 167 Alexandre Cases
---
416 167 Alexandre Cases
417 201 Thibaud Ajas
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}A L'ATTENTION DES UTILISATEURS D'ECLIPSE%
418 1 Etienne Pallier
419 211 Thibaud Ajas
*+0) Installer Eclipse (Si nécessaire), voire Java+*
420 1 Etienne Pallier
421 211 Thibaud Ajas
En effet, même si la version que vous allez installer est une version pour PHP, Eclipse à besoin de Java pour pouvoir s'exécuter.
422 211 Thibaud Ajas
Vérifiez que Java soit bien installé sur votre système :
423 211 Thibaud Ajas
<pre>
424 211 Thibaud Ajas
java -version
425 211 Thibaud Ajas
</pre>
426 211 Thibaud Ajas
Si ce n'est pas le cas, exécutez les lignes suivantes :
427 211 Thibaud Ajas
<pre>
428 211 Thibaud Ajas
sudo apt-add-repository ppa:webupd8team/java
429 211 Thibaud Ajas
sudo apt-get update
430 211 Thibaud Ajas
sudo apt-get install oracle-java8-installer
431 211 Thibaud Ajas
</pre>
432 211 Thibaud Ajas
433 211 Thibaud Ajas
Pour installer Eclipse, allez sur : http://www.eclipse.org/downloads/packages/release/Neon/3
434 1 Etienne Pallier
Selectionnez la version que vous désirez (Neon, Oxygen, Mars ...) puis sélectionnez "Eclipse for PHP Developers".
435 1 Etienne Pallier
Téléchargez la version correspondant à votre système d'exploitation.
436 211 Thibaud Ajas
Placez-vous dans le dossier ou vou voulez installer Eclipse avec l'archive précédement téléchargée (renommez-la en eclipse.tar.gz), puis exécutez la commande suivante :
437 211 Thibaud Ajas
<pre>
438 211 Thibaud Ajas
tar -zxvf eclipse.tar.gz
439 211 Thibaud Ajas
</pre>
440 1 Etienne Pallier
441 211 Thibaud Ajas
Si vous voulez Eclipse dans le menu des applications sous Ubuntu, il vous faudra crééer le fichier eclipse.desktop :
442 211 Thibaud Ajas
<pre>
443 211 Thibaud Ajas
gksudo gedit /usr/share/applications/eclipse.desktop
444 211 Thibaud Ajas
</pre>
445 212 Etienne Pallier
puis collez-y ce qui suit, en modifiant le chemin des lignes Exec et Icon au besoin :
446 211 Thibaud Ajas
<pre>
447 211 Thibaud Ajas
[Desktop Entry]
448 211 Thibaud Ajas
Name=Eclipse 
449 211 Thibaud Ajas
Type=Application
450 211 Thibaud Ajas
Exec=/opt/eclipse/eclipse
451 211 Thibaud Ajas
Terminal=false
452 211 Thibaud Ajas
Icon=/opt/eclipse/icon.xpm
453 211 Thibaud Ajas
Comment=Integrated Development Environment
454 211 Thibaud Ajas
NoDisplay=false
455 211 Thibaud Ajas
Categories=Development;IDE
456 211 Thibaud Ajas
Name[en]=eclipse.desktop
457 211 Thibaud Ajas
</pre>
458 211 Thibaud Ajas
459 211 Thibaud Ajas
Puis donnez les droits à tous les utilisateurs sur ce fichier :
460 211 Thibaud Ajas
<pre>
461 211 Thibaud Ajas
sudo chmod a+r /usr/share/applications/eclipse.desktop
462 211 Thibaud Ajas
</pre>
463 1 Etienne Pallier
464 202 Thibaud Ajas
*+1) Désactiver la vérification du certificat+*
465 1 Etienne Pallier
466 1 Etienne Pallier
Window -> Preferences -> Team -> git -> configuration -> Add entry
467 1 Etienne Pallier
468 1 Etienne Pallier
Key = http.sslVerify
469 1 Etienne Pallier
Value = false
470 1 Etienne Pallier
471 202 Thibaud Ajas
*+2) Récupérer le projet+*
472 1 Etienne Pallier
473 200 Thibaud Ajas
*(Si le projet git n'existe pas déjà sur votre machine)*
474 200 Thibaud Ajas
475 1 Etienne Pallier
File/Import project from git
476 1 Etienne Pallier
477 1 Etienne Pallier
Select repository source: Clone URI: https://gitlab.irap.omp.eu/epallier/labinvent.git
478 1 Etienne Pallier
479 1 Etienne Pallier
Directory: 
480 1 Etienne Pallier
- par défaut, il propose : /Users/epallier/git/labinvent
481 1 Etienne Pallier
- mais on peut le mettre n'importe où ailleurs, 
482 1 Etienne Pallier
par exemple, on pourrait le mettre directement dans le repertoire web de Apache:
483 1 Etienne Pallier
/Applications/XAMPP/xamppfiles/htdocs 
484 1 Etienne Pallier
(si on veut que le projet s'execute directement dans le dossier web apache htdocs, mais ca n'est pas obligatoire...)
485 1 Etienne Pallier
486 1 Etienne Pallier
initial branch: master
487 1 Etienne Pallier
remote name: origin
488 1 Etienne Pallier
489 1 Etienne Pallier
Import as general project
490 1 Etienne Pallier
491 1 Etienne Pallier
Project name: LABINVENT
492 1 Etienne Pallier
493 200 Thibaud Ajas
*(si le projet git existe déjà sur votre machine)*
494 1 Etienne Pallier
495 200 Thibaud Ajas
File/Import project from git
496 200 Thibaud Ajas
    
497 200 Thibaud Ajas
Existing local repository
498 1 Etienne Pallier
499 200 Thibaud Ajas
Directory
500 1 Etienne Pallier
501 200 Thibaud Ajas
ADD => Selectionnez le dossier contenant le projet git => Finish => Next
502 200 Thibaud Ajas
503 1 Etienne Pallier
Import existing Eclipse project
504 200 Thibaud Ajas
505 200 Thibaud Ajas
Selectionner le projet => Search for nested project => finish
506 200 Thibaud Ajas
507 200 Thibaud Ajas
508 202 Thibaud Ajas
*+3) Configurer le projet+*
509 200 Thibaud Ajas
510 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)
511 1 Etienne Pallier
Si ça n'est pas le cas, vérifier que le fichier .project (à la racine) contient bien
512 1 Etienne Pallier
	<natures>
513 1 Etienne Pallier
		<nature>org.eclipse.php.core.PHPNature</nature>
514 1 Etienne Pallier
	</natures>
515 1 Etienne Pallier
NB : Le fichier .project est normalement versionné et donc le projet labinvent devrait être reconnu automatiquement comme projet PHP
516 1 Etienne Pallier
517 1 Etienne Pallier
518 1 Etienne Pallier
b) S'assurer que les fichiers de vue de cakephp ("*.ctp") sont bien reconnus comme des fichiers PHP.
519 1 Etienne Pallier
Pour tester cela, ouvrir le fichier de vue cakephp/app/View/Categories/get_all.ctp
520 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. 
521 1 Etienne Pallier
Il faut donc associer l'editeur Php a l'extension de fichier "*.ctp" :
522 1 Etienne Pallier
- Preferences/General/Content types
523 1 Etienne Pallier
- Dans la liste "Content types", ouvrir la section "Text", selectionner PHP
524 1 Etienne Pallier
- Ajouter l'extension "*.ctp"
525 1 Etienne Pallier
526 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) :
527 1 Etienne Pallier
- Clic-droit sur le projet, Propriétés
528 1 Etienne Pallier
- PHP
529 1 Etienne Pallier
- Interpreter
530 1 Etienne Pallier
- Enable project specific settings, PHP Version : "PHP 5.6"
531 1 Etienne Pallier
532 1 Etienne Pallier
d) S'assurer que le texte est bien encodé en UTF-8 par défaut :
533 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
534 1 Etienne Pallier
(
535 1 Etienne Pallier
Il faudrait commiter ça mais je ne sais pas trop si c'est risqué ou pas.
536 1 Etienne Pallier
Les fichiers concernés sont :
537 1 Etienne Pallier
- .project (déjà versionné) : car il commence par la ligne "<?xml version="1.0" encoding="UTF-8"?>"
538 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"
539 1 Etienne Pallier
)
540 1 Etienne Pallier
541 1 Etienne Pallier
Les éléments suivants sont normalement DEJA ignorés par git, à vérifier :
542 1 Etienne Pallier
- .settings/
543 1 Etienne Pallier
- cakephp/app/tmp/ : tout sauf 
544 1 Etienne Pallier
	- documents/
545 1 Etienne Pallier
- cakephp/app/Config/ :
546 1 Etienne Pallier
	- database.php
547 1 Etienne Pallier
	- labinvent.php
548 1 Etienne Pallier
549 1 Etienne Pallier
550 1 Etienne Pallier
551 1 Etienne Pallier
552 1 Etienne Pallier
553 1 Etienne Pallier
<pre>
554 1 Etienne Pallier
*********************************************************
555 1 Etienne Pallier
REMARQUES INTERRESSANTES (MAIS VOUS POUVEZ LES IGNORER)
556 1 Etienne Pallier
557 1 Etienne Pallier
// DEBUT DES REMARQUES
558 1 Etienne Pallier
559 1 Etienne Pallier
A la racine du projet, j'ai plusieurs éléments cachés de configuration Eclipse :
560 1 Etienne Pallier
561 1 Etienne Pallier
1) fichier .buildpath 
562 1 Etienne Pallier
Il est versionné puisque "svn status .buildpath" (depuis la console) ne donne rien
563 1 Etienne Pallier
Il contient :
564 1 Etienne Pallier
565 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
566 1 Etienne Pallier
<buildpath>
567 1 Etienne Pallier
        <buildpathentry kind="con" path="org.eclipse.php.core.LANGUAGE"/>
568 1 Etienne Pallier
        <buildpathentry kind="lib" path="docs/mockup/mockup_html.zip"/>
569 1 Etienne Pallier
        <buildpathentry kind="src" path="cakephp"/>
570 1 Etienne Pallier
</buildpath>
571 1 Etienne Pallier
572 1 Etienne Pallier
2) fichier .project
573 1 Etienne Pallier
Il est déjà versionné
574 1 Etienne Pallier
Il contient :
575 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
576 1 Etienne Pallier
<projectDescription>
577 1 Etienne Pallier
        <name>invirap</name>
578 1 Etienne Pallier
        <comment></comment>
579 1 Etienne Pallier
        <projects>
580 1 Etienne Pallier
        </projects>
581 1 Etienne Pallier
        <buildSpec>
582 1 Etienne Pallier
                <buildCommand>
583 1 Etienne Pallier
                        <name>org.eclipse.wst.common.project.facet.core.builder</name>
584 1 Etienne Pallier
                        <arguments>
585 1 Etienne Pallier
                        </arguments>
586 1 Etienne Pallier
                </buildCommand>
587 1 Etienne Pallier
                <buildCommand>
588 1 Etienne Pallier
                        <name>org.eclipse.wst.validation.validationbuilder</name>
589 1 Etienne Pallier
                        <arguments>
590 1 Etienne Pallier
                        </arguments>
591 1 Etienne Pallier
                </buildCommand>
592 1 Etienne Pallier
                <buildCommand>
593 1 Etienne Pallier
                        <name>org.eclipse.dltk.core.scriptbuilder</name>
594 1 Etienne Pallier
                        <arguments>
595 1 Etienne Pallier
                        </arguments>
596 1 Etienne Pallier
                </buildCommand>
597 1 Etienne Pallier
        </buildSpec>
598 1 Etienne Pallier
        <natures>
599 1 Etienne Pallier
                <nature>org.eclipse.php.core.PHPNature</nature>
600 1 Etienne Pallier
                <nature>org.eclipse.wst.common.project.facet.core.nature</nature>
601 1 Etienne Pallier
        </natures>
602 1 Etienne Pallier
</projectDescription>
603 1 Etienne Pallier
604 1 Etienne Pallier
3) dossier .settings/ (exclus de svn)
605 1 Etienne Pallier
Il contient 3 fichiers :
606 1 Etienne Pallier
607 1 Etienne Pallier
- org.eclipse.core.resources.prefs : bizarrement, il ne contient que quelques références seulement :
608 1 Etienne Pallier
eclipse.preferences.version=1
609 1 Etienne Pallier
encoding//cakephp/app/Controller/MaterielsController.php=UTF-8
610 1 Etienne Pallier
encoding//cakephp/app/View/Elements/menu_view.ctp=UTF-8
611 1 Etienne Pallier
encoding//cakephp/app/View/Layouts/default.ctp=UTF-8
612 1 Etienne Pallier
encoding//cakephp/app/View/Materiels/index.ctp=UTF-8
613 1 Etienne Pallier
encoding//cakephp/app/View/Materiels/scaffold.view.ctp=UTF-8
614 1 Etienne Pallier
encoding//database/Upd_TableConstraints.sql=UTF-8
615 1 Etienne Pallier
encoding//database/update/README.txt=UTF-8
616 1 Etienne Pallier
encoding//docs/HOWTO.txt=UTF-8
617 1 Etienne Pallier
encoding//install/HOWTO.txt=UTF-8
618 1 Etienne Pallier
encoding/<project>=UTF-8
619 1 Etienne Pallier
620 1 Etienne Pallier
- org.eclipse.php.core.prefs
621 1 Etienne Pallier
eclipse.preferences.version=1
622 1 Etienne Pallier
include_path=0;/invirap\u00051;/invirap/docs/mockup/mockup_html.zip
623 1 Etienne Pallier
624 1 Etienne Pallier
- org.eclipse.wst.common.project.facet.core.xml : sans doute inutile ? (lié à "Faceted Project Validation Builder" dans Properties/Builders)
625 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
626 1 Etienne Pallier
<faceted-project>
627 1 Etienne Pallier
  <fixed facet="php.core.component"/>
628 1 Etienne Pallier
  <fixed facet="php.component"/>
629 1 Etienne Pallier
  <installed facet="php.core.component" version="1"/>
630 1 Etienne Pallier
  <installed facet="php.component" version="5.4"/>
631 1 Etienne Pallier
</faceted-project>
632 1 Etienne Pallier
633 1 Etienne Pallier
// FIN DES REMARQUES
634 1 Etienne Pallier
*********************************************************
635 1 Etienne Pallier
</pre>
636 1 Etienne Pallier
637 200 Thibaud Ajas
*+4) (TODO:) Set Code style+*
638 1 Etienne Pallier
639 1 Etienne Pallier
Window/Preferences : PHP / Editor
640 1 Etienne Pallier
...
641 1 Etienne Pallier
642 200 Thibaud Ajas
*+5) (TODO:) virtualenv+*
643 200 Thibaud Ajas
644 200 Thibaud Ajas
Now, once the PHP5 virtual environment is installed (see above),
645 1 Etienne Pallier
set it in Eclipse as the project interpreter:
646 1 Etienne Pallier
647 1 Etienne Pallier
(cf http://virtphp.org)
648 1 Etienne Pallier
649 1 Etienne Pallier
...
650 1 Etienne Pallier
651 200 Thibaud Ajas
*+6) (TODO:) Test+*
652 1 Etienne Pallier
653 1 Etienne Pallier
654 200 Thibaud Ajas
*+7) (TODO:) Run+*
655 1 Etienne Pallier
656 1 Etienne Pallier
check http://localhost:8080/