1.1.Conditions

Pour utiliser Myddleware, vous avez besoin des éléments suivants :

  • Un serveur web tel que Apache
  • Une version de PHP égale ou supérieure la version 7.1
  • MYSQL

 

Myddleware utilise Doctrine. Vous devez donc installer le pilote PDO du serveur de la base de données que vous avez l’intention d’utiliser.

 

1.2.Téléchargement de Myddleware

Veuillez télécharger la dernière version de Myddleware ici.

1.3.Copie de fichiers sur le serveur Web

Une fois que vous avez téléchargé le dossier Myddleware, copiez-le et extrayez-le sur votre serveur web.

Vous devriez avoir les répertoires suivants :

Assurez-vous que ces autorisations soient correctement configurées:

  • Les dossiers suivants doivent être accessibles en écriture par le web user
    • myddleware/var/cache/
    • myddleware/var/logs/
  • Les fichiers suivants doivent être accessibles en écriture par le web user
    • myddleware/app/config/myddleware.yml
    • myddleware/app/config/public/parameters_public.yml
    • myddleware/app/config/public/parameters_smtp.yml

1.4.Installez Myddleware

Vous pouvez installer Myddleware en ajoutant « /web/installMyddleware.php » à votre URL de base de Myddleware:  http://<path_to_myddleware>/web/installMyddleware.php

Changez vos autorisations de fichier ou votre configuration PHP si vous avez une erreur de permission ou une exigence de PHP manquante:

Une fois que vous avez corrigé toutes les erreurs, vous pourrez installer Myddleware.

Créez une base de données sur votre serveur. Remplissez le formulaire pour vous connecter à cette base de données puis créez votre utilisateur pour vous connecter à Myddleware:

Attendez que la page soit actualisée (cela peut prendre 30 secondes):

Cliquez ensuite sur le lien pour ouvrir Myddleware et connectez-vous avec le profil utilisateur que vous venez de créer:

Myddleware est maintenant prêt à utiliser:

Pour des raisons de sécurité : veuillez supprimer le fichier d’installation: http: // <path_to_myddleware> /web/installMyddleware.php

Nous vous recommandons également de configurer votre serveur, vous trouverez de l’aide ici.

1.5.Installation via la commande

Avant de commencer, assurez-vous que votre configuration est correcte : ouvrez un shell de commande et lancez la commande suivante :

php bin/symfony_requirements

Changez la configuration de votre système jusqu’à ce qu’il soit prêt pour installer Myddleware:

contab_2

Créez une base de données sur votre serveur puis modifiez les paramètres suivants dans le fichier /myddleware/app/config/parameters.yml:

  • database_driver: pdo_mysql
    • Ne changez pas le pilote pdo_mysql
  • database_host:
    • Il s’agit de «  localhost   » si la base de données est sur le serveur sur lequel vous avez installé Myddleware
  • database_port :
  • nom de la base de données:
  • database_user:
  • database_password:
  • secret:

Ensuite, allez dans votre répertoire Myddleware et exécutez les commandes suivantes :

Effacez le cache si vous avez déjà essayé d’installer Myddleware

