Developpement

Version 404 (Etienne Pallier, 07/05/2017 03:52 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 254 Etienne Pallier
* *DEMANDES (TODO LIST) : https://projects.irap.omp.eu/projects/inventirap/issues?query_id=222*
15 250 Etienne Pallier
16 251 Etienne Pallier
* *ROADMAP (VERSIONS) : https://projects.irap.omp.eu/projects/inventirap/roadmap?utf8=%E2%9C%93&tracker_ids%5B%5D=1&tracker_ids%5B%5D=2&tracker_ids%5B%5D=4&tracker_ids%5B%5D=5&tracker_ids%5B%5D=6&tracker_ids%5B%5D=7&tracker_ids%5B%5D=8&tracker_ids%5B%5D=9&with_subprojects=0&with_subprojects=1#version_2.5.x*
17 250 Etienne Pallier
18 252 Etienne Pallier
* Version numbering : http://semver.org
19 252 Etienne Pallier
20 97 Etienne Pallier
* HOWTO Format Redmine Wiki : http://www.redmine.org/projects/redmine/wiki/FrRedmineWikiFormatting
21 94 Etienne Pallier
22 96 Etienne Pallier
* [[Installation|Page wiki pour l'installation]]
23 1 Etienne Pallier
24 93 Etienne Pallier
* Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
25 93 Etienne Pallier
26 92 Etienne Pallier
* Liste complète des évolutions: https://gitlab.irap.omp.eu/epallier/labinvent/commits/master
27 1 Etienne Pallier
28 92 Etienne Pallier
* Browse files (gitlab): https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
29 1 Etienne Pallier
30 92 Etienne Pallier
* Inventirap 1.3 (prod): https://inventirap.irap.omp.eu
31 1 Etienne Pallier
32 92 Etienne Pallier
* Inventirap 1.3 (test): https://inventirap-test.irap.omp.eu/
33 92 Etienne Pallier
34 309 Etienne Pallier
* *CakePhp*:
35 1 Etienne Pallier
36 92 Etienne Pallier
 * ROADMAP: https://github.com/cakephp/cakephp/wiki
37 380 Etienne Pallier
 * *Migrations* plugin: http://book.cakephp.org/3.0/fr/migrations.html
38 310 Etienne Pallier
 * *CONVENTIONS*: https://book.cakephp.org/3.0/fr/intro/conventions.html
39 382 Etienne Pallier
 * Déploiement : https://book.cakephp.org/3.0/fr/deployment.html
40 93 Etienne Pallier
 * Forum cakephp: http://discourse.cakephp.org
41 381 Etienne Pallier
 * Debug Kit : https://book.cakephp.org/3.0/fr/debug-kit.html
42 93 Etienne Pallier
 * Quickstart tutorial: http://book.cakephp.org/3.0/en/quickstart.html
43 1 Etienne Pallier
 * Bookmarker tutorial: https://github.com/cakephp/bookmarker-tutorial
44 93 Etienne Pallier
 * Cakephp CRUD: https://github.com/FriendsOfCake/crud
45 380 Etienne Pallier
 * Plugin Chronos pour gérer les dates plus facilement : https://book.cakephp.org/3.0/fr/chronos.html
46 1 Etienne Pallier
47 1 Etienne Pallier
---
48 1 Etienne Pallier
49 363 Etienne Pallier
h2. CONVENTIONS CAKEPHP
50 1 Etienne Pallier
51 363 Etienne Pallier
https://book.cakephp.org/3.0/fr/intro/conventions.html
52 1 Etienne Pallier
53 363 Etienne Pallier
54 374 Etienne Pallier
* *+SYNTHÈSE GÉNÉRALE+*
55 1 Etienne Pallier
56 374 Etienne Pallier
En utilisant les conventions CakePHP dans le nommage des différentes parties de votre application, vous gagnerez des fonctionnalités sans les tracas et les affres de la configuration. Voici un exemple récapitulant les conventions abordées :
57 374 Etienne Pallier
58 374 Etienne Pallier
<pre>
59 374 Etienne Pallier
    Nom de la table de la base de données: “articles”
60 374 Etienne Pallier
    Classe Table: ArticlesTable se trouvant dans src/Model/Table/ArticlesTable.php
61 374 Etienne Pallier
    Classe Entity: Article se trouvant dans src/Model/Entity/Article.php
62 374 Etienne Pallier
    Classe Controller: ArticlesController se trouvant dans src/Controller/ArticlesController.php
63 374 Etienne Pallier
    Template de View se trouvant dans src/Template/Articles/index.ctp
64 374 Etienne Pallier
</pre>
65 374 Etienne Pallier
66 374 Etienne Pallier
En utilisant ces conventions, CakePHP sait qu’une requête de type http://exemple.com/articles/ sera liée à un appel à la fonction index() du Controller ArticlesController, dans lequel le model Articles est automatiquement disponible (et automatiquement lié à la table ‘articles’ dans la base) et rendue dans un fichier. Aucune de ces relations n’a été configurée par rien d’autre que la création des classes et des fichiers dont vous aviez besoin de toute façon.
67 374 Etienne Pallier
68 374 Etienne Pallier
69 373 Etienne Pallier
* *+Controleurs+*
70 365 Etienne Pallier
71 365 Etienne Pallier
noms des classes de controller sont au pluriel, en CamelCase et se terminent par Controller. UsersController et ArticleCategoriesController sont des exemples respectant cette convention
72 365 Etienne Pallier
73 365 Etienne Pallier
les méthodes publiques des controllers sont souvent exposées comme des ‘actions’ accessibles via un navigateur web. Par exemple /users/view correspond à la méthode view() de UsersController sans rien modifier. Les méthodes privées ou protégées ne sont pas accessibles avec le routing
74 365 Etienne Pallier
75 365 Etienne Pallier
UsersController (qui serait défini dans le nom de fichier UsersController.php) est accessible à l’adresse http://exemple.com/users.
76 365 Etienne Pallier
77 365 Etienne Pallier
/article-categories/view-all est la bonne forme pour accéder à l’action ArticleCategoriesController::viewAll()
78 365 Etienne Pallier
79 365 Etienne Pallier
Quand vous créez des liens en utilisant this->Html->link(), vous pouvez utiliser les conventions suivantes pour le tableau d’url:
80 365 Etienne Pallier
81 366 Etienne Pallier
<pre>
82 365 Etienne Pallier
$this->Html->link('link-title', [
83 365 Etienne Pallier
    'prefix' => 'MyPrefix' // CamelCased
84 365 Etienne Pallier
    'plugin' => 'MyPlugin', // CamelCased
85 365 Etienne Pallier
    'controller' => 'ControllerName', // CamelCased
86 365 Etienne Pallier
    'action' => 'actionName' // camelBacked
87 365 Etienne Pallier
]
88 366 Etienne Pallier
</pre>
89 363 Etienne Pallier
90 363 Etienne Pallier
91 373 Etienne Pallier
* *+Fichiers et noms de Classe+*
92 368 Etienne Pallier
93 368 Etienne Pallier
En général, les noms de fichiers correspondent aux noms des classes et suivent les standards PSR-0 et PSR-4 pour l’autoloading (chargement automatique). 
94 368 Etienne Pallier
Voici quelques exemples de noms de classes et de fichiers:
95 368 Etienne Pallier
96 372 Etienne Pallier
<pre>
97 368 Etienne Pallier
    La classe controller LatestArticlesController devra se trouver dans un fichier nommé LatestArticlesController.php.
98 368 Etienne Pallier
    La classe Component (Composant) MyHandyComponent devra se trouver dans un fichier nommé MyHandyComponent.php.
99 368 Etienne Pallier
    La classe Table OptionValuesTable devra se trouver dans un fichier nommé OptionValuesTable.php.
100 368 Etienne Pallier
    La classe Entity OptionValue devra se trouver dans un fichier nommé OptionValue.php.
101 368 Etienne Pallier
    La classe Behavior (Comportement) EspeciallyFunkableBehavior devra se trouver dans un fichier nommé EspeciallyFunkableBehavior.php.
102 368 Etienne Pallier
    La classe View (Vue) SuperSimpleView devra se trouver dans un fichier nommé SuperSimpleView.ctp.
103 368 Etienne Pallier
    La classe Helper (Assistant) BestEverHelper devra se trouver dans un fichier nommé BestEverHelper.php.
104 372 Etienne Pallier
</pre>
105 368 Etienne Pallier
106 368 Etienne Pallier
Chaque fichier sera situé dans le répertoire/namespace approprié dans le dossier de votre application.
107 368 Etienne Pallier
108 368 Etienne Pallier
109 375 Etienne Pallier
* *+Modèles et Bases de Données+*
110 368 Etienne Pallier
111 368 Etienne Pallier
Les noms de classe de *model* sont au *pluriel, en CamelCase et finissent par Table*. *UsersTable, ArticleCategoriesTable et UserFavoritePagesTable* en sont des exemples.
112 368 Etienne Pallier
113 368 Etienne Pallier
Les noms de *tables* correspondant aux models CakePHP sont au *pluriel et utilisent le caractère souligné* (underscore). Les tables correspondantes aux models mentionnés ci-dessus seront donc respectivement : *users, article_categories et user_favorite_pages*.
114 368 Etienne Pallier
115 370 Etienne Pallier
La convention est d’utiliser des *mots anglais pour les noms de colonne et de table*. Si vous utilisez des mots dans une autre langue, CakePHP ne va pas pouvoir convertir correctement les bonnes inflections (du singulier vers le pluriel et vice-versa). Dans certains cas, *si vous souhaitez ajouter vos propres règles pour des mots d’une autre langue, vous pouvez utiliser la classe utilitaire Cake\Utility\Inflector*.
116 368 Etienne Pallier
117 371 Etienne Pallier
Les *noms des champs avec deux mots ou plus* doivent être avec des *underscores* comme ici : *first_name*.
118 373 Etienne Pallier
119 371 Etienne Pallier
Les *clés étrangères des relations hasMany, belongsTo ou hasOne* sont *reconnues par défaut grâce au nom (singulier) de la table associée, suivi de _id*. Donc, si *Users hasMany Articles, la table articles se référera à la table users via une clé étrangère user_id*. Pour une table avec un nom de plusieurs mots comme *article_categories, la clé étrangère sera article_category_id*.
120 371 Etienne Pallier
121 371 Etienne Pallier
Les *tables de jointure utilisées dans les relations BelongsToMany* entre models doivent être *nommées d’après le nom des tables qu’elles unissent, dans l’ordre alphabétique (articles_tags plutôt que tags_articles)*.
122 372 Etienne Pallier
123 371 Etienne Pallier
124 375 Etienne Pallier
* *+Vues+*
125 371 Etienne Pallier
126 371 Etienne Pallier
Les fichiers de *template de view* sont nommés d’après les fonctions du controller qu’elles affichent, sous une forme avec underscores. La fonction *viewAll() de la classe ArticlesController cherchera un gabarit de view dans src/Template/Articles/view_all.ctp*.
127 371 Etienne Pallier
128 372 Etienne Pallier
Le schéma classique est *src/Template/Controller/nom_de_fonction_avec_underscore.ctp*.
129 371 Etienne Pallier
130 371 Etienne Pallier
131 363 Etienne Pallier
132 189 Etienne Pallier
133 188 Etienne Pallier
---
134 187 Etienne Pallier
135 393 Etienne Pallier
h2. TODOLIST
136 393 Etienne Pallier
137 393 Etienne Pallier
138 393 Etienne Pallier
NOUVEAUX BUGS (au 30/6/17) :
139 393 Etienne Pallier
140 397 Etienne Pallier
bugfix
141 398 Etienne Pallier
- BD test_labinvent pas créée automatiquement avec install.sh ? (j'ai dû la créer à la main !!)
142 397 Etienne Pallier
143 397 Etienne Pallier
ajouts:
144 403 Etienne Pallier
- faire une version docker pour éviter d'avoir à gérer différents OS : Mac (avec XAMPP), CentOS, Ubuntu, Fedora, etc.
145 400 Etienne Pallier
- généraliser bouton CANCEL
146 397 Etienne Pallier
- boolean "empruntable" pour materiel qu'on peut emprunter => permet recherche des matériels empruntables et voir disponibilité
147 393 Etienne Pallier
- matos/add : date enlever un chiffre à année => plante sur DateTime
148 393 Etienne Pallier
- matos/view : éviter d'afficher "€" quand pas de prix
149 393 Etienne Pallier
- matos/add : il faut pouvoir changer le proprio (resp+)
150 393 Etienne Pallier
- delete suivi : ramener sur le materiel et non pas sur la liste des suivis
151 393 Etienne Pallier
- éviter de commiter tout vendor, mais seulement composer.json puis install
152 393 Etienne Pallier
- héritage templates : ok + cancel pour tous les forms
153 404 Etienne Pallier
- ameliorer pagination : http://www.sanisoft.com/blog/2014/07/28/change-markup-for-pagination-cakephp3/
154 393 Etienne Pallier
- bug find 
155 393 Etienne Pallier
	technique ET administratif = technique seulement
156 393 Etienne Pallier
	administratif seulement = administratif
157 393 Etienne Pallier
158 393 Etienne Pallier
- materiels/find : chercher labo : on en trouve seulement 100 alors qu'il y en a plus
159 393 Etienne Pallier
- recup script upgrade cakephp + php (+phpunit)
160 393 Etienne Pallier
- passer à version 2.7
161 394 Etienne Pallier
- pagination: ameliorer la css inventirap.css
162 393 Etienne Pallier
- expliquer soucis avec cake.css : comment a-t-elle été désactivée ?
163 185 Etienne Pallier
164 364 Etienne Pallier
*La liste des demandes à jour se trouve ici* : https://projects.irap.omp.eu/projects/inventirap/issues?query_id=222_
165 364 Etienne Pallier
166 185 Etienne Pallier
*_NB: Cette liste est OBSOLÈTE (ici à titre indicatif, pour se souvenir des retours de réunion)_*
167 185 Etienne Pallier
168 185 Etienne Pallier
*Demandes des utilisateurs (transmises par D. Rambaud le 19/12/16) :*
169 204 Etienne Pallier
170 204 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
171 204 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.
172 204 Etienne Pallier
173 204 Etienne Pallier
174 204 Etienne Pallier
*Suite à réunion du 27/10/16 avec le LATMOS, constat des modifs nécessaires:*
175 204 Etienne Pallier
176 185 Etienne Pallier
* L'étiqueteuse semble ne plus fonctionner alors qu'elle fonctionnait avant...
177 185 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])
178 185 Etienne Pallier
* Check Date achat <= Date Livraison !!!
179 185 Etienne Pallier
* Ajouter un statut : ajouter un statut « désinventorié «  ou «amorti ? » (à réfléchir)
180 185 Etienne Pallier
* Ajouter colonne statut « hors service » dans la vue "liste des matériels"
181 192 Etienne Pallier
* N° série : à remettre dans la section informations (pour que tout le monde le voie)
182 1 Etienne Pallier
* Empêcher duplication d'une fiche matériel si même numéro de série
183 121 Alexandre Cases
* Importation depuis Excel
184 120 Alexandre Cases
* Le champ "Local de stockage" a-t-il disparu ??? => à remettre
185 120 Alexandre Cases
* Site : champ optionnel
186 120 Alexandre Cases
* 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)
187 120 Alexandre Cases
* (temporairement, on peut se contenter de CACHER certains champs, comme par exemple le champ "Site")
188 120 Alexandre Cases
* Suivis par fournisseur: ajouter la colonne "fournisseur" dans Suivi pour pouvoir trier la vue par fournisseur
189 1 Etienne Pallier
* Suivis relance : trouver un moyen de relancer automatiquement les suivis périodiques (ou bien avec une date programmée)
190 120 Alexandre Cases
* Emprunt dates: afficher les dates d'emprunt et de retour (date emprunt doit être obligatoire)
191 120 Alexandre Cases
* 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)
192 192 Etienne Pallier
* supprimer profil AdminPlus, inutile
193 120 Alexandre Cases
194 120 Alexandre Cases
195 120 Alexandre Cases
196 120 Alexandre Cases
*Suite à l'installation à l'IRAP du 21/01/2016*:
197 120 Alexandre Cases
198 120 Alexandre Cases
- Si elle existe, supprimer table "fichiers"
199 120 Alexandre Cases
- Sauvegarder les utilisateurs
200 120 Alexandre Cases
- Transformer table "utilisateurs" en "users"
201 120 Alexandre Cases
- Ajout table "configuration"
202 120 Alexandre Cases
- Ajout clé étrangère emprunts (site_id)/suivis (type_suivi_id)
203 120 Alexandre Cases
- Transformation des données correspondantes
204 120 Alexandre Cases
- Suppression ancien champ emprunt (e_lieu_stockage), suivis (type_intervention)
205 1 Etienne Pallier
206 1 Etienne Pallier
207 101 Etienne Pallier
*Suite à l'installation à l'IAS du 09/03/2015*
208 9 Etienne Pallier
209 9 Etienne Pallier
- Ajout table "organismes", "type_suivis", "sites"
210 180 Etienne Pallier
- Ajout clé correspondante dans table "matériels"
211 9 Etienne Pallier
- Transformation des données correspondantes
212 174 Etienne Pallier
- Suppression anciens champs
213 174 Etienne Pallier
- Ajout table "documents"
214 174 Etienne Pallier
- Sauvegarder les utilisateurs
215 174 Etienne Pallier
- Transformer table "utilisateurs" en "users"
216 174 Etienne Pallier
- Ajout table "configuration"
217 174 Etienne Pallier
- Ajout clé étrangère emprunts (site_id)/suivis (type_suivi_id)
218 209 Thibaud Ajas
- Transformation des données correspondantes
219 210 Thibaud Ajas
- Suppression ancien champ emprunt (e_lieu_stockage), suivis (type_intervention)
220 1 Etienne Pallier
---
221 210 Thibaud Ajas
222 386 Etienne Pallier
h2. Modèle de données (Data model)
223 1 Etienne Pallier
224 356 Etienne Pallier
225 386 Etienne Pallier
h3. Schéma de la base de données (v2.6)
226 1 Etienne Pallier
227 386 Etienne Pallier
{{thumbnail(BDD_schema.png, size=2000, title=Labinvent data model 2.6)}}
228 356 Etienne Pallier
229 389 Etienne Pallier
h3. Schéma de la base de données (v2.0)
230 388 Etienne Pallier
231 388 Etienne Pallier
232 388 Etienne Pallier
{{thumbnail(BDD_IRAP.png, size=2000, title=Labinvent data model 2.0)}}
233 388 Etienne Pallier
234 388 Etienne Pallier
235 388 Etienne Pallier
236 388 Etienne Pallier
237 388 Etienne Pallier
238 388 Etienne Pallier
239 388 Etienne Pallier
---
240 388 Etienne Pallier
241 174 Etienne Pallier
h2. Cycle de vie du Matériel
242 174 Etienne Pallier
243 174 Etienne Pallier
244 9 Etienne Pallier
---
245 9 Etienne Pallier
246 181 Etienne Pallier
h3. Diagramme d'états-transitions
247 181 Etienne Pallier
248 184 Etienne Pallier
{{thumbnail(equipment_status_state_diagram.png, size=2000, title=Cycle de vie du matériel)}}
249 183 Etienne Pallier
250 183 Etienne Pallier
251 181 Etienne Pallier
---
252 181 Etienne Pallier
253 181 Etienne Pallier
h3. Diagramme de séquences
254 12 Etienne Pallier
255 12 Etienne Pallier
{{thumbnail(equipment_interactions_sequence_diagram.png, size=1500, title=Cycle de vie du matériel)}}
256 76 Etienne Pallier
257 15 Etienne Pallier
258 1 Etienne Pallier
259 12 Etienne Pallier
---
260 17 Etienne Pallier
261 17 Etienne Pallier
h2. ACL - Gestion des droits selon le profil
262 66 Etienne Pallier
263 278 Etienne Pallier
Document Google doc (à jour) : https://docs.google.com/document/d/1-OhEeoi96j6ueUl5NQCQ9ZsTfbJTFw3ZVaWU2iYly_o/edit?usp=sharing 
264 277 Etienne Pallier
265 279 Etienne Pallier
Ancien document (n'est plus à jour et est incomplet) : {{thumbnail(ACLs Droits selon les Roles.pdf, size=1500, title=Cycle de vie du matériel)}}
266 84 Etienne Pallier
267 392 Etienne Pallier
---
268 392 Etienne Pallier
269 395 Etienne Pallier
---
270 395 Etienne Pallier
271 395 Etienne Pallier
h2. Deux environnements de dev pour avoir php5.6 et php7.X
272 395 Etienne Pallier
273 395 Etienne Pallier
Avec XAMPP : https://magazine.joomla.org/issues/issue-mar-2014/item/1797-practical-development-2-working-environment
274 395 Etienne Pallier
275 395 Etienne Pallier
276 395 Etienne Pallier
---
277 395 Etienne Pallier
278 392 Etienne Pallier
h2. Utilisation du serveur web de dev de CakePHP (à la place de apache)
279 392 Etienne Pallier
280 392 Etienne Pallier
/!\ Votre serveur MySQL doit être lancé !!!
281 392 Etienne Pallier
282 392 Etienne Pallier
* Se placer à la racine du projet.
283 392 Etienne Pallier
284 392 Etienne Pallier
* Lancer la commande suivante :
285 392 Etienne Pallier
286 392 Etienne Pallier
 <pre> bin/cake server </pre>
287 392 Etienne Pallier
288 392 Etienne Pallier
* Rendez-vous sur http://localhost:8765/
289 86 Etienne Pallier
290 84 Etienne Pallier
291 86 Etienne Pallier
---
292 154 Alexandre Cases
293 154 Alexandre Cases
h2. ROADMAP - Plan de développement
294 107 Alexandre Cases
295 274 Etienne Pallier
*Stage de Thibault :* il se déroule du 10 avril au 30 juin 2017, soit sur 12 semaines (S1 à S12)
296 154 Alexandre Cases
_*(Ne pas oublier de rédiger le rapport de stage au fur et à mesure)*_
297 154 Alexandre Cases
298 138 Etienne Pallier
299 154 Alexandre Cases
Voir le détail de la roadmap: https://projects.irap.omp.eu/projects/inventirap/roadmap
300 1 Etienne Pallier
301 275 Etienne Pallier
* S01-SO2 : "version 2.5.x - Amélioraiton installation, pagination":https://projects.irap.omp.eu/versions/160
302 275 Etienne Pallier
* S03-SO5 : "version 2.6.x - Emails, Etiquettes, bugfix...":https://projects.irap.omp.eu/versions/161
303 275 Etienne Pallier
* S06-SO7 : "version 2.7.x - Synchronization avec LATMOS, ACLs ok partout":https://projects.irap.omp.eu/versions/162
304 275 Etienne Pallier
* S08-S10 : "version 2.8.x - ACLs configurables via BDD, ...":https://projects.irap.omp.eu/versions/163
305 275 Etienne Pallier
* S11-S12 : "version 2.9.x - upgrade Cakephp3, passage à Php7":https://projects.irap.omp.eu/versions/164
306 271 Etienne Pallier
307 271 Etienne Pallier
308 276 Etienne Pallier
*Stage de Alexandre Cases (avril à juin 2016) :*
309 271 Etienne Pallier
310 271 Etienne Pallier
311 160 Alexandre Cases
|                    |   |_.Prévu |_.Réalisé |
312 90 Etienne Pallier
|/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|
313 161 Etienne Pallier
                     |.2|
314 90 Etienne Pallier
|/2=.S02 (18/4-22/4) |.1|
315 161 Etienne Pallier
                     |.2|
316 90 Etienne Pallier
|/2=.S03 (25/4-29/4) |.1|
317 154 Alexandre Cases
                     |.2|/4=<."version 2.01 - Implémentation complète du CRUD":https://projects.irap.omp.eu/versions/101|
318 154 Alexandre Cases
|/2=.S04 (02/5-06/5) |.1|/4=<.version 2.01|
319 154 Alexandre Cases
                     |.2|
320 154 Alexandre Cases
|/2=.S05 (09/5-13/5) |.1|
321 99 Etienne Pallier
                     |.2|/3=<."version 2.02 - Implémentation de toutes les autres actions":https://projects.irap.omp.eu/versions/106|
322 1 Etienne Pallier
|/2=.S06 (16/5-20/5) |.1|/2=<.version 2.02|
323 1 Etienne Pallier
                     |.2|
324 151 Etienne Pallier
|/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|
325 102 Etienne Pallier
                     |.2|
326 100 Etienne Pallier
|/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)|
327 98 Etienne Pallier
                     |.2|
328 100 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|
329 98 Etienne Pallier
                     |.2|
330 100 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|
331 98 Etienne Pallier
                     |.2|
332 98 Etienne Pallier
|/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|
333 98 Etienne Pallier
                     |.2|/2=<."version 2.08 - Cakephp3 + Php7 (compatible Php5)":https://projects.irap.omp.eu/versions/98|
334 98 Etienne Pallier
|/2=.S12 (27/6-30/6) |.1|
335 98 Etienne Pallier
                     |.2|/1=<."version 2.10 - Autres ajouts (+ fin rédaction rapport de stage)":https://projects.irap.omp.eu/versions/100|
336 98 Etienne Pallier
337 98 Etienne Pallier
---
338 98 Etienne Pallier
339 281 Etienne Pallier
h2. COMMIT : Procédure à suivre à chaque commit
340 98 Etienne Pallier
341 268 Etienne Pallier
NB: _cette procédure est détaillée davantage dans la section HOWTO de cette page (partie "CYCLE DE DEVELOPPEMENT A SUIVRE")_
342 267 Etienne Pallier
343 98 Etienne Pallier
Voici les différentes étapes à respecter au moment de chaque commit:
344 1 Etienne Pallier
345 283 Etienne Pallier
*1) S'assurer que tous les tests passent toujours !*
346 1 Etienne Pallier
347 286 Etienne Pallier
Cela permet de se prémunir contre toute régression (ce qui fonctionnait avant doit continuer de fonctionner)
348 285 Etienne Pallier
349 301 Etienne Pallier
*2) Optionnel : Incrementer la version et la date du projet*
350 282 Etienne Pallier
351 280 Etienne Pallier
A la fin du fichier src/Template/Layout/default.ctp
352 1 Etienne Pallier
353 265 Etienne Pallier
*3) Mettre à jour le fichier README-LABINVENT (ceci est un exemple, un template)*
354 265 Etienne Pallier
355 151 Etienne Pallier
Date: 11/05/2016
356 1 Etienne Pallier
Version: 2.1.9
357 151 Etienne Pallier
Mise à jour doc install
358 151 Etienne Pallier
(Attention, changement structure BDD)
359 260 Etienne Pallier
Demande(s) réalisée(s) : https://projects.irap.omp.eu/issues/3542
360 151 Etienne Pallier
Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
361 151 Etienne Pallier
362 100 Etienne Pallier
Remarques:
363 100 Etienne Pallier
=> Version: 2.1.9 = 9ème commit sur la version 2.1
364 100 Etienne Pallier
=> préciser "(bugfix)" si c'est le cas
365 1 Etienne Pallier
=> ajouter "(Attention, changement structure BDD)" s'il y a eu une modif de la BDD
366 100 Etienne Pallier
=> "Demande (terminée)" ou "Demande (en cours)", ou pas de demande du tout (exceptionnellement)
367 151 Etienne Pallier
=> ces infos permettront de savoir quelle version (et date) exacte du projet on a actuellement sur son disque
368 1 Etienne Pallier
369 1 Etienne Pallier
370 303 Etienne Pallier
*4) S'il y a eu un changement de structure de la BD*
371 98 Etienne Pallier
372 1 Etienne Pallier
* Copier la requête sql de modif dans un script db-update-AAAA-MM-JJ.sh du dossier database/update/
373 291 Etienne Pallier
* Mettre à jour le script sql complet de création de la BD database/labinvent_2.1_12-05-16.sql (et les autres scripts sql associés si besoin, insert_users...)
374 291 Etienne Pallier
* Mettre à jour le schéma (image png) de la BD (avec Mysql Workbench) dans le projet et sur le wiki (page "Documentation technique")
375 1 Etienne Pallier
* Avertir dans le README (Attention, changement de structure de la BDD, il faut exécuter le script de mise à jour database/update/xxx ...)
376 151 Etienne Pallier
377 1 Etienne Pallier
378 303 Etienne Pallier
*5) Si c'est la fin d'une version majeure (2.0, 2.1, 2.2, ...)*
379 1 Etienne Pallier
380 304 Etienne Pallier
381 304 Etienne Pallier
* On doit normalement avoir écrit quelques nouveaux tests pour cette version, n'est-ce pas ??? (sinon, c'est po bien) !!!
382 98 Etienne Pallier
* Ajouter cette version en tête de la section "MAIN CHANGES (MILESTONES)" dans le fichier README
383 1 Etienne Pallier
* Mettre à jour la doc install/INSTALLATION à partir du wiki (si nécessaire)
384 261 Etienne Pallier
* (On peut aussi tester une installation du logiciel from scratch)
385 98 Etienne Pallier
386 151 Etienne Pallier
387 284 Etienne Pallier
*6) PULL*
388 100 Etienne Pallier
389 100 Etienne Pallier
(au cas où quelqu'un d'autre aurait fait un push)
390 98 Etienne Pallier
391 104 Etienne Pallier
392 284 Etienne Pallier
*7) COMMIT*
393 104 Etienne Pallier
394 7 Etienne Pallier
Dans le message de commit, faire un simple copier/coller des infos du fichier README (sauf date):
395 1 Etienne Pallier
396 1 Etienne Pallier
Version: 2.1.9
397 1 Etienne Pallier
Mise à jour doc install (bugfix)
398 302 Etienne Pallier
(Attention, changement structure BDD)
399 1 Etienne Pallier
Demande (terminée): https://projects.irap.omp.eu/issues/3542
400 1 Etienne Pallier
Version majeure en cours (2.1): https://projects.irap.omp.eu/versions/101
401 1 Etienne Pallier
402 304 Etienne Pallier
*5) Si c'est la fin d'une version majeure (2.0, 2.1, 2.2, ...)*
403 1 Etienne Pallier
404 304 Etienne Pallier
* On doit normalement avoir écrit quelques nouveaux tests pour cette version, n'est-ce pas ??? (sinon, c'est po bien) !!!
405 304 Etienne Pallier
* Ajouter cette version en tête de la section "MAIN CHANGES (MILESTONES)" dans le fichier README
406 304 Etienne Pallier
* Mettre à jour la doc install/INSTALLATION à partir du wiki (si nécessaire)
407 304 Etienne Pallier
* (On peut aussi tester une installation du logiciel from scratch)
408 304 Etienne Pallier
* Voir aussi étape 9
409 304 Etienne Pallier
410 304 Etienne Pallier
411 302 Etienne Pallier
*8) Optionnel : PUSH*
412 1 Etienne Pallier
413 1 Etienne Pallier
(seulement si le commit est important/urgent, ou suite à un ensemble de commits sur un même thème)
414 304 Etienne Pallier
415 304 Etienne Pallier
416 304 Etienne Pallier
*9) Si c'est la fin d'une version majeure (2.0, 2.1, 2.2, ...), TAGUER la version*
417 304 Etienne Pallier
418 304 Etienne Pallier
Exemple:
419 304 Etienne Pallier
<pre>
420 304 Etienne Pallier
git tag 2.8 1b2e1d63ff
421 304 Etienne Pallier
</pre>
422 304 Etienne Pallier
423 304 Etienne Pallier
The 1b2e1d63ff stands for the first 10 characters of the commit id you want to reference with your tag. 
424 304 Etienne Pallier
You can get the commit id by looking at the log :
425 304 Etienne Pallier
426 304 Etienne Pallier
<pre>
427 304 Etienne Pallier
git log
428 304 Etienne Pallier
</pre>
429 304 Etienne Pallier
430 304 Etienne Pallier
431 304 Etienne Pallier
432 1 Etienne Pallier
433 1 Etienne Pallier
434 1 Etienne Pallier
---
435 203 Thibaud Ajas
436 288 Etienne Pallier
h2. Procédure à suivre pour MERGER le code entre 2 labos
437 288 Etienne Pallier
438 290 Etienne Pallier
*0) Etat initial :*
439 288 Etienne Pallier
- dev-LATMOS : état ok (tests passés & push fait)
440 288 Etienne Pallier
- dev-IRAP : état ok (tests passés & push fait)
441 288 Etienne Pallier
442 290 Etienne Pallier
*A faire à l'IRAP :*
443 288 Etienne Pallier
444 290 Etienne Pallier
*1) Merger dev-IRAP => dev*
445 289 Etienne Pallier
git checkout dev-IRAP
446 289 Etienne Pallier
(dev-IRAP) Incrémenter date + version + commit/push
447 288 Etienne Pallier
git checkout dev
448 313 Etienne Pallier
*git merge --no-ff dev-IRAP*
449 289 Etienne Pallier
Tests ok
450 305 Etienne Pallier
git push [origin dev]
451 288 Etienne Pallier
452 290 Etienne Pallier
*2) Merger dev-LATMOS => dev*
453 289 Etienne Pallier
git checkout dev-LATMOS
454 289 Etienne Pallier
(dev-LATMOS) Tests ok
455 289 Etienne Pallier
git checkout dev
456 313 Etienne Pallier
*git merge --no-ff dev-LATMOS*
457 307 Etienne Pallier
Si besoin, résoudre les conflits + add/commit/push
458 289 Etienne Pallier
Si besoin, exécuter le(s) script(s) db-update.sh
459 308 Etienne Pallier
si besoin, adapter le(s) script(s) db-update.sh
460 1 Etienne Pallier
Tests ok
461 311 Etienne Pallier
Faire un seul script db-update fusionnant toutes les modifs IRAP
462 308 Etienne Pallier
Update le script de création général de la BD (en fonction du contenu de db-update.sh) + add/commit/push
463 307 Etienne Pallier
Incrémenter date + version + add/commit/push
464 288 Etienne Pallier
465 312 Etienne Pallier
*3) Merger dev => dev-IRAP et dev-LATMOS*
466 312 Etienne Pallier
git checkout dev-IRAP
467 313 Etienne Pallier
*git merge --no-ff dev*
468 312 Etienne Pallier
Tests ok
469 312 Etienne Pallier
git push
470 1 Etienne Pallier
471 312 Etienne Pallier
git checkout dev-LATMOS
472 313 Etienne Pallier
*git merge --no-ff dev*
473 312 Etienne Pallier
Tests ok
474 306 Etienne Pallier
git push
475 289 Etienne Pallier
476 312 Etienne Pallier
Si besoin : Prévenir LATMOS que db-update à faire (venant de dev-IRAP) ?
477 288 Etienne Pallier
478 1 Etienne Pallier
h2. Installation from scratch (Sous UBuntu)
479 1 Etienne Pallier
480 1 Etienne Pallier
h3. Création projet avec Composer
481 1 Etienne Pallier
482 1 Etienne Pallier
* Télécharger composer.phar : 
483 1 Etienne Pallier
"curl -s https://getcomposer.org/installer | php"
484 1 Etienne Pallier
485 1 Etienne Pallier
* Avec le Composer créer un nouveau projet : 
486 1 Etienne Pallier
"php composer.phar create-project --prefer-dist cakephp/app labinvent_2.0"
487 1 Etienne Pallier
488 1 Etienne Pallier
> Voir structure projet : http://book.cakephp.org/3.0/fr/intro/cakephp-folder-structure.html
489 22 Alexandre Cases
490 22 Alexandre Cases
* On rempli la base de données avec le fichier sql
491 1 Etienne Pallier
492 1 Etienne Pallier
* On indique la BD utiliser à CakePHP dans le fichier config/app.php, propriété "Datasources".
493 1 Etienne Pallier
494 22 Alexandre Cases
* On se place à la racine du projet
495 22 Alexandre Cases
496 22 Alexandre Cases
* On génère le code Scaffold : 
497 1 Etienne Pallier
"bin/cake bake all nom_table" --> ça génére les modeles, les vues, et les controlleurs.
498 153 Etienne Pallier
499 1 Etienne Pallier
> Commande (en une fois) :
500 21 Alexandre Cases
> > 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
501 1 Etienne Pallier
502 1 Etienne Pallier
h3. Modification de la base de données 
503 1 Etienne Pallier
> Une version du sql corrigée au fur et à mesure est disponible dans le git :
504 1 Etienne Pallier
505 131 Alexandre Cases
> > Dans database/, le fichier labinvent_2.1_09-05-16 correspond à la création de la base.
506 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.
507 1 Etienne Pallier
508 1 Etienne Pallier
* Création table "config"
509 21 Alexandre Cases
510 1 Etienne Pallier
> > Mise à jour dans le fichier de création de base
511 21 Alexandre Cases
> > Mise à jour à part : db-update-2016-05-09.sql
512 21 Alexandre Cases
513 21 Alexandre Cases
h3. Autres remarques lors du développement
514 21 Alexandre Cases
515 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")...
516 21 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/contributing/cakephp-coding-conventions.html
517 21 Alexandre Cases
518 21 Alexandre Cases
* 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.
519 20 Alexandre Cases
Le mot de passe "login" = "$2y$10$LZzpws3oDidBcqO/Fy1RTedLLk3ENTmplny5J7bZ6R1PqFoGOw3Ma".
520 24 Alexandre Cases
Le mot de passe vide "" = "$2y$10$nBQMNstgN.sgad1ZANznY.pbJI.ZG/.Q5qX4gC8SXCFQnDIZC8rcW".
521 25 Alexandre Cases
522 91 Alexandre Cases
* Vérifier que la migration vers la prochaine version de cakephp3 (3.3 ?) sera facile... (décrire la procédure à suivre)
523 130 Alexandre Cases
--> Une migration vers une version mineur 3.2 => 3.3, se réalise avec la mise à jour de CakePHP à l'aide de Composer
524 91 Alexandre Cases
--> Puis il faut regarder les changements dans la page migration correspondant à la version voulu et adapter les changements au code.
525 91 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/appendices/3-2-migration-guide.html
526 31 Alexandre Cases
527 106 Alexandre Cases
* Outil (plugin) "DebugKit" de CakePHP3 : 
528 106 Alexandre Cases
--> DebugKit est un plugin qui fournit une toolbar pour aider à debugger les applications CakePHP plus facilement.
529 106 Alexandre Cases
--> Par défaut il est installé avec le squelette de l'application, pour l'activer, il faut se placer à la racine.
530 1 Etienne Pallier
--> Puis il faut éxécuter la ligne suivante : bin/cake plugin load DebugKit .
531 129 Alexandre Cases
--> La commande va aller modifier le fichier config bootstrap.php.
532 122 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.
533 129 Alexandre Cases
--> Le plugin nécessite l'extension php5-sqlite par défaut (il supporte l'équivalent avec de la config).
534 128 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/debug-kit.html
535 128 Alexandre Cases
536 157 Alexandre Cases
537 157 Alexandre Cases
* Mode debug personnaliser : 
538 157 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é.
539 125 Alexandre Cases
540 125 Alexandre Cases
> Voir : http://book.cakephp.org/3.0/fr/development/testing.html
541 156 Etienne Pallier
542 156 Etienne Pallier
* Pour charger une librairie (ex : phpqrcode, ...)
543 156 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/core-libraries/app.html#charger-les-fichiers-de-vendor
544 156 Etienne Pallier
545 156 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.
546 156 Etienne Pallier
> Voir : https://github.com/FriendsOfCake/CakePdf
547 156 Etienne Pallier
548 156 Etienne Pallier
* Pour le JavaScript, le JS Helper a été retiré 
549 156 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/appendices/3-0-migration-guide.html#jshelper
550 156 Etienne Pallier
551 156 Etienne Pallier
* Pour pouvoir éxécuter les tests depuis eclipse : 
552 156 Etienne Pallier
> Voir : http://blog.loftdigital.com/running-phpunit-tests-in-eclipse-pdt
553 156 Etienne Pallier
554 156 Etienne Pallier
* Avant de déployer l'application sur le serveur de production, optimiser les performances
555 156 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/deployment.html#ameliorer-les-performances-de-votre-application
556 156 Etienne Pallier
557 156 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}Installation sur Mac (retour des pb)%
558 156 Etienne Pallier
559 156 Etienne Pallier
1) install.sh
560 156 Etienne Pallier
=> 
561 156 Etienne Pallier
chmod: Unable to change file mode on ./webroot/img//gqbee0pkerrl8h2rbekaa3t8j1.png: Operation not permitted
562 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/models/myapp_cake_model_default_configurations: Operation not permitted
563 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/models/myapp_cake_model_default_documents: Operation not permitted
564 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_cake_fr__f_r: Operation not permitted
565 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
566 156 Etienne Pallier
chmod: Unable to change file mode on ./tmp//cache/persistent/myapp_cake_core_translations_default_fr__f_r: Operation not permitted
567 156 Etienne Pallier
568 156 Etienne Pallier
569 156 Etienne Pallier
=> sudo chmod -R 777 ../webroot/img
570 163 Alexandre Cases
=> sudo chmod -R 777 ../tmp/
571 156 Etienne Pallier
(=> sudo chmod -R 777 ../vendor)
572 163 Alexandre Cases
573 156 Etienne Pallier
574 165 Etienne Pallier
2) connexion au site
575 1 Etienne Pallier
=> mauvais affichage pourri
576 164 Alexandre Cases
=> il faut configurer la BD dans app.php
577 164 Alexandre Cases
            'username' => 'labinvent2user',
