Labinvent nouvelle version

Version 172 (Alexandre Cases, 05/02/2016 12:33 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 93 Etienne Pallier
---
101 93 Etienne Pallier
102 101 Etienne Pallier
h2. RECUPERATION
103 41 Etienne Pallier
104 100 Etienne Pallier
1) Authenticate to https://gitlab.irap.omp.eu/epallier/labinvent
105 41 Etienne Pallier
106 41 Etienne Pallier
In order to get this software, you must first authenticate on the IRAP gitlab.
107 41 Etienne Pallier
108 41 Etienne Pallier
For this, just go to https://gitlab.irap.omp.eu/epallier/labinvent
109 1 Etienne Pallier
and either sign in with your LDAP account (if you are from IRAP),
110 41 Etienne Pallier
or register via the "Sign up" form (then, confirm your registration by answering an email sent by gitlab,
111 41 Etienne Pallier
and wait for the "SI" to authorize your registration)
112 41 Etienne Pallier
113 105 Etienne Pallier
If you want, you can browse the code online (from gitlab) :
114 1 Etienne Pallier
115 1 Etienne Pallier
https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
116 1 Etienne Pallier
117 105 Etienne Pallier
2) Récupérer le logiciel
118 1 Etienne Pallier
119 105 Etienne Pallier
Deux options se présentent à vous :
120 106 Etienne Pallier
121 105 Etienne Pallier
 * a) soit vous récupérez une version statique du logiciel, en le téléchargeant
122 105 Etienne Pallier
 * b) soit vous récupérez une version synchronisée, avec git
123 105 Etienne Pallier
124 105 Etienne Pallier
a) Download it (static version, not synchronized)...
125 105 Etienne Pallier
126 41 Etienne Pallier
You can download the current version of the software.
127 41 Etienne Pallier
128 41 Etienne Pallier
Go to https://gitlab.irap.omp.eu/epallier/labinvent/tree/master
129 1 Etienne Pallier
130 41 Etienne Pallier
Click on "Download zip" on the up right hand corner.
131 41 Etienne Pallier
132 107 Etienne Pallier
Double-click on it to unzip it (or run "gzip -d labinvent.zip")
133 41 Etienne Pallier
134 41 Etienne Pallier
You should get a "labinvent.git" folder.
135 41 Etienne Pallier
136 105 Etienne Pallier
In this documentation, this software folder will be referenced as "LABINVENT".
137 41 Etienne Pallier
138 41 Etienne Pallier
(you can rename "labinvent.git" as "labinvent" if you want : "mv labinvent.git labinvent")
139 41 Etienne Pallier
140 105 Etienne Pallier
b) ... or Get it from GIT (dynamic version, synchronized)
141 41 Etienne Pallier
142 41 Etienne Pallier
(If you are using Windows, you must first get the git software, see below "Get git for Windows")
143 41 Etienne Pallier
144 41 Etienne Pallier
By getting the software from git, you will get a dynamically synchronized version,
145 41 Etienne Pallier
which means that you will be able to update your version as soon as a new version is available
146 41 Etienne Pallier
(with the command : "git pull").
147 41 Etienne Pallier
148 41 Etienne Pallier
* From Eclipse : See below, section "NOTES FOR ECLIPSE USERS"
149 41 Etienne Pallier
150 41 Etienne Pallier
* From the terminal
151 41 Etienne Pallier
152 41 Etienne Pallier
<pre>
153 41 Etienne Pallier
git clone https://gitlab.irap.omp.eu/epallier/labinvent.git labinvent
154 41 Etienne Pallier
</pre>
155 41 Etienne Pallier
156 41 Etienne Pallier
_(or also : git clone git@gitlab.irap.omp.eu:epallier/labinvent.git labinvent)_
157 41 Etienne Pallier
158 41 Etienne Pallier
If you ever get this error message... :
159 41 Etienne Pallier
<pre>
160 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.
161 41 Etienne Pallier
</pre>
162 41 Etienne Pallier
163 41 Etienne Pallier
...then, type this command (and then run again the "git clone" command):
164 41 Etienne Pallier
<pre>
165 41 Etienne Pallier
$ git config --global http.sslVerify false
166 41 Etienne Pallier
167 41 Etienne Pallier
Then check that your config is ok:
168 41 Etienne Pallier
169 41 Etienne Pallier
$ cat ~/.gitconfig 
170 41 Etienne Pallier
[user]
171 41 Etienne Pallier
	name = Etienne Pallier
