LABINVENT (InventIrap)

h1. Labinvent 2.0 (cakephp3) - Développement

_HOWTO Format Redmine Wiki_ : http://www.redmine.org/projects/redmine/wiki/FrRedmineWikiFormatting

[[Installation|=> Page wiki pour l'installation]]

{{toc}}

---

h2. LIENS UTILES

Activité sur le projet (gitlab): https://gitlab.irap.omp.eu/epallier/labinvent

Browse files (gitlab): https://gitlab.irap.omp.eu/epallier/labinvent/tree/master

Inventirap 1.3 (prod): https://inventirap.irap.omp.eu

Inventirap 1.3 (test): https://inventirap-test.irap.omp.eu/

Forum cakephp: http://discourse.cakephp.org

Quickstart tutorial: http://book.cakephp.org/3.0/en/quickstart.html

Bookmarker tutorial: https://github.com/cakephp/bookmarker-tutorial

Cakephp CRUD: https://github.com/FriendsOfCake/crud

---

h2. TODOLIST

---

h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}Schéma de la base de données (v2.0.0)%

{{thumbnail(BDD_IRAP.png, size=300, title=Pyros data model)}}

---

h2. ROADMAP - Plan de développement

Le stage se déroule de mi-avril à fin juin, soit sur 12 semaines (S1 à S12)

_*(Ne pas oublier de rédiger le rapport de stage au fur et à mesure)*_

* S1-S3début (2,5 semaines) : version 2.0 - Cakephp3 + Php5 (version de base from bake) 		

* S3fin-S5début (2 semaines) : version 2.1 - Implémentation complète du CRUD 		

Implémentation complète du CRUD sur Materiels (+find), Suivis, et Emprunts (labels + validations + liens 1-N ou M-N entre tables...)

* S5fin-S6 (1,5 semaines): version 2.2 - Implémentation de toutes les autres actions 		

Toutes les actions autres que CRUD (y-compris tout le javascript ajax...)

* S7 (1 semaine): version 2.3 - Implémentation du LDAP (vrai et fake) 			

* S8-S9début (1,5 semaines): version 2.4 - Implémentation des ACL (droits) 			

* S9fin-S10début (1 semaine): version 2.5 - Documents attaches aux materiels (+ photos) 			

* S10fin-S11début (1 semaine): version 2.6 - Cakephp3 + Php7 (compatible Php5) 			

* S11fin-S12 (1,5 semaines): version 2.7 - Autres ajouts (+ fin rédaction rapport de stage)

Voir le détail de la roadmap: https://projects.irap.omp.eu/projects/inventirap/roadmap

<table>

</table>

h2. Installation from scratch (Sous UBuntu)

h3. Création projet avec Composer

* Télécharger composer.phar : 

"curl -s https://getcomposer.org/installer | php"

* Avec le Composer créer un nouveau projet : 

"php composer.phar create-project --prefer-dist cakephp/app labinvent_2.0"

> Voir structure projet : http://book.cakephp.org/3.0/fr/intro/cakephp-folder-structure.html

* On rempli la base de données avec le fichier sql

* On indique la BD utilisé à CakePHP dans le fichier config/app.php, propriété "Datasources".

* On se place à la racine du projet

* On génère le code Scaffold : 

"bin/cake bake all nom_table" --> ça génére les modeles, les vues, et les controlleurs.

> Commande (en une fois) :

> > 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

h3. Modification de la base de données 

> Une version du sql corrigée au fur et à mesure est disponible dans le git :

> > Dans database/, le fichier labinvent_2.1_09-05-16 correspond à la création de la base.

> > 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.

* Création table "config"

> > Mise à jour dans le fichier de création de base

> > Mise à jour à part : db-update-2016-05-09.sql

h3. Autres remarques lors du dévellopement

* Avec CakePHP3 on peut gérér les ACL avec plusieurs gestionnaires d’autorisation propre à chaque profils (rôles), et une table users dans la base. 

(Lorsqu'un utilisateur se connecte, le gestionnaire de son type de compte se déclenche et les autres gestionnaires sont ignorés)

> Voir (explication) : http://book.cakephp.org/3.0/fr/controllers/components/authentication.html

> Voir (exemple) : http://book.cakephp.org/3.0/fr/tutorials-and-examples/blog-auth-example/auth.html

> Pour faire des tests d'authentication : http://book.cakephp.org/3.0/fr/development/testing.html#testing-authentication

* 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")...

> Voir : http://book.cakephp.org/3.0/fr/contributing/cakephp-coding-conventions.html

* 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.

Le mot de passe "login" = "$2y$10$LZzpws3oDidBcqO/Fy1RTedLLk3ENTmplny5J7bZ6R1PqFoGOw3Ma".

* Vérifier que la migration vers la prochaine version de cakephp3 (3.3 ?) sera facile... (décrire la procédure à suivre)

--> Une migration vers une version mineur 3.2 => 3.3, se réalise avec la mise à jour de CakePHP à l'aide de Composer

--> Puis il faut regarder les changements dans la page migration correspondant à la version voulu et adapter les changements au code.

> Voir : http://book.cakephp.org/3.0/fr/appendices/3-2-migration-guide.html

* Outil (plugin) "DebugKit" de CakePHP3 : 

--> DebugKit est un plugin qui fournit une toolbar pour aider à debugger les applications CakePHP plus facilement.

--> Par défaut il est installé avec le squelette de l'application, pour l'activer, il faut se placer à la racine.

--> Puis il faut éxécuter la ligne suivante : bin/cake plugin load DebugKit .

--> La commande va aller modifier le fichier config bootstrap.php.

--> 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.

--> Le plugin nécessite l'extension php5-sqlite par défaut (il supporte l'équivalent avec de la config).

> Voir : http://book.cakephp.org/3.0/fr/debug-kit.html

* Menu outils à améliorer (répartition des onglets)...

* Mode debug personnaliser : 

> Faire $this->myDebug($var) dans un controlleur pour afficher le contenu de la variable si mode debug personnalisé actif.

* Exception suppresion impossible du aux associations (#3540) 

--> CakePHP permet de définir des templates d'erreur qui sont déclenché selon les exceptions

--> Pour les exception PDO, il faut mettre le fichier "pdo_error.ctp" dans src/Template/Error

--> Un objet $error est disponible sur la vue correspondant aux informations de l'erreur

--> Avec ces informations nous pouvons renvoyer une erreur identifié et propre pour l'utilisateur

Ex : Si code = xxx -> Message de suppression impossible car l'objet X est utilisé pour l'objet Y...

* Actuellement dans l'application les exceptions sont levé correctement quand une propriété se rapporte à un matériel, par contre lors de la suppression d'un site qui se trouve uniquement dans un emprunt, aucune exception mais une erreur sur l'emprunt car clé étrangère du site non connu.

De plus le typeSuivi peut se faire supprimer même si des suivis l'utilise car il est marqué en dur dans le suivi, à résoudre... (soit faire de même pour le site et l'emprunt, soit faire une base "propre" et y mettre les associations correspondante, emprunt->site & suivi->typeSuivi).

* *TESTS* : CakePHP permet aussi de gérer les tests facilement et de générer leurs squelettes avec la commande "bake".

> Voir : http://book.cakephp.org/3.0/fr/development/testing.html

--> Pour commencer il faut récupérer phpunit (https://phpunit.de/), si la version de PHP est inférieur à 5.6, il faut télécharger le phpunit.phar compatible avec PHP, sinon il faut prendre la derniere version (compatible avec PHP7 également).

--> Il faut configurer une base de donnée pour les tests dans "app.php"

h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}NOTES FOR ECLIPSE USERS%

0) Install Eclipse (if necessary)

