DocumentationCommerceGuide de configuration

[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."}

Configuration du système de build

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Vous pouvez disposer d’un système de version qui répond aux exigences suivantes :

  • Tout le code Commerce est sous contrôle de code source dans le même référentiel que les systèmes de développement et de production

  • Assurez-vous que tous les éléments suivants sont inclus dans le contrôle de code source :

    • app/etc/config.php
    • Répertoire generated (et sous-répertoires)
    • répertoire pub/media
    • Répertoire pub/media/wysiwyg (et sous-répertoires)
    • Répertoire pub/static (et sous-répertoires)

  • Une version PHP compatible doit être installée

  • Composer doit être installé.

  • La propriété et les autorisations du système de fichiers sont définies, comme indiqué dans la section Prérequis pour les systèmes de développement, de version et de production.

  • Le système de build n’a pas besoin que Commerce soit installé, mais le code doit être disponible pour lui.

WARNING
La connexion à la base de données n’est pas requise si elle figure déjà dans config.php ; consultez la section ​ Exporter la configuration. Dans le cas contraire, la connexion à la base de données est requise.
INFO
La machine de génération peut se trouver sur son propre hôte ou sur le même hôte qu’un système Commerce installé.

Configuration de la machine de génération

Les sections suivantes expliquent comment configurer la machine de génération.

Installer le compositeur

Tout d’abord, vérifiez si le compositeur est déjà installé :

Dans une invite de commande, saisissez l’une des commandes suivantes :

  • composer --help
  • composer list --help

Si l’aide de la commande s’affiche, Composer est déjà installé.

Si une erreur s’affiche, procédez comme suit pour installer le compositeur.

Pour installer le compositeur :

  1. Modifiez ou créez un répertoire vide sur votre serveur Commerce.

  2. Saisissez les commandes suivantes :

    code language-bash 
    curl -sS https://getcomposer.org/installer | php
    code language-bash 
    mv composer.phar /usr/local/bin/composer

Pour obtenir des options d’installation supplémentaires, consultez la documentation d’installation du compositeur.

Installer PHP

Installez PHP sur CentOS ou Ubuntu.

Configurer le système de génération

Pour configurer le système de génération :

  1. Connectez-vous au système de génération en tant que propriétaire du système de fichiers ou passez à ce système.

  2. Récupérez le code Commerce du contrôle de code source.

    Si vous utilisez Git, utilisez la commande suivante :

    code language-bash 
    git clone [-b <branch name>] <repository URL>

  3. Accédez au répertoire racine Commerce et saisissez les informations suivantes :

    code language-bash 
    composer install

  4. Attendez que les dépendances soient mises à jour.

  5. Définir la propriété :

    code language-bash 
    chown -R <Commerce file system owner name>:<web server username> .

    Par exemple,

    code language-bash 
    chown -R commerce-username:apache .

  6. Si vous utilisez Git, ouvrez .gitignore dans un éditeur de texte.

  7. Commencez chacune des lignes suivantes par un caractère # pour les commenter :

    code language-conf 
    # app/etc/config.php
# pub/media/*
# generated/*
# pub/media/*.*
# pub/media/wysiwyg/*
# pub/static/*

  8. Enregistrez vos modifications dans .gitignore et quittez l’éditeur de texte.

  9. Si vous utilisez Git, validez la modification à l’aide des commandes suivantes :

    code language-bash 
    git add .gitignore && git commit -m "Modify .gitignore for build and production"

    Pour plus d’informations.gitignore voir la référence ​ .

  10. Le système de génération doit utiliser mode par défaut ou mode développeur :

    code language-bash 
    bin/magento deploy:mode:set <mode>

    <mode> est obligatoire. Il peut être default ou developer.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c