172 41 Etienne Pallier
	email = epallier@irap.omp.eu
173 41 Etienne Pallier
[http]
174 41 Etienne Pallier
	sslVerify = false
175 41 Etienne Pallier
[push]
176 41 Etienne Pallier
	default = simple
177 41 Etienne Pallier
</pre>
178 41 Etienne Pallier
179 41 Etienne Pallier
180 41 Etienne Pallier
(Also, the first time you get the project, git will ask you for a login and password)
181 41 Etienne Pallier
182 41 Etienne Pallier
This creates a labinvent/ folder containing the project (with a .git/ subfolder for synchronization with the git repository)
183 41 Etienne Pallier
184 41 Etienne Pallier
185 107 Etienne Pallier
(Windows only) : Get git for Windows:
186 41 Etienne Pallier
187 41 Etienne Pallier
 * Download git at https://git-scm.com/download/win
188 41 Etienne Pallier
 * Run setup (keep default configurations)
189 41 Etienne Pallier
 * Once installed, open cmd
190 41 Etienne Pallier
<pre>
191 1 Etienne Pallier
$ git config --global http.sslVerify false
192 1 Etienne Pallier
</pre>
193 1 Etienne Pallier
You can now use your git from the cmd or the graphic client !
194 107 Etienne Pallier
195 107 Etienne Pallier
196 107 Etienne Pallier
3) Préparation
197 107 Etienne Pallier
198 107 Etienne Pallier
* Vérifier que vous etes le propriétaire du dossier (il ne doit pas appartenir à "root"), sinon faire : 
199 107 Etienne Pallier
> sudo chown -R nom_utilisateur LABINVENT
200 107 Etienne Pallier
201 107 Etienne Pallier
* Placer cette archive à l'endroit voulu, 2 possibilités :
202 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/)
203 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
204 107 Etienne Pallier
205 43 Etienne Pallier
h2. INSTALLATION
206 7 Alexandre Cases
207 17 Alexandre Cases
h3. A/ PREREQUIS
208 8 Alexandre Cases
209 69 Etienne Pallier
(L'exemple est donné ici pour une distribution linux UBuntu 14.04.4)
210 50 Alexandre Cases
211 50 Alexandre Cases
* Pour commencer il faut mettre à jour les "repository" de apt : 
212 50 Alexandre Cases
> sudo apt-get update && sudo apt-get upgrade
213 50 Alexandre Cases
214 18 Alexandre Cases
* Un serveur web (apache avec le mod_rewrite actif)
215 50 Alexandre Cases
> sudo apt-get install apache2
216 50 Alexandre Cases
217 51 Alexandre Cases
> Editer le fichier /etc/apache2/apache2.conf et mettre le paramêtre "KeepAlive" à "Off" :
218 55 Alexandre Cases
<pre>
219 55 Alexandre Cases
KeepAlive Off
220 1 Etienne Pallier
</pre>
221 97 Etienne Pallier
=> (pas nécessaire sur Mac OS avec Xampp)
222 96 Etienne Pallier
223 96 Etienne Pallier
> Par défaut Apache utilise un "event module" et PHP un "prefork module".
224 50 Alexandre Cases
> Il faut désactiver le 1er module et activer le second :
225 1 Etienne Pallier
> > sudo a2dismod mpm_event
226 51 Alexandre Cases
> > sudo a2enmod mpm_prefork
227 97 Etienne Pallier
=> (pas nécessaire sur Mac OS avec Xampp)
228 50 Alexandre Cases
229 18 Alexandre Cases
* Un serveur de base de données (MySQL)
230 52 Alexandre Cases
> sudo apt-get install mysql-server 
231 1 Etienne Pallier
232 50 Alexandre Cases
* PHP 5.5.9 ou plus 
233 52 Alexandre Cases
> sudo apt-get install php5 php-pear
234 52 Alexandre Cases
> sudo apt-get install php5-mysql
235 1 Etienne Pallier
236 59 Alexandre Cases
> Dans le fichier /etc/php5/apache2/php.ini, vous devez positionner votre répertoire de log :
237 54 Alexandre Cases
<pre>
238 75 Alexandre Cases
error_reporting = E_ALL
239 1 Etienne Pallier
error_log = /var/log/php/error.log
240 54 Alexandre Cases
max_input_time = 30
241 54 Alexandre Cases
</pre>
242 96 Etienne Pallier
243 1 Etienne Pallier
> Ensuite il faut créer le dossier en question et donner à apache (ici www-data) les droits sur ce dossier :
244 96 Etienne Pallier
> > sudo mkdir /var/log/php
245 52 Alexandre Cases
> > sudo chown www-data /var/log/php
246 97 Etienne Pallier
=> (pas nécessaire sur Mac OS avec Xampp)
247 1 Etienne Pallier
248 96 Etienne Pallier
* Extension PHP "mbstring" et librairie "zlib"
249 96 Etienne Pallier
La collection de librairies est normalement déja installée avec PHP en tant que dépendances, sinon faire :
250 1 Etienne Pallier
> sudo apt-get install libapache2-mod-php5
251 97 Etienne Pallier
=> (TODO: y a-t-il un moyen simple de vérifier la présence de ces librairies ?)
252 96 Etienne Pallier
253 50 Alexandre Cases
* Extension PHP "intl"
254 112 Etienne Pallier
Vérifier que cette extension est activée dans le php.ini:
255 110 Etienne Pallier
<pre>
256 114 Etienne Pallier
extension=intl.so
257 1 Etienne Pallier
</pre>
258 1 Etienne Pallier
259 112 Etienne Pallier
Vérifier qu'elle est bien installée :
260 112 Etienne Pallier
<pre>
261 112 Etienne Pallier
$ php -m| grep intl
262 112 Etienne Pallier
(ça devrait retourner "intl")
263 112 Etienne Pallier
</pre>
264 112 Etienne Pallier
265 112 Etienne Pallier
Sinon, l'installer
266 1 Etienne Pallier
> sudo apt-get install php5-intl
267 1 Etienne Pallier
268 118 Etienne Pallier
(Sur MacOS avec XAMPP: cf http://stackoverflow.com/questions/27886117/php-intl-installation-on-xampp)
269 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)
270 114 Etienne Pallier
<pre>
271 114 Etienne Pallier
cd /Applications/XAMPP/bin
272 114 Etienne Pallier
sudo ./pecl install intl
273 114 Etienne Pallier
</pre>
274 116 Etienne Pallier
(Vérifier qu'elle a bien été installée dans /Applications/XAMPP/xamppfiles/lib/php/extensions/no-debug-non-zts-20131226/)
275 96 Etienne Pallier
276 1 Etienne Pallier
* Librairie PHP "php-gd" 
277 52 Alexandre Cases
>  sudo apt-get install php5-gd
278 1 Etienne Pallier
Quand "php-gd" est installé, aller dans le fichier /etc/php5/apache2/php.ini :
279 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 : 
280 96 Etienne Pallier
<pre>
281 96 Etienne Pallier
extension=gd.so
282 96 Etienne Pallier
</pre>
283 97 Etienne Pallier
=> (TODO: y a-t-il un moyen simple de vérifier la présence de cette librairie ?)
284 96 Etienne Pallier
285 54 Alexandre Cases
286 53 Alexandre Cases
> La page d'info devrait être accessible : http://localhost/info.php
287 53 Alexandre Cases
288 55 Alexandre Cases
* Il est aussi conseillé d'avoir un "phpmyadmin" installé pour pouvoir gérer manuellement la base de données.
289 1 Etienne Pallier
> sudo apt-get php5-mcrypt
290 1 Etienne Pallier
> sudo apt-get install phpmyadmin
291 1 Etienne Pallier
> Pensez à activer mcrypt : sudo php5enmod mcrypt
292 1 Etienne Pallier
293 108 Etienne Pallier
* Vous devez maintenant redémarrer Apache :
294 98 Etienne Pallier
> > sudo service apache2 restart
295 98 Etienne Pallier
(ou simplement le recharger: utiliser "reload" au lieu de "restart")
296 65 Alexandre Cases
297 8 Alexandre Cases
h3. B/ INSTALLATION
298 1 Etienne Pallier
299 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.
300 23 Alexandre Cases
301 1 Etienne Pallier
302 23 Alexandre Cases
* Aller dans le repertoire d'installation :
303 109 Etienne Pallier
cd LABINVENT/install/
304 23 Alexandre Cases
305 1 Etienne Pallier
306 23 Alexandre Cases
* Exécuter le script d'installation :
307 23 Alexandre Cases
./installation.sh
308 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).
309 23 Alexandre Cases
(Conseil : à la plupart des questions, laissez les réponses par défaut)
310 23 Alexandre Cases
(Comme expliqué au début, faites une installation en mode "sans LDAP")
311 23 Alexandre Cases
312 23 Alexandre Cases
313 37 Alexandre Cases
* Autoriser les fichiers .htaccess sur le site :
314 1 Etienne Pallier
(cf http://book.cakephp.org/3.0/fr/installation.html#url-rewriting)
315 109 Etienne Pallier
=> (TODO: expliquer rapidement comment faire)
316 1 Etienne Pallier
317 1 Etienne Pallier
Dans le fichier /etc/apache2/apache2.conf, si vous avez déja quelque chose comme ceci, cela suffit :
318 109 Etienne Pallier
<pre>
319 109 Etienne Pallier
<Directory />
320 109 Etienne Pallier
  Options FollowSymLinks
321 109 Etienne Pallier
  AllowOverride All
322 109 Etienne Pallier
  Order deny,allow
323 109 Etienne Pallier
  Deny from all
324 109 Etienne Pallier
  </Directory>
325 109 Etienne Pallier
</pre>
326 23 Alexandre Cases
327 23 Alexandre Cases
Sinon, vous pouvez ajouter ceci, uniquement pour Labinvent :
328 109 Etienne Pallier
<pre>
329 109 Etienne Pallier
<Directory /labinvent>
330 109 Etienne Pallier
  Options FollowSymLinks
331 109 Etienne Pallier
  AllowOverride All
332 109 Etienne Pallier
</Directory>
333 109 Etienne Pallier
</pre>
334 23 Alexandre Cases
335 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 :
336 73 Alexandre Cases
> <Directory /chemin/abosolu/vers/labinvent>
337 73 Alexandre Cases
338 73 Alexandre Cases
* Activer le mode rewrite de Apache :
339 73 Alexandre Cases
> sudo a2enmod rewrite
340 73 Alexandre Cases
341 35 Alexandre Cases
* Redémarrer Apache 
342 33 Alexandre Cases
343 74 Alexandre Cases
* Tester l'accès web à l'application : http://localhost/labinvent.git/
344 74 Alexandre Cases
345 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).
346 142 Alexandre Cases
Pour créer cet utilisateur, une fois la page d'acceuil disponible, allez à l'url qui ressemble à cela : /labinvent/users/add.
347 142 Alexandre Cases
Vous devriez pouvoir vous connecter...
348 142 Alexandre Cases
349 142 Alexandre Cases
350 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 : 
351 1 Etienne Pallier
<pre>
352 74 Alexandre Cases
353 119 Etienne Pallier
Fichier ./.htaccess : 
354 74 Alexandre Cases
<IfModule mod_rewrite.c>
355 74 Alexandre Cases
    RewriteEngine on
356 74 Alexandre Cases
    RewriteRule    ^$    webroot/    [L]
357 74 Alexandre Cases
    RewriteRule    (.*) webroot/$1    [L]
358 74 Alexandre Cases
</IfModule>
359 74 Alexandre Cases
</pre>
360 1 Etienne Pallier
361 74 Alexandre Cases
<pre>
362 74 Alexandre Cases
363 119 Etienne Pallier
Fichier ./webroot/.htaccess : 
364 74 Alexandre Cases
<IfModule mod_rewrite.c>
365 74 Alexandre Cases
    RewriteEngine On
366 74 Alexandre Cases
    RewriteCond %{REQUEST_FILENAME} !-f
367 33 Alexandre Cases
    RewriteRule ^ index.php [L]
368 33 Alexandre Cases
</IfModule>
369 140 Alexandre Cases
</pre>
370 140 Alexandre Cases
371 140 Alexandre Cases
372 119 Etienne Pallier
> Remarques :
373 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".
374 87 Alexandre Cases
> > L'application devrait être accessible à l'adresse suivante par défaut : http://localhost:8765/
375 7 Alexandre Cases
376 7 Alexandre Cases
h2. (DEV ONLY) Installation from scratch (Sous UBuntu)
377 2 Alexandre Cases
378 2 Alexandre Cases
h3. Création projet avec Composer
379 2 Alexandre Cases
380 2 Alexandre Cases
* Télécharger composer.phar : 
381 2 Alexandre Cases
"curl -s https://getcomposer.org/installer | php"
382 2 Alexandre Cases
383 2 Alexandre Cases
* Avec le Composer créer un nouveau projet : 
384 4 Alexandre Cases
"php composer.phar create-project --prefer-dist cakephp/app labinvent_2.0"
385 2 Alexandre Cases
386 2 Alexandre Cases
> Voir structure projet : http://book.cakephp.org/3.0/fr/intro/cakephp-folder-structure.html
387 2 Alexandre Cases
388 2 Alexandre Cases
* On rempli la base de données avec le fichier sql
389 2 Alexandre Cases
390 5 Alexandre Cases
* On indique la BD utilisé à CakePHP dans le fichier config/app.php, propriété "Datasources".
391 5 Alexandre Cases
392 2 Alexandre Cases
* On se place à la racine du projet
393 2 Alexandre Cases
394 2 Alexandre Cases
* On génère le code Scaffold : 
395 4 Alexandre Cases
"bin/cake bake all nom_table" --> ça génére les modeles, les vues, et les controlleurs.
396 87 Alexandre Cases
397 6 Alexandre Cases
> Commande (en une fois) :
398 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
399 13 Alexandre Cases
400 26 Alexandre Cases
h3. Modification de la base de données 
401 27 Alexandre Cases
> Une version du sql corrigée au fur et à mesure est disponible dans le git :
402 6 Alexandre Cases
> > Dans database/, le fichier labinvent_2.0_19-04-16 correspond à la création de la base.
403 12 Etienne Pallier
> > Dans database/, le fichier labinvent_2.0_insert-irap_19-04-16 correspond aux insertions.
404 12 Etienne Pallier
405 13 Alexandre Cases
* Table "fichiers" en doublon de "documents" => supprimer
406 20 Alexandre Cases
* Attribut organisme inutile dans la table matériel => supprimer
407 13 Alexandre Cases
408 89 Alexandre Cases
h3. Autres remarques lors du dévellopement
409 88 Alexandre Cases
410 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.
411 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.
412 83 Alexandre Cases
413 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 ?
414 83 Alexandre Cases
<pre>
415 83 Alexandre Cases
Configure::write('nomObjet', [
416 83 Alexandre Cases
    'attribut1' => 'valeur1',
417 83 Alexandre Cases
    'attribut2' => 'valeur2'
418 83 Alexandre Cases
]);
419 83 Alexandre Cases
</pre>
420 77 Alexandre Cases
421 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. 
422 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)
423 78 Alexandre Cases
424 80 Alexandre Cases
> Voir (explication) : http://book.cakephp.org/3.0/fr/controllers/components/authentication.html
425 45 Etienne Pallier
> Voir (exemple) : http://book.cakephp.org/3.0/fr/tutorials-and-examples/blog-auth-example/auth.html
426 79 Alexandre Cases
> Pour faire des tests d'authentication : http://book.cakephp.org/3.0/fr/development/testing.html#testing-authentication
427 117 Alexandre Cases
428 117 Alexandre Cases
429 45 Etienne Pallier
* La commande Bake de CakePHP3, permet aussi de générer des tests...
430 47 Etienne Pallier
---
431 46 Etienne Pallier
432 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")...
433 115 Alexandre Cases
> http://book.cakephp.org/3.0/fr/contributing/cakephp-coding-conventions.html
434 115 Alexandre Cases
435 46 Etienne Pallier
h2. %{margin-left:0px; font-weight:bold; font-size:25px;  display:block; color:red;}(DEV ONLY) NOTES FOR ECLIPSE USERS%
436 46 Etienne Pallier
437 46 Etienne Pallier
0) Install Eclipse (if necessary)
438 46 Etienne Pallier
439 46 Etienne Pallier
Get the Eclipse version for Php
440 46 Etienne Pallier
441 46 Etienne Pallier
442 46 Etienne Pallier
1) Deactivate CA certificate verification
443 46 Etienne Pallier
444 46 Etienne Pallier
Window -> Preferences -> Team -> git -> configuration -> Add entry
445 46 Etienne Pallier
446 46 Etienne Pallier
Key = http.sslVerify
447 46 Etienne Pallier
Value = false
448 46 Etienne Pallier
449 46 Etienne Pallier
2) Fetch the project
450 46 Etienne Pallier
451 1 Etienne Pallier
File/Import project from git
452 1 Etienne Pallier
453 1 Etienne Pallier
Select repository source: Clone URI: https://gitlab.irap.omp.eu/epallier/labinvent.git
454 61 Etienne Pallier
455 61 Etienne Pallier
Directory: 
456 61 Etienne Pallier
- par défaut, il propose : /Users/epallier/git/labinvent
457 61 Etienne Pallier
- mais on peut le mettre n'importe où ailleurs, 
458 61 Etienne Pallier
par exemple, on pourrait le mettre directement dans le repertoire web de Apache:
459 46 Etienne Pallier
/Applications/XAMPP/xamppfiles/htdocs 
460 46 Etienne Pallier
(si on veut que le projet s'execute directement dans le dossier web apache htdocs, mais ca n'est pas obligatoire...)
461 46 Etienne Pallier
462 46 Etienne Pallier
initial branch: master
463 1 Etienne Pallier
remote name: origin
464 1 Etienne Pallier
465 46 Etienne Pallier
Import as general project
466 1 Etienne Pallier
467 1 Etienne Pallier
Project name: LABINVENT
468 61 Etienne Pallier
469 61 Etienne Pallier
470 1 Etienne Pallier
471 1 Etienne Pallier
472 61 Etienne Pallier
3) Configure the project
473 61 Etienne Pallier
474 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)
475 61 Etienne Pallier
Si ça n'est pas le cas, vérifier que le fichier .project (à la racine) contient bien
476 61 Etienne Pallier
	<natures>
