env.php reference
Filen env.php innehåller följande avsnitt:
backendcachecache_typesconsumers_wait_for_messagescroncryptdbdefault_connectiondirectoriesdownloadable_domainsinstalllockMAGE_MODEqueueresourcesessionsystemx-frame-optionsserverdel
Konfigurera frontName för Commerce-administratörens URL med noden backend i env.php.
'backend' => [
'frontName' => 'admin'
]
cache
Konfigurera redis-sida och standardcachelagring genom att använda noden cache i filen 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'
]
]
]
]
Läs mer i Redis-konfiguration.
cache_types
Alla konfigurationer av cachetyper är tillgängliga från den här noden.
'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
]
Läs mer om olika cachetyper.
containers_wait_for_messages
Ange om konsumenterna ska fortsätta att avfråga meddelanden om antalet bearbetade meddelanden är mindre än värdet max_messages. Standardvärdet är 1.
'queue' => [
'consumers_wait_for_messages' => 1
]
Följande alternativ är tillgängliga:
-
1- Konsumenterna fortsätter att bearbeta meddelanden från meddelandekön tills detmax_messages-värde som anges i filenenv.phpnås innan TCP-anslutningen stängs och konsumentprocessen avslutas. Om kön töms innan värdetmax_messagesuppnås väntar konsumenten på att fler meddelanden ska komma fram.Vi rekommenderar den här inställningen för stora handlare eftersom ett konstant meddelandeflöde förväntas och förseningar i bearbetningen är oönskade.
-
0- Konsumenterna bearbetar tillgängliga meddelanden i kön, stänger TCP-anslutningen och avslutar. Konsumenterna väntar inte på att ytterligare meddelanden ska skickas till kön, även om antalet bearbetade meddelanden är mindre än värdetmax_messagessom anges i filenenv.php. Detta kan hjälpa till att förhindra problem med kronijobb som orsakas av långa förseningar i meddelandeköhanteringen.Vi rekommenderar den här inställningen för mindre handlare som inte förväntar sig ett konstant meddelandeflöde och som föredrar att spara datorresurser i utbyte mot mindre förseningar när det inte finns några meddelanden på några dagar.
cron
Aktivera eller inaktivera cron-jobb för Commerce-programmet. Kronijobb är som standard aktiverade. Om du vill inaktivera dem lägger du till konfigurationen cron i filen env.php och anger värdet till 0.
'cron' => [
'enabled' => 0
]
Läs mer om Crons.
kryptera
Commerce använder en krypteringsnyckel för att skydda lösenord och andra känsliga data. Den här nyckeln genereras under installationsprocessen.
'crypt' => [
'key' => '63d409380ccb1182bfb27c231b732f05'
]
Läs mer om Krypteringsnyckel i användarhandboken för Commerce.
db
Alla databaskonfigurationer är tillgängliga i den här noden.
'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
Definierar standardanslutningen för meddelandeköer. Värdet kan vara db, amqp, stomp eller ett anpassat kösystem som redismq. Om du anger något annat värde än db måste meddelandeköprogrammet först installeras och konfigureras. Annars kommer meddelanden inte att behandlas korrekt.
'queue' => [
'default_connection' => 'amqp'
]
För STOMP (ActiveMQ Artemis):
'queue' => [
'default_connection' => 'stomp'
]
Om queue/default_connection anges i systemfilen env.php används den här anslutningen för alla meddelandeköer via systemet, såvida inte en viss anslutning definieras i en queue_topology.xml-, queue_publisher.xml- eller queue_consumer.xml-fil.
Om queue/default_connection till exempel är amqp i env.php men en db-anslutning har angetts i kökonfigurationens XML-filer för en modul, använder modulen MySQL som meddelandehanterare.
kataloger
Valfria katalogmappningsalternativ som måste anges när webbservern är konfigurerad för att hantera Commerce-programmet från katalogen /pub för förbättrad säkerhet.
'directories' => [
'document_root_is_pub' => true
]
downloadable_domains
En lista över tillgängliga hämtningsbara domäner i den här noden. Ytterligare domäner kan läggas till, tas bort eller listas med CLI-kommandon.
'downloadable_domains' => [
'local.vanilla.com'
]
Läs mer om Hämtningsbara domäner.
installera
Installationsdatumet för Commerce-programmet.
'install' => [
'date' => 'Tue, 23 Apr 2019 09:31:07 +0000'
]
lock
Lås providerinställningar konfigureras med noden lock.
Läs mer om Lås providerkonfiguration.
MAGE_MODE
Distributionsläget kan konfigureras i den här noden.
'MAGE_MODE' => 'developer'
Läs mer om programlägen.
kö
Meddelandekökonfigurationer är tillgängliga i den här noden. Du kan konfigurera RabbitMQ (AMQP) eller ActiveMQ Artemis (STOMP) som meddelandehanterare.
'queue' => [
'topics' => [
'customer.created' => [publisher="default-broker"],
'order.created' => [publisher="default-broker"],
]
]
Läs mer om Meddelandekö.
resurs
Resurskonfigurationsinställningar är tillgängliga i den här noden.
'resource' => [
'default_setup' => [
'connection' => 'default'
]
]
session
Sessionskonfigurationer lagras i noden session.
'session' => [
'save' => 'files'
],
Läs mer om Session.
x-frame-options
Rubriken för x-frame-options kan konfigureras med den här noden.
'x-frame-options' => 'SAMEORIGIN'
Läs mer om x-frame-options.
system
Med den här noden låser Commerce konfigurationsvärdena i filen env.php och inaktiverar sedan fältet i administratören.
'system' => [
'default' => [
'web' => [
'secure' => [
'base_url' => 'https://magento.test/'
]
]
]
Läs mer i env-php-config-set.
Lägg till variabler i filkonfigurationen
Du kan ställa in eller åsidosätta alla konfigurationsalternativ (variabel med värde) med miljövariabler på operativsystemnivå (OS).
Konfigurationen env.php lagras i en matris med kapslade nivåer. Om du vill konvertera en kapslad arraysökväg till en sträng för systemmiljövariabler sammanfogar du varje nyckel i sökvägen med två understreck, __, överkant och prefix med MAGENTO_DC_.
Låt oss till exempel konvertera hanteraren för sessionssparande från konfigurationen env.php till en systemvariabel.
'session' => [
'save' => 'files'
],
Sammanfogade med __ och överraderade nycklar blir SESSION__SAVE.
Sedan prefixar vi det med MAGENTO_DC_ för att hämta det resulterande variabelnamnet MAGENTO_DC_SESSION__SAVE för operativsystemsmiljön.
export MAGENTO_DC_SESSION__SAVE=files
Som ett annat exempel konverterar vi en skalär sökväg för konfigurationsalternativ för env.php.
'x-frame-options' => 'SAMEORIGIN'
Det är bara att versalera det och prefix med MAGENTO_DC_ för att ta emot det slutliga systemmiljövariabelnamnet MAGENTO_DC_X-FRAME-OPTIONS.
export MAGENTO_DC_X-FRAME-OPTIONS=SAMEORIGIN
env.php-innehåll kommer att ha prioritet framför operativsystemets miljövariabler.Åsidosätt filkonfiguration med variabler
Om du vill åsidosätta de befintliga env.php-konfigurationsalternativen med en OS-miljövariabel måste konfigurationens matriselement vara JSON-kodat och anges som ett värde för MAGENTO_DC__OVERRIDE OS-variabeln.
När MAGENTO_DC__OVERRIDE har angetts åsidosätter Commerce-ramverket motsvarande värden i env.php-filen och läser konfigurationen direkt från systemvariabeln. Värdena i filen env.php förblir oförändrade men ignoreras för de åsidosatta konfigurationsavsnitten.
MAGENTO_DC__OVERRIDE åsidosätter fullständigt de angivna konfigurationsavsnitten i filen env.php. Det här beteendet skiljer sig från enskilda MAGENTO_DC_-variabler, som har lägre prioritet än värdena i filen env.php.Om du behöver åsidosätta flera konfigurationsalternativ måste du montera alla i en enda array före JSON-kodning.
Vi kan till exempel åsidosätta följande env.php-konfigurationer:
'session' => [
'save' => 'files'
],
'x-frame-options' => 'SAMEORIGIN'
JSON-kodad text i ovanstående array blir{"session":{"save":"files"},"x-frame-options":"SAMEORIGIN"}.
Ange det nu som värdet för OS-variabeln MAGENTO_DC__OVERRIDE.
export MAGENTO_DC__OVERRIDE='{"session":{"save":"files"},"x-frame-options":"SAMEORIGIN"}'