Labinvent nouvelle version

Version 173 (Alexandre Cases, 05/02/2016 12:40 pm)

1 38 Etienne Pallier
h1. Labinvent 2.0 (cakephp3)
2 2 Alexandre Cases
3 41 Etienne Pallier
4 42 Etienne Pallier
{{toc}}
5 42 Etienne Pallier
6 126 Etienne Pallier
7 93 Etienne Pallier
8 125 Etienne Pallier
---
9 125 Etienne Pallier
10 125 Etienne Pallier
h2. LIENS UTILES
11 125 Etienne Pallier
12 130 Etienne Pallier
Activité sur le projet (gitlab): https://gitlab.irap.omp.eu/epallier/labinvent
13 130 Etienne Pallier
14 131 Etienne Pallier
Browse files (gitlab): https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
15 131 Etienne Pallier
16 132 Etienne Pallier
Inventirap 1.3 (prod): https://inventirap.irap.omp.eu
17 132 Etienne Pallier
18 132 Etienne Pallier
Inventirap 1.3 (test): https://inventirap-test.irap.omp.eu/
19 132 Etienne Pallier
20 1 Etienne Pallier
Forum cakephp: http://discourse.cakephp.org
21 1 Etienne Pallier
22 129 Etienne Pallier
Quickstart tutorial: http://book.cakephp.org/3.0/en/quickstart.html
23 129 Etienne Pallier
24 129 Etienne Pallier
Bookmarker tutorial: https://github.com/cakephp/bookmarker-tutorial
25 127 Etienne Pallier
26 135 Etienne Pallier
Cakephp CRUD: https://github.com/FriendsOfCake/crud
27 135 Etienne Pallier
28 128 Etienne Pallier
---
29 128 Etienne Pallier
30 93 Etienne Pallier
h2. TODOLIST
31 93 Etienne Pallier
32 167 Etienne Pallier
 * 1) Materiels/form
33 167 Etienne Pallier
34 167 Etienne Pallier
 * 2) ACL
35 167 Etienne Pallier
36 165 Etienne Pallier
 * saisir ces TODO en tant que demande dans la roadmap
37 165 Etienne Pallier
 
38 165 Etienne Pallier
 * dans vue détaillée Domaine, afficher toutes les catégories associées (idem pour toutes les relations 1-N)
39 165 Etienne Pallier
40 164 Etienne Pallier
 * recup schéma BD fait par Elodie sur 1.3
41 163 Etienne Pallier
42 163 Etienne Pallier
 * installer une VM avec LDAP
43 1 Etienne Pallier
44 167 Etienne Pallier
 * Table config ou fichier labinvent.php ?
45 162 Etienne Pallier
46 148 Alexandre Cases
 * -Erreur sur materiels/index (EP):-
47 148 Alexandre Cases
-Warning (512):-
48 148 Alexandre Cases
 -Association property name "organisme" clashes with field of same name 
49 137 Etienne Pallier
of table "materiels". You should explicitly specify the "propertyName" 
50 137 Etienne Pallier
option. [CORE/src/ORM/Association.php, line 446]
51 148 Alexandre Cases
Warning: file_put_contents(/Users/epallier/Documents/_W_more/PROJECTS/LABINVENT/SOURCE/labinvent2/logs/error.log) [function.file-put-contents]: failed to open stream: Permission denied in /Users/epallier/Documents/_W_more/PROJECTS/LABINVENT/SOURCE/labinvent2/vendor/cakephp/cakephp/src/Log/Engine/FileLog.php on line 134-
52 137 Etienne Pallier
53 134 Etienne Pallier
 * Refaire l'explication sur l'installation des pré-requis : commencer par le strict minimum (apache + mysql + php), puis demander de vérifier ce qui manque en allant sur la page home.ctp,
54 133 Etienne Pallier
et demander de faire l'installation uniquement des points manquants ("en rouge").
55 133 Etienne Pallier
56 160 Alexandre Cases
 * -Mieux gérer le debug=2 dans cakephp3 pour éviter pb de cache (update structure BDD)-
57 152 Alexandre Cases
--> Pas d'entier pour le mode debug, seulement 2 boolean debug activé ==> true, debug désactivé ==> false
58 152 Alexandre Cases
--> Le fonctionnement devrait être plus simple de lui-même...
59 124 Etienne Pallier
60 156 Alexandre Cases
 * La configuration du mode debug necessite l'extension "pdo_sqlite" (php5-sqlite pour ubuntu)...
61 156 Alexandre Cases
  Et même avec, ça marche pas (mais il n'y a plus d'erreurs dans le log de CakePHP)... vérifier syntaxe : "Configure::write('debug', false);".
62 157 Alexandre Cases
--> Syntaxe correct mais modifie la valeur momentanément...
63 158 Alexandre Cases
--> Utilisation de variable session pour un mode debug (mode install) personalisé (mode debug de CakePHP3, ne doit pas être actif sur un serveur de production). 
64 156 Alexandre Cases
65 124 Etienne Pallier
 * Rendre Envoi de mail possible en local (et pas seulement sur serveur prod)
