[Nur PaaS]{class="badge informative" title="Gilt nur für Adobe Commerce in Cloud-Projekten (von Adobe verwaltete PaaS-Infrastruktur) und lokale Projekte."}

env.php-Referenz

Die env.php-Datei enthält die folgenden Abschnitte:

Backend

Konfigurieren Sie frontName für die Commerce Admin-URL unter Verwendung des backend Knotens in env.php.

'backend' => [
  'frontName' => 'admin'
]

Cache

Konfigurieren Sie die Redis-Seite und das Standard-Caching mithilfe cache Knotens in der env.php.

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379'
            ],
        ],
        'page_cache' => [
            'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
            'backend_options' => [
                'server' => '127.0.0.1',
                'port' => '6379',
                'database' => '1',
                'compress_data' => '0'
            ]
        ]
    ]
]

Weitere Informationen finden Sie unter Redis-Konfiguration.

cache_types

Alle Konfigurationen der Cache-Typen sind über diesen Knoten verfügbar.

'cache_types' => [
  'config' => 1,
  'layout' => 1,
  'block_html' => 1,
  'collections' => 1,
  'reflection' => 1,
  'db_ddl' => 1,
  'compiled_config' => 1,
  'eav' => 1,
  'customer_notification' => 1,
  'config_integration' => 1,
  'config_integration_api' => 1,
  'full_page' => 1,
  'config_webservice' => 1,
  'translate' => 1,
  'vertex' => 1
]

Weitere Informationen zu den verschiedenen Cache-Typen.

consumers_wait_for_messages

Geben Sie an, ob Verbraucher weiterhin Nachrichten abfragen sollen, wenn die Anzahl der verarbeiteten Nachrichten kleiner als der max_messages ist. Der Standardwert ist 1.

'queue' => [
    'consumers_wait_for_messages' => 1
]

Die folgenden Optionen sind verfügbar:

Cron

Aktivieren oder Deaktivieren von Cron-Aufträgen für das Commerce-Programm. Standardmäßig sind Cron-Aufträge aktiviert. Um sie zu deaktivieren, fügen Sie die cron-Konfiguration zur env.php hinzu und setzen den Wert auf 0.

'cron' => [
  'enabled' => 0
]

Weitere Informationen zu Crons.

Krypta

Commerce verwendet einen Verschlüsselungsschlüssel zum Schutz von Kennwörtern und anderen vertraulichen Daten. Dieser Schlüssel wird während des Installationsprozesses generiert.

'crypt' => [
  'key' => '63d409380ccb1182bfb27c231b732f05'
]

Weitere Informationen zu Verschlüsselungsschlüssel finden Sie im Commerce-Benutzerhandbuch.

dB

In diesem Knoten sind alle Datenbankkonfigurationen verfügbar.

'db' => [
  'table_prefix' => '',
  'connection' => [
    'default' => [
      'host' => 'localhost',
      'dbname' => 'magento_db',
      'username' => 'root',
      'password' => 'admin123',
      'model' => 'mysql4',
      'engine' => 'innodb',
      'initStatements' => 'SET NAMES utf8;',
      'active' => '1'
    ]
  ]
]

default_connection

Definiert die Standardverbindung für Nachrichtenwarteschlangen. Der Wert kann db, amqp, stomp oder ein benutzerdefiniertes Warteschlangensystem wie redismq sein. Wenn Sie einen anderen Wert als db angeben, muss zuerst die Message Queue-Software installiert und konfiguriert werden. Andernfalls werden die Nachrichten nicht korrekt verarbeitet.

'queue' => [
    'default_connection' => 'amqp'
]

Für STOMP (ActiveMQ Artemis):

'queue' => [
    'default_connection' => 'stomp'
]

Wenn queue/default_connection in der env.php angegeben ist, wird diese Verbindung für alle Meldungswarteschlangen im System verwendet, es sei denn, eine bestimmte Verbindung ist in einer queue_topology.xml-, queue_publisher.xml- oder queue_consumer.xml definiert.
Wenn queue/default_connection beispielsweise in amqp env.php ist, aber in den XML-Dateien der Warteschlangenkonfiguration eines Moduls eine db angegeben ist, verwendet das Modul MySQL als Nachrichtenbroker.

Verzeichnisse

