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

Paramètres de Bootstrap

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

Créé pour :

  • Expérimenté
  • Administration
  • Développeur

Cette rubrique explique comment définir les valeurs des paramètres d’amorçage de l’application Commerce. Voir Aperçu de l'initialisation et du démarrage de l'application.

Le tableau suivant décrit les paramètres d’amorçage que vous pouvez définir :

Paramètre Bootstrap
Description
MAGE_DIRS
Spécifie le répertoire personnalisé et les chemins d’URL
MAGE_PROFILER
Active les graphiques de dépendance et le profilage HTML
INFO
  • Tous les paramètres de bootstrap ne sont pas documentés.
  • Vous pouvez maintenant définir le mode d’application (développeur, par défaut, production) à l’aide de la commande magento deploy:mode:set {mode}.

Définition de paramètres à l’aide d’une variable d’environnement

Cette section explique comment définir les valeurs des paramètres de bootstrap à l’aide de variables d’environnement.

Définir le mode d’application

Vous pouvez spécifier les variables de bootstrap en tant que variables d’environnement à l’échelle du système, ce qui permet à tous les processus de les utiliser.

Par exemple, vous pouvez utiliser la variable d’environnement système MAGE_PROFILER pour spécifier un mode comme suit :

MAGE_PROFILER={firebug|csv|<custom value>}

Définissez la variable à l’aide d’une commande spécifique au shell. Étant donné que les shell ont une syntaxe différente, consultez une référence telle que unix.stackexchange.com.

Exemple de shell Bash pour CentOS :

export MAGE_PROFILER=firebug
INFO
Si un PHP Fatal error s’affiche dans le navigateur après avoir défini une valeur de profil, redémarrez votre serveur web. La raison peut être liée à la mise en cache du bytecode PHP, qui met en cache les bytecode et les classes de chemins PHP.

Définition des paramètres pour Apache ou Nginx

Cette section explique comment spécifier le mode pour Apache ou Nginx.

Paramètre Nginx

Voir l’exemple de configuration [Nginx] sur GitHub.

Paramètre Apache .htaccess

Vous pouvez définir le mode d’application en modifiant les .htaccess. Ainsi, vous n’avez pas à modifier les paramètres Apache.

Vous pouvez modifier les .htaccess à l’un des emplacements suivants, en fonction de votre point d’entrée dans l’application Commerce :

  • <magento_root>/.htaccess
  • <magento_root>/pub/.htaccess

Pour définir une variable :

  1. Ouvrez l’un des fichiers précédents dans un éditeur de texte et ajoutez ou supprimez les commentaires du paramètre souhaité.

    Par exemple, pour spécifier un mode, supprimez les commentaires suivants :

    code language-conf 
    #   SetEnv MAGE_PROFILER firebug

  2. Définissez la valeur de MAGE_PROFILER sur l’une des valeurs suivantes :

    code language-none 
    firebug
csvfile
<custom value>

  3. Enregistrez vos modifications dans .htaccess ; il n’est pas nécessaire de redémarrer Apache pour qu’elles soient prises en compte.

Paramètre Apache

Le serveur web Apache prend en charge la définition du mode d’application à l’aide de directives mod_env.

La directive Apache mod_env est légèrement différente dans Apache version 2.2 et Apache version 2.4.

Les procédures qui suivent montrent comment définir le mode d’application dans un hôte virtuel Apache. Ce n’est pas la seule façon d’utiliser les directives mod_env. Pour plus d’informations, consultez la documentation Apache .

TIP
La section suivante suppose que vous avez déjà configuré votre hôte virtuel. Si ce n’est pas encore fait, consultez une ressource telle que ce tutoriel DigitalOcean.

Pour spécifier une variable de démarrage pour Apache sur Ubuntu :

  1. En tant qu’utilisateur disposant de privilèges root, ouvrez votre fichier de configuration d’hôte virtuel dans un éditeur de texte.

    Par exemple, si votre hôte virtuel est nommé my.magento,

    • Apache 2.4 : vim /etc/apache2/sites-available/my.magento.conf
    • Apache 2.2 : vim /etc/apache2/sites-available/my.magento

  2. À tout endroit de la configuration de l’hôte virtuel, ajoutez la ligne suivante :

    code language-conf 
    SetEnv "<variable name>" "<variable value>"

    Par exemple,

    code language-conf 
    SetEnv "MAGE_PROFILER" "firebug"

  3. Enregistrez vos modifications et quittez l’éditeur de texte.

  4. Activez votre hôte virtuel si vous ne l’avez pas déjà fait :

    code language-bash 
    a2ensite <virtual host config file name>

    Par exemple,

    code language-bash 
    a2ensite my.magento.conf

  5. Après avoir défini le mode , redémarrez le serveur web :

    • Ubuntu : service apache2 restart
    • CentOS : service httpd restart
TIP
Cette section suppose que vous avez déjà configuré votre hôte virtuel. Si ce n’est pas encore fait, consultez une ressource telle que ce tutoriel DigitalOcean.

Pour spécifier une variable de démarrage pour Apache sous CentOS :

  1. En tant qu’utilisateur disposant de droits d’root, ouvrez /etc/httpd/conf/httpd.conf dans un éditeur de texte.

  2. À tout endroit de la configuration de l’hôte virtuel, ajoutez la ligne suivante :

    code language-conf 
    SetEnv "<variable name>" "<variable value>"

    Par exemple,

    code language-conf 
    SetEnv "MAGE_PROFILER" "firebug"

  3. Enregistrez vos modifications et quittez l’éditeur de texte.

  4. Après avoir défini le mode , redémarrez le serveur web :

    • Ubuntu : service apache2 restart
    • CentOS : service httpd restart
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c