66 160 Alexandre Cases
(voir pour labinvent 2.0 : http://book.cakephp.org/3.0/fr/core-libraries/email.html#email-configuration)
67 124 Etienne Pallier
68 123 Etienne Pallier
 * Faire tous les TODO: qui sont sur cette page
69 123 Etienne Pallier
70 148 Alexandre Cases
 * -Erreurs constatées lors de mon (EP) installation:-
71 148 Alexandre Cases
-Lors de l'installation, j'ai entré le login "labinvent2user" (idem pour le mdp), mais dans database/build.sql, je lis ceci:-
72 148 Alexandre Cases
-grant all on labinvent2.* to 'mydb'@'localhost' identified by 'mydb1';-
73 1 Etienne Pallier
-Ca n'a donc pas été mis à jour...-
74 148 Alexandre Cases
75 160 Alexandre Cases
 * Vérifier que la migration vers la prochaine version de cakephp3 (3.3 ?) sera facile... (décrire la procédure à suivre)
76 160 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
77 161 Alexandre Cases
--> Puis il faut regarder les changements dans la page migration correspondant à la version voulu et adapter les changements au code.
78 161 Alexandre Cases
==>http://book.cakephp.org/3.0/fr/appendices/3-2-migration-guide.html
79 93 Etienne Pallier
80 151 Alexandre Cases
 * -Faire un script d'installation qu'on peut exécuter et ré-exécuter plusieurs fois sans crainte de tout casser-
81 151 Alexandre Cases
-Pour l'instant le script peut se reéxécuter mais il y aura des erreurs de dossiers déja existant qui ne nuise pas au fonctionnement mais il faut ajouter des conditions pour que ce soit plus propre.-
82 150 Alexandre Cases
-De plus le script ne configure pas encore app.php-
83 95 Etienne Pallier
84 148 Alexandre Cases
 * -Le script d'installation doit proposer par défaut l'installation de "faux utilisateurs" pour tester l'application, avec des mots de passe (mot passe = login ; par exemple, "superadmin/superadmin", "responsable/responsable"...)-
85 95 Etienne Pallier
La solution pour insérer un utilisateur directement dans la base et pouvoir se connecter avec dans l'application est de l'insérer avec un mot de passe haché de la méme façon.
86 154 Alexandre Cases
Le mot de passe "login" = "$2y$10$LZzpws3oDidBcqO/Fy1RTedLLk3ENTmplny5J7bZ6R1PqFoGOw3Ma". 
87 155 Alexandre Cases
88 168 Alexandre Cases
* Mettre a jour informations script d'installation 
89 168 Alexandre Cases
90 170 Alexandre Cases
* Page d'acceuil --> login
91 170 Alexandre Cases
92 171 Alexandre Cases
* Dans le script de la bd il faut supprimer l'utilisateur avant de le créer : "DELETE FROM mysql.user WHERE user='<USERNAME>';"
93 172 Alexandre Cases
<pre>
94 172 Alexandre Cases
SQL_SCRIPT="CREATE DATABASE IF NOT EXISTS pyros; GRANT USAGE ON *.* TO 
95 172 Alexandre Cases
'$DB_USER'; DROP USER '$DB_USER'; GRANT ALL ON pyros.* TO 
96 172 Alexandre Cases
'$DB_USER'@'localhost' IDENTIFIED BY '$DB_PASSWORD'; 
97 172 Alexandre Cases
GRANT ALL ON test_pyros.* TO '$DB_USER'@'localhost'"
98 172 Alexandre Cases
</pre>
99 95 Etienne Pallier
 
100 173 Alexandre Cases
* Script d'installation qui configure app.php au niveau du nom de la bd
101 173 Alexandre Cases
102 173 Alexandre Cases
* Mode debug par défaut, et mode install
103 173 Alexandre Cases
104 93 Etienne Pallier
---
105 93 Etienne Pallier
106 101 Etienne Pallier
h2. RECUPERATION
107 41 Etienne Pallier
108 100 Etienne Pallier
1) Authenticate to https://gitlab.irap.omp.eu/epallier/labinvent
109 41 Etienne Pallier
110 41 Etienne Pallier
In order to get this software, you must first authenticate on the IRAP gitlab.
111 41 Etienne Pallier
112 41 Etienne Pallier
For this, just go to https://gitlab.irap.omp.eu/epallier/labinvent
113 1 Etienne Pallier
and either sign in with your LDAP account (if you are from IRAP),
114 41 Etienne Pallier
or register via the "Sign up" form (then, confirm your registration by answering an email sent by gitlab,
115 41 Etienne Pallier
and wait for the "SI" to authorize your registration)
116 41 Etienne Pallier
117 105 Etienne Pallier
If you want, you can browse the code online (from gitlab) :
118 1 Etienne Pallier
119 1 Etienne Pallier
https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
120 1 Etienne Pallier
121 105 Etienne Pallier
2) Récupérer le logiciel
122 1 Etienne Pallier
123 105 Etienne Pallier
Deux options se présentent à vous :
124 106 Etienne Pallier
125 105 Etienne Pallier
 * a) soit vous récupérez une version statique du logiciel, en le téléchargeant
126 105 Etienne Pallier
 * b) soit vous récupérez une version synchronisée, avec git
