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 5.6
  • MYSQL

 

Veuillez vérifier les exigences de Symfony2 avant l’installation. Myddleware :http://symfony.com/doc/2.8/reference/requirements.html

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.

Assurez-vous que « only_full_group_by  » n’est pas dans l’option MySQL « sql_mode ».

 

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/app/cache/
    • myddleware/app/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> /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 le programme check.php dans  le répertoire de l’application suivant: php app/check.php

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

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 app/console cache:clear –env=prod

Générez le fichier que Myddleware doit exécuter( plus d’infos ici )

  • app php/console assetic:dump –env=prod –no-debug

Générez des fichiers de bundles Web

  • Actifs app/console php:install web –env=prod

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

  • php app/console doctrine:schema: update –force –env=prod

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

  • php app/console doctrine: fixtures:load –append –env=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 app/console fos: utilisateur:create myddleware_username myddleware_user_email myddleware_password –env=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 –env=prod

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

  • Les dossiers suivants doivent être accessibles en écriture par le web user
    • myddleware/app/cache/
    • myddleware/app/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:

cp app/config/parameters.yml.dist app/config/parameters.yml
cp app/config/parameters_smtp.yml.dist app/config/public/parameters_smtp.yml
cp app/config/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 le programme check.php dans l’application directory:   php app / check.php

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>; application php/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>; application php / 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>; application php / 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>; application php / 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

Sinon, vous pouvez seulement envoyer la commande:

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 Symfony2 et leurs dépendances:
php composer.phar installer –no-plugins –no-scripts
php composer.phar update –no-plugins –no-scripts

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 app / console doctrine: schéma: mise à jour –force –env = arrière-plan
php application / console doctrine: fixtures: load –append –env = arrière-plan

Puis effacez le cache et actualisez les fichiers css et js avec les commandes suivantes:
rm -rf app / cache / *
php app / console assetic: dump –env = fond –no-debug
Actifs de l’application / console php: install web –env = background
application php / console myddleware: mise à niveau –env = arrière-plan

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