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

Fichiers de configuration pour le déploiement

Adobe Commerce fournit des fichiers de configuration qui vous permettent de personnaliser facilement un composant et de créer des types de configuration pour étendre les fonctionnalités par défaut. Le processus de configuration du déploiement correspond à la configuration partagée et spécifique au système pour votre installation. La configuration du déploiement de Commerce est divisée entre app/etc/config.php et app/etc/env.php.

Ensemble, config.php et env.php sont appelés Commerce configuration du déploiement, car les fichiers sont créés lors de l’installation et sont nécessaires pour démarrer l’application Commerce.

Contrairement aux autres fichiers de configuration de module, la configuration de déploiement de Commerce est chargée en mémoire lors de l’initialisation. Elle n’est pas fusionnée avec d’autres fichiers et ne peut pas être étendue. (config.php et env.php sont toutefois fusionnés.)

Détails sur la configuration de déploiement

config.php et env.php sont des fichiers PHP qui renvoient un tableau associatif multidimensionnel, qui est fondamentalement une disposition hiérarchique des paramètres et valeurs de configuration.

Au niveau supérieur de ce tableau se trouvent des segments de configuration. Un segment comporte du contenu arbitraire (une valeur scalaire ou un tableau imbriqué), se distinguant par une clé arbitraire, où la paire clé-valeur est définie par le framework Commerce.

Magento\Framework\App\DeploymentConfig donne simplement accès à ces sections, mais ne vous permet pas de les étendre.

Au niveau de la hiérarchie suivante, les éléments de chaque segment sont triés en fonction de la définition de séquence de module, obtenue en fusionnant tous les fichiers de configuration des modules, à l’exception des modules désactivés.

Les sections suivantes décrivent la structure et le contenu de la configuration de déploiement :

Gestion des modules installés

Le fichier config.php contient la liste des modules installés. Adobe Commerce fournit des utilitaires de ligne de commande et web pour gérer les modules (installation, désinstallation, activation, désactivation ou mise à niveau).

Exemples :

config.php

return array (
  'modules' =>
  array (
    'Magento_Core' => 1,
    'Magento_Store' => 1,
    'Magento_Theme' => 1,
    'Magento_Authorization' => 1,
    'Magento_Directory' => 1,
    'Magento_Backend' => 1,
    'Magento_Backup' => 1,
    'Magento_Eav' => 1,
    'Magento_Customer' => 1,
...
  ),
);

La valeur 1 ou 0 indique si un module est activé ou désactivé.

Les modules désactivés ne sont pas reconnus par l’application Commerce ; en d’autres termes, ils ne participent pas à la fusion de la configuration, à l’injection de dépendance, aux événements, aux modules externes, etc. Les modules désactivés ne modifient pas le storefront ou l’administrateur et n’affectent pas le routage.

La seule différence pratique entre un module désactivé et un module absent dans la base de code est qu'un module désactivé est trouvé par le chargeur automatique, et ses classes et constantes sont disponibles pour réutilisation dans d'autres codes.