578 164 Alexandre Cases
            'password' => 'labinvent2user',
579 164 Alexandre Cases
            'database' => 'labinvent2',
580 164 Alexandre Cases
581 164 Alexandre Cases
3) login
582 164 Alexandre Cases
=> epallier/login
583 164 Alexandre Cases
584 164 Alexandre Cases
585 164 Alexandre Cases
---
586 172 Alexandre Cases
587 172 Alexandre Cases
h2. Pour mettre à jour CakePHP
588 156 Etienne Pallier
589 156 Etienne Pallier
* Utiliser le composer : "php composer.phar update" à la racine de l'application
590 156 Etienne Pallier
> Voir : http://book.cakephp.org/3.0/fr/installation.html#rester-a-jour-avec-les-derniers-changements-de-cakephp
591 222 Thibaud Ajas
592 1 Etienne Pallier
* Puis il faut modifier le fichier : ./vendor/cakephp/cakephp/src/View/Helper/PaginatorHelper.php
593 222 Thibaud Ajas
  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".
594 222 Thibaud Ajas
  Enfin dans le même tableau, il faut remplacer la ligne suivante : 
595 222 Thibaud Ajas
> 'current' => '<span class="active"><a href="">{{text}}</a></span>',
596 222 Thibaud Ajas
597 222 Thibaud Ajas
           Par : 
