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]的设置

后端

使用env.php中的backend节点为Commerce管理员URL配置​ frontName

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

缓存

使用env.php文件中的cache节点配置redis页面和默认缓存。

'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_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 — 使用者继续处理来自消息队列的消息,直到达到env.php文件中指定的max_messages值为止,然后关闭TCP连接并终止使用者进程。 如果队列在达到max_messages值之前清空,则使用者将等待更多消息到达。

    我们建议大型商家使用此设置,因为预计消息流量会持续不变,并且不希望出现处理延迟。

  • 0 — 使用者处理队列中的可用消息,关闭TCP连接并终止。 即使已处理的消息数小于env.php文件中指定的max_messages值,使用者也不会等待其他消息进入队列。 这有助于防止由于消息队列处理长时间延迟而导致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以外的任何值,则必须先安装和配置消息队列软件。 否则,将无法正确处理消息。

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

如果在系统env.php文件中指定了queue/default_connection,则此连接用于通过系统的所有消息队列,除非在queue_topology.xmlqueue_publisher.xmlqueue_consumer.xml文件中定义了特定连接。
例如,如果queue/default_connectionenv.php中为amqp,但在模块的队列配置XML文件中指定了db连接,则模块将使用MySQL作为消息代理。

目录

可选目录映射选项,在将Web服务器配置为从/pub目录提供Commerce应用程序时需要设置这些选项,以提高安全性

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

downloadable_domains

此节点中可用的可下载域列表。 使用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' => [
  '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