Gestion de la configuration du magasin

Les configurations par défaut de votre magasin sont stockées dans un config.xml pour le module approprié. Lorsque vous modifiez les paramètres dans l’administrateur Commerce ou la commande CLI bin/magento config:set, les modifications sont répercutées dans la base de données principale, en particulier dans la table core_config_data. Ces paramètres remplacent les configurations par défaut stockées dans le fichier config.xml.

Les paramètres de magasin, qui font référence aux configurations de la section Admin Magasins > Paramètres > Configuration , sont stockés dans les fichiers de configuration de déploiement en fonction du type de configuration :

La gestion des configurations permet de déployer des paramètres de magasin cohérents dans vos environnements avec un temps d’arrêt minimal à l’aide du déploiement du pipeline. Adobe Commerce sur le projet d’infrastructure cloud inclut le serveur de génération, les scripts de génération et de déploiement, ainsi que les environnements de déploiement conçus en tenant compte de la stratégie de déploiement de pipeline.

Schéma de remplacement de configuration

Toutes les configurations système sont définies lors des phases de création et de déploiement selon le schéma de remplacement suivant :

Pour résumer, les variables d’environnement remplacent toutes les autres valeurs.

Si le même paramètre est configuré à plusieurs endroits, l’application se base sur la hiérarchie de configuration suivante pour déterminer la valeur à appliquer à l’environnement :

Dépôt de configuration

Vous pouvez utiliser la commande ece-tools suivante pour générer un fichier config.php contenant toutes les configurations de magasin actuelles :

./vendor/bin/ece-tools config:dump

Les données "vidées" vers le fichier app/etc/config.php deviennent verrouillées, ce qui signifie que le champ correspondant dans l’administrateur Commerce devient lecture seule. Le fichier config.php comprend uniquement les paramètres que vous configurez. Les valeurs par défaut ne sont pas verrouillées. En verrouillant uniquement les valeurs que vous mettez à jour, vous avez également la garantie que toutes les extensions utilisées dans les environnements d’évaluation et de production ne sont pas rompues en raison de configurations en lecture seule, notamment Fastly.

Données sensibles

Toutes les configurations sensibles sont exportées vers le fichier app/etc/env.php lorsque vous utilisez la commande bin/magento app:config:dump. Vous pouvez définir des valeurs sensibles à l’aide de la commande d’interface en ligne de commande : bin/magento config:sensitive:set. Voir Paramètres sensibles et spécifiques à l’environnement dans le guide Extensions PHP Commerce pour savoir comment désigner les paramètres de configuration comme étant sensibles ou spécifiques au système.

Consultez la liste des paramètres sensibles ou spécifiques au systèmedans le Guide de configuration.

Performances SCD

Selon la taille de votre magasin, vous pouvez déployer un grand nombre de fichiers de contenu statique. Normalement, le contenu statique est déployé pendant la phase de déploiement lorsque l’application est en mode de maintenance. La configuration la plus optimale consiste à générer du contenu statique pendant la phase de création. Voir Choix d’une stratégie de déploiement.

Si vous avez activé Configuration Management après avoir vidé les configurations, vous devez déplacer les variables SCD_* de l’étape de déploiement vers l’étape de création pour activer correctement la génération de contenu statique pendant la phase de création. Voir Variables d’environnement.

Avant la gestion de la configuration :

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...
    REDIS_USE_SLAVE_CONNECTION: 1

Après avoir activé Configuration Management :

Déplacez les variables SCD_* vers l’étape de création :

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    REDIS_USE_SLAVE_CONNECTION: 1
  build:
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...

Procédure de gestion des paramètres

Voici un aperçu général de ce processus :

Pour configurer votre magasin et générer un fichier de configuration :

Une fois le déploiement terminé, connectez-vous à l’administrateur de l’environnement mis à jour pour vérifier les paramètres. Continuez à fusionner toutes les configurations supplémentaires aux environnements d’évaluation et de production, si nécessaire.

Mise à jour des configurations

Lorsque vous modifiez votre environnement par l’intermédiaire de l’administrateur et exécutez à nouveau la commande, de nouvelles configurations sont ajoutées au code dans le fichier config.php.

Restauration des fichiers de configuration

Des copies des fichiers app/etc/env.php et app/etc/config.php d’origine ont été créées pendant le processus de déploiement et stockées dans le même dossier. L’exemple suivant montre les fichiers BAK (sauvegarde) et PHP (fichiers originaux) dans le même dossier app/etc :

...
config.php.bak
di.xml
env.php.bak
vendor_path.php
config.php
db_schema.xml
env.php
...

Les anciennes configurations utilisaient le fichier app/etc/config.local.php. Voir Migration des anciennes configurations.

Pour restaurer les fichiers de configuration :

Migration des anciennes configurations

Si vous effectuez une mise à niveau vers Adobe Commerce sur l’infrastructure cloud 2.2 ou une version ultérieure, vous souhaiterez peut-être migrer les paramètres du fichier config.local.php vers votre nouveau fichier config.php. Si les paramètres de configuration de votre administrateur correspondent au contenu du fichier, suivez les instructions pour générer et ajouter le fichier config.php.

S’ils diffèrent, vous pouvez ajouter du contenu du fichier config.local.php à votre nouveau fichier config.php :

Cette migration n’est effectuée qu’une seule fois. Après la migration, utilisez le fichier config.php.

Modifier les paramètres régionaux

Vous pouvez modifier les paramètres régionaux de votre magasin sans suivre un processus complexe d'import et d'export de configuration, si vous avez activé SCD_ON_DEMAND. Vous pouvez mettre à jour les paramètres régionaux à l’aide de l’Admin.

Vous pouvez ajouter un autre paramètre régional à l’environnement d’évaluation ou de production en activant SCD_ON_DEMAND dans une branche d’intégration, en générant un fichier config.php mis à jour avec les nouvelles informations de paramètres régionaux et en copiant le fichier de configuration dans l’environnement cible.