DocumentationCommerceGuide d’installation

[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Clonage de référentiels Git de données d’exemple

Last update: Fri Aug 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Cette rubrique explique comment cloner et ajouter des données d’exemple si vous avez cloné le référentiel GitHub de Magento Open Source. Cette méthode est destinée uniquement aux développeurs contributeurs (c’est-à-dire aux développeurs qui prévoient de contribuer à la base de code Magento Open Source).

Si vous n’êtes pas un développeur participant, choisissez l’une des autres options affichées dans la table des matières sur le côté gauche de la page.

Les développeurs contributeurs peuvent utiliser cette méthode d’installation des données d’exemple uniquement si ce qui suit est vrai :

WARNING
Vous pouvez utiliser des données d’exemple avec la branche develop (plus récente) ou une branche publiée (telle que 2.4 (plus stable)). Nous vous recommandons d’utiliser une branche publiée, car elle est plus stable. Si vous apportez du code au référentiel et que vous avez besoin du code le plus récent, utilisez la branche develop. Quelle que soit la branche que vous choisissez, vous devez cloner la branche correspondante du référentiel GitHub Magento Open Source. Par exemple, les exemples de données pour la branche develop peuvent être utilisés uniquement avec la branche Magento Open Source develop.

Cloner le référentiel de données d’exemple

Cette section explique comment installer des données d’exemple en clonant le référentiel de données d’exemple. Vous pouvez cloner le référentiel de données d’exemple de l’une des manières suivantes :

Cloner avec SSH

Pour cloner le référentiel GitHub de données d’exemple à l’aide du protocole SSH :

  1. Dans un navigateur web, accédez au référentiel de données d’exemple.

  2. En regard du nom de la branche, cliquez sur SSH dans la liste.

  3. Cliquez sur Copier dans le presse-papiers

    La figure suivante en est un exemple.

    Cloner le référentiel GitHub à l’aide de SSH

  4. Accédez au répertoire racine du serveur web.

    En général, pour Ubuntu, c'est /var/www et pour CentOS, c'est /var/www/html.

  5. Saisissez git clone et collez la valeur obtenue précédemment.

    Voici un exemple :

    code language-bash 
    git clone git@github.com:magento/magento2-sample-data.git

  6. Attendez que le référentiel soit cloné sur votre serveur.

    note note
    NOTE
    Si l’erreur suivante s’affiche, veillez à partager votre clé SSH avec GitHub:
    code language-none 
    Cloning into 'magento2'...
Permission denied (publickey).
fatal: The remote end hung up unexpectedly

  7. Veillez à extraire la branche du référentiel de données d’exemple qui correspond à la branche que vous avez utilisée à partir du référentiel de magento2 principal.

    Par exemple :

    Si vous avez utilisé la branche 2.4-develop du référentiel GitHub de Magento Open Source, la branche Données d’exemple doit être 2.4-develop.

    Pour extraire la branche appropriée, exécutez la commande suivante à partir du répertoire racine du référentiel de données d’exemple (en supposant que vous ayez besoin de la branche 2.4-develop) :

    code language-bash 
    git checkout 2.4-develop

  8. Remplacez par <app_root>.

  9. Saisissez la commande suivante pour créer des liens symboliques entre les fichiers que vous avez clonés afin que les exemples de données fonctionnent correctement :

    code language-bash 
    php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="<path_to_your_magento_instance>"

  10. Attendez que la commande soit terminée.

  11. Voir Définir les autorisations et la propriété du système de fichiers.

  12. Exécutez la commande suivante :

    code language-bash 
    bin/magento setup:upgrade

Cloner avec HTTPS

Pour cloner le référentiel GitHub de données d’exemple à l’aide du protocole HTTPS :

  1. Dans un navigateur web, accédez au référentiel de données d’exemple.

  2. Dans la partie droite de la page, sous le champ Cloner l’URL, cliquez sur HTTPS.

  3. Cliquez sur Copier dans le presse-papiers.

    La figure suivante en est un exemple.

    Cloner le référentiel GitHub à l’aide de HTTPS

  4. Accédez au répertoire racine du serveur web.

    En général, pour Ubuntu, c'est /var/www et pour CentOS, c'est /var/www/html.

  5. Saisissez git clone et collez la valeur obtenue précédemment.

    Voici un exemple :

    code language-bash 
    git clone https://github.com/magento/magento2-sample-data.git

  6. Attendez que le référentiel soit cloné sur votre serveur.

  7. Veillez à extraire la branche du référentiel de données d’exemple qui correspond à la branche que vous avez utilisée à partir du référentiel de magento2 principal.

    Par exemple :

    Si vous avez utilisé la branche 2.4-develop du référentiel GitHub de Magento Open Source, la branche Données d’exemple doit être 2.4-develop.

    Pour extraire la branche appropriée, exécutez la commande suivante à partir du répertoire racine du référentiel de données d’exemple (en supposant que vous ayez besoin de la branche 2.4-develop) :

    code language-bash 
    git checkout 2.4-develop

  8. Remplacez par <magento_root>.

  9. Saisissez la commande suivante pour créer des liens symboliques entre les fichiers que vous avez clonés afin que les exemples de données fonctionnent correctement :

    code language-bash 
    php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="<path_to_your_magento_instance>"

    Par exemple,

    code language-bash 
    php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="/var/www/magento2"

  10. Attendez que la commande soit terminée.

  11. Pour plus d'informations, consultez la section suivante.

WARNING
Si vous installez des données d’exemple après avoir installé Adobe Commerce, vous devez également exécuter la commande suivante pour mettre à jour la base de données et le schéma :
code language-bash 
<magento_root>/bin/magento setup:upgrade

Définition de la propriété et des autorisations du système de fichiers

Étant donné que le script php build-sample-data.php crée des liens symboliques entre le référentiel de données d’exemple et votre référentiel Magento Open Source, vous devez définir les autorisations et la propriété du système de fichiers dans le référentiel de données d’exemple. Dans le cas contraire, des erreurs se produisent lors de l’accès au storefront.

Pour définir les autorisations et la propriété du système de fichiers sur le référentiel de données d’exemple :

  1. Accédez à votre répertoire de clone de données d’exemple.

  2. Définir la propriété :

    code language-bash 
    chown -R :<your web server group name> .

    Exemples typiques :

    • CentOS : chown -R :apache .

    • Ubuntu : chown -R :www-data .

  3. Définissez les autorisations :

    code language-bash 
    find . -type d -exec chmod g+ws {} +

  4. Effacer les fichiers statiques :

    code language-bash 
    cd <your Magento Open Source install dir>
    code language-bash 
    rm -rf var/cache/* var/page_cache/* generated/*

Terminer l’installation des données d’exemple

Après avoir téléchargé les packages de données d’exemple, connectez-vous à votre serveur d’applications en tant que propriétaire du système de fichiers ou passez à celui-ci, puis saisissez la commande suivante dans <app_root> répertoire :

bin/magento setup:upgrade
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995