477 61 Etienne Pallier
		<nature>org.eclipse.php.core.PHPNature</nature>
478 1 Etienne Pallier
	</natures>
479 61 Etienne Pallier
NB : Le fichier .project est normalement versionné et donc le projet labinvent devrait être reconnu automatiquement comme projet PHP
480 62 Etienne Pallier
481 61 Etienne Pallier
482 61 Etienne Pallier
b) S'assurer que les fichiers de vue de cakephp ("*.ctp") sont bien reconnus comme des fichiers PHP.
483 61 Etienne Pallier
Pour tester cela, ouvrir le fichier de vue cakephp/app/View/Categories/get_all.ctp
484 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. 
485 61 Etienne Pallier
Il faut donc associer l'editeur Php a l'extension de fichier "*.ctp" :
486 61 Etienne Pallier
- Preferences/General/Content types
487 61 Etienne Pallier
- Dans la liste "Content types", ouvrir la section "Text", selectionner PHP
488 62 Etienne Pallier
- Ajouter l'extension "*.ctp"
489 61 Etienne Pallier
490 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) :
491 61 Etienne Pallier
- Clic-droit sur le projet, Propriétés
492 62 Etienne Pallier
- PHP
493 61 Etienne Pallier
- Interpreter
494 62 Etienne Pallier
- Enable project specific settings, PHP Version : "PHP 5.6"
495 61 Etienne Pallier
496 61 Etienne Pallier
d) S'assurer que le texte est bien encodé en UTF-8 par défaut :
497 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
498 61 Etienne Pallier
(
499 61 Etienne Pallier
Il faudrait commiter ça mais je ne sais pas trop si c'est risqué ou pas.
500 62 Etienne Pallier
Les fichiers concernés sont :
501 61 Etienne Pallier
- .project (déjà versionné) : car il commence par la ligne "<?xml version="1.0" encoding="UTF-8"?>"
502 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"
503 62 Etienne Pallier
)
504 61 Etienne Pallier
505 61 Etienne Pallier
Les éléments suivants sont normalement DEJA ignorés par git, à vérifier :
506 61 Etienne Pallier
- .settings/
507 61 Etienne Pallier
- cakephp/app/tmp/ : tout sauf 
508 61 Etienne Pallier
	- documents/