598 222 Thibaud Ajas
599 222 Thibaud Ajas
> 'current' => '<span class="current">{{text}}</span>',
600 222 Thibaud Ajas
601 222 Thibaud Ajas
* Puis il faut vider le cache de l'application (et du navigateur) pour que debug_kit fonctionne.
602 222 Thibaud Ajas
603 222 Thibaud Ajas
604 222 Thibaud Ajas
---
605 222 Thibaud Ajas
606 385 Thibaud Ajas
h2. Pour utiliser php5.6 ET php7.0 sur le même OS (Fonctionne avec Ubuntu 14.04.5 - le 02/05/2017)
607 222 Thibaud Ajas
608 385 Thibaud Ajas
*Installation de php 5.6 et de php 7.0 :*
609 222 Thibaud Ajas
610 222 Thibaud Ajas
<pre>
611 222 Thibaud Ajas
sudo add-apt-repository ppa:ondrej/php
612 222 Thibaud Ajas
sudo apt-get update
613 385 Thibaud Ajas
sudo apt-get install php7.0 php5.6 php5.6-mysql php-gettext php5.6-mbstring php-mbstring php7.0-mbstring php-xdebug libapache2-mod-php5.6 libapache2-mod-php7.0
614 222 Thibaud Ajas
</pre>
615 222 Thibaud Ajas
616 221 Thibaud Ajas
*Comment changer de version :*
617 221 Thibaud Ajas
618 385 Thibaud Ajas
_*Depuis php5.6 vers php7.0 :*_
619 167 Alexandre Cases
620 167 Alexandre Cases
<pre>
621 385 Thibaud Ajas
sudo a2dismod php5.6 ; sudo a2enmod php7.0 ; sudo service apache2 restart
622 385 Thibaud Ajas
sudo update-alternatives --set php /usr/bin/php7.0
623 169 Alexandre Cases
</pre>
624 169 Alexandre Cases
625 385 Thibaud Ajas
_*Depuis php7.0 vers php5.6 :*_
626 169 Alexandre Cases
627 169 Alexandre Cases
<pre>
628 385 Thibaud Ajas
sudo a2dismod php7.0 ; sudo a2enmod php5.6 ; sudo service apache2 restart
629 1 Etienne Pallier
sudo update-alternatives --set php /usr/bin/php5.6
630 173 Alexandre Cases
</pre>
631 173 Alexandre Cases
632 173 Alexandre Cases
---
633 173 Alexandre Cases
634 1 Etienne Pallier
h2. Rappel d'intervention par mail
635 170 Alexandre Cases
636 170 Alexandre Cases
* Il faut définir un attribut *"rappel" de type "int"* dans la table suivis.
637 170 Alexandre Cases
Cet attribut peut avoir *4 valeurs* : 
638 167 Alexandre Cases
<pre>
639 167 Alexandre Cases
0 ==> Pas d'envoi de rappel programmé
640 167 Alexandre Cases
1 ==> Rappel programmé 1 mois avant
641 201 Thibaud Ajas
2 ==> Rappel programmé 15 jours avant
642 1 Etienne Pallier
3 ==> Rappel programmé 2 jours avant
643 211 Thibaud Ajas
</pre>
644 1 Etienne Pallier
645 211 Thibaud Ajas
* Dans *l'AppController*, il faut définir une fonction "rappelIntervention()" qui :
646 211 Thibaud Ajas
- 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".
647 211 Thibaud Ajas
- Met cette attribut à 1
648 211 Thibaud Ajas
- 
649 211 Thibaud Ajas
650 211 Thibaud Ajas
...........................
651 211 Thibaud Ajas
652 211 Thibaud Ajas
* Dans *l'UsersController*, il faut executer la fonction précédente une fois que l'utilisateur est connecté (dans fonction login()).
653 211 Thibaud Ajas
654 211 Thibaud Ajas
---
655 211 Thibaud Ajas
656 263 Etienne Pallier
---
657 263 Etienne Pallier
658 328 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}AMELIORATIONS A VENIR (TODO)%
659 1 Etienne Pallier
660 336 Etienne Pallier
h3. *1) POUR LE CODE SOURCE*
661 1 Etienne Pallier
662 341 Etienne Pallier
Bien maîtriser les 4 étapes qui s'enchainent lors de l'appel d'une action :
663 1 Etienne Pallier
664 1 Etienne Pallier
665 343 Etienne Pallier
*a) Avant l'appel d'une action d'un controleur*
666 1 Etienne Pallier
667 331 Etienne Pallier
Ex: src/MaterielsController/isAuthorized()
668 331 Etienne Pallier
669 376 Etienne Pallier
(NB: Au plus haut niveau, c'est vendor/cakephp/src/Controller/Component/AuthComponent.php::isAuthorized())
670 376 Etienne Pallier
671 328 Etienne Pallier
Définir qui a droit à quoi dans src/<Model>Controller/isAuthorized(),
672 329 Etienne Pallier
action par action, et à l'intérieur d'une action, role par role
673 328 Etienne Pallier
674 330 Etienne Pallier
Respecter cette structure de code :
675 330 Etienne Pallier
<pre>
676 330 Etienne Pallier
switch ($action) {
677 329 Etienne Pallier
678 330 Etienne Pallier
   case 'action1':
679 330 Etienne Pallier
      switch ($role) :
680 330 Etienne Pallier
         case USER:
681 330 Etienne Pallier
         case RESP:
682 330 Etienne Pallier
         case ADMIN:
683 330 Etienne Pallier
         ...
684 330 Etienne Pallier
685 330 Etienne Pallier
   case 'action2':
686 330 Etienne Pallier
      switch ($role) :
687 330 Etienne Pallier
688 1 Etienne Pallier
   ...
689 1 Etienne Pallier
</pre>
690 1 Etienne Pallier
691 330 Etienne Pallier
692 343 Etienne Pallier
*b) Dans le traitement de l'action, avant la vue*
693 336 Etienne Pallier
694 331 Etienne Pallier
Ex: src/MaterielsController/add()
695 331 Etienne Pallier
696 1 Etienne Pallier
Définir TOUTES les données dont la vue aura besoin, dans src/<Model>Controller/<action()>
697 1 Etienne Pallier
La vue ne doit faire AUCUN traitement, elle doit se contenter d'afficher les données qu'on lui passe.
698 331 Etienne Pallier
699 333 Etienne Pallier
En particulier, selon le role (profil) actif, positionner ces tableaux (listes de champs pour dire à quels champs ce role à accès et dans quelles conditions (lecture seule, obligatoire, ...) :
700 1 Etienne Pallier
701 333 Etienne Pallier
 * $hiddenFields = [ fields list ]
702 333 Etienne Pallier
 * $readonlyFields = [ fields list ]
703 327 Etienne Pallier
 * $mandatoryFields = [ fields list ]
704 1 Etienne Pallier
 * $defaultValueForFields = [ field1 => value1, field2 => value2, ..., fieldN => valueN ]
705 1 Etienne Pallier
706 333 Etienne Pallier
Passer ensuite ces listes à la vue avec set()
707 1 Etienne Pallier
708 343 Etienne Pallier
*c) Dans la vue correspondant à l'action*
709 1 Etienne Pallier
710 331 Etienne Pallier
Ex: dans src/Template/Materiels/add.ctp
711 331 Etienne Pallier
712 328 Etienne Pallier
Dans src/Template/<Model>/<action.ctp>
713 1 Etienne Pallier
714 1 Etienne Pallier
Afficher les données passées par le controleur pour cette action
715 1 Etienne Pallier
716 1 Etienne Pallier
(faire le moins de traitements possibles, seulement de l'affichage)
717 1 Etienne Pallier
718 337 Etienne Pallier
En particulier, la vue affichera les champs (fields) un par un, en utilisant une fonction displayField() qui tiendra compte automatiquement des listes définies à l'étape précédente :
719 337 Etienne Pallier
$hiddenFields, $readonlyFields, $mandatoryFields, et $defaultValueForField
720 335 Etienne Pallier
721 340 Etienne Pallier
722 343 Etienne Pallier
*d) (TODO) 4ème étape à envisager : ce qui se passe APRES que l'action a été exécutée*
723 340 Etienne Pallier
724 341 Etienne Pallier
* La sauvegarde dans la BD (voir aussi beforeSave())
725 340 Etienne Pallier
* Quelle redirection vers quelle vue ?
726 340 Etienne Pallier
727 336 Etienne Pallier
h3. *2) POUR LES TESTS*
728 336 Etienne Pallier
729 379 Etienne Pallier
(https://book.cakephp.org/3.0/en/development/testing.html)
730 379 Etienne Pallier
731 338 Etienne Pallier
Les tests sont dans tests/TestCase/
732 338 Etienne Pallier
733 338 Etienne Pallier
Ils sont organisés par type :
734 338 Etienne Pallier
735 338 Etienne Pallier
* Controller/
736 338 Etienne Pallier
* Model/
737 338 Etienne Pallier
* View/
738 338 Etienne Pallier
739 339 Etienne Pallier
La plupart des tests sont dans Controller, mais il faudra aussi faire quelques tests de Model et de View...
740 338 Etienne Pallier
741 338 Etienne Pallier
Concernant les tests liés aux controleurs (dans Controller/), ils sont organisés par controleur :
742 338 Etienne Pallier
743 338 Etienne Pallier
* EmpruntsControllerTest.php
744 338 Etienne Pallier
* MaterielsControllerTest.php
745 338 Etienne Pallier
* PagesControllerTest.php
746 338 Etienne Pallier
* SuivisControllerTest.php
747 338 Etienne Pallier
* UsersControllerTest.php
748 338 Etienne Pallier
749 359 Etienne Pallier
(on prendra plutôt l'exemple des tests du controleur de Materiels, MaterielsControllerTest.php)
750 339 Etienne Pallier
751 359 Etienne Pallier
Il y a 2 manières de procéder :
752 1 Etienne Pallier
753 360 Etienne Pallier
*La manière intuitive, moins exhaustive, mais PLUS LISIBLE car plus naturelle, et de plus haut niveau sémantique :*
754 1 Etienne Pallier
755 359 Etienne Pallier
On organise les tests à la façon BDD (Behaviour Driven Dev) avec le GIVEN WHEN THEN :
756 359 Etienne Pallier
757 359 Etienne Pallier
"GIVEN a context, As a ADMIN, WHEN I do an ACTION, THEN I get this result"
758 359 Etienne Pallier
759 359 Etienne Pallier
Les tests sont organisés non pas par controleur, ni par action, mais par ROLE ("AS a ADMIN"), puis à l'intérieur de ce rôle, par ACTION
760 359 Etienne Pallier
761 359 Etienne Pallier
ex: 
762 359 Etienne Pallier
763 360 Etienne Pallier
test_as_Unauthenticated_i_can_goto_APROPOS_page_and_HOME_page_and_LOGIN()
764 1 Etienne Pallier
765 360 Etienne Pallier
test_as_Authenticated_i_can_LOGOUT_and_LOGIN_again()
766 360 Etienne Pallier
767 1 Etienne Pallier
test_as_USER_i_can_ADD_a_MATERIEL_then_DELETE_it()
768 1 Etienne Pallier
769 360 Etienne Pallier
test_as_USER_i_can_ADD_a_MATERIEL_then_EDIT_it()
770 1 Etienne Pallier
771 360 Etienne Pallier
test_as_USER_i_cannot_EDIT_a_MATERIEL_that_is_not_mine()
772 1 Etienne Pallier
773 360 Etienne Pallier
test_as_USER_i_can_EDIT_a_MATERIEL_that_is_mine_even_if_VALIDATED()
774 360 Etienne Pallier
775 360 Etienne Pallier
test_as_ADMIN_i_can_VALIDATE_a_MATERIEL_that_is_CREATED()
776 360 Etienne Pallier
777 361 Etienne Pallier
On peut aussi avoir des tests qui permettent de vérifier les Règles de Gestion :
778 361 Etienne Pallier
779 361 Etienne Pallier
test_MATERIEL_date_reception_superieure_ou_egale_a_date_commande
780 361 Etienne Pallier
781 361 Etienne Pallier
test_MATERIEL_ne_doit_pas_etre_ni_technique_ni_inventoriable
782 360 Etienne Pallier
783 360 Etienne Pallier
784 360 Etienne Pallier
785 360 Etienne Pallier
*La manière systématique, exhaustive, pour ne rien oublier, mais PEU LISIBLE (donc on préfèrera la manière précédente) :*
786 360 Etienne Pallier
787 359 Etienne Pallier
On organise les tests pour un controleur donné (ex: MaterielsController) +par ACTION+, et +pour chaque action tester les droits des différents ROLES+.
788 359 Etienne Pallier
789 359 Etienne Pallier
CHAQUE TEST devrait dans l'idéal comporter 3 ou 4 parties correspondant aux 4 étapes présentées au point "1) POUR LE CODE SOURCE" ci-dessus :
790 359 Etienne Pallier
791 345 Etienne Pallier
*a) Avant l'appel d'une action d'un controleur :* 
792 1 Etienne Pallier
793 346 Etienne Pallier
Tester qui a le droit de faire quoi
794 1 Etienne Pallier
795 345 Etienne Pallier
*b+c) Dans la vue correspondant à l'action :*
796 344 Etienne Pallier
797 346 Etienne Pallier
Tester que la vue a bien été générée comme il faut pour cette action, et que les listes $readonlyFields, $mandatoryFields, ... sont bien remplies comme il faut
798 1 Etienne Pallier
799 1 Etienne Pallier
*d) Après la réalisation de l'action :*
800 1 Etienne Pallier
801 346 Etienne Pallier
Tester que l'action attendue a bien été réalisée et qu'on est bien sur la vue de redirection prévue
802 346 Etienne Pallier
803 346 Etienne Pallier
Exemples :
804 346 Etienne Pallier
805 346 Etienne Pallier
806 346 Etienne Pallier
testUnauthenticatedUserCanLogin() : tester qu'un user non logué peut appeler l'action "login", et se trouve bien ensuite sur la page accueil
807 346 Etienne Pallier
808 346 Etienne Pallier
testUnauthenticatedUserCanViewAboutPage() : tester qu'un user non logué peut voir la page "about"
809 346 Etienne Pallier
810 346 Etienne Pallier
testUnauthenticatedUserCannotDoAnythingElse() : tester qu'un user non logué ne peut voir que les pages "accueil" et "about", et rien d'autre
811 346 Etienne Pallier
812 346 Etienne Pallier
testAuthenticatedUserCanLogout() : tester qu'un user logué peut se déloguer et atteint bien la page de login
813 346 Etienne Pallier
814 346 Etienne Pallier
815 348 Etienne Pallier
*Tests spécifiques pour le controleur Materiels (les tests doivent être organisés PAR ACTION) :*
816 348 Etienne Pallier
817 346 Etienne Pallier
testOnMaterielsActionViewCanBeDoneByAll() : tester que tout le monde peut voir un matériel
818 1 Etienne Pallier
819 348 Etienne Pallier
testOnMaterielsActionAddCanBeDoneByAll() : tester que tout le monde peut créer un matériel, sans toutefois voir les mêmes champs (et pas dans les mêmes conditions), et vérifier que l'ajout d'un matériel a bien été fait et qu'on arrive sur la vue détaillée du matériel (oui, tout ça doit être testé, les 4 étapes citées plus haut, et cela pour tous les profils)
820 1 Etienne Pallier
821 349 Etienne Pallier
testOnMaterielsActionEditCanBeDoneByXXXWithConditions() : tester que selon les profils, on ne peut pas éditer les mêmes matériels (USER doit être owner, RESP doit appartenir au même groupe thématique ou métier, ...)
822 349 Etienne Pallier
823 349 Etienne Pallier
Pour chaque test, on peut imaginer des SOUS-TESTS de ce type (on prend ici l'exemple du test précédent) :
824 1 Etienne Pallier
825 1 Etienne Pallier
* testOnMaterielsInViewEditXXXCanSeeOnlyTheseFields (fields list) : test des hidden fields
826 349 Etienne Pallier
* testOnMaterielsInViewEditXXXCannotChangeTheseFields (fields list) : test des readonly fields
827 359 Etienne Pallier
* testOnMaterielsInViewEditXXXMustFillTheseFields (fields list) : test des mandatory fields
828 359 Etienne Pallier
* testOnMaterielsInViewEditXXXTheseFieldsHaveDefaultValues (fields list with default values) : test des default value fields
829 349 Etienne Pallier
830 350 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}HOWTO (nouvelle version avec CakePhp3)%
831 348 Etienne Pallier
832 354 Etienne Pallier
* *Auth : Chemin parcouru lors d'une connexion au site web*
833 378 Etienne Pallier
834 378 Etienne Pallier
(https://book.cakephp.org/3.0/en/controllers/components/authentication.html)
835 378 Etienne Pallier
836 351 Etienne Pallier
Ce chemin est parcouru dans l'ordre :
837 351 Etienne Pallier
<pre>
838 351 Etienne Pallier
webroot/index.php 
839 355 Etienne Pallier
840 350 Etienne Pallier
config/bootstrap.php => lit config/app.php
841 355 Etienne Pallier
842 350 Etienne Pallier
src/Controller/PagesController/display()
843 355 Etienne Pallier
844 350 Etienne Pallier
src/Controller/UsersController/login() sans POST
845 355 Etienne Pallier
846 350 Etienne Pallier
src/Template/Users/login.ctp => formulaire de login => POST
847 355 Etienne Pallier
848 350 Etienne Pallier
src/Controller/UsersController/login() avec POST
849 1 Etienne Pallier
850 351 Etienne Pallier
   user = $this->LdapAuth->connection();
851 351 Etienne Pallier
852 351 Etienne Pallier
     src/Controller/Component/LdapAuthComponent/connection()
853 351 Etienne Pallier
    
854 352 Etienne Pallier
        $resp = TableRegistry::get('LdapConnections')->ldapAuthentication($login, $password);
855 352 Etienne Pallier
856 352 Etienne Pallier
        src/Model/Table/LdapConnectionsTable.php::ldapAuthentication()
857 352 Etienne Pallier
858 352 Etienne Pallier
		if ($this->USE_LDAP) {
859 352 Etienne Pallier
			$ldapConnection = ldap_connect($this->host, $this->port);
860 352 Etienne Pallier
       		        if (@ldap_bind($ldapConnection, $this->authenticationType . '=' . $login . ',' . $this->baseDn, $password)) {
861 352 Etienne Pallier
		            return $this->getUserAttributes($login)[0];
862 352 Etienne Pallier
		}
863 352 Etienne Pallier
		else {
864 352 Etienne Pallier
		        $user = $this->getFakeLdapUser($login);
865 352 Etienne Pallier
			if ($user != false && (new DefaultPasswordHasher)->check($password, $user['userpassword'][0]))
866 352 Etienne Pallier
			    return $user;
867 352 Etienne Pallier
                }
868 352 Etienne Pallier
                return FALSE
869 351 Etienne Pallier
			
870 351 Etienne Pallier
   if ($user != FALSE) {
871 351 Etienne Pallier
      $this->LdapAuth->setUser($user);
872 351 Etienne Pallier
      return $this->redirect($this->LdapAuth->redirectUrl());
873 327 Etienne Pallier
</pre>
874 353 Etienne Pallier
Pour info, si ça bogue (par exemple, à une époque on retournait "YOLO" au lieu de FALSE en cas d'échec de connection ldap), c'est *src/Template/Error/error400.ctp* qui prend le relais...
875 350 Etienne Pallier
876 314 Etienne Pallier
877 319 Etienne Pallier
* *Champ facultatif/obligatoire : Comment rendre facultatif ou obligatoire un champ, et définir les vérifications à faire sur ce champ ?*
878 1 Etienne Pallier
=> src/Model/Table/<Model>Table.php
879 1 Etienne Pallier
ex : src/Model/Table/MaterielsTable.php pour définir les règles sur les champs de la table "materiels"
880 317 Etienne Pallier
881 325 Etienne Pallier
* *Où définir les éléments passés à une vue (c'est à dire à une action) ?*
882 323 Etienne Pallier
=> src/Controller/<Model>Controller/nom_de_la_vue_ou_action()
883 323 Etienne Pallier
ex : src/Controller/MaterielsController/edit() pour définir (avec set()) les éléments passés à la vue "edit" des materiels
884 321 Etienne Pallier
885 318 Etienne Pallier
* *ACL* : 
886 320 Etienne Pallier
887 325 Etienne Pallier
 * *ACL1 : Comment définir qui a droit de faire quelles actions (c'est à dire qui a le droit d'accéder à quelles vues) ?*
888 1 Etienne Pallier
=> Régles générales par défaut pour tous les controleurs : src/Controller/AppController.php/isAuthorized()
889 377 Etienne Pallier
(héritage de Cake\Controller\Component\AuthComponent::isAuthorized(), c'est à dire vendor/cakephp/src/Controller/Component/AuthComponent.php::isAuthorized())
890 377 Etienne Pallier
891 326 Etienne Pallier
(cf https://book.cakephp.org/3.0/fr/controllers/components/authentication.html et https://book.cakephp.org/3.0/fr/tutorials-and-examples/blog-auth-example/auth.html)
892 1 Etienne Pallier
_Voir aussi beforeFilter()_
893 317 Etienne Pallier
=> Régles pour un controleur donné : src/Controller/<Model>Controller.php/isAuthorized()
894 317 Etienne Pallier
895 318 Etienne Pallier
 * *ACL2 : Une fois qu'on est dans une vue, comment définir qui a droit de voir quels éléments de la vue ?*
896 317 Etienne Pallier
=> src/Template/<Model>/nom_de_la_vue.ctp
897 317 Etienne Pallier
ex : src/Template/Materiels/edit.ctp pour les règles concernant la vue "edit" des materiels
898 314 Etienne Pallier
899 315 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}HOWTO (ancienne version LabInvent 1.3 avec CakePhp2)%
900 263 Etienne Pallier
901 263 Etienne Pallier
*_Attention, ce howto est sans doute obsolète car il concerne l'ancienne version LabInvent 1.3 avec CakePhp2, mais il contient sûrement des conseils encore bien utiles_*
902 263 Etienne Pallier
903 264 Etienne Pallier
Ce document est un HOWTO, c'est à dire un guide pour savoir "comment faire quoi".
904 264 Etienne Pallier
Il donne des solutions à différents types de besoins ou problèmes, et explique aussi "où trouver quoi".
905 263 Etienne Pallier
906 263 Etienne Pallier
907 264 Etienne Pallier
* *VERSION DE CAKEPHP*
908 263 Etienne Pallier
909 263 Etienne Pallier
Version de cakephp ?
910 263 Etienne Pallier
Configure::version(); // 2.1.3
911 263 Etienne Pallier
Et aussi : fichier cakephp/lib/Cake/VERSION.txt
912 263 Etienne Pallier
913 263 Etienne Pallier
914 264 Etienne Pallier
* *CYCLE DE DEVELOPPEMENT A SUIVRE (11 commandements)*
915 263 Etienne Pallier
916 263 Etienne Pallier
Je veux apporter un changement (correction ou evolution) au projet, comment dois-je faire ?
917 263 Etienne Pallier
918 263 Etienne Pallier
1) Incrementer la version du projet, a la fin du fichier cakephp/app/View/Layouts/default.ctp, et mettre à jour la date
919 263 Etienne Pallier
920 263 Etienne Pallier
2) Selectionner le changement a apporter (une demande) dans le Redmine du projet (https://projects.irap.omp.eu/projects/inventirap) :
921 263 Etienne Pallier
- soit depuis la liste des demandes : onglet Demandes
922 263 Etienne Pallier
- soit depuis la roadmap : onglet Roadmap, cocher la case "Anomalie", cliquer sur Appliquer, puis "version 1.3" (la version en cours depuis fin 2012)
923 263 Etienne Pallier
Commencer de préférence par les "anomalies" parmi celles qui ont la plus haute priorité (et faire les "évolutions" dans un 2ème temps).
924 263 Etienne Pallier
Choisir une demande et cliquer dessus pour aller sur sa fiche detaillee et voir le travail a faire.
925 263 Etienne Pallier
Cliquer sur "mettre a jour", selectionner le statut "En cours", modifier eventuellement d'autres champs..., puis cliquer sur "Soumettre".
926 263 Etienne Pallier
Noter l'URL de cette fiche (par exemple : https://projects.irap.omp.eu/issues/1050)
927 263 Etienne Pallier
NB : Si la demande n'existe pas encore, la creer :
928 263 Etienne Pallier
- cliquer sur l'onglet "Nouvelle demande"
929 263 Etienne Pallier
- Selectionner "Anomalie" ou "Evolution"
930 263 Etienne Pallier
- Positionner le statut a "En cours" si on veut travailler aussitot dessus (sinon, laisser a "Nouveau")
931 263 Etienne Pallier
- Completer le reste de la fiche de demande (mettre "Assigne a" a "<<moi>>", choisir la version cible "version 1.3" ou "version 1.4", ...)
932 263 Etienne Pallier
- cliquer sur le bouton "Creer"
933 263 Etienne Pallier
934 263 Etienne Pallier
3) Verifier que cette nouvelle demande apparait bien dans la roadmap (cliquer sur onglet "Roadmap", ..., puis version 1.3)
935 263 Etienne Pallier
936 263 Etienne Pallier
ÉTAPE OPTIONNELLE MAIS FORTEMENT CONSEILLÉE :
937 263 Etienne Pallier
4) Ecrire un test qui vérifie que cette fonctionnalité ne marche pas encore (bug) ou bien n'est pas encore implémentée
938 263 Etienne Pallier
On utilise ici l'approche TDD (Test Driven Development)
939 263 Etienne Pallier
Ce test ne devrait pas passer (il est au rouge) ; il passera plus tard, quand on aura écrit le code nécessaire.
940 263 Etienne Pallier
Bien sur, c'est dans la mesure du possible, car on ne peut pas TOUT tester.
941 263 Etienne Pallier
Dans tous les cas, il faut ecrire un test qui s'approche le plus possible de la réalité à tester.
942 263 Etienne Pallier
Voir pour cela la section "TESTS" (à la fin de ce document)
943 263 Etienne Pallier
944 263 Etienne Pallier
5) Faire les changements necessaires dans le code Php
945 263 Etienne Pallier
Si ce changement implique aussi un changement dans la base de donnees,
946 263 Etienne Pallier
copier le script SQL correspondant à ce changement dans un fichier database/update/db-update-YYYY-MM-DD.sql
947 263 Etienne Pallier
portant la date du jour (voir des exemples dans database/update/old/).
948 263 Etienne Pallier
Plus tard, il faudra penser à intégrer ce changement dans le script general de creation de la BDD database/BDD_IRAP.sql
949 263 Etienne Pallier
(et/ou éventuellement les fichiers Insert_TablesFunct.sql, Insert_Users.sql, et Upd_TableConstraints.sql)
950 263 Etienne Pallier
et donc deplacer le script de modification database/update/db-update-YYYY-MM-DD.sql dans database/update/old/db-update-YYYY-MM-DD.sql
951 263 Etienne Pallier
952 263 Etienne Pallier
6) Tester manuellement ce changement jusqu'a ce qu'il soit totalement OK
953 263 Etienne Pallier
a) faire quelques tests manuels
954 263 Etienne Pallier
b) Le test écrit à l'étape (4) doit maintenant passer (il est au vert).
955 263 Etienne Pallier
Il doit être inclus dans l'ensemble des tests accessibles par le lien "AllTests".
956 263 Etienne Pallier
c) Test de non régression : afin de s'assurer que cette modification du code n'entraîne aucune régression sur le reste du code, 
957 263 Etienne Pallier
tous les autres tests écrits avant doivent aussi passer (vert) : pour cela, exécuter l'url /test.php?case=AllTests
958 263 Etienne Pallier
959 263 Etienne Pallier
7) Compléter le fichier /README.txt, section HISTORIQUE DES VERSIONS (fichier situé à la racine du projet)
960 263 Etienne Pallier
Y mettre le même commentaire que ce que tu mettras lors du commit
961 263 Etienne Pallier
962 263 Etienne Pallier
8) Mettre a jour TON code (en mode console, "svn update" depuis la racine du projet, ou bien depuis Eclipse, clic droit sur le projet, "Team/Update") 
963 1 Etienne Pallier
C'est important, au cas ou quelqu'un d'autre aurait fait des modifs (avant ou en meme temps que toi), et pour etre bien sur d'avoir la derniere version
964 1 Etienne Pallier
965 263 Etienne Pallier
9) Faire un "commit" du code, en collant dans le commentaire l'URL de la demande realisee (exemple : https://projects.irap.omp.eu/issues/1050)
966 263 Etienne Pallier
967 263 Etienne Pallier
10) Fermer la demande sur redmine
968 263 Etienne Pallier
Sur la fiche detaillee, cliquer sur "Mettre a jour", changer le statut a "ferme", changer "% realise" a 100%, (copier l'URL de la fiche), cliquer sur Soumettre
969 263 Etienne Pallier
970 263 Etienne Pallier
11) Si c'est un changement important, le répercuter sur le site officiel 
971 263 Etienne Pallier
Le changement est important si c'est une anomalie ou bien si c'est une évolution attendue.
972 263 Etienne Pallier
Demander alors au service informatique de le répercuter sur l'installation officielle (faire un "svn update", mail à loic.jahan@irap.omp.eu).  
973 263 Etienne Pallier
Si ce changement implique aussi la base de données, donner la directive que le fichier database/update/db-update-YYYY-MM-DD.sql doit être exécuté sur leur BDD.
974 263 Etienne Pallier
Si ce changement impliquer une modification du fichier de configuration labinvent.php, donner la procédure à suivre dans le mail.
975 263 Etienne Pallier
976 263 Etienne Pallier
977 263 Etienne Pallier
978 1 Etienne Pallier
979 264 Etienne Pallier
* *CORRIGER UNE ERREUR, RESOUDER UN PROBLEME, COMMENT DEBOGUER (DEBUG)*
980 264 Etienne Pallier
981 263 Etienne Pallier
Cakephp vous affiche une erreur, mais vous ne savez pas d'ou vient le probleme.
982 263 Etienne Pallier
Don't panic.
983 263 Etienne Pallier
En general, un bon moyen de le savoir est de lire le fichier de log des erreurs
984 263 Etienne Pallier
dans cakephp/app/tmp/logs/error.log
985 263 Etienne Pallier
986 263 Etienne Pallier
Dans le dossier logs, vous trouverez d'autres logs utiles :
987 263 Etienne Pallier
- labinvent.log
988 263 Etienne Pallier
- debug.log (pas sur que ce fichier soit encore utilisé...)
989 263 Etienne Pallier
990 263 Etienne Pallier
Remarque :
991 263 Etienne Pallier
$this->log('Something broke');
992 263 Etienne Pallier
==> écrit dans cakephp/app/tmp/logs/ :
993 263 Etienne Pallier
- error.log
994 263 Etienne Pallier
- inventirap.log
995 263 Etienne Pallier
996 263 Etienne Pallier
997 263 Etienne Pallier
998 264 Etienne Pallier
* *OU EST QUOI (WHERE IS WHAT) ?*
999 263 Etienne Pallier
1000 263 Etienne Pallier
- OU mettre a jour la VERSION du soft (AVANT CHAQUE COMMIT) ?
1001 263 Etienne Pallier
En attendant mieux, on fait cela a la fin du fichier cakephp/app/View/Layouts/default.ctp
1002 263 Etienne Pallier
1003 263 Etienne Pallier
- OU EST LA PAGE GENERALE (qui contient tous les elements) ? : cakephp/app/View/Layouts/default.ctp
1004 263 Etienne Pallier
1005 263 Etienne Pallier
- OU EST LA PAGE D'ACCUEIL ? : app/View/Pages/home.ctp
1006 263 Etienne Pallier
1007 263 Etienne Pallier
- OU SONT LES MENUS ? : app/View/Elements/
1008 263 Etienne Pallier
	- menu general + Recherche generale : menu.ctp