127 105 Etienne Pallier
128 105 Etienne Pallier
a) Download it (static version, not synchronized)...
129 105 Etienne Pallier
130 41 Etienne Pallier
You can download the current version of the software.
131 41 Etienne Pallier
132 41 Etienne Pallier
Go to https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
133 1 Etienne Pallier
134 41 Etienne Pallier
Click on "Download zip" on the up right hand corner.
135 41 Etienne Pallier
136 107 Etienne Pallier
Double-click on it to unzip it (or run "gzip -d labinvent.zip")
137 41 Etienne Pallier
138 41 Etienne Pallier
You should get a "labinvent.git" folder.
139 41 Etienne Pallier
140 105 Etienne Pallier
In this documentation, this software folder will be referenced as "LABINVENT".
141 41 Etienne Pallier
142 41 Etienne Pallier
(you can rename "labinvent.git" as "labinvent" if you want : "mv labinvent.git labinvent")
143 41 Etienne Pallier
144 105 Etienne Pallier
b) ... or Get it from GIT (dynamic version, synchronized)
145 41 Etienne Pallier
146 41 Etienne Pallier
(If you are using Windows, you must first get the git software, see below "Get git for Windows")
147 41 Etienne Pallier
148 41 Etienne Pallier
By getting the software from git, you will get a dynamically synchronized version,
149 41 Etienne Pallier
which means that you will be able to update your version as soon as a new version is available
150 41 Etienne Pallier
(with the command : "git pull").
151 41 Etienne Pallier
152 41 Etienne Pallier
* From Eclipse : See below, section "NOTES FOR ECLIPSE USERS"
153 41 Etienne Pallier
154 41 Etienne Pallier
* From the terminal
155 41 Etienne Pallier
156 41 Etienne Pallier
<pre>
157 41 Etienne Pallier
git clone https://gitlab.irap.omp.eu/epallier/labinvent.git labinvent
158 41 Etienne Pallier
</pre>
159 41 Etienne Pallier
160 41 Etienne Pallier
_(or also : git clone git@gitlab.irap.omp.eu:epallier/labinvent.git labinvent)_
161 41 Etienne Pallier
162 41 Etienne Pallier
If you ever get this error message... :
163 41 Etienne Pallier
<pre>
164 41 Etienne Pallier
fatal: unable to access 'https://gitlab.irap.omp.eu/epallier/labinvent.git/': Peer's certificate issuer has been marked as not trusted by the user.
165 41 Etienne Pallier
</pre>
166 41 Etienne Pallier
167 41 Etienne Pallier
...then, type this command (and then run again the "git clone" command):
168 41 Etienne Pallier
<pre>
169 41 Etienne Pallier
$ git config --global http.sslVerify false
170 41 Etienne Pallier
171 41 Etienne Pallier
Then check that your config is ok:
172 41 Etienne Pallier
173 41 Etienne Pallier
$ cat ~/.gitconfig 
174 41 Etienne Pallier
[user]
175 41 Etienne Pallier
	name = Etienne Pallier
176 41 Etienne Pallier
	email = epallier@irap.omp.eu
177 41 Etienne Pallier
[http]
178 41 Etienne Pallier
	sslVerify = false
179 41 Etienne Pallier
[push]
180 41 Etienne Pallier
	default = simple
181 41 Etienne Pallier
</pre>
182 41 Etienne Pallier
183 41 Etienne Pallier
184 41 Etienne Pallier
(Also, the first time you get the project, git will ask you for a login and password)
185 41 Etienne Pallier
186 41 Etienne Pallier
This creates a labinvent/ folder containing the project (with a .git/ subfolder for synchronization with the git repository)
187 41 Etienne Pallier
188 41 Etienne Pallier
189 107 Etienne Pallier
(Windows only) : Get git for Windows:
190 41 Etienne Pallier
191 41 Etienne Pallier
 * Download git at https://git-scm.com/download/win
192 41 Etienne Pallier
 * Run setup (keep default configurations)
193 41 Etienne Pallier
 * Once installed, open cmd