509 61 Etienne Pallier
- cakephp/app/Config/ :
510 61 Etienne Pallier
	- database.php
511 46 Etienne Pallier
	- labinvent.php
512 46 Etienne Pallier
513 46 Etienne Pallier
514 66 Etienne Pallier
515 67 Etienne Pallier
516 66 Etienne Pallier
517 66 Etienne Pallier
<pre>
518 66 Etienne Pallier
*********************************************************
519 66 Etienne Pallier
REMARQUES INTERRESSANTES (MAIS VOUS POUVEZ LES IGNORER)
520 66 Etienne Pallier
521 66 Etienne Pallier
// DEBUT DES REMARQUES
522 66 Etienne Pallier
523 66 Etienne Pallier
A la racine du projet, j'ai plusieurs éléments cachés de configuration Eclipse :
524 66 Etienne Pallier
525 66 Etienne Pallier
1) fichier .buildpath 
526 66 Etienne Pallier
Il est versionné puisque "svn status .buildpath" (depuis la console) ne donne rien
527 66 Etienne Pallier
Il contient :
528 66 Etienne Pallier
529 66 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
530 66 Etienne Pallier
<buildpath>
531 66 Etienne Pallier
        <buildpathentry kind="con" path="org.eclipse.php.core.LANGUAGE"/>