1009 263 Etienne Pallier
	- sous le menu general, et sous le champ "Recherche", titre du modele a ajouter : menu_index.ctp
1010 263 Etienne Pallier
1011 263 Etienne Pallier
- OU EST LA FEUILLE DE STYLE CSS ? : cakephp/app/webroot/css/inventirap.css
1012 263 Etienne Pallier
1013 263 Etienne Pallier
- OU EST DEFINIE LA PAGINATION ?
1014 263 Etienne Pallier
Dans le Controleur
1015 263 Etienne Pallier
Ex : la pagination des materiels est definie dans app/Controller/MaterielsController.php 
1016 263 Etienne Pallier
	public $paginate = array(
1017 263 Etienne Pallier
		'limit' => 50,
1018 263 Etienne Pallier
		'order' => array('Materiel.id' => 'desc'));
1019 263 Etienne Pallier
1020 263 Etienne Pallier
- OU SONT LES INFOS CONCERNANT UNE ENTITE quelconque (Materiel, Emprunt, Suivi, Utilisateur) ?
1021 263 Etienne Pallier
par exemple, ou trouver les infos sur l'entite "Materiel" ? : Aller dans cakephp/app/
1022 263 Etienne Pallier
- le Modele : Model/Materiel.php
1023 263 Etienne Pallier
- le Controleur : Controller/MaterielsController.php
1024 1 Etienne Pallier
- les Vues (templates) : View/Materiels
1025 1 Etienne Pallier
	- Vue de consultation : scaffold.view.ctp
1026 263 Etienne Pallier
	- Vue d'ajout (add) et edition (edit) : scaffold.form.ctp
1027 263 Etienne Pallier
	- vue de liste : index.ctp
1028 263 Etienne Pallier
1029 263 Etienne Pallier
- OU SONT DEFINIS LES ROLES (ACL) ?
1030 263 Etienne Pallier
Dans app/Model/Utilisateur.php :
1031 263 Etienne Pallier
	private $acceptedRoles = array ('Utilisateur', 'Responsable', 'Administration', 'Super Administrateur');
1032 263 Etienne Pallier
	public function getAuthenticationLevelFromRole($role) {
1033 263 Etienne Pallier
		if ($role == 'Utilisateur')
1034 263 Etienne Pallier
			return 1;
1035 263 Etienne Pallier
		elseif ($role == 'Responsable')
1036 263 Etienne Pallier
			return 2;
1037 263 Etienne Pallier
		elseif ($role == 'Administration')
1038 263 Etienne Pallier
			return 3;
1039 263 Etienne Pallier
		elseif ($role == 'Super Administrateur')
1040 263 Etienne Pallier
			return 4;
1041 263 Etienne Pallier
		return 0;
1042 263 Etienne Pallier
	}
1043 263 Etienne Pallier
1044 263 Etienne Pallier
1045 263 Etienne Pallier
1046 264 Etienne Pallier
* *WORKFLOW des materiels*
1047 264 Etienne Pallier
1048 263 Etienne Pallier
Le statut d'un materiel change selon le workflow suivant :
1049 263 Etienne Pallier
1) Un utilisateur lambda le cree (n'importe qui du labo) --> CREATED
1050 263 Etienne Pallier
2) L'Administration le valide (apres avoir eventuellement complete la fiche) --> VALIDATED
1051 263 Etienne Pallier
3) Un utilisateur lambda demande a l'archiver --> TOBEARCHIVED
1052 263 Etienne Pallier
4) L'Administration le sort de l'inventaire --> ARCHIVED
1053 263 Etienne Pallier
1054 263 Etienne Pallier
Notes : 
1055 263 Etienne Pallier
- Dans l'ideal, le materiel est premierement cree par l'utilisateur concerne,
1056 263 Etienne Pallier
puis mis a jour par l'administration au moment de la commande (puis validé)
1057 263 Etienne Pallier
- L'administration peut toujours retrograder le statut d'un materiel (ce qui revient a annuler un changement de statut) 
1058 263 Etienne Pallier
1059 263 Etienne Pallier
1060 263 Etienne Pallier
1061 264 Etienne Pallier
* *STRUCTURE GENERALE D'UNE PAGE WEB (TEMPLATE) = default.ctp*
1062 264 Etienne Pallier
1063 263 Etienne Pallier
app/View/Layouts/default.ctp contient la structure suivante :
1064 263 Etienne Pallier
1065 1 Etienne Pallier
	<div id="container">