Get the Eclipse version for Php

1) Deactivate CA certificate verification

Window -> Preferences -> Team -> git -> configuration -> Add entry

Key = http.sslVerify

Value = false

2) Fetch the project

File/Import project from git

Select repository source: Clone URI: https://gitlab.irap.omp.eu/epallier/labinvent.git

Directory: 

- par défaut, il propose : /Users/epallier/git/labinvent

- mais on peut le mettre n'importe où ailleurs, 

par exemple, on pourrait le mettre directement dans le repertoire web de Apache:

/Applications/XAMPP/xamppfiles/htdocs 

(si on veut que le projet s'execute directement dans le dossier web apache htdocs, mais ca n'est pas obligatoire...)

initial branch: master

remote name: origin

Import as general project

Project name: LABINVENT

3) Configure the project

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)

Si ça n'est pas le cas, vérifier que le fichier .project (à la racine) contient bien

	<natures>

		<nature>org.eclipse.php.core.PHPNature</nature>

	</natures>

NB : Le fichier .project est normalement versionné et donc le projet labinvent devrait être reconnu automatiquement comme projet PHP

b) S'assurer que les fichiers de vue de cakephp ("*.ctp") sont bien reconnus comme des fichiers PHP.

Pour tester cela, ouvrir le fichier de vue cakephp/app/View/Categories/get_all.ctp

