Installation

Version 1 (Etienne Pallier, 05/02/2016 04:05 pm)

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