1066 1 Etienne Pallier
		<div id="header">
1067 263 Etienne Pallier
			LE HEADER AVEC SON LOGO
1068 263 Etienne Pallier
			<div class="user">
1069 263 Etienne Pallier
				BIENVENUE $userName (ou invité)
1070 263 Etienne Pallier
			</div>
1071 263 Etienne Pallier
		</div>
1072 263 Etienne Pallier
		<div id="content">
1073 263 Etienne Pallier
			<?php echo $this->Session->flash(); ?>
1074 1 Etienne Pallier
			<?php echo $this->fetch('content'); ?>
1075 1 Etienne Pallier
		</div>
1076 263 Etienne Pallier
		<div id="footer">
1077 263 Etienne Pallier
			LE FOOTER
1078 263 Etienne Pallier
		</div>
1079 263 Etienne Pallier
	</div>
1080 263 Etienne Pallier
1081 263 Etienne Pallier
La DIV "content" insère 2 contenus :
1082 263 Etienne Pallier
	- le message flash éventuel (qui dit si une opération demandée s'est bien passée ou pas...)
1083 1 Etienne Pallier
	- la section "content", qui n'est autre que le coeur de la page
1084 1 Etienne Pallier
	
1085 263 Etienne Pallier
La page d'ACCUEIL n'est qu'un "content" parmi d'autres.
1086 263 Etienne Pallier
Elle se trouve dans app/View/Pages/home.ctp
1087 263 Etienne Pallier
(elle est affichée par le controleur de pages nommé PagesController)
1088 263 Etienne Pallier
1089 263 Etienne Pallier
1090 263 Etienne Pallier
1091 264 Etienne Pallier
* *COMMENT VOIR LES REQUETES SQL FAITES PAR CAKEPHP ?*
1092 264 Etienne Pallier
1093 263 Etienne Pallier
Dans le layout general (cakephp/app/View/Layouts/default.php), ajouter cette ligne :
1094 263 Etienne Pallier
	<?php echo $this->element('SQL_DUMP'); ?>
1095 263 Etienne Pallier
Vous devez aussi vous assurer que vous etes bien en mode DEBUG=2 (et non pas 0 ou 1)
1096 263 Etienne Pallier
dans le fichier de configuration Config/labinvent.php (ou bien dans le fichier Config/core.php)
1097 263 Etienne Pallier
1098 263 Etienne Pallier
1099 263 Etienne Pallier
1100 264 Etienne Pallier
* *OU EST FAIT LE CHARGEMENT DU FICHIER CONFIG database.php ?*
1101 264 Etienne Pallier
1102 263 Etienne Pallier
lib/Cake/Model/ConnectionManager.php (fonction _init())
1103 263 Etienne Pallier
Ce fichier fait partie de la librairie standard de CakePhp. Il ne faut donc pas y toucher.
1104 263 Etienne Pallier
A l'origine, j'avais (EP) changé ici le nom du fichier config "database.php" en "config.php",
1105 263 Etienne Pallier
ce qui marchait très très bien...
1106 263 Etienne Pallier
MAIS il ne vaut mieux pas modifier le comportement par défaut de cakephp,
1107 263 Etienne Pallier
car si un jour on change de version de cakephp, ça ne marchera plus.
1108 263 Etienne Pallier
1109 263 Etienne Pallier
1110 263 Etienne Pallier
1111 264 Etienne Pallier
* *CREATION ET GESTION DU NOUVEAU FICHIER DE CONFIG labinvent.php*
1112 264 Etienne Pallier
1113 263 Etienne Pallier
(cf http://book.cakephp.org/2.0/fr/development/configuration.html#loading-configuration-files)
1114 263 Etienne Pallier
1115 263 Etienne Pallier
1) J'ai créé le nouveau fichier de config dans app/Config/ (par exemple labinvent.php)
1116 263 Etienne Pallier
Ce fichier doit au minimum contenir un tableau nommé $config :
1117 263 Etienne Pallier
	$config = array(
1118 263 Etienne Pallier
			'labName' => 'IRAP',
1119 263 Etienne Pallier
			...
1120 263 Etienne Pallier
	);
1121 263 Etienne Pallier
 
1122 263 Etienne Pallier
2) Charger ce nouveau fichier de config au démarrage
1123 263 Etienne Pallier
Pour cela, ajouter cette ligne dans app/Config/bootstrap.php :
1124 263 Etienne Pallier
	Configure::load('labinvent');
1125 263 Etienne Pallier
1126 263 Etienne Pallier
3) Lire (ou même modifier) les paramètres de ce fichier de config, depuis N'IMPORTE OU (controleur, modèle, vue) :
1127 263 Etienne Pallier
		debug(Configure::version()); // pour afficher la version de Cakephp
1128 1 Etienne Pallier
		debug(Configure::read()); // tout lire
1129 1 Etienne Pallier
		debug(Configure::read('localisation')); // le tableau $localisation
1130 263 Etienne Pallier
		$labName = strtoupper(Configure::read('localisation.labNameShort'));
1131 263 Etienne Pallier
		debug(Configure::read('localisation.labName'));
1132 263 Etienne Pallier
		if (Configure::read('USE_LDAP')) ...
1133 263 Etienne Pallier
		if (Configure::read('debug') > 0 ) ...
1134 263 Etienne Pallier
On peut même modifier la valeur d'un paramètre dynamiquement comme ceci :
1135 263 Etienne Pallier
		Configure::write('debug',2)
1136 263 Etienne Pallier
C'est d'ailleurs ce qui est fait dans app/Config/core.php
1137 263 Etienne Pallier
1138 263 Etienne Pallier
1139 263 Etienne Pallier
4) Penser à modifier le script d'installation install/installation.sh pour qu'il prenne en compte ce nouveau fichier
1140 1 Etienne Pallier
1141 263 Etienne Pallier
1142 263 Etienne Pallier
1143 263 Etienne Pallier
1144 264 Etienne Pallier
* *LOCALISATION (adapatation du logiciel à l'entité locale)*
1145 263 Etienne Pallier
1146 263 Etienne Pallier
Vues (Pages) impactées :
1147 263 Etienne Pallier
- app/View/Layouts/default.ctp (template)
1148 263 Etienne Pallier
- app/View/Pages/home.ctp (Accueil)
1149 263 Etienne Pallier
- app/View/Pages/about.ctp (A propos)
1150 263 Etienne Pallier
1151 263 Etienne Pallier
Controleurs impactés :
1152 263 Etienne Pallier
- MaterielsController.php (fonction getLabNumber())
1153 1 Etienne Pallier
1154 1 Etienne Pallier
Documents impactés :
1155 263 Etienne Pallier
- Etiquette
1156 263 Etienne Pallier
- app/View/Documents/admission.ctp (Document d'admission)
1157 263 Etienne Pallier
- app/View/Documents/admission_cnrs.ctp (Document d'admission CNRS)
1158 263 Etienne Pallier
- app/View/Documents/admission_ups.ctp (Document d'admission UPS)
1159 1 Etienne Pallier
1160 263 Etienne Pallier
1161 263 Etienne Pallier
1162 264 Etienne Pallier
* *AJOUTER UNE NOUVELLE PAGE WEB*
1163 264 Etienne Pallier
1164 263 Etienne Pallier
Par exemple, voici ce que j'ai fait pour ajouter la page "about", qui est accessible via l'url https://inventirap.irap.omp.eu/pages/about
1165 263 Etienne Pallier
1) Aller dans app/View/Pages/
1166 263 Etienne Pallier
1) Faire un copier/coller d'une page existante, par exemple infos.ctp, et l'appeler about.ctp
1167 263 Etienne Pallier
2) Remplir cette page avec le contenu souhaité
1168 263 Etienne Pallier
3) Tester que cette page est bien accessible via l'url http://.../pages/about
1169 263 Etienne Pallier
4) Ajouter un lien vers cette page, soit dans le menu outils (app/View/Pages/tools.ctp), soit dans le menu général (app/View/Elements/menu.ctp)
1170 263 Etienne Pallier
5) Si cette page ne doit pas être accessible a tout le monde, définir le profil minimum exigé dans app/Controller/PagesController.php, en ajoutant une ligne dans le tableau $minProfileAllowedForPage
1171 263 Etienne Pallier
1172 263 Etienne Pallier
1173 263 Etienne Pallier
1174 264 Etienne Pallier
* *LOGIN workflow*
1175 263 Etienne Pallier
1176 263 Etienne Pallier
Controller/UtilisateursController/login() : 
1177 263 Etienne Pallier
; cherche l'utilisateur dans la table utilisateurs pour voir si c'est un user SPECIAL ou bien un user quelconque
1178 263 Etienne Pallier
; appelle Controller/Component/LdapAuthComponent/connection() et getUserName($ldapAuthentication)
1179 263 Etienne Pallier
1180 263 Etienne Pallier
Controller/Component/LdapAuthComponent : contient les 2 méthodes 
1181 263 Etienne Pallier
	- connection() : appelle Model/LdapConnection/ldapAuthentication($login, $password)
1182 263 Etienne Pallier
	- getUserName() : appelle Model/LdapConnection/getUserAttributes($ldapAuthentication)
1183 263 Etienne Pallier
1184 263 Etienne Pallier
Page d'accueil = View/Pages/home.ctp
1185 263 Etienne Pallier
(Controleur des pages simples = Controller/PagesController.php)
1186 263 Etienne Pallier
1187 263 Etienne Pallier
1188 263 Etienne Pallier
1189 264 Etienne Pallier
* *LOG*
1190 264 Etienne Pallier
1191 263 Etienne Pallier
$this->log('Something broke');
1192 263 Etienne Pallier
==> écrit dans cakephp/app/tmp/logs/ :
1193 263 Etienne Pallier
- error.log
1194 263 Etienne Pallier
- inventirap.log
1195 263 Etienne Pallier
1196 263 Etienne Pallier
1197 263 Etienne Pallier
1198 264 Etienne Pallier
* *GOOGLE ANALYTICS INTEGRATION*
1199 263 Etienne Pallier
1200 263 Etienne Pallier
adapté de http://blog.janjonas.net/2010-01-31/cakephp-google-analytics-integration
1201 1 Etienne Pallier
1202 263 Etienne Pallier
1) Copier ce code dans app/View/Elements/google-analytics.ctp :
1203 263 Etienne Pallier
<?php
1204 263 Etienne Pallier
$gaCode = Configure::read('google-analytics.tracker-code');
1205 263 Etienne Pallier
if ($gaCode) {
1206 263 Etienne Pallier
$googleAnalytics = <<<EOD
1207 263 Etienne Pallier
<script type="text/javascript">
1208 263 Etienne Pallier
  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
1209 263 Etienne Pallier
  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
1210 263 Etienne Pallier
  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
1211 263 Etienne Pallier
  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
1212 263 Etienne Pallier
1213 263 Etienne Pallier
  ga('create', 'UA-45668893-3', 'omp.eu');
1214 263 Etienne Pallier
  ga('send', 'pageview');
1215 263 Etienne Pallier
1216 263 Etienne Pallier
</script>
1217 263 Etienne Pallier
EOD;
1218 263 Etienne Pallier
echo $googleAnalytics;
1219 263 Etienne Pallier
}
1220 263 Etienne Pallier
?>
1221 263 Etienne Pallier
1222 263 Etienne Pallier
/* ANCIEN CODE JAVASCRIPT :
1223 263 Etienne Pallier
<script type="text/javascript">
1224 263 Etienne Pallier
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
1225 263 Etienne Pallier
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
1226 263 Etienne Pallier
</script>
1227 263 Etienne Pallier
<script type="text/javascript">
1228 263 Etienne Pallier
try {
1229 1 Etienne Pallier
var pageTracker = _gat._getTracker("$gaCode");
1230 1 Etienne Pallier
pageTracker._trackPageview();
1231 263 Etienne Pallier
} catch(err) {}</script>
1232 263 Etienne Pallier
*/
1233 263 Etienne Pallier
1234 263 Etienne Pallier
1235 263 Etienne Pallier
1236 263 Etienne Pallier
2) Inclure le view element dans app/View/Layouts/default.ctp (juste avant </body>):
1237 263 Etienne Pallier
<?php echo $this->element('google-analytics'); ?>
1238 1 Etienne Pallier
1239 1 Etienne Pallier
3) Définir le tracker code dans la configuration (/app/Config/core.php):
1240 263 Etienne Pallier
Configure::write('google-analytics.tracker-code', false); // disables Google Analytics
1241 263 Etienne Pallier
Configure::write('google-analytics.tracker-code', 'YOUR-TRACKING-CODE'); // enables Google Analytics
1242 263 Etienne Pallier
1243 263 Etienne Pallier
1244 264 Etienne Pallier
* *GENERALITES*
1245 263 Etienne Pallier
1246 263 Etienne Pallier
- URL : http://localhost/inventirapsvn/cakephp/
1247 263 Etienne Pallier
1248 263 Etienne Pallier
- BD admin : http://localhost/phpmyadmin
1249 263 Etienne Pallier
1250 263 Etienne Pallier
- LOG : cakephp/app/tmp/logs/inventirap.log
1251 263 Etienne Pallier
1252 263 Etienne Pallier
- (UPDATE : cd Inventirap/ ; chmod -R 777 ./cakephp/app/tmp/)
1253 263 Etienne Pallier
1254 263 Etienne Pallier
- (SORTIE INVENTAIRE a faire : pc portable DELL (ex Nicolas Andre) - sept 2012 CNES 4017 (carte mere hs))
1255 263 Etienne Pallier
1256 263 Etienne Pallier
- Eclipse config :
1257 263 Etienne Pallier
Setup syntax highlighting for .ctp files:
1258 263 Etienne Pallier
Window > Preferences > General > Appearance > content Types > Text > PHP Content type > Add.. , then put in *.ctp.
1259 263 Etienne Pallier
1260 263 Etienne Pallier
- Cakephp config : cakephp/app/Config/
1261 263 Etienne Pallier
Mode debug ON (pour voir les erreurs et pour vider le cache en cas de changement sur la BD) 
1262 263 Etienne Pallier
core.php : 	Configure::write('debug', 1);
1263 263 Etienne Pallier
1264 263 Etienne Pallier
- Fichier de demarrage :
1265 263 Etienne Pallier
cakephp/index.php (qui pointe sur cakephp/app/webroot/index.php)
1266 263 Etienne Pallier
(Attention, il y a aussi un fichier cakephp/app/index.php qui pointe sur webroot/index.php)
1267 263 Etienne Pallier
(ROOT doit pointer sur le dossier cakephp/)
1268 263 Etienne Pallier
Le fichier execute ensuite est cakephp/lib/Cake/bootstrap.php qui lance ./Core/App.php
1269 263 Etienne Pallier
and so on...
1270 263 Etienne Pallier
1271 263 Etienne Pallier
1272 263 Etienne Pallier
1273 263 Etienne Pallier
1274 264 Etienne Pallier
* *RECHERCHE de materiels*
1275 264 Etienne Pallier
1276 263 Etienne Pallier
3 methodes :
1277 263 Etienne Pallier
- recherche generale (sous le menu general) : cakephp/app/View/Elements/menu.ctp
1278 1 Etienne Pallier
- VUE de recherche : cakephp/app/View/Materiels/find.ctp
1279 1 Etienne Pallier
- ACTION de recherche : cakephp/app/Controller/MaterielsController (methode find())
1280 263 Etienne Pallier
1281 263 Etienne Pallier
1282 263 Etienne Pallier
1283 264 Etienne Pallier
* *ACL (Controle d'acces aux ressources)*
1284 264 Etienne Pallier
1285 263 Etienne Pallier
NB: Cette section n'est sans doute plus très à jour ; sur ce sujet, il est préférable de lire le document docs/userguide/ACL.doc (ou .pdf)
1286 263 Etienne Pallier
1287 263 Etienne Pallier
Synthese sur les droits selon le profil
1288 263 Etienne Pallier
1289 1 Etienne Pallier
Profils (roles), dans le sens du pouvoir croissant :
1290 1 Etienne Pallier
Qq = Utilisateur Quelconque (lambda)
1291 263 Etienne Pallier
Rp = Responsable
1292 263 Etienne Pallier
Ad = Administration
1293 263 Etienne Pallier
Sa = Superadmin
1294 263 Etienne Pallier
1295 263 Etienne Pallier
Actions :
1296 263 Etienne Pallier
C = Create
1297 263 Etienne Pallier
R = Read (voir, consulter)
1298 263 Etienne Pallier
U = Update (mettre a jour)
1299 263 Etienne Pallier
D = Delete (supprimer)
1300 263 Etienne Pallier
V = Valider un materiel CREATED --> passe alors en statut VALIDATED
1301 263 Etienne Pallier
A = Demander l'Archivage d'un materiel VALIDATED --> passe alors en statut TOBEARCHIVED 
1302 263 Etienne Pallier
S = Sortir de l'inventaire (Valider une demande d'archivage d'un materiel TOBEARCHIVED) --> passe alors en statut ARCHIVED 
1303 263 Etienne Pallier
E = Exporter
1304 263 Etienne Pallier
1305 263 Etienne Pallier
Par defaut, le superadmin a acces a TOUT 
1306 263 Etienne Pallier
1307 263 Etienne Pallier
Materiels :
1308 263 Etienne Pallier
- Qq a les droits C, R (sauf champs admin), U (si createur et sauf champs admin), A, D (si CREATED et owner)
1309 263 Etienne Pallier
- Rp a les droits C, R (sauf champs admin), U (sauf champs admin), D (si CREATED), V, A, E
1310 263 Etienne Pallier
- Ad a les droits C, R, U (ssi NOT ARCHIVED), D (si CREATED), V, (A mais inutile car fait directement S sans passer par A), S, E
1311 263 Etienne Pallier
1312 263 Etienne Pallier
Suivis et Emprunts :
1313 263 Etienne Pallier
- Dans tous les cas, on ne doit pas pouvoir emprunter ou suivre un materiel non valide (CREATED)
1314 263 Etienne Pallier
- Qq a les droits C, R, U (si createur), D (si createur)
1315 263 Etienne Pallier
- Rp a les droits C, R, U, D
1316 263 Etienne Pallier
- Ad a les memes droits que Rp
1317 263 Etienne Pallier
1318 263 Etienne Pallier
VUES specifiques :
1319 263 Etienne Pallier
- Acces aux Outils : reserve a Rp et Ad (vue contenant des liens vers differentes ressources telles que utilisateurs, materiels, categories...)
1320 263 Etienne Pallier
- L'administration a une vue resumee sur la page d'accueil (liens directs vers actions a faire)
1321 263 Etienne Pallier
- L'administration a une vue enrichie de la liste des materiels :
1322 263 Etienne Pallier
	- filtres (y-compris sur ARCHIVED)
1323 263 Etienne Pallier
	- export en CSV (pour tableur Excel)
1324 263 Etienne Pallier
	- upgrade du statut (validation et sortie)
1325 263 Etienne Pallier
1326 263 Etienne Pallier
Autres regles (de gestion) importantes :
1327 264 Etienne Pallier
- un materiel non valide (CREATED) peut etre supprime uniquement par le createur de la fiche, le responsable (Roger), et l'administration
1328 264 Etienne Pallier
Idem pour la mise a jour de cette fiche
1329 263 Etienne Pallier
- un materiel valide (VALIDATED) n'est pas supprimable
1330 263 Etienne Pallier
- les champs ADMINISTRATIFS d'un materiel ne sont visibles et modifiables que par l'administration
1331 263 Etienne Pallier
- par defaut, la liste des materiels affiche tous les materiels SAUF ceux qui sont sortis de l'inventaire (ARCHIVED) qui sont donc masques.
1332 263 Etienne Pallier
Il est de toutes facons toujours possible (pour l'administration seulement) de les voir, grace au nouveau filtre "Archives" present sur la liste des materiels
1333 263 Etienne Pallier
- la recherche doit s'effectuer dans TOUS les materiels (y-compris ARCHIVED)
1334 263 Etienne Pallier
1335 263 Etienne Pallier
1336 263 Etienne Pallier
1337 263 Etienne Pallier
1338 264 Etienne Pallier
* *COMMENT CONTOURNER LE LDAP officiel*
1339 264 Etienne Pallier
1340 263 Etienne Pallier
(ATTENTION: CONTENU OBSOLETE A METTRE A JOUR (EP))
1341 263 Etienne Pallier
1342 263 Etienne Pallier
(cf Controller/UtilisateursController.php :	methode login())
1343 263 Etienne Pallier
1344 263 Etienne Pallier
1) Si on veut tester le LDAP, on peut utiliser le LDAP de la Virtual Machine Upsilon (CentOS 6)
1345 263 Etienne Pallier
Dans ce cas, il faut ajouter dans la BD les utilisateurs specifiques suivants :
1346 263 Etienne Pallier
# Ajout d'utilisateurs de TEST (LDAP upsilon)
1347 263 Etienne Pallier
INSERT INTO utilisateurs (nom, login, email, role, groupes_metier_id) VALUES
1348 263 Etienne Pallier
 	('Hillembrand Cedric', 'Cedric', 'Cedric.Hillembrand@irap.omp.eu', 'Super Administrateur', 1),
1349 263 Etienne Pallier
 	('Turner Daniel', 'Daniel', 'Daniel.Turner@irap.omp.eu', 'Administration', 1),
1350 263 Etienne Pallier
 	('Sky Gin', 'Gin', 'Gin.Sky@irap.omp.eu', 'Responsable', 1),
1351 263 Etienne Pallier
 	('Robert Henri', 'Henri', 'Henri.Robert', 'Utilisateur', 1);
1352 263 Etienne Pallier
1353 263 Etienne Pallier
2) Sinon, le plus simple est d'utiliser un FAUX (fake) LDAP interne a l'application
1354 263 Etienne Pallier
Dans ce cas, il faut decommenter la variable $fakeLDAP dans le fichier config.php et ajouter dans la BD les utilisateurs specifiques suivants :
1355 263 Etienne Pallier
# Ajout d'utilisateurs de TEST (hors LDAP)
1356 263 Etienne Pallier
INSERT INTO utilisateurs (nom, login, email, role, groupes_metier_id) VALUES
1357 263 Etienne Pallier
 	('Hubert SuperAdmin', 'superadmin', 'hubert.superadmin@irap.omp.eu', 'Super Administrateur', 1),
