env.php參考

env.php 檔案包含下列區段:

名稱
說明
backend
管理區域的設定
cache
設定Redis頁面和預設快取
cache_types
快取儲存設定
consumers_wait_for_messages
設定使用者處理訊息佇列訊息的方式
cron
啟用或停用cron工作
crypt
密碼編譯功能的加密金鑰
db
資料庫連線設定
default_connection
訊息佇列預設連線
directories
Commerce目錄對應設定
downloadable_domains
可下載網域的清單
install
安裝日期
lock
鎖定提供者設定
MAGE_MODE
應用程式模式
queue
訊息佇列 設定
resource
將資源名稱對應到連線
session
工作階段儲存資料
system
停用「管理員」中要編輯的欄位
x-frame-options
設定 [x-frame-options][x-frame-options]

後端

設定 frontName 針對Commerce管理員url,使用 backend env.php中的節點。

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

快取

使用設定redis頁面和預設快取 cache 中的節點 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'
            ]
        ]
    ]
]

進一步瞭解 Redis設定.

cache_type

所有快取型別設定都可從此節點取得。

'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
]

深入瞭解不同 快取型別.

consumers_wait_for_messages

指定當處理的訊息數小於以下值時消費者是否應繼續輪詢訊息: max_messages 值。 預設值為 1.

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

下列選項可供使用:

  • 1 — 消費者會繼續處理來自訊息佇列的訊息,直到到達 max_messages 中指定的值 env.php 關閉TCP連線並終止取用者處理序之前的檔案。 如果佇列在到達之前排空 max_messages 值,消費者會等待更多訊息到達。

    我們建議大型商戶使用此設定,因為系統預期訊息流程會持續不變,且不希望處理延遲。

  • 0 — 取用者處理佇列中的可用訊息、關閉TCP連線,然後終止。 即使已處理的訊息數量少於 max_messages 中指定的值 env.php 檔案。 這有助於防止因訊息佇列處理長時間延遲而導致cron工作發生問題。

    我們建議將此設定用於小型商家,這類商戶不希望持續傳送訊息流,且偏好節省運算資源,以換取在數天內沒有訊息時的輕微處理延遲。

cron

啟用或停用Commerce應用程式的cron工作。 預設會啟用cron工作。 若要加以停用,請新增 cron 的設定 env.php 檔案並將值設為 0.

'cron' => [
  'enabled' => 0
]
WARNING
停用cron工作時請小心。 當它們停用時,Commerce應用程式所需的基本流程將不會執行。

進一步瞭解 Crons.

加密

Commerce使用加密金鑰來保護密碼和其他敏感資料。 此金鑰會在安裝過程中產生。

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

進一步瞭解 加密金鑰Commerce使用手冊.

db

此節點提供所有資料庫組態。

'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

定義訊息佇列的預設連線。 該值可以是 dbamqp或自訂佇列系統,例如 redismq. 如果您指定的值不是 db,必須先安裝及設定message queue軟體。 否則,訊息將無法正確處理。

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

如果 queue/default_connection 已在系統中指定 env.php 檔案中,此連線用於透過系統的所有訊息佇列,除非在檔案中定義了特定連線, queue_topology.xmlqueue_publisher.xmlqueue_consumer.xml 檔案。
例如,如果 queue/default_connectionamqpenv.phpdb 連線是在模組的佇列組態XML檔案中指定的,模組將使用MySQL做為訊息代理人。

目錄

選用的目錄對應選項,在網頁伺服器設定為從提供Commerce應用程式時 /pub 目錄: 提升安全性.

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

downloadable_domain

此節點中可用的可下載網域清單。 您可以使用CLI指令來新增、移除或列出其他網域。

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

進一步瞭解 可下載的網域.

安裝

Commerce應用程式的安裝日期。

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

鎖定

鎖定提供者設定是使用 lock 節點。

進一步瞭解 鎖定提供者設定.

影像模式

可在此節點中設定部署模式。

'MAGE_MODE' => 'developer'

進一步瞭解 應用程式模式.

佇列

此節點提供訊息佇列設定。

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

進一步瞭解 訊息佇列.

resource

資源組態設定可在此節點中使用。

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

session

工作階段設定會儲存在 session 節點。

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

進一步瞭解 工作階段.

x-frame-options

x-frame-options標頭可使用此節點進行設定。

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

進一步瞭解 x-frame-options.

系統

使用此節點,Commerce會在以下位置鎖定設定值: env.php 然後停用管理員中的欄位。

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

進一步瞭解 env-php-config-set.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c