高级安装

对比基本安装命令进行阅读，基本安装命令如下：

bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=opensearch \
--opensearch-host=os-host.example.com \
--opensearch-port=9200 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15

命令行安装的基本格式

bin/magento setup:install --<option>=<value> ... --<option>=<value>

注意：

  • 任何包含空格或特殊字符的选项都必须用单引号或双引号引起来
  • 完整的命令行参数：magento cli

admin 选项

NameValueRequired?
--admin-firstnameAdministrator user’s first name.
管理员用户的名字。		Yes
--admin-lastnameAdministrator user’s last name.
管理员用户的姓。		Yes
--admin-emailAdministrator user’s e-mail address.
管理员用户的电子邮件地址。		Yes
--admin-userAdministrator username.
管理员用户名。		Yes
--admin-passwordAdministrator user password. The password must be at least 7 characters in length and must include at least one alphabetic and at least one numeric character. We recommend a longer, more complex password. Enclose the entire password string in single quotes. For example, --admin-password='A0b9%t3g'
管理员用户密码。密码长度必须至少为 7 个字符，并且必须至少包含一个字母字符和至少一个数字字符。我们建议使用更长、更复杂的密码。将整个密码字符串括在单引号中。例如， --admin-password='A0b9%t3g'		Yes

站点和数据库配置选项

NameValueRequired?
--base-url例如：
- http://127.0.0.1/
- http://127.0.0.1:8001/
- https://magento.xxx.com/		Yes
--backend-frontnameadmin panel 访问路径，如果省略，magento 自动生成随机值，例如：admin_jkhgdfq