532 66 Etienne Pallier
        <buildpathentry kind="lib" path="docs/mockup/mockup_html.zip"/>
533 66 Etienne Pallier
        <buildpathentry kind="src" path="cakephp"/>
534 66 Etienne Pallier
</buildpath>
535 66 Etienne Pallier
536 66 Etienne Pallier
2) fichier .project
537 66 Etienne Pallier
Il est déjà versionné
538 66 Etienne Pallier
Il contient :
539 66 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
540 66 Etienne Pallier
<projectDescription>
541 66 Etienne Pallier
        <name>invirap</name>
542 66 Etienne Pallier
        <comment></comment>
543 66 Etienne Pallier
        <projects>
544 66 Etienne Pallier
        </projects>
545 66 Etienne Pallier
        <buildSpec>
546 66 Etienne Pallier
                <buildCommand>
547 66 Etienne Pallier
                        <name>org.eclipse.wst.common.project.facet.core.builder</name>
548 66 Etienne Pallier
                        <arguments>
549 66 Etienne Pallier
                        </arguments>
550 66 Etienne Pallier
                </buildCommand>
551 66 Etienne Pallier
                <buildCommand>
552 66 Etienne Pallier
                        <name>org.eclipse.wst.validation.validationbuilder</name>
553 66 Etienne Pallier
                        <arguments>