1358 263 Etienne Pallier
 	('Pierre Responsable', 'responsable', 'pierre.resp@irap.omp.eu', 'Responsable', 2),
1359 263 Etienne Pallier
 	('Jean Administration', 'admin', 'Jean.Administration@irap.omp.eu', 'Administration', 5),
1360 263 Etienne Pallier
 	('Jacques Utilisateur', 'user', 'Jacques.Utilisateur@irap.omp.eu', 'Utilisateur', 7);
1361 263 Etienne Pallier
1362 263 Etienne Pallier
Informations sur le LDAP :
1363 263 Etienne Pallier
1364 263 Etienne Pallier
Classe LdapAuthComponent (extends AuthComponent), definie dans : app/Controller/Component/LdapAuthComponent.php 
1365 263 Etienne Pallier
1366 263 Etienne Pallier
Definition des roles (ACL) : app/Model/Utilisateur.php :
1367 263 Etienne Pallier
	private $acceptedRoles = array ('Utilisateur', 'Responsable', 'Administration', 'Super Administrateur');
1368 263 Etienne Pallier
	public function getAuthenticationLevelFromRole($role) {
1369 263 Etienne Pallier
		if ($role == 'Utilisateur')
1370 263 Etienne Pallier
			return 1;
1371 263 Etienne Pallier
		elseif ($role == 'Responsable')
1372 263 Etienne Pallier
			return 2;
1373 263 Etienne Pallier
		elseif ($role == 'Administration')
1374 263 Etienne Pallier
			return 3;
1375 263 Etienne Pallier
		elseif ($role == 'Super Administrateur')
1376 263 Etienne Pallier
			return 4;
1377 263 Etienne Pallier
		return 0;
1378 263 Etienne Pallier
	}
1379 263 Etienne Pallier
1380 263 Etienne Pallier
Lecture du fichier de config : app/Model/LdapConnection.php :
1381 263 Etienne Pallier
		private function checkConfiguration()
1382 263 Etienne Pallier
1383 263 Etienne Pallier
Workflow du LDAP :
1384 263 Etienne Pallier
1) Page d'accueil : j'entre mon login et pwd
1385 263 Etienne Pallier
2) clic sur bouton "Se Connecter" --> execute l'action Utilisateurs/login (dans app/Controller/UtilisateursController.php)
1386 263 Etienne Pallier
1387 263 Etienne Pallier
1388 263 Etienne Pallier
1389 263 Etienne Pallier
1390 263 Etienne Pallier
1391 264 Etienne Pallier
* *COMMENT AJOUTER UNE NOUVELLE TABLE DANS LA BD*
1392 263 Etienne Pallier
1393 263 Etienne Pallier
On explique ici ce qu'il faut faire quand on veut ajouter une nouvelle table dans la base de données, 
1394 263 Etienne Pallier
table qui doit être prise en compte dans l'application.
1395 263 Etienne Pallier
Cette explication est donnée avec 2 exemples.
1396 263 Etienne Pallier
1397 263 Etienne Pallier
1) Premier exemple : ajout de la table sur-categorie (EP)
1398 263 Etienne Pallier
1399 263 Etienne Pallier
Avant cet ajout, il n'y avait que la table categorie et la table sous-categorie.
1400 263 Etienne Pallier
Vous trouverez plus de détails sur ce sujet dans la section suivante nommée "COMMENT J'AI FAIT POUR AJOUTER UN 3eme niveau de categorie appele sur_categorie (ou domaine)"
1401 263 Etienne Pallier
1402 263 Etienne Pallier
a) impact sur la BD
1403 263 Etienne Pallier
- ajout d'une nouvelle table sur_categories(id,nom) :
1404 263 Etienne Pallier
CREATE TABLE IF NOT EXISTS sur_categories (
1405 263 Etienne Pallier
  id int(11) NOT NULL AUTO_INCREMENT,
1406 263 Etienne Pallier
  nom varchar(45) DEFAULT NULL,
1407 263 Etienne Pallier
  PRIMARY KEY (id),
1408 263 Etienne Pallier
  UNIQUE KEY nom_UNIQUE (nom)
1409 263 Etienne Pallier
) ENGINE=InnoDB  DEFAULT CHARSET=latin1;
1410 263 Etienne Pallier
1411 263 Etienne Pallier
- ajout dans la table categories d'une cle etrangere sur_categorie_id :
1412 263 Etienne Pallier
ALTER TABLE categories 
1413 263 Etienne Pallier
	ADD sur_categorie_id INT( 11 ) NULL DEFAULT NULL,
1414 263 Etienne Pallier
  	ADD CONSTRAINT fk_sur_categorie_id FOREIGN KEY (sur_categorie_id) REFERENCES sur_categories (id) ON DELETE NO ACTION ON UPDATE NO ACTION;
1415 263 Etienne Pallier
1416 263 Etienne Pallier
- ajout dans la table materiels d'une cle etrangere sur_categorie_id :
1417 263 Etienne Pallier
ALTER TABLE materiels 
1418 263 Etienne Pallier
	ADD sur_categorie_id INT( 11 ) NOT NULL after designation,
1419 263 Etienne Pallier
	ADD CONSTRAINT fk_materiels_sur_categorie_id FOREIGN KEY (sur_categorie_id) REFERENCES sur_categories (id) ON DELETE NO ACTION ON UPDATE NO ACTION;
1420 263 Etienne Pallier
1421 263 Etienne Pallier
(attention, il faut d'abord vider les lignes des tables suivis, emprunts, et materiels)
1422 263 Etienne Pallier
delete from suivis;
1423 263 Etienne Pallier
delete from emprunts;
1424 263 Etienne Pallier
delete from materiels;
1425 1 Etienne Pallier
1426 263 Etienne Pallier
Il faut aussi ajouter des sur-categories :
1427 263 Etienne Pallier
# Ajout de quelques sur-categories
1428 263 Etienne Pallier
insert into sur_categories (id,nom) values 
1429 263 Etienne Pallier
(1,'Electronique'), 
1430 263 Etienne Pallier
(2,'Informatique'), 
1431 263 Etienne Pallier
(3,'Instrumentation')
1432 263 Etienne Pallier
(4, 'Logistique'),
1433 263 Etienne Pallier
(5, 'Mecanique'),
1434 263 Etienne Pallier
(6, 'Optique')
1435 263 Etienne Pallier
;
1436 263 Etienne Pallier
1437 263 Etienne Pallier
# Relier toutes les categories a une sur-categorie (la 1)
1438 263 Etienne Pallier
update categories set sur_categorie_id=1 where id<10; 
1439 263 Etienne Pallier
update categories set sur_categorie_id=2 where id>=10 and id<20; 
1440 263 Etienne Pallier
update categories set sur_categorie_id=3 where id>=20;
1441 263 Etienne Pallier
1442 263 Etienne Pallier
1443 263 Etienne Pallier
b) impact sur les modeles (cakephp/app/Model)
1444 263 Etienne Pallier
- Ajout du nouveau modèle SurCategorie.php : copie de Categorie.php avec "hasMany categorie"
1445 263 Etienne Pallier
- Modif du modèle Categorie.php : + belongsTo="SurCategorie"
1446 263 Etienne Pallier
1447 263 Etienne Pallier
c) impact sur les controleurs (cakephp/app/Controller)
1448 263 Etienne Pallier
- Ajout du nouveau controleur SurCategoriesController.php : minimaliste (comme CategoriesController)
1449 1 Etienne Pallier
- Modif du controleur CategoriesController.php : +getBySurCategorie()
1450 263 Etienne Pallier
1451 263 Etienne Pallier
d) impact sur les vues (cakephp/app/View)
1452 263 Etienne Pallier
- SurCategorie : no view (scaffold ?)
1453 263 Etienne Pallier
- Categorie : actuellement no view (scaffold ?) 
1454 263 Etienne Pallier
--> creer une vue (comme SousCategorie) 
1455 263 Etienne Pallier
+ get_by_surcategorie.ctp
1456 263 Etienne Pallier
+ scaffold.form.ctp
1457 263 Etienne Pallier
1458 263 Etienne Pallier
e) View/Pages/tools.ctp : ajouter une entree au menu pour les Sur-Categories
1459 263 Etienne Pallier
1460 263 Etienne Pallier
f) impact sur TOUTES les vues de Materiel
1461 263 Etienne Pallier
add/edit/view/index
1462 263 Etienne Pallier
dans la vue index, remplacer la categorie par la sur-categorie
1463 263 Etienne Pallier
GROS BOULOT sur la vue ADD/EDIT (+ javascript)
1464 263 Etienne Pallier
1465 263 Etienne Pallier
1466 263 Etienne Pallier
2) Deuxième exemple : ajout de la table type_suivis (VM)
1467 263 Etienne Pallier
1468 263 Etienne Pallier
Un peu plus haut est expliqué comment créer une table, je vais ici expliquer comment créer et remplir tout ce qui est basiquement 
1469 263 Etienne Pallier
nécessaire pour l'utiliser, en prenant pour exemple la table type_suivis.
1470 263 Etienne Pallier
1471 263 Etienne Pallier
Après avoir créé la table, on lui crée :
1472 263 Etienne Pallier
- Un controller : Héritant de AppController, avec une variable $scaffold sui se chargera de presque tout et une variable $name avec son nom.
1473 263 Etienne Pallier
- Un model : Avec la même variable $name et une variable $displayField qui correspond a la designation dans la BDD (ex: "nom");
1474 263 Etienne Pallier
	Il doit contenir la fonction typeSuiviNameIsUnik($name) {} (qu'on retrouve dans sites ou organisme) ainsi que le $validate comprenant les validations necessaires. 
1475 263 Etienne Pallier
- Une vue, selon l'utilité, n'est pas forcément nécessaire grâce au scaffold.
1476 263 Etienne Pallier
Par la suite, pour lister son contenu via un lien dans "outils" par exemple, il suffit de créer le chemin dans view/pages/tools.ctp.
1477 263 Etienne Pallier
1478 263 Etienne Pallier
1479 263 Etienne Pallier
1480 264 Etienne Pallier
* *CREER UN CHAMP DATE (VM)*
1481 263 Etienne Pallier
1482 263 Etienne Pallier
Pour expliquer comment créer un champ date fonctionnel, je vais prendre l'exemple de la Date de reception.
1483 263 Etienne Pallier
Une fois vôtre colonne créé dans la table marteriel, vous devrez faire des modifications dans : 
1484 263 Etienne Pallier
1485 263 Etienne Pallier
MaterielController : //Passer la date au format français	
1486 263 Etienne Pallier
1487 263 Etienne Pallier
		if(isset($this->request->data['Materiel']['date_reception'])){
1488 263 Etienne Pallier
		$this->request->data['Materiel']['date_reception'] = date("d-m-Y", strtotime($this->request->data['Materiel']['date_reception'])); }
1489 263 Etienne Pallier
1490 263 Etienne Pallier
le Model Materiel : Créer un champ de validation adapté à la date, avec un regex. Et surtout remplir le formatage de date à l'américaine :
1491 263 Etienne Pallier
1492 263 Etienne Pallier
		if (isset($this->data['Materiel']['date_reception'])) {
1493 263 Etienne Pallier
			$originalDate = $this->data['Materiel']['date_reception'];
1494 263 Etienne Pallier
			$this->data['Materiel']['date_reception'] = date("Y-m-d", strtotime($originalDate));
1495 263 Etienne Pallier
		}
1496 263 Etienne Pallier
1497 263 Etienne Pallier
La vue Materiel : - Scaffold.view : Repasser la date en français et l'afficher.
1498 263 Etienne Pallier
				  - Scaffold.form : Créer le champ date du formulaire
1499 263 Etienne Pallier
1500 263 Etienne Pallier
Puis il faut adapter le champ date reception presque partout ou il y a le champ date acquisition.
1501 263 Etienne Pallier
1502 263 Etienne Pallier
1503 263 Etienne Pallier
1504 263 Etienne Pallier
1505 263 Etienne Pallier
1506 264 Etienne Pallier
* *COMMENT J'AI FAIT POUR AJOUTER UN 3eme niveau de categorie appele sur_categorie (ou domaine) (EP) ?*
1507 263 Etienne Pallier
1508 263 Etienne Pallier
je me rends compte d'une incoherence de stockage dans la table Materiels.
1509 263 Etienne Pallier
En effet, quand on saisit un materiel, on doit choisir une categorie ET une sous-categorie.
1510 263 Etienne Pallier
Du coup, les 2 id (categorie + sous-categorie) sont stockes dans la table Materiels...
1511 263 Etienne Pallier
Or, c'est inutile car la sous-categorie suffit a determiner la categorie...
1512 263 Etienne Pallier
Cette redondance pourrait meme amener des incoherences dans la table Materiels si par exemple on fait des modifications 
1513 263 Etienne Pallier
dans les tables categories et sous_categories sans les repercuter dans la table materiels !!
1514 263 Etienne Pallier
Je suppose que c'est un choix de facilite qui a ete fait par upsilon.
1515 263 Etienne Pallier
1516 263 Etienne Pallier
Donc, si vous etes ok, et a moins que Upsilon me dise qu'il y avait une bonne raison de faire ce choix (j'en doute),
1517 263 Etienne Pallier
je propose de modifier le code pour que seule la sous-categorie soit stockee (on ne stocke plus la categorie).
1518 263 Etienne Pallier
1519 263 Etienne Pallier
En plus, cela simplifiera l'ajout du 3eme niveau "sur-categorie" puisque lui-meme n'aura pas besoin d'etre stocke etant donne qu'il est automatiquement determine par la categorie.
1520 263 Etienne Pallier
On aura alors :
1521 263 Etienne Pallier
sous_categorie_id -> categorie_id -> sur_categorie_id
1522 263 Etienne Pallier
Avec seulement la sous_categorie, on pourra determiner la categorie, et donc la sur_categorie. 
1523 263 Etienne Pallier
1524 263 Etienne Pallier
Du coup, si je fais cette modif, on pourrait meme se permettre de demarrer officiellement INVENTIRAP rapidement.
1525 263 Etienne Pallier
En effet, l'ajout de la sur-categorie ne change rien au contenu des tables "administratives" (materiels, emprunts, suivis), 
1526 263 Etienne Pallier
et donc on pourra le faire plus tard, meme apres que l'administration ait commence a remplir la BD. 
1527 263 Etienne Pallier
Ca sera totalement transparent.
1528 263 Etienne Pallier
1529 263 Etienne Pallier
1) suppression de la redondance (categorie_id) dans la table materiels
1530 263 Etienne Pallier
1531 263 Etienne Pallier
a) impact sur la vue index de Materiel
1532 263 Etienne Pallier
add/edit/view/index
1533 263 Etienne Pallier
1534 263 Etienne Pallier
2) ajout d'une sur-categorie
1535 263 Etienne Pallier
1536 263 Etienne Pallier
a) impact sur la BD
1537 263 Etienne Pallier
- ajout d'une nouvelle table sur_categories(id,nom) :
1538 263 Etienne Pallier
CREATE TABLE IF NOT EXISTS sur_categories (
1539 263 Etienne Pallier
  id int(11) NOT NULL AUTO_INCREMENT,
1540 263 Etienne Pallier
  nom varchar(45) DEFAULT NULL,
1541 263 Etienne Pallier
  PRIMARY KEY (id),
1542 263 Etienne Pallier
  UNIQUE KEY nom_UNIQUE (nom)
1543 1 Etienne Pallier
) ENGINE=InnoDB  DEFAULT CHARSET=latin1;
1544 263 Etienne Pallier
1545 263 Etienne Pallier
- ajout dans la table categories d'une cle etrangere sur_categorie_id :
1546 263 Etienne Pallier
ALTER TABLE categories 
1547 263 Etienne Pallier
	ADD sur_categorie_id INT( 11 ) NULL DEFAULT NULL,
1548 263 Etienne Pallier
  	ADD CONSTRAINT fk_sur_categorie_id FOREIGN KEY (sur_categorie_id) REFERENCES sur_categories (id) ON DELETE NO ACTION ON UPDATE NO ACTION;
1549 263 Etienne Pallier
1550 263 Etienne Pallier
- ajout dans la table materiels d'une cle etrangere sur_categorie_id :
1551 263 Etienne Pallier
ALTER TABLE materiels 
1552 263 Etienne Pallier
	ADD sur_categorie_id INT( 11 ) NOT NULL after designation,
1553 263 Etienne Pallier
	ADD CONSTRAINT fk_materiels_sur_categorie_id FOREIGN KEY (sur_categorie_id) REFERENCES sur_categories (id) ON DELETE NO ACTION ON UPDATE NO ACTION;