Optionale Verzeichniszuordnungsoptionen, die festgelegt werden müssen, wenn der Webserver so konfiguriert ist, dass er die Commerce-App aus dem /pub bereitstellt (​ Sicherheit.

'directories' => [
    'document_root_is_pub' => true
]

downloadable_domains

Eine Liste der in diesem Knoten verfügbaren herunterladbaren Domains. Zusätzliche Domains können über CLI-Befehle hinzugefügt, entfernt oder aufgelistet werden.

'downloadable_domains' => [
    'local.vanilla.com'
]

Weitere Informationen zu "​ Domains.

installieren

Das Installationsdatum der Commerce-Anwendung.

'install' => [
  'date' => 'Tue, 23 Apr 2019 09:31:07 +0000'
]

Sperren

Die Einstellungen des Sperranbieters werden mithilfe des lock-Knotens konfiguriert.

Weitere Informationen über Sperranbieter-Konfiguration.

MAGE_MODE

Der Bereitstellungsmodus kann in diesem Knoten konfiguriert werden.

'MAGE_MODE' => 'developer'

Weitere Informationen zu Anwendungsmodi.

Warteschlange

In diesem Knoten sind Konfigurationen für die Nachrichtenwarteschlange verfügbar. Sie können RabbitMQ (AMQP) oder ActiveMQ Artemis (STOMP) als Nachrichtenbroker konfigurieren.

'queue' => [
  'topics' => [
    'customer.created' => [publisher="default-broker"],
    'order.created' => [publisher="default-broker"],
  ]
]

Weitere Informationen über Nachrichtenwarteschlange.

Ressource

Ressourcenkonfigurationseinstellungen sind in diesem Knoten verfügbar.

'resource' => [
  'default_setup' => [
    'connection' => 'default'
  ]
]

Sitzung

Sitzungskonfigurationen werden im Knoten session gespeichert.

'session' => [
  'save' => 'files'
],

Weitere Informationen über Sitzung.

X-Frame-Options

Der X-Frame-Options-Header kann mit diesem Knoten konfiguriert werden.

'x-frame-options' => 'SAMEORIGIN'

Weitere Informationen zu x-frame-options.

System

Mithilfe dieses Knotens sperrt Commerce die Konfigurationswerte in der env.php und deaktiviert dann das Feld in der Admin-Instanz.

'system' => [
  'default' => [
    'web' => [
      'secure' => [
          'base_url' => 'https://magento.test/'
      ]
    ]
  ]

Weitere Informationen finden Sie unter env-php-config-set.

Variablen zur Dateikonfiguration hinzufügen

Sie können jede Konfigurationsoption (Variable mit Wert) mit Umgebungsvariablen auf Betriebssystemebene festlegen oder überschreiben.

Die env.php wird in einem Array mit verschachtelten Ebenen gespeichert. Um einen verschachtelten Array-Pfad in eine Zeichenfolge für OS-Umgebungsvariablen zu konvertieren, verketten Sie jeden Schlüssel im Pfad mit doppelten Unterstrichen __, großgeschrieben und mit dem Präfix MAGENTO_DC_.

Konvertieren wir beispielsweise den Sitzungsspeicher-Handler aus env.php Konfiguration in eine BS-Umgebungsvariable.

'session' => [
  'save' => 'files'
],

Verkettet mit __ und Großbuchstaben wird SESSION__SAVE.

Anschließend stellen wir MAGENTO_DC_ als Präfix voran, um den resultierenden Namen der Betriebssystemumgebungsvariablen MAGENTO_DC_SESSION__SAVE.

export MAGENTO_DC_SESSION__SAVE=files

Als weiteres Beispiel konvertieren wir einen Optionspfad für die Skalarkonfiguration env.php.

'x-frame-options' => 'SAMEORIGIN'

Wir schreiben sie einfach in Großbuchstaben und setzen das Präfix MAGENTO_DC_, um den endgültigen MAGENTO_DC_X-FRAME-OPTIONS für den Betriebssystemumgebungsvariablen zu erhalten.

export MAGENTO_DC_X-FRAME-OPTIONS=SAMEORIGIN

Überschreiben der Dateikonfiguration mit Variablen

Um die vorhandenen env.php-Konfigurationsoptionen mit einer BS-Umgebungsvariablen zu überschreiben, muss das Array-Element der Konfiguration JSON-kodiert sein und als Wert der MAGENTO_DC__OVERRIDE OS-Variablen festgelegt sein.

Wenn MAGENTO_DC__OVERRIDE festgelegt ist, umgeht das Commerce-Framework die entsprechenden Werte in der env.php und liest die Konfiguration direkt aus der Umgebungsvariablen. Die Werte in der env.php bleiben unverändert, werden aber für die überschriebenen Konfigurationsabschnitte ignoriert.

Wenn Sie mehrere Konfigurationsoptionen überschreiben müssen, stellen Sie sie alle in einem einzigen Array zusammen, bevor Sie JSON-Codierung verwenden.

Überschreiben wir beispielsweise die folgenden env.php:

'session' => [
  'save' => 'files'
],
'x-frame-options' => 'SAMEORIGIN'

Der JSON-codierte Text des obigen Arrays lautet wie folgt
{"session":{"save":"files"},"x-frame-options":"SAMEORIGIN"}.

Legen Sie ihn jetzt als Wert der MAGENTO_DC__OVERRIDE-Betriebssystemvariablen fest.

export MAGENTO_DC__OVERRIDE='{"session":{"save":"files"},"x-frame-options":"SAMEORIGIN"}'