194 41 Etienne Pallier
<pre>
195 1 Etienne Pallier
$ git config --global http.sslVerify false
196 1 Etienne Pallier
</pre>
197 1 Etienne Pallier
You can now use your git from the cmd or the graphic client !
198 107 Etienne Pallier
199 107 Etienne Pallier
200 107 Etienne Pallier
3) Préparation
201 107 Etienne Pallier
202 107 Etienne Pallier
* Vérifier que vous etes le propriétaire du dossier (il ne doit pas appartenir à "root"), sinon faire : 
203 107 Etienne Pallier
> sudo chown -R nom_utilisateur LABINVENT
204 107 Etienne Pallier
205 107 Etienne Pallier
* Placer cette archive à l'endroit voulu, 2 possibilités :
206 107 Etienne Pallier
- (1) soit vous placez cette archive directement dans le repertoire des sites webs du serveur web (par exemple /var/www/html/localhost/public_html/)
207 107 Etienne Pallier
- (2) soit vous la placez n'importe où ailleurs (par exemple dans votre repertoire home), et ensuite vous indiquerez au serveur web où trouver ce projet
208 107 Etienne Pallier
209 43 Etienne Pallier
h2. INSTALLATION
210 7 Alexandre Cases
211 17 Alexandre Cases
h3. A/ PREREQUIS
212 8 Alexandre Cases
213 69 Etienne Pallier
(L'exemple est donné ici pour une distribution linux UBuntu 14.04.4)
214 50 Alexandre Cases
215 50 Alexandre Cases
* Pour commencer il faut mettre à jour les "repository" de apt : 
216 50 Alexandre Cases
> sudo apt-get update && sudo apt-get upgrade
217 50 Alexandre Cases
218 18 Alexandre Cases
* Un serveur web (apache avec le mod_rewrite actif)
219 50 Alexandre Cases
> sudo apt-get install apache2
220 50 Alexandre Cases
221 51 Alexandre Cases
> Editer le fichier /etc/apache2/apache2.conf et mettre le paramêtre "KeepAlive" à "Off" :
222 55 Alexandre Cases
<pre>
223 55 Alexandre Cases
KeepAlive Off
224 1 Etienne Pallier
</pre>
225 97 Etienne Pallier
=> (pas nécessaire sur Mac OS avec Xampp)
226 96 Etienne Pallier
227 96 Etienne Pallier
> Par défaut Apache utilise un "event module" et PHP un "prefork module".
228 50 Alexandre Cases
> Il faut désactiver le 1er module et activer le second :
229 1 Etienne Pallier
> > sudo a2dismod mpm_event
230 51 Alexandre Cases
> > sudo a2enmod mpm_prefork
231 97 Etienne Pallier
=> (pas nécessaire sur Mac OS avec Xampp)
232 50 Alexandre Cases
233 18 Alexandre Cases
* Un serveur de base de données (MySQL)
234 52 Alexandre Cases
> sudo apt-get install mysql-server 
235 1 Etienne Pallier
236 50 Alexandre Cases
* PHP 5.5.9 ou plus 
237 52 Alexandre Cases
> sudo apt-get install php5 php-pear
238 52 Alexandre Cases
> sudo apt-get install php5-mysql
239 1 Etienne Pallier
240 59 Alexandre Cases
> Dans le fichier /etc/php5/apache2/php.ini, vous devez positionner votre répertoire de log :
241 54 Alexandre Cases
<pre>
242 75 Alexandre Cases
error_reporting = E_ALL
243 1 Etienne Pallier
error_log = /var/log/php/error.log
244 54 Alexandre Cases
max_input_time = 30
245 54 Alexandre Cases
</pre>
246 96 Etienne Pallier
247 1 Etienne Pallier
> Ensuite il faut créer le dossier en question et donner à apache (ici www-data) les droits sur ce dossier :
248 96 Etienne Pallier
> > sudo mkdir /var/log/php
249 52 Alexandre Cases
> > sudo chown www-data /var/log/php
250 97 Etienne Pallier
=> (pas nécessaire sur Mac OS avec Xampp)
251 1 Etienne Pallier
252 96 Etienne Pallier
* Extension PHP "mbstring" et librairie "zlib"
253 96 Etienne Pallier
La collection de librairies est normalement déja installée avec PHP en tant que dépendances, sinon faire :
254 1 Etienne Pallier
> sudo apt-get install libapache2-mod-php5
255 97 Etienne Pallier
=> (TODO: y a-t-il un moyen simple de vérifier la présence de ces librairies ?)
256 96 Etienne Pallier
257 50 Alexandre Cases
* Extension PHP "intl"
258 112 Etienne Pallier
Vérifier que cette extension est activée dans le php.ini:
259 110 Etienne Pallier
<pre>
260 114 Etienne Pallier
extension=intl.so
261 1 Etienne Pallier
</pre>
262 1 Etienne Pallier
263 112 Etienne Pallier
Vérifier qu'elle est bien installée :
264 112 Etienne Pallier
<pre>
265 112 Etienne Pallier
$ php -m| grep intl
266 112 Etienne Pallier
(ça devrait retourner "intl")
267 112 Etienne Pallier
</pre>
268 112 Etienne Pallier
269 112 Etienne Pallier
Sinon, l'installer
270 1 Etienne Pallier
> sudo apt-get install php5-intl
271 1 Etienne Pallier
272 118 Etienne Pallier
(Sur MacOS avec XAMPP: cf http://stackoverflow.com/questions/27886117/php-intl-installation-on-xampp)
273 118 Etienne Pallier
(Il se pourrait que vous ayez besoin de ré-exécuter l'installeur de XAMPP afin de cocher l'option "XAMPP Developer Files", si vous ne l'aviez pas déjà fait lors de votre installation de XAMPP)
274 114 Etienne Pallier
<pre>
275 114 Etienne Pallier
cd /Applications/XAMPP/bin
276 114 Etienne Pallier
sudo ./pecl install intl
277 114 Etienne Pallier
</pre>
278 116 Etienne Pallier
(Vérifier qu'elle a bien été installée dans /Applications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20131226/)
279 96 Etienne Pallier
280 1 Etienne Pallier
* Librairie PHP "php-gd" 
281 52 Alexandre Cases
>  sudo apt-get install php5-gd
282 1 Etienne Pallier
Quand "php-gd" est installé, aller dans le fichier /etc/php5/apache2/php.ini :
283 97 Etienne Pallier
Vérifier que la ligne suivante est présente et décommentée (absence de ";" devant la ligne) sinon il faut la rajouter : 
284 96 Etienne Pallier
<pre>
285 96 Etienne Pallier
extension=gd.so
286 96 Etienne Pallier
</pre>
287 97 Etienne Pallier
=> (TODO: y a-t-il un moyen simple de vérifier la présence de cette librairie ?)
288 96 Etienne Pallier
289 54 Alexandre Cases
290 53 Alexandre Cases
> La page d'info devrait être accessible : http://localhost/info.php
291 53 Alexandre Cases
292 55 Alexandre Cases
* Il est aussi conseillé d'avoir un "phpmyadmin" installé pour pouvoir gérer manuellement la base de données.
293 1 Etienne Pallier
> sudo apt-get php5-mcrypt
294 1 Etienne Pallier
> sudo apt-get install phpmyadmin
295 1 Etienne Pallier
> Pensez à activer mcrypt : sudo php5enmod mcrypt
296 1 Etienne Pallier
297 108 Etienne Pallier
* Vous devez maintenant redémarrer Apache :
298 98 Etienne Pallier
> > sudo service apache2 restart
299 98 Etienne Pallier
(ou simplement le recharger: utiliser "reload" au lieu de "restart")
300 65 Alexandre Cases
301 8 Alexandre Cases
h3. B/ INSTALLATION
302 1 Etienne Pallier
303 23 Alexandre Cases
Nous vous préconisons d'installer le logiciel en mode "SANS LDAP", et d'activer le mode "AVEC LDAP" par la suite, si vous en avez besoin.
304 23 Alexandre Cases
305 1 Etienne Pallier
306 23 Alexandre Cases
* Aller dans le repertoire d'installation :
307 109 Etienne Pallier
cd LABINVENT/install/
308 23 Alexandre Cases
309 1 Etienne Pallier
310 23 Alexandre Cases
* Exécuter le script d'installation :
311 23 Alexandre Cases
./installation.sh
312 109 Etienne Pallier
(vous pourriez éventuellement le faire en tant qu'administrateur "root", mais ça n'est pas nécessaire, le script fera quelques petits "sudo" seulement au besoin).
313 23 Alexandre Cases
(Conseil : à la plupart des questions, laissez les réponses par défaut)
314 23 Alexandre Cases
(Comme expliqué au début, faites une installation en mode "sans LDAP")
315 23 Alexandre Cases
316 23 Alexandre Cases
317 37 Alexandre Cases
* Autoriser les fichiers .htaccess sur le site :
318 1 Etienne Pallier
(cf http://book.cakephp.org/3.0/fr/installation.html#url-rewriting)
319 109 Etienne Pallier
=> (TODO: expliquer rapidement comment faire)
320 1 Etienne Pallier
321 1 Etienne Pallier
Dans le fichier /etc/apache2/apache2.conf, si vous avez déja quelque chose comme ceci, cela suffit :
322 109 Etienne Pallier
<pre>
323 109 Etienne Pallier
<Directory />
324 109 Etienne Pallier
  Options FollowSymLinks
325 109 Etienne Pallier
  AllowOverride All
326 109 Etienne Pallier
  Order deny,allow
327 109 Etienne Pallier
  Deny from all
328 109 Etienne Pallier
  </Directory>
329 109 Etienne Pallier
</pre>
330 23 Alexandre Cases
331 23 Alexandre Cases
Sinon, vous pouvez ajouter ceci, uniquement pour Labinvent :
332 109 Etienne Pallier
<pre>
333 109 Etienne Pallier
<Directory /labinvent>
334 109 Etienne Pallier
  Options FollowSymLinks
335 109 Etienne Pallier
  AllowOverride All
336 109 Etienne Pallier
</Directory>
337 109 Etienne Pallier
</pre>
338 23 Alexandre Cases
339 8 Alexandre Cases
NB : si labinvent n'est pas dans le repertoire des sites webs, il faut mettre son chemin absolu a la place de /labinvent :
340 73 Alexandre Cases
> <Directory /chemin/abosolu/vers/labinvent>
341 73 Alexandre Cases
342 73 Alexandre Cases
* Activer le mode rewrite de Apache :
343 73 Alexandre Cases
> sudo a2enmod rewrite
344 73 Alexandre Cases
345 35 Alexandre Cases
* Redémarrer Apache 
346 33 Alexandre Cases
347 74 Alexandre Cases
* Tester l'accès web à l'application : http://localhost/labinvent.git/
348 74 Alexandre Cases
349 142 Alexandre Cases
* Pour l'instant il faut créer un utilisateur en passant par l'application labinvent pour pouvoir se connecter (problème dû au hachage du mot de passe).
350 142 Alexandre Cases
Pour créer cet utilisateur, une fois la page d'acceuil disponible, allez à l'url qui ressemble à cela : /labinvent/users/add.
351 142 Alexandre Cases
Vous devriez pouvoir vous connecter...
352 142 Alexandre Cases
353 142 Alexandre Cases
354 119 Etienne Pallier
Il est possible que le mode rewrite ne fonctionne pas correctement si les fichiers .htaccess dans la racine et dans webroot disparaissent. Sur certains systèmes les fichiers commençant par un point peuvent disparaitre lors d'une copie. Si c'est le cas pour vous, voici le contenu de ces deux fichiers et leurs emplacements : 
355 1 Etienne Pallier
<pre>
356 74 Alexandre Cases
357 119 Etienne Pallier
Fichier ./.htaccess : 
358 74 Alexandre Cases
<IfModule mod_rewrite.c>
359 74 Alexandre Cases
    RewriteEngine on
360 74 Alexandre Cases
    RewriteRule    ^$    webroot/    [L]
361 74 Alexandre Cases
    RewriteRule    (.*) webroot/$1    [L]
362 74 Alexandre Cases
</IfModule>
363 74 Alexandre Cases
</pre>
364 1 Etienne Pallier
365 74 Alexandre Cases
<pre>
366 74 Alexandre Cases
367 119 Etienne Pallier
Fichier ./webroot/.htaccess : 
368 74 Alexandre Cases
<IfModule mod_rewrite.c>
369 74 Alexandre Cases
    RewriteEngine On
370 74 Alexandre Cases
    RewriteCond %{REQUEST_FILENAME} !-f
371 33 Alexandre Cases
    RewriteRule ^ index.php [L]
372 33 Alexandre Cases
</IfModule>
373 140 Alexandre Cases
</pre>
374 140 Alexandre Cases
375 140 Alexandre Cases
376 119 Etienne Pallier
> Remarques :
377 33 Alexandre Cases
> > Dans CakePHP3 un serveur de développement est disponible, il faut se placer à la racine du projet faire la commande "bin/cake server".
378 87 Alexandre Cases
> > L'application devrait être accessible à l'adresse suivante par défaut : http://localhost:8765/
379 7 Alexandre Cases
380 7 Alexandre Cases
h2. (DEV ONLY) Installation from scratch (Sous UBuntu)
381 2 Alexandre Cases
382 2 Alexandre Cases
h3. Création projet avec Composer
383 2 Alexandre Cases
384 2 Alexandre Cases
* Télécharger composer.phar : 
385 2 Alexandre Cases
"curl -s https://getcomposer.org/installer | php"
386 2 Alexandre Cases
387 2 Alexandre Cases
* Avec le Composer créer un nouveau projet : 
388 4 Alexandre Cases
"php composer.phar create-project --prefer-dist cakephp/app labinvent_2.0"
389 2 Alexandre Cases
390 2 Alexandre Cases
> Voir structure projet : http://book.cakephp.org/3.0/fr/intro/cakephp-folder-structure.html
391 2 Alexandre Cases
392 2 Alexandre Cases
* On rempli la base de données avec le fichier sql
393 2 Alexandre Cases
394 5 Alexandre Cases
* On indique la BD utilisé à CakePHP dans le fichier config/app.php, propriété "Datasources".
395 5 Alexandre Cases
396 2 Alexandre Cases
* On se place à la racine du projet
397 2 Alexandre Cases
398 2 Alexandre Cases
* On génère le code Scaffold : 
399 4 Alexandre Cases
"bin/cake bake all nom_table" --> ça génére les modeles, les vues, et les controlleurs.
400 87 Alexandre Cases
401 6 Alexandre Cases
> Commande (en une fois) :
402 6 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
403 13 Alexandre Cases
404 26 Alexandre Cases
h3. Modification de la base de données 
405 27 Alexandre Cases
> Une version du sql corrigée au fur et à mesure est disponible dans le git :
406 6 Alexandre Cases
> > Dans database/, le fichier labinvent_2.0_19-04-16 correspond à la création de la base.
407 12 Etienne Pallier
> > Dans database/, le fichier labinvent_2.0_insert-irap_19-04-16 correspond aux insertions.
408 12 Etienne Pallier
409 13 Alexandre Cases
* Table "fichiers" en doublon de "documents" => supprimer
410 20 Alexandre Cases
* Attribut organisme inutile dans la table matériel => supprimer
411 13 Alexandre Cases
412 89 Alexandre Cases
h3. Autres remarques lors du dévellopement
413 88 Alexandre Cases
414 13 Alexandre Cases
* En mode debug la page d'acceuil est une page d'information sur l'état et la configuration de CakePHP3 et de ses dépendances.
415 82 Alexandre Cases
Je pense que il y a moyen de rajouter des lignes pour vérifier TOUTE la config, ce serait pas mal comme outil de debug.
416 83 Alexandre Cases
417 159 Alexandre Cases
* CakePHP permet de se configurer en PHP, on pourrait permettre au super-admin de configurer sa base, les noms, les logos, et autres graphiquement outils config dans la section outils ou dans le script d'installation, ou un autre script ?
418 83 Alexandre Cases
<pre>
419 83 Alexandre Cases
Configure::write('nomObjet', [
420 83 Alexandre Cases
    'attribut1' => 'valeur1',
421 83 Alexandre Cases
    'attribut2' => 'valeur2'
422 83 Alexandre Cases
]);
423 83 Alexandre Cases
</pre>
424 77 Alexandre Cases
425 77 Alexandre Cases
* 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. 
426 78 Alexandre Cases
(Lorsqu'un utilisateur se connecte, le gestionnaire de son type de compte se déclenche et les autres gestionnaires sont ignorés)
427 78 Alexandre Cases
428 80 Alexandre Cases
> Voir (explication) : http://book.cakephp.org/3.0/fr/controllers/components/authentication.html
429 45 Etienne Pallier
> Voir (exemple) : http://book.cakephp.org/3.0/fr/tutorials-and-examples/blog-auth-example/auth.html
430 79 Alexandre Cases
> Pour faire des tests d'authentication : http://book.cakephp.org/3.0/fr/development/testing.html#testing-authentication
431 117 Alexandre Cases
432 117 Alexandre Cases
433 45 Etienne Pallier
* La commande Bake de CakePHP3, permet aussi de générer des tests...
434 47 Etienne Pallier
---
435 46 Etienne Pallier
436 115 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")...
437 115 Alexandre Cases
> http://book.cakephp.org/3.0/fr/contributing/cakephp-coding-conventions.html
438 115 Alexandre Cases
439 46 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}(DEV ONLY) NOTES FOR ECLIPSE USERS%
440 46 Etienne Pallier
441 46 Etienne Pallier
0) Install Eclipse (if necessary)
442 46 Etienne Pallier
443 46 Etienne Pallier
Get the Eclipse version for Php
444 46 Etienne Pallier
445 46 Etienne Pallier
446 46 Etienne Pallier
1) Deactivate CA certificate verification
447 46 Etienne Pallier
448 46 Etienne Pallier
Window -> Preferences -> Team -> git -> configuration -> Add entry
449 46 Etienne Pallier
450 46 Etienne Pallier
Key = http.sslVerify
451 46 Etienne Pallier
Value = false
452 46 Etienne Pallier
453 46 Etienne Pallier
2) Fetch the project
454 46 Etienne Pallier
455 1 Etienne Pallier
File/Import project from git
456 1 Etienne Pallier
457 1 Etienne Pallier
Select repository source: Clone URI: https://gitlab.irap.omp.eu/epallier/labinvent.git
458 61 Etienne Pallier
459 61 Etienne Pallier
Directory: 
460 61 Etienne Pallier
- par défaut, il propose : /Users/epallier/git/labinvent
461 61 Etienne Pallier
- mais on peut le mettre n'importe où ailleurs, 
462 61 Etienne Pallier
par exemple, on pourrait le mettre directement dans le repertoire web de Apache:
463 46 Etienne Pallier
/Applications/XAMPP/xamppfiles/htdocs 
464 46 Etienne Pallier
(si on veut que le projet s'execute directement dans le dossier web apache htdocs, mais ca n'est pas obligatoire...)
465 46 Etienne Pallier
466 46 Etienne Pallier
initial branch: master
467 1 Etienne Pallier
remote name: origin
468 1 Etienne Pallier
469 46 Etienne Pallier
Import as general project
470 1 Etienne Pallier
471 1 Etienne Pallier
Project name: LABINVENT
472 61 Etienne Pallier
473 61 Etienne Pallier
474 1 Etienne Pallier
475 1 Etienne Pallier
476 61 Etienne Pallier
3) Configure the project
477 61 Etienne Pallier
478 61 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)
479 61 Etienne Pallier
Si ça n'est pas le cas, vérifier que le fichier .project (à la racine) contient bien
480 61 Etienne Pallier
	<natures>