php bin/console cache:clear -e prod
Générez le fichier que Myddleware doit exécuter( plus d'infos ici )
php bin/console assetic:dump -e prod --no-debug

Générez des fichiers de bundles Web

php bin/console assets:install web -e prod

Créez des tables dans votre base de données

php bin/console doctrine:schema:update -f -e prod

Ajoutez des données dans les tables créées

php bin/console doctrine: fixtures:load --append -e prod

Créez le profil utilisateur pour vous connecter à Myddleware. Changez les valeurs myddleware_username, myddleware_user_email, myddleware_password selon vos propres paramètres

php bin/console fos:utilisateur:create myddleware_username myddleware_user_email myddleware_password -e prod

Ajouter le rôle d'administrateur à l'utilisateur que vous venez de créer

php app/console fos:utilisateur:promote myddleware_username ROLE_ADMIN -e prod

 Assurez-vous que ces autorisations soient correctement configurées:

  • Les dossiers suivants doivent être accessibles en écriture par le web user
    • myddleware/var/cache/
    • myddleware/var/logs/
  • Les fichiers suivants doivent être accessibles en écriture par le web user
    • myddleware/app/config/myddleware.yml
    • myddleware/app/config/public/parameters_public.yml
    • myddleware/app/config/public/parameters_smtp.yml

Pour des raisons de sécurité, veuillez supprimer le fichier d'installation: <path_to_myddleware> /web/installMyddleware.php

Nous vous recommandons également de configurer votre serveur, vous trouverez de l'aide ici.

Vous pouvez maintenant accéder à Myddleware avec cette URL:

http: //<path_to_myddleware>/web/app.php

1.6.Installation à partir de Github

Pour obtenir Myddleware depuis Github, utilisez cette commande:

git clone https://github.com/Myddleware/myddleware

Allez dans le répertoire racine de Myddleware, créez vos fichiers de paramètre:

cd myddleware
cp app/config/parameters.yml.dist app/config/parameters.yml
cp app/config/public/parameters_smtp.yml.dist app/config/public/parameters_smtp.yml
cp app/config/public/parameters_public.yml.dist app/config/public/parameters_public.yml

Et installez les modules Symfony:

php composer.phar install --no-plugins

Ensuite, suivez les étapes ce tutoriel pour effectuer  l’installation de Myddleware via un navigateur ici.

2.Configurer la tâche cron

Myddleware peut travailler avec des tâches en arrière-plan tout en synchronisant vos données, envoyant des notifications, nettoyant des données, et plus encore.

Si vous souhaitez effectuer ce genre d’actions en simultané, vous devrez configurer quelques tâches d’arrière-plan en utilisant le crontab.

Avant de créer la tâche cron, assurez-vous que votre configuration est correcte, ouvrez un shell de commande et exécutez cette commande:

php bin/symfony_requirements

contab_1

Changez votre permission de fichier ou configuration de PHP en cas d’erreur d’autorisation ou d’exigence de PHP manquante:

contab_2

Vous pouvez maintenant commencer les tâches suivantes en fonction de vos besoins:

cd <répertoire mydelware>; php bin/console myddleware:synchro ALL –env=background   > /dev/null 2>&1

  • Ce programme synchronisera les données en exécutant chaque règle active.
  • Paramètre => ALL ou règle_name_slug:

cd <répertoire mydelware>;  php bin/console myddleware:rerunerror 100 5 –env=background   > /dev/null 2>&1

  • Ce programme lira les documents erronés et essaiera de les renvoyer
  • 1er paramètre => limitation du nombre de documents en erreur que le programme va lire. Dans ce cas particulier, le programme lira un maximum de 100 documents en erreur
  • 2ème paramètre => limitation du nombre de tentatives: les documents que Myddleware a essayé d’envoyer au maximum 5 fois seront lus.

cd <répertoire mydelware>; php bin/console myddleware:cleardata –env=background  > /dev/null 2>&1

  • Ce programme effacera toutes les données selon que le paramètre « Suppression de données » est défini sur la règle.
  • N’exécutez pas ce programme si vous ne voulez pas effacer les données.

cd <répertoire mydelware>; php bin/console myddleware:notification –env=background > /dev/null 2>&1

  • Ce programme enverra une notification si certains documents sont erronés. Un e-mail sera envoyé à l’adresse e-mail configurée  dans le fichier myddleware/app/config/config_background.yml, paramètre notification_emailaddress

Voici un exemple de crontab:

cron_example

3.Upgrade Myddleware

Nous vous suggérons d’utiliser git pour mettre à jour Myddleware. Si vous n’avez pas git sur votre serveur, voici les instructions pour l’installer https://git-scm.com/download/linux

:   https://git-scm.com/download/linux

Avant de commencer, fermez tous vos transferts de données ouverts (ou en erreur). Ensuite, créez un back up de votre Myddleware avant la mise à jour.

Après le back up, allez dans le répertoire racine de Myddleware et exécutez la commande comme indiqué ci-dessous pour mettre à jour tous les fichiers de Myddleware.

Si vous n’avez jamais utilisé git avec Myddleware, veuillez envoyer ces commandes:

git init
git remote add -t maître origine https://github.com/Myddleware/myddleware.git
git fetch
git checkout origine / maître -ft

Ensuite vous pouvez mettre à jour Myddleware via cette commande :

php bin/console myddleware:upgrade –env=background

Si vous rencontrez un problème durant l’exécution de cette commande, vous pouvez suivre ce tutoriel étape par étape :

git pull

Si vous obtenez le message ci-dessous pendant le pull, vous avez probablement changé au moins un fichier dans le code standard de Myddleware. Veuillez lire l’article sur les bonnes pratiques pour apprendre comment ajouter un code de mise à jour personnalisé dans Myddleware. Cela vous aidera à gérer les conflits.

Vous pouvez également supprimer ces fichiers, exécuter le pull et vous obtiendrez la dernière version de ces fichiers mais  vous perdrez le code personnalisé.

Ensuite, mettez à jour les fournisseurs Symfony et leurs dépendances:

php composer.phar install –no-plugins

A ce stade, s’il s’agit de votre première mise à jour avec git, vous devrez répondre  par oui  plusieurs fois à cette question:

Ensuite, exécutez cette commande pour mettre à jour la base de données de Myddleware:

php bin/console doctrine:schema:update –force –env=background
php bin/console doctrine:fixtures:load –append –env=background

Puis effacez le cache et actualisez les fichiers css et js avec les commandes suivantes:

rm -rf app/cache/*
php bin/console assetic:dump –env=background –no-debug
php bin/console assets:install web –env=background

Si vous rencontrez un problème lors de la mise à jour de Myddleware, veuillez nous contacter sur notre forum: https://github.com/Myddleware/myddleware/issues

4.Platform.sh

En premier lieu, cliquez sur ce lien :

Vous serez invités à créer un compte d’essai gratuit sur Platform.sh, notre partenaire cloud. Myddleware sera alors déployé automatiquement.

Une fois votre compte créé, sélectionnez la région où se trouve votre cloud.

Enfin, continuez vers la page de paiement. Vous ne serez pas débité pendant la période d’essai (30 jours) et vous pouvez annuler à n’importe quel moment.

C’est à ce moment-là que Platform.sh génère votre compte.

Patientez 2 minutes et vous serez redirigé vers votre environnement. Indiquez le nom de votre projet :

Cliquez sur « Poursuivre » et Platform.sh générera votre environnement Myddleware :

Patientez 2 minutes jusqu’à ce que le statut passe à « Réussi » :

Cliquez sur « Visiter votre site ». Vous serez alors redirigé vers la page de connexion de votre Myddleware :

Pour des raisons de sécurité, changez svp votre mot de passe dans Myddleware :

Vous pourrez également changer votre adresse email et pourrez ainsi être alertés sur la progression de vos transferts de données.

Vous pouvez désormais profiter pleinement de Myddleware !

Suggérer  de  modifier