Comment installer des exemples de données Magento 2 : guide étape par étape

Magento est une puissante plateforme de commerce électronique.

Mais apprendre à utiliser correctement Magento peut être difficile. Pour simplifier cette tâche, Adobe fournit un exemple de module de données pour Magento 2 qui transforme une installation Magento en une boutique de démonstration Magento 2.

Ce guide explique les bases du module de données d’exemple de Magento 2 et vous apprend à l’installer correctement.

Voici ce que nous couvrons dans ce tutoriel :

Exemple de données Magento 2 101

Les exemples de données Magento sont un module qui transforme une instance Magento en une boutique de démonstration. Ce magasin contient des exemples de données telles que les clients, les commandes, les catégories, les pages CMS et les règles de tarification. En plus de cela, il installe le Luma gratuit Thème Magento 2 et ajoute plus de 250 produits Magento 2.

L’exemple de module de données est une collection de 19 packages pour Magento Open Source et 24 packages pour Adobe Commerce.

Vous pouvez afficher les packages pour Magento Open Source dans le exemple de référentiel de données.

Les utilisateurs d’Adobe Commerce ont accès à ces packages ainsi qu’aux cinq modules suivants pour les fonctionnalités spécifiques à Commerce :

magento/module-target-rule-sample-data.
magento/module-customer-balance-sample-data.
magento/module-gift-registry-sample-data.
magento/module-gift-card-sample-data.
magento/module-multiple-wishlist-sample-data.

Vous pouvez installer des exemples de données Magento de trois manières :

Utilisation de l’interface de ligne de commande (CLI) Magento.
Utilisation de Compositeur.
En clonant le dépôt Magento GitHub.

Les méthodes d’installation Magento CLI et Composer peuvent être utilisées lorsque vous avez installé Magento 2 à l’aide d’un fichier d’archive d’Adobe ou d’un métapaquet Composer.

Mais ces méthodes ne fonctionneront pas si vous avez installé Magento en clonant son archive GitHub.

C’est parce que le compositeur.json Le fichier dans l’archive GitHub ne contient pas l’URL “https://repo.magento.com”. Si vous avez installé Magento 2 en clonant une archive GitHub, vous devrez installer des exemples de données en clonant son référentiel GitHub.

Adobe vous offre la exemple de données:supprimer Commande CLI pour désinstaller des exemples de modules de données. Cependant, cette commande ne supprime pas les entrées de la base de données Magento.

La seule façon de supprimer entièrement l’exemple de module de données de Magento 2 consiste à supprimer la base de données et à réinstaller Magento 2 avec une nouvelle base de données.

Comment installer des exemples de données dans Magento

Connectez-vous à votre serveur et activez le mode développeur.
Exécutez la commande d’installation des exemples de données.
Mettez à jour la base de données et le schéma et effacez le cache Magento.
Vérifiez l’exemple d’installation des données.

Suivez ces étapes pour installer des exemples de données dans Magento 2.

Note: N’installez pas de données d’exemple sur un serveur de production, car vous ne pouvez pas désinstaller le module sans supprimer la base de données Magento et réinstaller Magento.

Étape 1 : connectez-vous à votre serveur et activez le mode développeur

Connectez-vous à votre serveur via SSH, passez à l’utilisateur du système de fichiers Magento et accédez au répertoire racine de Magento. Ensuite, activez le mode développeur en utilisant :

$ php bin/magento deploy:mode:set developer

Ensuite, effacez les classes et les proxys précédemment générés à l’aide de la commande suivante :

$ rm -rf generated/code/* generated/metadata/*

Étape 2 : exécutez la commande d’installation des exemples de données

Installez l’exemple de module de données Magento 2 à l’aide de la commande suivante :

$ php bin/magento sampledata:deploy

Vous devriez voir la sortie de terminal suivante :

Note: Vous devrez peut-être saisir vos clés d’authentification Magento à ce stade. Suivre Adobepour récupérer les clés publiques et privées utilisées pour installer votre application Magento et utiliser les mêmes clés pour l’exemple d’installation du module de données.

Étape 3 : mettre à jour la base de données et le schéma et vider le cache Magento

Une fois la commande d’installation des exemples de données Magento 2 exécutée avec succès, mettez à jour la base de données et le schéma Magento à l’aide de la commande ci-dessous :

$ php bin/magento setup:upgrade

Après cela, effacez tous les types de cache Magento en utilisant :

$ php bin/magento cache:clean
$ php bin/magento cache:flush

Étape 4 : vérifier l’exemple d’installation des données

Enfin, accédez à votre vitrine dans un navigateur. Voici à quoi cela ressemblera :

Erreurs courantes d’installation des exemples de données Magento et étapes pour les corriger

Voici trois erreurs courantes que vous pouvez rencontrer lors de l’installation des exemples de données et les étapes pour les corriger.

1. Erreur d’autorisations du système de fichiers

Les erreurs d’autorisation du système de fichiers sont l’une des erreurs les plus courantes auxquelles vous pouvez être confronté lorsque vous installez des exemples de données Magento 2.

Par exemple, vous pouvez rencontrer des exceptions telles que :

Impossible de créer le répertoire /var/www/html/magento2/generated/code/Magento/CatalogRule/Model/.
La classe Magento\CatalogRule\Model\RuleFactory n’existe pas.

Si vous rencontrez de telles erreurs, vous devrez réinitialiser les autorisations du système de fichiers en fonction de votre déploiement.

Suivez le guide d’Adobe montrant les étapes pour définir les autorisations d’accès au système de fichiers et réexécutez le exemples de données : déploiement commande.

2. Erreur du mode Magento

L’installation des exemples de données Magento en mode production peut provoquer une erreur fatale PHP ou l’erreur suivante lorsque vous exécutez le configuration:mise à niveau commande:

Pour éviter de telles erreurs, passez en mode développeur et effacez les données générées avant d’installer les exemples de données Magento 2.

3. Erreur PHP max_execution_time

Les exemples de données Magento processus d’installation des modules est une tâche gourmande en ressources. Selon la configuration de votre serveur, cela peut prendre de quelques secondes à plusieurs minutes.

Parfois, il peut échouer silencieusement lorsque le max_execution_time dans ton PHP le fichier de configuration n’est pas adapté à l’exemple de script de données.

Pour résoudre ce problème, passez à un utilisateur disposant des privilèges root et modifiez le php.ini fichier à l’aide de votre éditeur de texte préféré.

Par exemple, si votre version de PHP est 7.4, vous pouvez exécuter ce code :

$ nano /etc/php/7.4/fpm/php.ini

Trouvez le max_execution_time paramètre et mettre à jour sa valeur à 600 ou plus. Enregistrez le fichier et redémarrez PHP pour mettre à jour sa configuration.

Après cela, lancez le exemples de données : déploiement commande et réinitialiser le max_execution_time valeur à la valeur d’origine une fois l’installation des exemples de données Magento 2 terminée.

Réflexions finales : comment installer les exemples de données de Magento 2

Nous avons expliqué les bases du module de données d’exemple de Magento 2, démontré un processus d’installation étape par étape et partagé des conseils pour corriger les erreurs courantes.

Il est important de se rappeler que vous ne pouvez pas désinstaller les exemples de données sans réinstaller Magento. Assurez-vous donc de l’installer uniquement dans un environnement intermédiaire.

Vous n’avez pas de serveur de test ?

Inscrivez vous pour hébergement Magento infogéré avec Nexcess et accédez à des sites de développement dédiés sans frais supplémentaires.

Parcourez nos forfaits pour en savoir plus.