481 61 Etienne Pallier
		<nature>org.eclipse.php.core.PHPNature</nature>
482 1 Etienne Pallier
	</natures>
483 61 Etienne Pallier
NB : Le fichier .project est normalement versionné et donc le projet labinvent devrait être reconnu automatiquement comme projet PHP
484 62 Etienne Pallier
485 61 Etienne Pallier
486 61 Etienne Pallier
b) S'assurer que les fichiers de vue de cakephp ("*.ctp") sont bien reconnus comme des fichiers PHP.
487 61 Etienne Pallier
Pour tester cela, ouvrir le fichier de vue cakephp/app/View/Categories/get_all.ctp
488 61 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. 
489 61 Etienne Pallier
Il faut donc associer l'editeur Php a l'extension de fichier "*.ctp" :
490 61 Etienne Pallier
- Preferences/General/Content types
491 61 Etienne Pallier
- Dans la liste "Content types", ouvrir la section "Text", selectionner PHP
492 62 Etienne Pallier
- Ajouter l'extension "*.ctp"
493 61 Etienne Pallier
494 61 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) :
495 61 Etienne Pallier
- Clic-droit sur le projet, Propriétés
496 62 Etienne Pallier
- PHP
497 61 Etienne Pallier
- Interpreter
498 62 Etienne Pallier
- Enable project specific settings, PHP Version : "PHP 5.6"
499 61 Etienne Pallier
500 61 Etienne Pallier
d) S'assurer que le texte est bien encodé en UTF-8 par défaut :
501 61 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
502 61 Etienne Pallier
(
503 61 Etienne Pallier
Il faudrait commiter ça mais je ne sais pas trop si c'est risqué ou pas.
504 62 Etienne Pallier
Les fichiers concernés sont :
505 61 Etienne Pallier
- .project (déjà versionné) : car il commence par la ligne "<?xml version="1.0" encoding="UTF-8"?>"
506 61 Etienne Pallier
- mais c'est surtout celui-ci qui compte (actuellement ignoré de git) : .settings/org.eclipse.core.resources.prefs : car sa 2eme ligne est "encoding/<project>=UTF-8"
507 62 Etienne Pallier
)
508 61 Etienne Pallier
509 61 Etienne Pallier
Les éléments suivants sont normalement DEJA ignorés par git, à vérifier :
510 61 Etienne Pallier
- .settings/
511 61 Etienne Pallier
- cakephp/app/tmp/ : tout sauf 
512 61 Etienne Pallier
	- documents/