1554 263 Etienne Pallier
1555 263 Etienne Pallier
(attention, il faut d'abord vider les lignes des tables suivis, emprunts, et materiels)
1556 263 Etienne Pallier
delete from suivis;
1557 263 Etienne Pallier
delete from emprunts;
1558 263 Etienne Pallier
delete from materiels;
1559 263 Etienne Pallier
1560 263 Etienne Pallier
Il faut aussi ajouter des sur-categories :
1561 263 Etienne Pallier
# Ajout de quelques sur-categories
1562 263 Etienne Pallier
insert into sur_categories (id,nom) values 
1563 263 Etienne Pallier
(1,'Electronique'), 
1564 263 Etienne Pallier
(2,'Informatique'), 
1565 263 Etienne Pallier
(3,'Instrumentation')
1566 263 Etienne Pallier
(4, 'Logistique'),
1567 263 Etienne Pallier
(5, 'Mecanique'),
1568 263 Etienne Pallier
(6, 'Optique')
1569 263 Etienne Pallier
;
1570 263 Etienne Pallier
1571 263 Etienne Pallier
# Relier toutes les categories a une sur-categorie (la 1)
1572 263 Etienne Pallier
update categories set sur_categorie_id=1 where id<10; 
1573 263 Etienne Pallier
update categories set sur_categorie_id=2 where id>=10 and id<20; 
1574 263 Etienne Pallier
update categories set sur_categorie_id=3 where id>=20;
1575 263 Etienne Pallier
1576 263 Etienne Pallier
1577 263 Etienne Pallier
b) impact sur les modeles (cakephp/app/Model)
1578 263 Etienne Pallier
- SurCategorie.php : copie de Categorie.php avec "hasMany categorie"
1579 263 Etienne Pallier
- Categorie.php : + belongsTo="SurCategorie"
1580 263 Etienne Pallier
1581 263 Etienne Pallier
c) impact sur les controleurs (cakephp/app/Controller)
1582 263 Etienne Pallier
- SurCategoriesController.php : minimaliste (comme CategoriesController)
1583 263 Etienne Pallier
- CategoriesController.php : +getBySurCategorie()
1584 263 Etienne Pallier
1585 263 Etienne Pallier
d) impact sur les vues (cakephp/app/View)
1586 263 Etienne Pallier
- SurCategorie : no view (scaffold ?)
1587 263 Etienne Pallier
- Categorie : actuellement no view (scaffold ?) 
1588 263 Etienne Pallier
--> creer une vue (comme SousCategorie) 
1589 263 Etienne Pallier
+ get_by_surcategorie.ctp
1590 263 Etienne Pallier
+ scaffold.form.ctp
1591 263 Etienne Pallier
1592 263 Etienne Pallier
e) View/Pages/tools.ctp : ajouter une entree au menu pour les Sur-Categories
1593 263 Etienne Pallier
1594 263 Etienne Pallier
f) impact sur TOUTES les vues de Materiel
1595 263 Etienne Pallier
add/edit/view/index
1596 263 Etienne Pallier
dans la vue index, remplacer la categorie par la sur-categorie
1597 263 Etienne Pallier
GROS BOULOT sur la vue ADD/EDIT (+ javascript)
1598 263 Etienne Pallier
1599 263 Etienne Pallier
1600 263 Etienne Pallier
1601 263 Etienne Pallier
1602 264 Etienne Pallier
* *TESTS*
1603 263 Etienne Pallier
1604 263 Etienne Pallier
A - EXECUTION
1605 263 Etienne Pallier
1606 263 Etienne Pallier
Prérequis : PHPUNIT 3 doit être déjà installé et accessible depuis la console (phpunit -version) via le fichier php.ini
1607 263 Etienne Pallier
(ATTENTION : cakephp 2.x n'est pas compatible avec PhpUnit 4)
1608 263 Etienne Pallier
1609 263 Etienne Pallier
Avec XAMPP (conseillé) : PhpUnit 3 est déjà inclus
1610 263 Etienne Pallier
Avec MAMP (+ difficile) : pour installer PhpUnit, suivre cette documentation : http://www.dolinaj.net/software-installation/mac/how-to-install-phpunit-with-mamp-on-mac/
1611 263 Etienne Pallier
1612 263 Etienne Pallier
Procédure à suivre pour pouvoir exécuter les tests unitaires et fonctionnels livrés avec le logiciel :
1613 263 Etienne Pallier
1614 263 Etienne Pallier
1) Ajouter une nouvelle configuration de base de données dans votre fichier app/Config/database.php pour la BD de test
1615 263 Etienne Pallier
 
1616 263 Etienne Pallier
 Exemple de configuration :
1617 263 Etienne Pallier
 
1618 263 Etienne Pallier
	public $test = array(
1619 263 Etienne Pallier
		'datasource' => 'Database/Mysql',
1620 263 Etienne Pallier
		'persistent' => false,
1621 263 Etienne Pallier
		'host' => 'localhost',
1622 263 Etienne Pallier
		'database' => 'test_labinvent',
1623 263 Etienne Pallier
		'login' => 'root',
1624 263 Etienne Pallier
		'password' => '',
1625 263 Etienne Pallier
	);
1626 263 Etienne Pallier
1627 263 Etienne Pallier
1628 263 Etienne Pallier
2) Créer la BD de test (vide)
1629 263 Etienne Pallier
A l'aide de phpmyadmin ou bien avec un client mysql quelconque,
1630 263 Etienne Pallier
créer une BD de test vide que vous nommerez avec le même nom que celui donné dans la configuration ci-dessus,
1631 263 Etienne Pallier
soit pour l'exemple, "test_labinvent"
1632 263 Etienne Pallier
Syntaxe SQL : "create database test_labinvent"
1633 263 Etienne Pallier
1634 263 Etienne Pallier
3) Passer en mode "debug" 
1635 263 Etienne Pallier
Dans votre fichier de configuration labinvent.php, mettez votre paramètre "debug" à 1 ou 2 (mais pas à 0) :
1636 263 Etienne Pallier
		'debug' => 2,
1637 263 Etienne Pallier
1638 263 Etienne Pallier
4) Se connecter à l'application
1639 263 Etienne Pallier
Les test ne passeront pas si vous n'êtes pas connectés 
1640 263 Etienne Pallier
 
1641 263 Etienne Pallier
5) Exécuter les tests
1642 263 Etienne Pallier
1643 263 Etienne Pallier
a) Exécution depuis l'application (conseillé) :
1644 263 Etienne Pallier
ATTENTION : vous devez être logué pour que les tests passent !!!
1645 263 Etienne Pallier
Il suffit d'aller à l'URL /test.php de votre installation du logiciel LabInvent
1646 263 Etienne Pallier
(vous pouvez aussi essayer l'URL "/app/webroot/test.php", ou encore "/cakephp/test.php")
1647 263 Etienne Pallier
Cette page de tests se trouve dans cakephp/app/webroot/
1648 263 Etienne Pallier
Vous avez alors accès à 2 types de tests :
1649 263 Etienne Pallier
- App : Tests ==> les tests écris pour tester l'application Labinvent
1650 263 Etienne Pallier
- Core : Tests ==> les tests fournis avec cakephp pour tester le framework
1651 263 Etienne Pallier
Pour exécuter tous les tests liés à l'application Labinvent (à faire systématiquement avant de commiter tout changement) :
1652 263 Etienne Pallier
cliquer sur "Tests" sous "App", puis sur "AllTests"
1653 263 Etienne Pallier
("AllController" exécute tous les tests de controleurs ; "AllModel" exécute tous les tests de modèles)
1654 263 Etienne Pallier
1655 263 Etienne Pallier
b) Execution depuis la console :
1656 263 Etienne Pallier
Aller dans le repertoire app/
1657 263 Etienne Pallier
Pour tester le controleur MaterielsController :
1658 263 Etienne Pallier
./Console/cake test app Controller/MaterielsController
1659 263 Etienne Pallier
1660 263 Etienne Pallier
1661 263 Etienne Pallier
B - ECRITURE DE NOUVEAUX TESTS
1662 263 Etienne Pallier
1663 263 Etienne Pallier
cf http://book.cakephp.org/2.0/en/development/testing.html
1664 263 Etienne Pallier
1665 263 Etienne Pallier
Aller dans app/Test/
1666 263 Etienne Pallier
1667 263 Etienne Pallier
Ce dossier contient l'arborescence suivante :
1668 263 Etienne Pallier
1669 263 Etienne Pallier
- Case/ : les tests
1670 263 Etienne Pallier
	- Controller/ : les tests de controleurs
1671 263 Etienne Pallier
	- Model/ : les tests de modèles
1672 263 Etienne Pallier
	- View/ (peu ou pas utilisé) : les tests de vues (ou de helpers)
1673 263 Etienne Pallier
	- AllControllerTest.php : exécution de tous les tests de controleurs
1674 263 Etienne Pallier
	- AllModelTest.php : exécution de tous les tests de modèles
1675 263 Etienne Pallier
	- AllTestsTest.php : éxécution de TOUS les tests
1676 263 Etienne Pallier
	
1677 263 Etienne Pallier
- Fixture/ : les différentes initialisations nécessaires dans la BD de test pour pouvoir executer les tests
1678 263 Etienne Pallier
Ces "fixtures" sont automatiquement executees AU DEBUT de chaque test.
1679 263 Etienne Pallier
Ce dossier contient un fichier pour chaque table pour laquelle on a besoin d'une "fixture".
1680 263 Etienne Pallier
1681 263 Etienne Pallier
1) Les "fixtures"
1682 263 Etienne Pallier
1683 263 Etienne Pallier
La façon la plus basique de creer une fixture pour une table donnee est de la realiser automatiquement a partir d'une copie de la table de la vraie BD.
1684 263 Etienne Pallier
Par exemple, pour que la table "categories" de la BD de test contienne la meme chose que la table de la vraie BD, il suffit de creer un fichier CategorieFixture.php contenant ceci :
1685 263 Etienne Pallier
1686 263 Etienne Pallier
class CategorieFixture extends CakeTestFixture {
1687 263 Etienne Pallier
	public $import = array('model' => 'Categorie', 'records' => true);
1688 263 Etienne Pallier
}
1689 263 Etienne Pallier
1690 263 Etienne Pallier
Au demarrage des tests, cette table sera chargee automatiquement avec les vraies donnees.
1691 263 Etienne Pallier
A la fin des tests, cette table sera vidée.
1692 263 Etienne Pallier
	
1693 263 Etienne Pallier
Dans le cas particulier de la table "materiels", on prefere l'initialiser nous-memes avec des valeurs choisies.
1694 263 Etienne Pallier
Exemple d'une fixture avec 2 materiels (dans le fichier MaterielFixture.php) :
1695 263 Etienne Pallier
1696 263 Etienne Pallier
class MaterielFixture extends CakeTestFixture {
1697 263 Etienne Pallier
1698 263 Etienne Pallier
	public $import = 'Materiel'; // import only structure, no record
1699 263 Etienne Pallier
	
1700 263 Etienne Pallier
	public $records = array(
1701 263 Etienne Pallier
			array(
1702 263 Etienne Pallier
					'designation' => 'matos1', 
1703 263 Etienne Pallier
					'sur_categorie_id' => 1, 
1704 263 Etienne Pallier
					'categorie_id' => 11, 
1705 263 Etienne Pallier
					'materiel_administratif' => 0, 
1706 263 Etienne Pallier
					'materiel_technique' => 1, 
1707 263 Etienne Pallier
					'status' => 'CREATED', 
1708 263 Etienne Pallier
					'nom_createur' => 'Pallier Etienne', 
1709 263 Etienne Pallier
					'nom_modificateur' => 'Jean Administration', 
1710 263 Etienne Pallier
					'nom_responsable' => 'Jacques Utilisateur', 
1711 263 Etienne Pallier
					'email_responsable' => 'Jacques.Utilisateur@irap.omp.eu', 
1712 263 Etienne Pallier
			),
1713 263 Etienne Pallier
			array(
1714 263 Etienne Pallier
					'designation' => 'matos2',
1715 263 Etienne Pallier
					'sur_categorie_id' => 1,
1716 1 Etienne Pallier
					'categorie_id' => 11,
1717 263 Etienne Pallier
					'materiel_administratif' => 0,
1718 263 Etienne Pallier
					'materiel_technique' => 1,
1719 263 Etienne Pallier
					'status' => 'CREATED',
1720 263 Etienne Pallier
					'nom_createur' => 'Pallier Etienne',
1721 263 Etienne Pallier
					'nom_modificateur' => 'Jean Administration',
1722 263 Etienne Pallier
					'nom_responsable' => 'Jacques Utilisateur',
1723 263 Etienne Pallier
					'email_responsable' => 'Jacques.Utilisateur@irap.omp.eu',
1724 263 Etienne Pallier
			),
1725 263 Etienne Pallier
	);
1726 263 Etienne Pallier
} 
1727 263 Etienne Pallier
1728 263 Etienne Pallier
1729 263 Etienne Pallier
2) Les tests
1730 263 Etienne Pallier
1731 263 Etienne Pallier
Prenons l'exemple des tests ecrits pour le controleur des materiels (MaterielsController). Il devra s'appeler MaterielsControllerTest et aura la structure suivante :
1732 263 Etienne Pallier
1733 263 Etienne Pallier
class MaterielsControllerTest extends ControllerTestCase {
1734 263 Etienne Pallier
1735 263 Etienne Pallier
	// Liste des fixtures à charger avant l'execution des tests
1736 263 Etienne Pallier
	public $fixtures = array('app.materiel', 'app.sur_categorie', 'app.categorie', 'app.sous_categorie', 
1737 263 Etienne Pallier
			'app.groupes_thematique', 'app.groupes_metier', 'app.suivi', 'app.emprunt'
1738 263 Etienne Pallier
	);
1739 263 Etienne Pallier
	
1740 263 Etienne Pallier
	// Initialisations diverses a faire avant chaque test
1741 263 Etienne Pallier
	public function setUp() {
1742 263 Etienne Pallier
		parent::setUp();
1743 263 Etienne Pallier
	}
1744 263 Etienne Pallier
	
1745 263 Etienne Pallier
	// un 1er test	
1746 263 Etienne Pallier
	public function testMonPremier() {
1747 263 Etienne Pallier
		$result = $this->testAction(...);
1748 263 Etienne Pallier
		$this->assert...('resultat attendu', $result);
1749 263 Etienne Pallier
	}
1750 263 Etienne Pallier
1751 263 Etienne Pallier
	// un 2eme test
1752 263 Etienne Pallier
	public function testMonDeuxieme() {
1753 263 Etienne Pallier
		$result = $this->testAction(...);
1754 263 Etienne Pallier
		$this->assert...('resultat attendu', $result);
1755 263 Etienne Pallier
	}
1756 263 Etienne Pallier
1757 263 Etienne Pallier
	...
1758 263 Etienne Pallier
1759 263 Etienne Pallier
}	
1760 263 Etienne Pallier
	
1761 263 Etienne Pallier
Voir le vrai fichier Test/Case/Controller/MaterielsControllerTest.php
1762 263 Etienne Pallier
1763 263 Etienne Pallier
1764 263 Etienne Pallier
3) Execution
1765 263 Etienne Pallier
1766 263 Etienne Pallier
Exemple avec l'execution du test MaterielsControllerTest
1767 263 Etienne Pallier
1768 263 Etienne Pallier
a) Execution depuis le site web : 
1769 263 Etienne Pallier
/test.php?case=Controller%2FMaterielsController
1770 263 Etienne Pallier
Ajouter &debug=1 à l'url pour voir tous les messages de debug
1771 263 Etienne Pallier
1772 263 Etienne Pallier
b) Execution depuis la console :
1773 263 Etienne Pallier
Dans le repertoire app : ./Console/cake test app Controller/MaterielsController
1774 263 Etienne Pallier
Ajouter --debug pour voir tous les messages de debug
1775 263 Etienne Pallier
1776 263 Etienne Pallier
1777 263 Etienne Pallier
1778 263 Etienne Pallier
1779 264 Etienne Pallier
* *DATE PICKERS*
1780 263 Etienne Pallier
1781 263 Etienne Pallier
Pour fontionner, le datePicker fait appel dans la page "View/Layout/default" à 3 scripts (jquery-1.5.2.js, jquery-1.8.12.js, DatepickerConfig.js)
1782 263 Etienne Pallier
présents dans le repertoire "webroot/js/" et à un fichier "Theme" (smoothness.css) présent dans le repertoire "webroot/css/"
1783 263 Etienne Pallier
1784 263 Etienne Pallier
Le thème global peut très facilement être changé en téléchargeant le fichier css de son choix, à cette adresse: "http://jqueryui.com/themeroller/"
1785 263 Etienne Pallier
et en remplaçant celui se trouvant dans "webroot/css/"
1786 263 Etienne Pallier
1787 263 Etienne Pallier
Les options du datePicker sont modifiables dans le fichier "webroot/js/DatepickerConfig.js" et sont assez explicites.
1788 263 Etienne Pallier
Malgré cela, pour plus de précisions, la doc est facilement consultable à cette adresse: "http://jqueryui.com/datepicker/"
1789 263 Etienne Pallier
1790 263 Etienne Pallier
1791 263 Etienne Pallier
1792 263 Etienne Pallier
1793 263 Etienne Pallier
---
1794 263 Etienne Pallier
1795 211 Thibaud Ajas
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}A L'ATTENTION DES UTILISATEURS D'ECLIPSE%
1796 211 Thibaud Ajas
1797 1 Etienne Pallier
*+0) Installer Eclipse (Si nécessaire), voire Java+*
1798 1 Etienne Pallier
1799 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.
1800 211 Thibaud Ajas
Vérifiez que Java soit bien installé sur votre système :
1801 211 Thibaud Ajas
<pre>
1802 211 Thibaud Ajas
java -version
1803 1 Etienne Pallier
</pre>
1804 211 Thibaud Ajas
Si ce n'est pas le cas, exécutez les lignes suivantes :
1805 211 Thibaud Ajas
<pre>
1806 211 Thibaud Ajas
sudo apt-add-repository ppa:webupd8team/java
1807 211 Thibaud Ajas
sudo apt-get update
1808 212 Etienne Pallier
sudo apt-get install oracle-java8-installer
1809 211 Thibaud Ajas
</pre>
1810 211 Thibaud Ajas
1811 211 Thibaud Ajas
Pour installer Eclipse, allez sur : http://www.eclipse.org/downloads/packages/release/Neon/3
1812 211 Thibaud Ajas
Selectionnez la version que vous désirez (Neon, Oxygen, Mars ...) puis sélectionnez "Eclipse for PHP Developers".
1813 211 Thibaud Ajas
Téléchargez la version correspondant à votre système d'exploitation.
1814 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 :
1815 211 Thibaud Ajas
<pre>
1816 211 Thibaud Ajas
tar -zxvf eclipse.tar.gz
1817 211 Thibaud Ajas
</pre>
1818 211 Thibaud Ajas
1819 211 Thibaud Ajas
Si vous voulez Eclipse dans le menu des applications sous Ubuntu, il vous faudra crééer le fichier eclipse.desktop :
1820 211 Thibaud Ajas
<pre>
1821 211 Thibaud Ajas
gksudo gedit /usr/share/applications/eclipse.desktop
1822 211 Thibaud Ajas
</pre>
1823 211 Thibaud Ajas
puis collez-y ce qui suit, en modifiant le chemin des lignes Exec et Icon au besoin :
1824 211 Thibaud Ajas
<pre>
1825 211 Thibaud Ajas
[Desktop Entry]
1826 1 Etienne Pallier
Name=Eclipse 
1827 202 Thibaud Ajas
Type=Application
1828 1 Etienne Pallier
Exec=/opt/eclipse/eclipse
1829 1 Etienne Pallier
Terminal=false
1830 1 Etienne Pallier
Icon=/opt/eclipse/icon.xpm
1831 1 Etienne Pallier
Comment=Integrated Development Environment
1832 1 Etienne Pallier
NoDisplay=false
1833 1 Etienne Pallier
Categories=Development;IDE
1834 202 Thibaud Ajas
Name[en]=eclipse.desktop
1835 1 Etienne Pallier
</pre>
1836 200 Thibaud Ajas
1837 200 Thibaud Ajas
Puis donnez les droits à tous les utilisateurs sur ce fichier :
1838 1 Etienne Pallier
<pre>
1839 1 Etienne Pallier
sudo chmod a+r /usr/share/applications/eclipse.desktop
1840 1 Etienne Pallier
</pre>
1841 1 Etienne Pallier
1842 1 Etienne Pallier
*+1) Désactiver la vérification du certificat+*
1843 1 Etienne Pallier
1844 1 Etienne Pallier
Window -> Preferences -> Team -> git -> configuration -> Add entry
1845 1 Etienne Pallier
1846 1 Etienne Pallier
Key = http.sslVerify
1847 1 Etienne Pallier
Value = false
1848 1 Etienne Pallier
1849 1 Etienne Pallier
*+2) Récupérer le projet+*
1850 1 Etienne Pallier
1851 1 Etienne Pallier
*(Si le projet git n'existe pas déjà sur votre machine)*
1852 1 Etienne Pallier
1853 1 Etienne Pallier
File/Import project from git
1854 1 Etienne Pallier
1855 1 Etienne Pallier
Select repository source: Clone URI: https://gitlab.irap.omp.eu/epallier/labinvent.git
1856 200 Thibaud Ajas
1857 1 Etienne Pallier
Directory: 
1858 200 Thibaud Ajas
- par défaut, il propose : /Users/epallier/git/labinvent
1859 200 Thibaud Ajas
- mais on peut le mettre n'importe où ailleurs, 
1860 200 Thibaud Ajas
par exemple, on pourrait le mettre directement dans le repertoire web de Apache:
1861 1 Etienne Pallier
/Applications/XAMPP/xamppfiles/htdocs 
1862 200 Thibaud Ajas
(si on veut que le projet s'execute directement dans le dossier web apache htdocs, mais ca n'est pas obligatoire...)
1863 1 Etienne Pallier
1864 200 Thibaud Ajas
initial branch: master
1865 200 Thibaud Ajas
remote name: origin
1866 1 Etienne Pallier
1867 200 Thibaud Ajas
Import as general project
1868 200 Thibaud Ajas
1869 200 Thibaud Ajas
Project name: LABINVENT
1870 200 Thibaud Ajas
1871 202 Thibaud Ajas
*(si le projet git existe déjà sur votre machine)*
1872 200 Thibaud Ajas
1873 1 Etienne Pallier
File/Import project from git
1874 1 Etienne Pallier
    
1875 1 Etienne Pallier
Existing local repository
1876 1 Etienne Pallier
1877 1 Etienne Pallier
Directory
1878 1 Etienne Pallier
1879 1 Etienne Pallier
ADD => Selectionnez le dossier contenant le projet git => Finish => Next
1880 1 Etienne Pallier
1881 1 Etienne Pallier
Import existing Eclipse project
1882 1 Etienne Pallier
1883 1 Etienne Pallier
Selectionner le projet => Search for nested project => finish
1884 1 Etienne Pallier
1885 1 Etienne Pallier
1886 1 Etienne Pallier
*+3) Configurer le projet+*
1887 1 Etienne Pallier
1888 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)
1889 1 Etienne Pallier
Si ça n'est pas le cas, vérifier que le fichier .project (à la racine) contient bien
1890 1 Etienne Pallier
	<natures>
