DokumentationCommerceKonfigurationshandbuch

Nur PaaS

Bootstrap-Parameter

Letzte Aktualisierung: 18. Dezember 2024
  • Themen:
  • Konfiguration

Erstellt für:

  • Experte
  • Admin
  • Entwickler

Dieses Thema zeigt, wie Sie die Werte der Bootstrap-Parameter von Commerce-Anwendungen festlegen. Siehe Übersicht über Anwendungsinitialisierung und Bootstrapping.

In der folgenden Tabelle werden die Bootstrap-Parameter erläutert, die Sie festlegen können:

Bootstrap ParameterBeschreibung
MAGE_DIRSGibt benutzerdefinierte Verzeichnis- und URL-Pfade an
MAGE_PROFILERAktiviert Abhängigkeitsdiagramme und HTML-Profilerstellung
INFO
  • Nicht alle Bootstrap-Parameter sind dokumentiert.
  • Sie können jetzt den Anwendungsmodus (Entwickler, Standard, Produktion) mit dem Befehl magento deploy:mode:set {mode} festlegen.

Festlegen von Parametern mithilfe einer Umgebungsvariablen

In diesem Abschnitt wird beschrieben, wie Sie die Werte von Bootstrap-Parametern mithilfe von Umgebungsvariablen festlegen.

Festlegen des Anwendungsmodus

Sie können Bootstrap-Variablen als systemweite Umgebungsvariablen angeben, wodurch alle Prozesse sie verwenden können.

Beispielsweise können Sie mit der MAGE_PROFILER-Umgebungsvariablen einen Modus wie folgt angeben:

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

Legen Sie die Variable mithilfe eines Shell-spezifischen Befehls fest. Da Shell unterschiedliche Syntax haben, sollten Sie einen Verweis wie unix.stackexchange.com heranziehen.

Bash-Shell-Beispiel für CentOS:

export MAGE_PROFILER=firebug
INFO
Wenn nach dem Festlegen eines Profilerwerts im Browser ein PHP Fatal error angezeigt wird, starten Sie den Webserver neu. Der Grund könnte mit dem PHP Bytecode Caching zusammenhängen, das Bytecodes und PHP-Klassenpfade zwischenspeichert.

Festlegen von Parametern für Apache oder Nginx

In diesem Abschnitt wird beschrieben, wie Sie den Modus für Apache oder Nginx angeben.

Nginx-Einstellung

Siehe die Nginx-Beispielkonfiguration auf GitHub.

Apache .htaccess-Einstellung

Eine Möglichkeit, den Anwendungsmodus festzulegen, besteht darin, .htaccess zu bearbeiten. Auf diese Weise müssen Sie die Apache-Einstellungen nicht ändern.

Je nach Einstiegspunkt für das Commerce-Programm können Sie .htaccess an jedem der folgenden Speicherorte ändern:

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

So legen Sie eine Variable:

  1. Öffnen Sie eine der zuvor genannten Dateien in einem Texteditor und fügen Sie die gewünschte Einstellung hinzu oder heben Sie die Auskommentierung auf.

    Um beispielsweise einen „Modus anzugeben, hebenden Kommentar für Folgendes auf:

    #   SetEnv MAGE_PROFILER firebug
    
  2. Legen Sie den Wert von MAGE_PROFILER auf einen der folgenden Werte fest:

    firebug
    csvfile
    <custom value>
    
  3. Speichern Sie Ihre Änderungen in .htaccess. Sie müssen Apache nicht neu starten, damit die Änderungen wirksam werden.

Apache-Einstellung

Der Apache-Webserver unterstützt das Festlegen des Anwendungsmodus mithilfe von mod_env-Anweisungen.

Die Apache mod_env-Direktive unterscheidet sich geringfügig von [Apache-Version 2.2] und Apache-Version 2.4.

Die folgenden Verfahren zeigen, wie Sie den Anwendungsmodus in einem virtuellen Apache-Host festlegen. Dies ist nicht die einzige Möglichkeit, mod_env Anweisungen zu verwenden. Weitere Informationen finden Sie in der Apache-Dokumentation .

TIP
Im folgenden Abschnitt wird davon ausgegangen, dass Sie Ihren virtuellen Host bereits eingerichtet haben. Andernfalls finden Sie weitere Informationen in einer Ressource wie diesem DigitalOcean-Tutorial.

So geben Sie eine Bootstrap-Variable für Apache auf Ubuntu an:

  1. Als Benutzer mit root Berechtigungen können Sie Ihre Konfigurationsdatei für virtuelle Hosts in einem Texteditor öffnen.

    Wenn Ihr virtueller Host beispielsweise my.magento heißt,

    • Apache 2.4: vim /etc/apache2/sites-available/my.magento.conf
    • Apache 2.2: vim /etc/apache2/sites-available/my.magento
  2. Fügen Sie an einer beliebigen Stelle in der Konfiguration des virtuellen Hosts die folgende Zeile hinzu:

    SetEnv "<variable name>" "<variable value>"
    

    Beispiel:

    SetEnv "MAGE_PROFILER" "firebug"
    
  3. Speichern Sie Ihre Änderungen und beenden Sie den Texteditor.

  4. Aktivieren Sie Ihren virtuellen Host, falls noch nicht geschehen:

    a2ensite <virtual host config file name>
    

    Beispiel:

    a2ensite my.magento.conf
    
  5. Starten Sie den Webserver neu, nachdem Sie den Modus festgelegt haben:

    • Ubuntu: service apache2 restart
    • CentOS: service httpd restart
TIP
In diesem Abschnitt wird davon ausgegangen, dass Sie Ihren virtuellen Host bereits eingerichtet haben. Andernfalls finden Sie weitere Informationen in einer Ressource wie diesem DigitalOcean-Tutorial.

So geben Sie eine Bootstrap-Variable für Apache unter CentOS an:

  1. Wenn Sie ein Benutzer mit root Berechtigungen sind, öffnen Sie /etc/httpd/conf/httpd.conf in einem Texteditor.

  2. Fügen Sie an einer beliebigen Stelle in der Konfiguration des virtuellen Hosts die folgende Zeile hinzu:

    SetEnv "<variable name>" "<variable value>"
    

    Beispiel:

    SetEnv "MAGE_PROFILER" "firebug"
    
  3. Speichern Sie Ihre Änderungen und beenden Sie den Texteditor.

  4. Starten Sie den Webserver neu, nachdem Sie den Modus festgelegt haben:

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