513 61 Etienne Pallier
- cakephp/app/Config/ :
514 61 Etienne Pallier
	- database.php
515 46 Etienne Pallier
	- labinvent.php
516 46 Etienne Pallier
517 46 Etienne Pallier
518 66 Etienne Pallier
519 67 Etienne Pallier
520 66 Etienne Pallier
521 66 Etienne Pallier
<pre>
522 66 Etienne Pallier
*********************************************************
523 66 Etienne Pallier
REMARQUES INTERRESSANTES (MAIS VOUS POUVEZ LES IGNORER)
524 66 Etienne Pallier
525 66 Etienne Pallier
// DEBUT DES REMARQUES
526 66 Etienne Pallier
527 66 Etienne Pallier
A la racine du projet, j'ai plusieurs éléments cachés de configuration Eclipse :
528 66 Etienne Pallier
529 66 Etienne Pallier
1) fichier .buildpath 
530 66 Etienne Pallier
Il est versionné puisque "svn status .buildpath" (depuis la console) ne donne rien
531 66 Etienne Pallier
Il contient :
532 66 Etienne Pallier
533 66 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
534 66 Etienne Pallier
<buildpath>
535 66 Etienne Pallier
        <buildpathentry kind="con" path="org.eclipse.php.core.LANGUAGE"/>