Si ce fichier s'ouvre comme un simple fichier texte, c'est qu'il n'est pas reconnu par Eclipse comme un fichier Php. 

Il faut donc associer l'editeur Php a l'extension de fichier "*.ctp" :

- Preferences/General/Content types

- Dans la liste "Content types", ouvrir la section "Text", selectionner PHP

- Ajouter l'extension "*.ctp"

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) :

- Clic-droit sur le projet, Propriétés

- PHP

- Interpreter

- Enable project specific settings, PHP Version : "PHP 5.6"

d) S'assurer que le texte est bien encodé en UTF-8 par défaut :

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

(

Il faudrait commiter ça mais je ne sais pas trop si c'est risqué ou pas.

Les fichiers concernés sont :

- .project (déjà versionné) : car il commence par la ligne "<?xml version="1.0" encoding="UTF-8"?>"

- 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"

)

Les éléments suivants sont normalement DEJA ignorés par git, à vérifier :

- .settings/

- cakephp/app/tmp/ : tout sauf 

	- documents/

- cakephp/app/Config/ :

	- database.php

	- labinvent.php

<pre>

*********************************************************

REMARQUES INTERRESSANTES (MAIS VOUS POUVEZ LES IGNORER)

// DEBUT DES REMARQUES

A la racine du projet, j'ai plusieurs éléments cachés de configuration Eclipse :

1) fichier .buildpath 

Il est versionné puisque "svn status .buildpath" (depuis la console) ne donne rien

Il contient :

<?xml version="1.0" encoding="UTF-8"?>

<buildpath>

        <buildpathentry kind="con" path="org.eclipse.php.core.LANGUAGE"/>

        <buildpathentry kind="lib" path="docs/mockup/mockup_html.zip"/>

        <buildpathentry kind="src" path="cakephp"/>

</buildpath>

2) fichier .project

Il est déjà versionné

Il contient :

<?xml version="1.0" encoding="UTF-8"?>

<projectDescription>

        <name>invirap</name>

        <comment></comment>

        <projects>

        </projects>

        <buildSpec>

                <buildCommand>

                        <name>org.eclipse.wst.common.project.facet.core.builder</name>

                        <arguments>

                        </arguments>

                </buildCommand>

                <buildCommand>

                        <name>org.eclipse.wst.validation.validationbuilder</name>

                        <arguments>

                        </arguments>

                </buildCommand>

                <buildCommand>

                        <name>org.eclipse.dltk.core.scriptbuilder</name>

                        <arguments>

                        </arguments>

                </buildCommand>

        </buildSpec>

        <natures>

                <nature>org.eclipse.php.core.PHPNature</nature>

                <nature>org.eclipse.wst.common.project.facet.core.nature</nature>

        </natures>

</projectDescription>

3) dossier .settings/ (exclus de svn)

Il contient 3 fichiers :

- org.eclipse.core.resources.prefs : bizarrement, il ne contient que quelques références seulement :

eclipse.preferences.version=1

encoding//cakephp/app/Controller/MaterielsController.php=UTF-8

encoding//cakephp/app/View/Elements/menu_view.ctp=UTF-8

encoding//cakephp/app/View/Layouts/default.ctp=UTF-8

encoding//cakephp/app/View/Materiels/index.ctp=UTF-8

encoding//cakephp/app/View/Materiels/scaffold.view.ctp=UTF-8

encoding//database/Upd_TableConstraints.sql=UTF-8

encoding//database/update/README.txt=UTF-8

encoding//docs/HOWTO.txt=UTF-8

encoding//install/HOWTO.txt=UTF-8

encoding/<project>=UTF-8

- org.eclipse.php.core.prefs

eclipse.preferences.version=1

include_path=0;/invirap\u00051;/invirap/docs/mockup/mockup_html.zip

- org.eclipse.wst.common.project.facet.core.xml : sans doute inutile ? (lié à "Faceted Project Validation Builder" dans Properties/Builders)

<?xml version="1.0" encoding="UTF-8"?>

<faceted-project>

  <fixed facet="php.core.component"/>

  <fixed facet="php.component"/>

  <installed facet="php.core.component" version="1"/>

  <installed facet="php.component" version="5.4"/>

</faceted-project>

// FIN DES REMARQUES

*********************************************************

</pre>

4) (TODO:) Set Code style

Window/Preferences : PHP / Editor

...

5) (TODO: virtualenv) Now, once the PHP5 virtual environment is installed (see above),

set it in Eclipse as the project interpreter:

(cf http://virtphp.org)

...

6) (TODO:) Test

7) (TODO:) Run

check http://localhost:8080/