可以使用 bin/magento info:adminuri 查看 adminuri		No
--db-host- 数据库服务器的完全限定主机名或 IP 地址。
- localhost (默认) 或 127.0.0.1 (如果您的数据库服务器与 Web 服务器位于同一主机上）
- localhost 表示 MySQL 客户端库使用 UNIX 套接字连接到数据库
- 127.0.0.1 使客户端库使用 TCP 协议		Yes
--db-name要在其中安装数据库表的数据库实例的名称，默认值： magento2Yes
--db-user数据库用户名，默认值：rootYes
--db-password数据库密码Yes
--db-prefix有些客户有多个 Adobe Commerce 或 Magento 开源实例运行在一台服务器上，所有表都在同一数据库中。前缀长度最多为五个字符。它必须以字母开头，并且只能包含字母、数字和下划线字符。No
--db-ssl-keyPath to the client key.
客户端密钥的路径。		No
--db-ssl-certPath to the client certificate.
客户端证书的路径。		No
--db-ssl-caPath to the server certificate.
服务器证书的路径。		No
--language语言，可用 bin/magento info:language:list 查看支持的值No
--currency货币，可用 bin/magento info:currency:list 查看支持的值No
--timezone时区，可用 bin/magento info:timezone:list 查看支持的值No
--use-rewrites是否让 php 启用重写
1 表示您对 Storefront 和 Admin 中生成的链接使用 Web 服务器重写。

0 禁用 Web 服务器重写。这是默认设置。		No
--use-secure1 在 Storefront URL 中启用安全套接字层 (SSL)。在选择此选项之前，请确保您的 Web 服务器支持 SSL。

0 禁用 SSL。在这种情况下，所有其他安全 URL 选项也假定为 0。这是默认设置。		No
--base-url-secure用于访问管理员和店面的安全基本 URL，格式如下： http[s]://<host or ip>/<your install dir>/No
--use-secure-admin1 表示使用 SSL 访问管理员。在选择此选项之前，请确保您的 Web 服务器支持 SSL。

0 表示您不对管理员使用 SSL。这是默认设置。		No
--admin-use-security-key1 使应用程序使用随机生成的密钥值访问 Admin 和 Forms 中的页面。这些密钥值有助于防止跨站点脚本伪造攻击。这是默认设置。

0 禁用密钥。		No
--session-save- db 在数据库中存储会话数据。如果您有集群数据库，请选择数据库存储；否则，与基于文件的存储相比，可能不会有太多好处。
- files 在文件系统中存储会话数据。基于文件的会话存储是合适的，除非文件系统访问很慢，您有一个集群数据库，或者您想要在 Redis 中存储会话数据。
- redis 在 Redis 中存储会话数据。如果您使用 Redis 进行默认或页面缓存，则必须已经安装了 Redis。有关配置对 Redis 的支持的其他信息，请参阅将 Redis 用于会话存储。		No
--key如果您有密钥，请指定一个密钥来加密数据库中的敏感数据。如果您没有，应用程序会为您生成一个。Yes
--cleanup-database要在安装 Adobe Commerce 或 Magento Open Source 之前删除数据库表，请指定此参数（不需要值）。否则，数据库将保持不变。No
--db-init-statements高级 MySQL 配置参数。连接到 MySQL 数据库时使用数据库初始化语句运行。在设置任何值之前，请参考与此类似的参考。

默认为。 SET NAMES utf8;		No
--sales-order-increment-prefix指定用作销售订单前缀的字符串值。通常，这用于保证支付处理商的唯一订单号。No

搜索引擎配置选项

NameValueRequired?
--search-engine用作搜索引擎的 Elasticearch 或 OpenSearch 的版本。默认值为 elasticsearch7 。ElasticSearch 5 已弃用，不推荐使用。No
--elasticsearch-host运行 Elasticearch 的主机名或 IP 地址。默认值为 localhost 。No
--elasticsearch-port用于传入的 HTTP 请求的 Elasticearch 端口。默认值为 9200 。No
--elasticsearch-index-prefix标识 Elasticearch 搜索索引的前缀。默认值为 magento2 。No
--elasticsearch-timeout系统超时前的秒数。默认值为 15 。No
--elasticsearch-enable-auth在 Elasticearch 服务器上启用身份验证。默认值为 false 。No
--elasticsearch-username要向 Elasticearch 服务器进行身份验证的用户 ID。否，除非启用身份验证
--elasticsearch-password向 Elasticearch 服务器进行身份验证的密码。否，除非启用身份验证
--opensearch-host运行 OpenSearch 的主机名或 IP 地址。默认值为 localhost 。No
--opensearch-port用于传入的 HTTP 请求的 OpenSearch 端口。默认值为 9200 。No
--opensearch-index-prefix标识 OpenSearch 搜索索引的前缀。默认值为 magento2 。No
--opensearch-timeout系统超时前的秒数。默认值为 15 。No
--opensearch-enable-auth在 OpenSearch 服务器上启用身份验证。默认值为 false 。No
--opensearch-username要向 OpenSearch 服务器进行身份验证的用户 ID。否，除非启用身份验证
--opensearch-password用于向 OpenSearch 服务器进行身份验证的密码。否，除非启用身份验证

RabbitMQ 配置选项

除非您已经安装了 RabbitMQ，否则不要使用 --amqp-* 选项。有关安装和配置 RabbitMQ 的更多信息，请参阅 RabbitMQ 安装指南

NameValueRequired?
--amqp-host安装 RabbitMQ 的主机名。No
--amqp-port用于连接到 RabbitMQ 的端口。默认值为 5672。No
--amqp-user连接到 RabbitMQ 的用户名。请勿使用默认用户 guest 。No
--amqp-password连接到 RabbitMQ 的密码。请勿使用默认密码 guest 。No
--amqp-virtualhost用于连接到 RabbitMQ 的虚拟主机。默认值为 / 。No
--amqp-ssl指示是否连接到 RabbitMQ。默认值为 false 。有关为 RabbitMQ 设置 SSL 的信息，请参阅 RabbitMQ。No
--consumers-wait-for-messages消费者应该等待队列中的消息吗？
- 0 ：消费者处理队列中的可用消息，关闭 TCP 连接，并终止。消费者不会等待其他消息进入队列，即使处理的消息数少于启动消费者时指定的 --max_messages 值。
- 1 ：消费者继续处理来自消息队列的消息，直到达到最大消息数 ( queue:consumers:start 命令中为 --max_messages 指定的值)，然后关闭 TCP 连接并终止消费者进程。如果队列在到达 --max_messages 之前清空，消费者将等待更多消息到达。如果您使用工作器而不是使用 cron 作业来运行使用者，请将此变量设置为 1 。		No

锁定配置选项

NameValueRequired?
--lock-provider锁定提供程序名称。

可用的锁提供程序： db 、 zookeeper 、 file 。

默认锁提供程序： db		No
--lock-db-prefix使用 db 锁提供程序时避免锁冲突的特定数据库前缀。

默认值： NULL		No
--lock-zookeeper-host使用 zookeeper 锁定提供程序时连接到 ZooKeeper 群集的主机和端口。

例如： 127.0.0.1:2181		是，如果设置 --lock-provider=zookeeper
--lock-zookeeper-pathZooKeeper 保存锁的路径。

默认路径为： /magento/locks		No
--lock-file-path保存文件锁定的路径。是，如果您设置 --lock-provider=file

注意：
要使用 HTTPS 访问 store 和 admin，必须设置以下所有参数

  • --use-secure=1
  • --base-url-secure=https://xxxx
  • --use-secure-admin=1