Paramètres du Bootstrap

Cette rubrique explique comment définir les valeurs des paramètres de bootstrap de l’application Commerce. Voir Présentation de l’initialisation et de l’amorçage de l’application.

Le tableau suivant décrit les paramètres de bootstrap que vous pouvez définir :

Paramètre du Bootstrap
Description
MAGE_DIRS
Spécifie les chemins d’URL et de répertoire personnalisés
MAGE_PROFILER
Active les graphiques de dépendances et le profilage des HTMLS
INFO
  • Tous les paramètres de bootstrap ne sont pas documentés.
  • Vous définissez maintenant le mode de l'application (développeur, valeur 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 des variables d’amorçage 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. Les shells ayant 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 profileur, redémarrez votre serveur web. La raison peut être liée à la mise en cache des bytecode PHP, qui met en cache les bytecodes et les classpaths PHP.

Définition de paramètres pour Apache ou Nginx

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

Paramètre Nginx

Consultez l’ exemple de configuration Nginx sur GitHub.

Paramètre Apache .htaccess

Pour définir le mode de l’application, modifiez .htaccess. Ainsi, vous n’avez pas à modifier les paramètres Apache.

Vous pouvez modifier .htaccess aux emplacements suivants, en fonction du point d’entrée de 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 annulez la mise en commentaire du paramètre souhaité.

    Par exemple, pour spécifier un mode, annulez la mise en commentaire des éléments suivants :

    code language-conf
    #   SetEnv MAGE_PROFILER firebug
    
  2. Définissez la valeur de MAGE_PROFILER sur l’une des valeurs suivantes :

    code language-terminal
    firebug
    csvfile
    <custom value>
    
  3. Enregistrez vos modifications sur .htaccess ; vous n’avez pas besoin de redémarrer Apache pour que la modification soit prise en compte.

Paramètre Apache

Le serveur web Apache prend en charge le paramétrage du mode d'application à l'aide des 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 ci-dessous 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 ; consultez la documentation Apache pour plus de détails.

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

Pour spécifier une variable bootstrap pour Apache sur Ubuntu, :

  1. En tant qu’utilisateur disposant des 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. N'importe où dans 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 le cas, consultez une ressource telle que ce tutoriel DigitalOcean.

Pour spécifier une variable bootstrap pour Apache sur CentOS :

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

  2. N'importe où dans 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