1891 1 Etienne Pallier
		<nature>org.eclipse.php.core.PHPNature</nature>
1892 1 Etienne Pallier
	</natures>
1893 1 Etienne Pallier
NB : Le fichier .project est normalement versionné et donc le projet labinvent devrait être reconnu automatiquement comme projet PHP
1894 1 Etienne Pallier
1895 1 Etienne Pallier
1896 1 Etienne Pallier
b) S'assurer que les fichiers de vue de cakephp ("*.ctp") sont bien reconnus comme des fichiers PHP.
1897 1 Etienne Pallier
Pour tester cela, ouvrir le fichier de vue cakephp/app/View/Categories/get_all.ctp
1898 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. 
1899 1 Etienne Pallier
Il faut donc associer l'editeur Php a l'extension de fichier "*.ctp" :
1900 1 Etienne Pallier
- Preferences/General/Content types
1901 1 Etienne Pallier
- Dans la liste "Content types", ouvrir la section "Text", selectionner PHP
1902 1 Etienne Pallier
- Ajouter l'extension "*.ctp"
1903 1 Etienne Pallier
1904 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) :
1905 1 Etienne Pallier
- Clic-droit sur le projet, Propriétés
1906 1 Etienne Pallier
- PHP
1907 1 Etienne Pallier
- Interpreter
1908 1 Etienne Pallier
- Enable project specific settings, PHP Version : "PHP 5.6"
1909 1 Etienne Pallier
1910 1 Etienne Pallier
d) S'assurer que le texte est bien encodé en UTF-8 par défaut :
1911 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
1912 1 Etienne Pallier
(
1913 1 Etienne Pallier
Il faudrait commiter ça mais je ne sais pas trop si c'est risqué ou pas.
1914 1 Etienne Pallier
Les fichiers concernés sont :
1915 1 Etienne Pallier
- .project (déjà versionné) : car il commence par la ligne "<?xml version="1.0" encoding="UTF-8"?>"
1916 219 Thibaud Ajas
- 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"
1917 219 Thibaud Ajas
)
1918 219 Thibaud Ajas
1919 1 Etienne Pallier
Les éléments suivants sont normalement DEJA ignorés par git, à vérifier :
1920 1 Etienne Pallier
- .settings/
1921 1 Etienne Pallier
- cakephp/app/tmp/ : tout sauf 
1922 1 Etienne Pallier
	- documents/
1923 1 Etienne Pallier
- cakephp/app/Config/ :
1924 1 Etienne Pallier
	- database.php
1925 1 Etienne Pallier
	- labinvent.php
1926 1 Etienne Pallier
1927 1 Etienne Pallier
1928 1 Etienne Pallier
1929 1 Etienne Pallier
1930 1 Etienne Pallier
1931 1 Etienne Pallier
---
1932 1 Etienne Pallier
1933 1 Etienne Pallier
1934 1 Etienne Pallier
<pre>
1935 1 Etienne Pallier
*********************************************************
1936 1 Etienne Pallier
REMARQUES INTERRESSANTES (MAIS VOUS POUVEZ LES IGNORER)
1937 1 Etienne Pallier
1938 1 Etienne Pallier
// DEBUT DES REMARQUES
1939 1 Etienne Pallier
1940 1 Etienne Pallier
A la racine du projet, j'ai plusieurs éléments cachés de configuration Eclipse :
1941 1 Etienne Pallier
1942 1 Etienne Pallier
1) fichier .buildpath 
1943 1 Etienne Pallier
Il est versionné puisque "svn status .buildpath" (depuis la console) ne donne rien
1944 1 Etienne Pallier
Il contient :
1945 1 Etienne Pallier
1946 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
1947 1 Etienne Pallier
<buildpath>
1948 1 Etienne Pallier
        <buildpathentry kind="con" path="org.eclipse.php.core.LANGUAGE"/>
1949 1 Etienne Pallier
        <buildpathentry kind="lib" path="docs/mockup/mockup_html.zip"/>
1950 1 Etienne Pallier
        <buildpathentry kind="src" path="cakephp"/>
1951 1 Etienne Pallier
</buildpath>
1952 1 Etienne Pallier
1953 1 Etienne Pallier
2) fichier .project
1954 1 Etienne Pallier
Il est déjà versionné
1955 1 Etienne Pallier
Il contient :
1956 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
1957 1 Etienne Pallier
<projectDescription>
1958 1 Etienne Pallier
        <name>invirap</name>
1959 1 Etienne Pallier
        <comment></comment>
1960 1 Etienne Pallier
        <projects>
1961 1 Etienne Pallier
        </projects>
1962 1 Etienne Pallier
        <buildSpec>
1963 1 Etienne Pallier
                <buildCommand>
1964 1 Etienne Pallier
                        <name>org.eclipse.wst.common.project.facet.core.builder</name>
1965 1 Etienne Pallier
                        <arguments>
1966 1 Etienne Pallier
                        </arguments>
1967 1 Etienne Pallier
                </buildCommand>
1968 1 Etienne Pallier
                <buildCommand>
1969 1 Etienne Pallier
                        <name>org.eclipse.wst.validation.validationbuilder</name>
1970 1 Etienne Pallier
                        <arguments>
1971 1 Etienne Pallier
                        </arguments>
1972 1 Etienne Pallier
                </buildCommand>
1973 1 Etienne Pallier
                <buildCommand>
1974 1 Etienne Pallier
                        <name>org.eclipse.dltk.core.scriptbuilder</name>
1975 1 Etienne Pallier
                        <arguments>
1976 1 Etienne Pallier
                        </arguments>
1977 1 Etienne Pallier
                </buildCommand>
1978 1 Etienne Pallier
        </buildSpec>
1979 1 Etienne Pallier
        <natures>
1980 1 Etienne Pallier
                <nature>org.eclipse.php.core.PHPNature</nature>
1981 1 Etienne Pallier
                <nature>org.eclipse.wst.common.project.facet.core.nature</nature>
1982 1 Etienne Pallier
        </natures>
1983 1 Etienne Pallier
</projectDescription>
1984 1 Etienne Pallier
1985 1 Etienne Pallier
3) dossier .settings/ (exclus de svn)
1986 1 Etienne Pallier
Il contient 3 fichiers :
1987 1 Etienne Pallier
1988 1 Etienne Pallier
- org.eclipse.core.resources.prefs : bizarrement, il ne contient que quelques références seulement :
1989 1 Etienne Pallier
eclipse.preferences.version=1
1990 1 Etienne Pallier
encoding//cakephp/app/Controller/MaterielsController.php=UTF-8
1991 1 Etienne Pallier
encoding//cakephp/app/View/Elements/menu_view.ctp=UTF-8
1992 1 Etienne Pallier
encoding//cakephp/app/View/Layouts/default.ctp=UTF-8
1993 1 Etienne Pallier
encoding//cakephp/app/View/Materiels/index.ctp=UTF-8
1994 1 Etienne Pallier
encoding//cakephp/app/View/Materiels/scaffold.view.ctp=UTF-8
1995 1 Etienne Pallier
encoding//database/Upd_TableConstraints.sql=UTF-8
1996 1 Etienne Pallier
encoding//database/update/README.txt=UTF-8
1997 1 Etienne Pallier
encoding//docs/HOWTO.txt=UTF-8
1998 1 Etienne Pallier
encoding//install/HOWTO.txt=UTF-8
1999 1 Etienne Pallier
encoding/<project>=UTF-8
2000 1 Etienne Pallier
2001 1 Etienne Pallier
- org.eclipse.php.core.prefs
2002 1 Etienne Pallier
eclipse.preferences.version=1
2003 200 Thibaud Ajas
include_path=0;/invirap\u00051;/invirap/docs/mockup/mockup_html.zip
2004 1 Etienne Pallier
2005 1 Etienne Pallier
- org.eclipse.wst.common.project.facet.core.xml : sans doute inutile ? (lié à "Faceted Project Validation Builder" dans Properties/Builders)
2006 1 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
2007 1 Etienne Pallier
<faceted-project>
2008 200 Thibaud Ajas
  <fixed facet="php.core.component"/>
2009 200 Thibaud Ajas
  <fixed facet="php.component"/>
2010 200 Thibaud Ajas
  <installed facet="php.core.component" version="1"/>
2011 1 Etienne Pallier
  <installed facet="php.component" version="5.4"/>
2012 1 Etienne Pallier
</faceted-project>
2013 1 Etienne Pallier
2014 1 Etienne Pallier
// FIN DES REMARQUES
2015 1 Etienne Pallier
*********************************************************
2016 1 Etienne Pallier
</pre>
2017 200 Thibaud Ajas
2018 1 Etienne Pallier
*+4) (TODO:) Set Code style+*
2019 1 Etienne Pallier
2020 200 Thibaud Ajas
Window/Preferences : PHP / Editor
2021 1 Etienne Pallier
...
2022 1 Etienne Pallier
2023 1 Etienne Pallier
*+5) (TODO:) virtualenv+*
2024 1 Etienne Pallier
2025 1 Etienne Pallier
Now, once the PHP5 virtual environment is installed (see above),
2026 1 Etienne Pallier
set it in Eclipse as the project interpreter:
2027 1 Etienne Pallier
2028 1 Etienne Pallier
(cf http://virtphp.org)
2029 1 Etienne Pallier
2030 1 Etienne Pallier
...
2031 1 Etienne Pallier
2032 1 Etienne Pallier
*+6) (TODO:) Test+*
2033 1 Etienne Pallier
2034 1 Etienne Pallier
2035 1 Etienne Pallier
*+7) (TODO:) Run+*
2036 1 Etienne Pallier
2037 1 Etienne Pallier
check http://localhost:8080/
2038 292 Thibaud Ajas
2039 292 Thibaud Ajas
2040 292 Thibaud Ajas
---
2041 292 Thibaud Ajas
2042 292 Thibaud Ajas
h2. Installer un serveur LDAP et un serveur web sur deux VMs différentes
2043 293 Thibaud Ajas
2044 298 Etienne Pallier
Si vous êtes là c'est que vous avez déjà une VM avec votre serveur web, sinon je vous renvoie à la page d'installation du serveur web :
2045 293 Thibaud Ajas
> https://projects.irap.omp.eu/projects/inventirap/wiki/Installation
2046 293 Thibaud Ajas
2047 293 Thibaud Ajas
Ceci est une VM LDAP déjà installée et configurée (si vous en avez pas déjà) :
2048 293 Thibaud Ajas
> https://www.turnkeylinux.org/openldap
2049 293 Thibaud Ajas
2050 293 Thibaud Ajas
Après avoir installer vos deux VMs, on va les configurer.
2051 293 Thibaud Ajas
2052 299 Thibaud Ajas
Par la suite, j'utiliserais ces termes pour éviter de tout réécrire à chaque fois :
2053 293 Thibaud Ajas
> Machine hôte = Machine physique avec laquelle vous travaillez
2054 293 Thibaud Ajas
> VM_1 = Machine virtuelle qui héberge votre serveur Web/Apache/MySQL ...
2055 293 Thibaud Ajas
> VM_2 = Machine virtuelle qui héberge votre serveur LDAP
2056 293 Thibaud Ajas
2057 293 Thibaud Ajas
La configuration qui a servi a réaliser ce tutoriel :
2058 293 Thibaud Ajas
> Machine hôte : Windows 7 Pro 64bits
2059 293 Thibaud Ajas
> VM_1 : Ubuntu 14.04.5 32bits
2060 293 Thibaud Ajas
> VM_2 : TURNKEY OPENLDAP 64bits
2061 293 Thibaud Ajas
2062 293 Thibaud Ajas
*A faire sur la machine hôte :*
2063 293 Thibaud Ajas
2064 293 Thibaud Ajas
Configuration des 2 cartes réseau de la VM_1 :
2065 293 Thibaud Ajas
2066 293 Thibaud Ajas
_Carte n°1 :_
2067 293 Thibaud Ajas
2068 293 Thibaud Ajas
> Activer la carte réseau
2069 293 Thibaud Ajas
> Mode d'accès : NAT
2070 293 Thibaud Ajas
> 
2071 293 Thibaud Ajas
> (Si vous voulez pouvoir utiliser votre serveur web depuis votre machine hôte)
2072 293 Thibaud Ajas
> 
2073 293 Thibaud Ajas
> -> Avancé -> Redirection de ports
2074 293 Thibaud Ajas
> 
2075 293 Thibaud Ajas
> Ajoutez une règle de redirection :
2076 293 Thibaud Ajas
> IP hôte : 127.0.0.1
2077 293 Thibaud Ajas
> Port hôte : 8080
2078 293 Thibaud Ajas
> Port invité : 80
2079 293 Thibaud Ajas
> (Le reste n'y touchez pas)
2080 293 Thibaud Ajas
2081 296 Thibaud Ajas
(Un exemple)
2082 296 Thibaud Ajas
!Config_carte1_VM_1.png!
2083 296 Thibaud Ajas
2084 293 Thibaud Ajas
_Carte n°2 :_
2085 293 Thibaud Ajas
2086 293 Thibaud Ajas
> Activer la carte réseau
2087 293 Thibaud Ajas
> Mode d'accès : Réseau interne
2088 293 Thibaud Ajas
> Nom : Connexion_LDAP (ceci est un exemple, mettez ce que vous voulez)
2089 293 Thibaud Ajas
> -> Avancé
2090 293 Thibaud Ajas
> Mode Promiscuité : Tout autoriser
2091 293 Thibaud Ajas
2092 296 Thibaud Ajas
(Un exemple)
2093 296 Thibaud Ajas
!Config_carte2_VM_1.png!
2094 296 Thibaud Ajas
2095 293 Thibaud Ajas
Configuration de la carte réseau de la VM_2 :
2096 293 Thibaud Ajas
2097 293 Thibaud Ajas
_Carte n°1 :_
2098 293 Thibaud Ajas
2099 293 Thibaud Ajas
> Activer la carte réseau
2100 293 Thibaud Ajas
> Mode d'accès : Réseau interne
2101 293 Thibaud Ajas
> Nom : Connexion_LDAP (ceci est un exemple, mettez ce que vous voulez, faut juste que ce soit le même que celui de la carte 2 de la VM_1)
2102 293 Thibaud Ajas
> -> Avancé
2103 293 Thibaud Ajas
> Mode Promiscuité : Tout autoriser
2104 296 Thibaud Ajas
2105 296 Thibaud Ajas
(Un exemple)
2106 296 Thibaud Ajas
!Config_carte1_VM_2.png!
2107 293 Thibaud Ajas
2108 293 Thibaud Ajas
Voila, on est bon pour la machine hôte, maintenant on passe à la configuration des VMs.
2109 293 Thibaud Ajas
2110 293 Thibaud Ajas
*A faire sur la VM_1 :*
2111 293 Thibaud Ajas
2112 293 Thibaud Ajas
Carte réseau n°1 : Adresse IPv4 : Méthode d’obtention : DHCP
2113 293 Thibaud Ajas
2114 293 Thibaud Ajas
Carte réseau n°2 : Adresse IPv4 : Méthode d’obtention : Manuelle :
2115 293 Thibaud Ajas
> Adress (Adresse): 192.168.1.2
2116 293 Thibaud Ajas
> Netmask (Masque de sous-réseau) : 255.255.255.0
2117 293 Thibaud Ajas
> Gateway (Passerelle) : 255.255.255.0
2118 293 Thibaud Ajas
2119 297 Thibaud Ajas
Cela devrait ressembler plus ou moins à ceci :
2120 299 Thibaud Ajas
!Config_cartes_reseau_VM_1.png!
2121 297 Thibaud Ajas
2122 297 Thibaud Ajas
*A faire sur la VM_2 :*
2123 297 Thibaud Ajas
2124 297 Thibaud Ajas
-> Advanced Menu -> Networking -> StaticIP
2125 297 Thibaud Ajas
> IP Adress : 192.168.1.3
2126 297 Thibaud Ajas
> Netmask : 255.255.255.0
2127 297 Thibaud Ajas
> (laissez le reste vide)
2128 297 Thibaud Ajas
-> Apply
2129 297 Thibaud Ajas
2130 297 Thibaud Ajas
Cela devrait ressembler à ça :
2131 297 Thibaud Ajas
!Config_carte_reseau_VM_2.png!
2132 297 Thibaud Ajas
2133 297 Thibaud Ajas
Et voila, maintenant pour accéder à votre site depuis votre machine hôte, rendez-vous à l'adresse 127.0.0.1:8080 dans votre navigateur préféré.
2134 300 Thibaud Ajas
Pour ce qui est du LDAP, les adresses vous sont données en page d'accueil lorsque vous lancez votre VM LDAP. Sachez cependant que votre machine hôte ne pourra en aucun cas communiquer avec la VM LDAP, et vice-versa. Le LDAP, quand à lui, n'aura aucun accès à internet.
2135 300 Thibaud Ajas
2136 297 Thibaud Ajas
2137 297 Thibaud Ajas
---