Merge branch 'klodd' into 'master'

Mise à jour des instructions d'installation et fix pour Symfony 4.3

See merge request Kohinos/kohinos!2

INSTALL.txt

-
-
-Attention, il est préférable d'installer dans une bdd vierge (voir .env).
-Dans le cas contraire, modifier le fichier de migration une fois généré mais avant application (src/Migrations/).
-
-// créer un fichier .env avec le contenu suivant
-#dev, test ou prod#
-APP_ENV=dev
-#debug 0 ou 1#
-APP_DEBUG=1
-#token secret#
-APP_SECRET=9hgz21afe254dj7f552gtya2f01dd5f2
-#prefix des tables#
-DATABASE_PREFIX=prefix_
-#acces bdd#
-DATABASE_URL=mysql://user:passw@localhost:3306/nom_bdd
-#smtp#
-MAILER_URL=smtp://localhost:25?encryption=&auth_mode=
-
-
-// Installer composer si besoin
-curl -sS https://getcomposer.org/installer | php
-
-1 // Cloner le projet dans le dossier nomdudossier
-git clone https://gitlab.com/Kohinos/kohinos.git nomdudossier
-
-// Aller à nomdudossier
-cd nomdudossier
-
-2 // Copier le .env et modifier les variables d'environnement (bdd, cache...)
-vi .env
-
-3 // Installer les dépendances via composer
-composer install
-ou pour OVH
-php ../composer.phar install
-
-4 // Générer le fichier de migration
-php bin/console doctrine:migrations:diff
-
-5 // Lancer la mise à jour de la base de données
-php bin/console doctrine:migrations:migrate
-
-6 // Charger les fixtures standards
-php bin/console hautelook:fixtures:load --purge-with-truncate
-php bin/console lexik:translations:import
-
-7 // Installer les assets via symlink (vérifier avant dans public/bundles)
-php bin/console assets:install --symlink
-
-// Supprimer le cache (si besoin)
-php bin/console cache:clear
-ou
-rm -rf var/cache/* (supprimes tous les dossiers de cache, plus rapide et plus efficace en cas de changement de structure de bdd)
-
-Faire pointer l'adresse dans le dossier public.
-Naviguer vers l'application et démarer le système.
-
-// En local
-php bin/console server:run
-
-// Naviguer vers
-http://127.0.0.1:8000
-
-// Modifier le .htaccess si probleme (si apache < 2.4, il y a le public/.htaccessOLD qui peut être comptatible)
-vi public/.htaccess
-
-Remarques, géolocalisation difficile en local.
-
-
-
-
-
-
-
-
-

README.md

@@ -2,4 +2,107 @@
 
 Outil de gestion, destiné aux associations désireuses de porter une Monnaie Locale Complémentaire
 
-Communauté de développement pour une économie plus juste et solidaire.
+Communauté de développement pour une économie plus juste et solidaire.
\ No newline at end of file
+
+
+
+# Installation
+
+## Pré-requis
+Pour pouvoir fonctionner un certain nombre de packages système sont requis. Vous devez utiliser yum/apt pour les installer
+
+Les packages PHP `php7.2-cli php-mbstring php-zip php-curl php-xml`
+
+Pour la base de donnée, vous pouvez choisir entre `mysql-server` et `mariadb-server`
+
+## Mysql
+Il vous faut un utilisateur `user` qui peut se logger avec un mot de passe `passwd` ainsi qu'une database existante `nom_bdd`.
+
+
+
+
+## Installation de Kohinos
+Attention, il est préférable d'installer dans une bdd (database) vierge.
+Dans le cas contraire, modifier le fichier de migration une fois généré mais avant application (src/Migrations/).
+
+- créer un fichier .env avec le contenu suivant
+```
+#dev, test ou prod#
+APP_ENV=dev
+#debug 0 ou 1#
+APP_DEBUG=1
+#token secret (ne pas changer)#
+APP_SECRET=9hgz21afe254dj7f552gtya2f01dd5f2
+#prefix des tables#
+DATABASE_PREFIX=prefix_
+#acces bdd#
+DATABASE_URL=mysql://user:passw@localhost:3306/nom_bdd
+#smtp#
+MAILER_URL=smtp://localhost:25?encryption=&auth_mode=
+```
+
+- Installer composer si besoin
+
+`curl -sS https://getcomposer.org/installer | php`
+
+- Cloner le projet dans le dossier nomdudossier
+
+`git clone https://gitlab.com/Kohinos/kohinos.git nomdudossier`
+
+- Naviguer vers `nomdudossier`
+
+`cd nomdudossier`
+
+- Installer les dépendances via composer (cela dépend des systèmes)
+
+`composer install` ou bien `php ../composer.phar install`
+
+- Générer le fichier de migration
+
+`php bin/console doctrine:migrations:diff`
+
+- Lancer la mise à jour de la base de données
+
+`php bin/console doctrine:migrations:migrate`
+
+- Charger les fixtures standards
+
+`php bin/console hautelook:fixtures:load --purge-with-truncate`
+
+- TODO: je ne sais pas à quoi sert cette étape ?
+
+`php bin/console lexik:translations:import`
+
+- **dev uniquement :** charger les fixtures de dev (ce qui crée des éléments dans la BDD pour pouvoir tester les fonctionnalités)
+
+`php bin/console hautelook:fixtures:load --purge-with-truncate --env=test`
+
+
+- Si `public/bundles` est vide, sinon sauter l'étape suivante
+
+`php bin/console assets:install --symlink`
+
+- Supprimer le cache (si besoin)
+
+`php bin/console cache:clear`
+
+ou pour supprimer tous les dossiers de cache (plus rapide et plus efficace en cas de changement de structure de bdd)
+
+`rm -rf var/cache/*`
+
+- Sur un serveur :
+  - Faire pointer l'adresse dans le dossier public.
+  - Naviguer vers l'application et démarer le système.
+
+- En local :
+`php bin/console server:run`
+  - Naviguer vers `http://127.0.0.1:8000`
+
+
+## htaccess
+En cas de problème, modifier le .htaccess (si apache < 2.4, il y a le public/.htaccessOLD qui peut être comptatible)
+
+`vi public/.htaccess`
+
+## Remarques
+- La géolocalisation est difficile en local.

composer.json

@@ -28,28 +28,28 @@
         "sonata-project/intl-bundle": "^2.5",
         "sonata-project/media-bundle": "^3.16",
         "sonata-project/translation-bundle": "^2.4",
-        "sonata-project/user-bundle": "^4.2",
+        "sonata-project/user-bundle": "^4.3",
         "stof/doctrine-extensions-bundle": "^1.3",
         "symfony/apache-pack": "^1.0",
-        "symfony/asset": "4.2.*",
-        "symfony/cache": "4.2.*",
-        "symfony/console": "4.2.*",
-        "symfony/expression-language": "4.2.*",
+        "symfony/asset": "4.3.*",
+        "symfony/cache": "4.3.*",
+        "symfony/console": "4.3.*",
+        "symfony/expression-language": "4.3.*",
         "symfony/flex": "^1.1",
-        "symfony/form": "4.2.*",
-        "symfony/framework-bundle": "4.2.*",
+        "symfony/form": "4.3.*",
+        "symfony/framework-bundle": "4.3.*",
         "symfony/monolog-bundle": "^3.1",
         "symfony/orm-pack": "*",
-        "symfony/process": "4.2.*",
-        "symfony/security-bundle": "4.2.*",
+        "symfony/process": "4.3.*",
+        "symfony/security-bundle": "4.3.*",
         "symfony/serializer-pack": "*",
         "symfony/swiftmailer-bundle": "^3.1",
-        "symfony/translation": "4.2.*",
-        "symfony/twig-bundle": "4.2.*",
-        "symfony/validator": "4.2.*",
-        "symfony/web-link": "4.2.*",
+        "symfony/translation": "4.3.*",
+        "symfony/twig-bundle": "4.3.*",
+        "symfony/validator": "4.3.*",
+        "symfony/web-link": "4.3.*",
         "symfony/webpack-encore-bundle": "^1.0",
-        "symfony/yaml": "4.2.*",
+        "symfony/yaml": "4.3.*",
         "vich/uploader-bundle": "^1.8",
         "willdurand/geocoder-bundle": "^5.0"
     },
@@ -57,16 +57,16 @@
         "doctrine/doctrine-fixtures-bundle": "^3.0",
         "hautelook/alice-bundle": "^2.3",
         "sensiolabs/security-checker": "^5.0",
-        "symfony/browser-kit": "4.2.*",
-        "symfony/css-selector": "4.2.*",
+        "symfony/browser-kit": "4.3.*",
+        "symfony/css-selector": "4.3.*",
         "symfony/debug-pack": "*",
-        "symfony/dotenv": "4.2.*",
+        "symfony/dotenv": "4.3.*",
         "symfony/maker-bundle": "^1.0",
-        "symfony/phpunit-bridge": "4.2.*",
+        "symfony/phpunit-bridge": "4.3.*",
         "symfony/profiler-pack": "*",
         "symfony/test-pack": "^1.0",
-        "symfony/var-dumper": "4.2.*",
-        "symfony/web-server-bundle": "4.2.*"
+        "symfony/var-dumper": "4.3.*",
+        "symfony/web-server-bundle": "4.3.*"
     },
     "config": {
         "preferred-install": {
@@ -111,7 +111,7 @@
     "extra": {
         "symfony": {
             "allow-contrib": false,
-            "require": "4.2.*"
+            "require": "4.3.*"
         }
     }
 }

config/packages/dev/jms_serializer.yaml

 jms_serializer:
     visitors:
-        json:
+        json_serialization:
             options:
                 - JSON_PRETTY_PRINT
                 - JSON_UNESCAPED_SLASHES

config/packages/jms_serializer.yaml

 jms_serializer:
     visitors:
-        xml:
+        xml_serialization:
             format_output: '%kernel.debug%'
 #    metadata:
 #        auto_detection: false

config/packages/prod/jms_serializer.yaml

 jms_serializer:
     visitors:
-        json:
+        json: # TODO: will crash in prod
             options:
                 - JSON_UNESCAPED_SLASHES
                 - JSON_PRESERVE_ZERO_FRACTION