536 66 Etienne Pallier
        <buildpathentry kind="lib" path="docs/mockup/mockup_html.zip"/>
537 66 Etienne Pallier
        <buildpathentry kind="src" path="cakephp"/>
538 66 Etienne Pallier
</buildpath>
539 66 Etienne Pallier
540 66 Etienne Pallier
2) fichier .project
541 66 Etienne Pallier
Il est déjà versionné
542 66 Etienne Pallier
Il contient :
543 66 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
544 66 Etienne Pallier
<projectDescription>
545 66 Etienne Pallier
        <name>invirap</name>
546 66 Etienne Pallier
        <comment></comment>
547 66 Etienne Pallier
        <projects>
548 66 Etienne Pallier
        </projects>
549 66 Etienne Pallier
        <buildSpec>
550 66 Etienne Pallier
                <buildCommand>
551 66 Etienne Pallier
                        <name>org.eclipse.wst.common.project.facet.core.builder</name>
552 66 Etienne Pallier
                        <arguments>
553 66 Etienne Pallier
                        </arguments>
554 66 Etienne Pallier
                </buildCommand>
555 66 Etienne Pallier
                <buildCommand>
556 66 Etienne Pallier
                        <name>org.eclipse.wst.validation.validationbuilder</name>
557 66 Etienne Pallier
                        <arguments>