554 66 Etienne Pallier
                        </arguments>
555 66 Etienne Pallier
                </buildCommand>
556 66 Etienne Pallier
                <buildCommand>
557 66 Etienne Pallier
                        <name>org.eclipse.dltk.core.scriptbuilder</name>
558 66 Etienne Pallier
                        <arguments>
559 66 Etienne Pallier
                        </arguments>
560 66 Etienne Pallier
                </buildCommand>
561 66 Etienne Pallier
        </buildSpec>
562 66 Etienne Pallier
        <natures>
563 66 Etienne Pallier
                <nature>org.eclipse.php.core.PHPNature</nature>
564 66 Etienne Pallier
                <nature>org.eclipse.wst.common.project.facet.core.nature</nature>
565 66 Etienne Pallier
        </natures>
566 66 Etienne Pallier
</projectDescription>
567 66 Etienne Pallier
568 66 Etienne Pallier
3) dossier .settings/ (exclus de svn)
569 66 Etienne Pallier
Il contient 3 fichiers :
570 66 Etienne Pallier
571 66 Etienne Pallier
- org.eclipse.core.resources.prefs : bizarrement, il ne contient que quelques références seulement :
572 66 Etienne Pallier
eclipse.preferences.version=1
573 66 Etienne Pallier
encoding//cakephp/app/Controller/MaterielsController.php=UTF-8
574 66 Etienne Pallier
encoding//cakephp/app/View/Elements/menu_view.ctp=UTF-8
575 66 Etienne Pallier
encoding//cakephp/app/View/Layouts/default.ctp=UTF-8
576 66 Etienne Pallier
encoding//cakephp/app/View/Materiels/index.ctp=UTF-8
577 66 Etienne Pallier
encoding//cakephp/app/View/Materiels/scaffold.view.ctp=UTF-8
578 66 Etienne Pallier
encoding//database/Upd_TableConstraints.sql=UTF-8
579 66 Etienne Pallier
encoding//database/update/README.txt=UTF-8
580 66 Etienne Pallier
encoding//docs/HOWTO.txt=UTF-8
581 66 Etienne Pallier
encoding//install/HOWTO.txt=UTF-8
582 66 Etienne Pallier
encoding/<project>=UTF-8
583 66 Etienne Pallier
584 66 Etienne Pallier
- org.eclipse.php.core.prefs
585 66 Etienne Pallier
eclipse.preferences.version=1
586 66 Etienne Pallier
include_path=0;/invirap\u00051;/invirap/docs/mockup/mockup_html.zip
587 66 Etienne Pallier
588 66 Etienne Pallier
- org.eclipse.wst.common.project.facet.core.xml : sans doute inutile ? (lié à "Faceted Project Validation Builder" dans Properties/Builders)
589 66 Etienne Pallier
<?xml version="1.0" encoding="UTF-8"?>
590 66 Etienne Pallier
<faceted-project>
591 66 Etienne Pallier
  <fixed facet="php.core.component"/>
