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

Exemple avec une configuration partagée

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

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Cet exemple montre comment modifier les paramètres suivants dans votre système de développement, mettre à jour le fichier de configuration partagé, config.php, dans votre système de génération et implémenter les mêmes paramètres dans votre système de production :

  • Fuseau horaire
  • Unité de poids

Ces paramètres sont disponibles dans Admin dans Magasins > Paramètres > Configuration > Général > Général.

Vous pouvez utiliser la même procédure pour configurer des paramètres non sensibles et non spécifiques au système dans les références suivantes :

Avant de commencer

Avant de commencer, configurez les autorisations et la propriété du système de fichiers comme décrit dans la section Conditions préalables pour les systèmes de développement, de création et de production.

Hypothèses

Cette rubrique fournit un exemple de modification de la configuration du système d’exploitation. Vous pouvez choisir différentes options de configuration si vous le souhaitez.

Pour les besoins de cet exemple, nous supposons que :

  • Vous utilisez le contrôle de code source Git.
  • Le système de développement est disponible dans un référentiel distant Git nommé mconfig
  • Votre branche de travail Git est nommée m2.2_deploy

Étape 1 : définir la configuration dans le système de développement

Pour définir le fuseau horaire et les unités de poids dans votre système de développement :

  1. Connectez-vous à l’administrateur.

  2. Cliquez sur Magasins > Paramètres > Configuration > Général > Général.

  3. Dans le volet de droite, développez Options locales.

    La figure suivante en est un exemple.

    Définir des options de paramètres régionaux dans le système de développement

  4. Dans la liste Fuseau horaire, cliquez sur GMT+00:00 (UTC).

  5. Désélectionnez la case Utiliser la valeur système située en regard du champ Unité de poids.

  6. Dans la liste Unité de poids, cliquez sur kg.

  7. Cliquez sur Enregistrer la configuration.

  8. Si vous y êtes invité, videz le cache.

Étape 2 : mettre à jour la configuration partagée

Générez le fichier de configuration partagé, app/etc/config.php, dans votre système de développement et transférez-le à l’aide du contrôle de code source vers votre système de génération, comme indiqué dans cette section.

Pour mettre à jour la configuration :

  1. Connectez-vous à votre système de développement en tant que propriétaire du système de fichiers ou passez à ce système.

  2. Passez à la racine de l’application et exécutez la commande dump.

    code language-bash 
    cd <Magento root dir>
php bin/magento app:config:dump

    Par exemple, si Commerce est installé dans /var/www/html/magento2, saisissez :

    code language-bash 
    cd /var/www/html/magento2
php bin/magento app:config:dump

  3. Vérifiez que app/etc/config.php a été mis à jour.

    code language-bash 
    git status

    Exemple de réponse :

    code language-none 
    On branch m2.2_deploy
Changed but not updated:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)
       modified:   app/etc/config.php
    note warning
    WARNING
    N’envoyez pas les modifications apportées aux répertoires generated, pub/media ou pub/static au contrôle de code source. Vous générez ces fichiers sur votre système de génération. Le système de développement comporte probablement du code, des thèmes, etc., qui ne sont pas prêts à être utilisés sur le système de production.

  4. Archivez vos modifications dans app/etc/config.php uniquement au contrôle de code source.

    code language-bash 
    git add app/etc/config.php && git commit -m "Updated shared configuration" && git push mconfig m2.2_deploy

Étape 3 : mettre à jour votre système de génération et générer des fichiers

Maintenant que vous avez validé vos modifications de la configuration partagée dans le contrôle de code source, vous pouvez extraire ces modifications dans votre système de génération, compiler le code et générer des fichiers statiques. La dernière étape consiste à apporter ces modifications à votre système de production. Par conséquent, la configuration de votre système de production correspond à votre système de développement.

Pour mettre à jour le système de build :

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

  2. Accédez au répertoire racine de l’application.

    code language-bash 
    cd <Magento root dir>

  3. Extrayez les modifications apportées à app/etc/config.php à partir du contrôle de code source.

    code language-bash 
    git pull mconfig m2.2_deploy

  4. Compilez le code.

    code language-bash 
    bin/magento setup:di:compile

  5. Une fois le code compilé, générez des fichiers de vue statiques.

    code language-bash 
    bin/magento setup:static-content:deploy -f

  6. Vérifiez les modifications dans le contrôle de code source.

    code language-bash 
    git add -A && git commit -m "Updated files on build system" && git push mconfig m2.2_deploy

Etape 4 : Mise à jour du système d'exploitation

La dernière étape du processus consiste à mettre à jour votre système de production à partir du contrôle de code source. Cela extrait toutes les modifications que vous avez apportées à vos systèmes de développement et de création, ce qui signifie que votre système de production est complètement à jour.

Pour mettre à jour le système d’exploitation :

  1. Connectez-vous au système d’exploitation en tant que propriétaire du système de fichiers.

  2. Passez à la racine de l’application et activez le mode de maintenance.

    code language-bash 
    cd <Magento root dir>
    code language-bash 
    bin/magento maintenance:enable

    Pour d’autres options, telles que la possibilité de définir une liste autorisée d’adresses IP, voir magento maintenance:enable.

  3. Arrêtez tous les programmes de traitement de file d’attente en cours d’exécution en définissant cron_run sur false dans app/etc/env.php comme suit :

    code language-php?start_inline=1 
    'cron_consumers_runner' => [
        'cron_run' => false
    ]

  4. Mettez à jour la configuration.

    code language-bash 
    bin/magento app:config:import

  5. Enfin, kill tous les processus consommateurs actifs.

    code language-bash 
    kill <PID>

    Où PID est l’ID du processus à interrompre, par exemple :

    code language-bash 
    kill 1234

  6. Extrayez le code du contrôle de code source.

    code language-bash 
    git pull mconfig m2.2_deploy

  7. Mettez à jour la configuration.

    code language-bash 
    bin/magento app:config:import

  8. Nettoyez le cache.

    code language-bash 
    bin/magento cache:clean

  9. Terminez le mode de maintenance.

    code language-bash 
    bin/magento maintenance:disable

Vérifier les modifications dans l’administrateur

Pour vérifier que ces paramètres ne sont pas modifiables dans l’administration :

  1. Connectez-vous à l’administrateur.

  2. Cliquez sur Magasins > Paramètres > Configuration > Général > Général.

  3. Dans le volet de droite, développez Options locales.

    Les options que vous venez de définir s’affichent comme suit :

    Les options de configuration ne peuvent pas être modifiées dans l’administration

INFO
Pour modifier un paramètre verrouillé dans Admin, utilisez la commande magento config:set --lock.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c