558 66 Etienne Pallier
                        </arguments>
559 66 Etienne Pallier
                </buildCommand>
560 66 Etienne Pallier
                <buildCommand>
561 66 Etienne Pallier
                        <name>org.eclipse.dltk.core.scriptbuilder</name>
562 66 Etienne Pallier
                        <arguments>
563 66 Etienne Pallier
                        </arguments>
564 66 Etienne Pallier
                </buildCommand>
565 66 Etienne Pallier
        </buildSpec>
566 66 Etienne Pallier
        <natures>
567 66 Etienne Pallier
                <nature>org.eclipse.php.core.PHPNature</nature>
568 66 Etienne Pallier
                <nature>org.eclipse.wst.common.project.facet.core.nature</nature>
569 66 Etienne Pallier
        </natures>
570 66 Etienne Pallier
</projectDescription>
571 66 Etienne Pallier
572 66 Etienne Pallier
3) dossier .settings/ (exclus de svn)
573 66 Etienne Pallier
Il contient 3 fichiers :
574 66 Etienne Pallier
575 66 Etienne Pallier
- org.eclipse.core.resources.prefs : bizarrement, il ne contient que quelques références seulement :
576 66 Etienne Pallier
eclipse.preferences.version=1
577 66 Etienne Pallier
encoding//cakephp/app/Controller/MaterielsController.php=UTF-8
578 66 Etienne Pallier
encoding//cakephp/app/View/Elements/menu_view.ctp=UTF-8
579 66 Etienne Pallier
encoding//cakephp/app/View/Layouts/default.ctp=UTF-8
580 66 Etienne Pallier
encoding//cakephp/app/View/Materiels/index.ctp=UTF-8
581 66 Etienne Pallier
encoding//cakephp/app/View/Materiels/scaffold.view.ctp=UTF-8
582 66 Etienne Pallier
encoding//database/Upd_TableConstraints.sql=UTF-8
583 66 Etienne Pallier
encoding//database/update/README.txt=UTF-8
584 66 Etienne Pallier
encoding//docs/HOWTO.txt=UTF-8
585 66 Etienne Pallier
encoding//install/HOWTO.txt=UTF-8
586 66 Etienne Pallier
encoding/<project>=UTF-8
587 66 Etienne Pallier
588 66 Etienne Pallier
- org.eclipse.php.core.prefs
589 66 Etienne Pallier
eclipse.preferences.version=1
590 66 Etienne Pallier
include_path=0;/invirap\u00051;/invirap/docs/mockup/mockup_html.zip
591 66 Etienne Pallier
592 66 Etienne Pallier
- org.eclipse.wst.common.project.facet.core.xml : sans doute inutile ? (lié à "Faceted Project Validation Builder" dans Properties/Builders)
593 66 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
594 66 Etienne Pallier
<faceted-project>
595 66 Etienne Pallier
  <fixed facet="php.core.component"/>
596 66 Etienne Pallier
  <fixed facet="php.component"/>
597 66 Etienne Pallier
  <installed facet="php.core.component" version="1"/>
598 66 Etienne Pallier
  <installed facet="php.component" version="5.4"/>
599 66 Etienne Pallier
</faceted-project>
600 1 Etienne Pallier
601 67 Etienne Pallier
// FIN DES REMARQUES
602 66 Etienne Pallier
*********************************************************
603 63 Etienne Pallier
</pre>
604 46 Etienne Pallier
605 63 Etienne Pallier
4) (TODO:) Set Code style
606 63 Etienne Pallier
607 1 Etienne Pallier
Window/Preferences : PHP / Editor
608 63 Etienne Pallier
...
609 46 Etienne Pallier
610 46 Etienne Pallier
5) (TODO: virtualenv) Now, once the PHP5 virtual environment is installed (see above),
611 68 Etienne Pallier
set it in Eclipse as the project interpreter:
612 68 Etienne Pallier
613 63 Etienne Pallier
(cf http://virtphp.org)
614 46 Etienne Pallier
615 63 Etienne Pallier
...
616 46 Etienne Pallier
617 46 Etienne Pallier
6) (TODO:) Test
618 63 Etienne Pallier
619 46 Etienne Pallier
620 63 Etienne Pallier
7) (TODO:) Run
621 1 Etienne Pallier
622 1 Etienne Pallier
check http://localhost:8080/