592 66 Etienne Pallier
  <fixed facet="php.component"/>
593 66 Etienne Pallier
  <installed facet="php.core.component" version="1"/>
594 66 Etienne Pallier
  <installed facet="php.component" version="5.4"/>
595 66 Etienne Pallier
</faceted-project>
596 1 Etienne Pallier
597 67 Etienne Pallier
// FIN DES REMARQUES
598 66 Etienne Pallier
*********************************************************
599 63 Etienne Pallier
</pre>
600 46 Etienne Pallier
601 63 Etienne Pallier
4) (TODO:) Set Code style
602 63 Etienne Pallier
603 1 Etienne Pallier
Window/Preferences : PHP / Editor
604 63 Etienne Pallier
...
605 46 Etienne Pallier
606 46 Etienne Pallier
5) (TODO: virtualenv) Now, once the PHP5 virtual environment is installed (see above),
607 68 Etienne Pallier
set it in Eclipse as the project interpreter:
608 68 Etienne Pallier
609 63 Etienne Pallier
(cf http://virtphp.org)
610 46 Etienne Pallier
611 63 Etienne Pallier
...
612 46 Etienne Pallier
613 46 Etienne Pallier
6) (TODO:) Test
614 63 Etienne Pallier
615 46 Etienne Pallier
616 63 Etienne Pallier
7) (TODO:) Run
617 1 Etienne Pallier
618 1 Etienne Pallier
check http://localhost:8080/