快速启动内部部署

本页上的说明介绍了如何在上安装Adobe Commerce 自托管 基础架构。 有关升级现有安装的指导,请参阅 升级指南.

Adobe用途 Composer 管理Adobe Commerce组件及其依赖项。 使用Composer获取Adobe Commercemetapackage具有以下优势:

  • 重用第三方库,而无需将它们与源代码捆绑在一起
  • 通过使用基于组件的架构和强大的依赖关系管理,减少扩展冲突和兼容性问题
  • 遵守 PHP-Framework互操作性组(FIG) 标准
  • 使用其他组件重新打包Magento Open Source
  • 在生产环境中使用Adobe Commerce软件
NOTE
对Magento Open Source有贡献的开发人员应使用 基于Git 安装方法。

先决条件

在继续之前,必须执行以下操作:

以文件系统所有者的身份登录

在中了解所有权、权限和文件系统所有者 所有权和权限主题概述.

切换到文件系统所有者:

  1. 以具有写入文件系统权限的用户身份登录或切换到应用程序服务器。

    如果使用bash shell,则可以使用以下语法切换到文件系统所有者并同时输入命令:

    code language-bash
    su <file system owner> -s /bin/bash -c <command>
    

    如果文件系统所有者不允许登录,您可以执行以下操作:

    code language-bash
    sudo -u <file system owner>  <command>
    
  2. 要从任何目录运行CLI命令,请添加 <app_root>/bin 到您的系统 PATH.

    由于外壳具有不同的语法,请查阅 unix.stackexchange.com.

    CentOS的bash shell示例:

    code language-bash
    export PATH=$PATH:/var/www/html/magento2/bin
    

    或者,也可以通过以下方式运行命令:

    • cd <app_root>/bin 并运行它们 ./magento <command name>
    • app_root>/bin/magento <command name>
    • <app_root> 是Web服务器docroot的子目录

获取隐喻

要获取Adobe Commerce的比喻,请执行以下操作:

  1. 以以下身份登录到您的应用程序服务器,或切换到 文件系统所有者.

  2. 转到Web服务器docroot目录或您已配置为虚拟主机docroot的目录。

  3. 使用Commerce隐喻创建编辑器项目。

    Magento Open Source

    code language-bash
    composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>
    

    Adobe Commerce

    code language-bash
    composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>
    

    出现提示时,输入您的身份验证密钥。 可在中创建和配置公钥和私钥, Commerce Marketplace.

    note note
    NOTE
    使用编辑器时 auth.json 文件或环境变量,则不会提示您输入身份验证密钥。

    如果您遇到错误,例如 Could not find package......no matching package found,确保命令中没有拼写错误。 如果仍遇到错误,则可能无权下载Adobe Commerce。 联系人 Adobe Commerce支持 以寻求帮助。

    请参阅 疑难解答 以获取有关更多错误的帮助。

示例 — 次要版本

次发行版本包含新功能、质量修复和安全修复。 使用编辑器指定次要版本。 例如,要指定Adobe Commerce 2.4.6metapackage,请执行以下操作:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>

示例 — 质量修补程序

质量补丁主要包含功能性 安全修复。 但是,它们有时也可以包含向后兼容的新功能。 使用Composer下载质量修补程序。 例如,要指定Adobe Commerce 2.4.6metapackage,请执行以下操作:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>

示例 — 安全修补程序

安全修补程序仅包含安全修补程序。 它们旨在使升级过程更快、更轻松。

安全修补程序使用编辑器命名约定 2.4.6-px. 使用Composer指定修补程序。 例如,要下载Adobe Commerce 2.4.6-p1中继包,请执行以下操作:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>

设置文件权限

在安装Adobe Commerce之前,必须设置Web服务器组的读写权限。 这是必要的,以便命令行可以将文件写入文件系统。

cd /var/www/html/<magento install directory>
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :www-data . # Ubuntu
chmod u+x bin/magento

安装应用程序

您必须使用命令行安装Adobe Commerce。

此示例假定安装目录名为 magento2eedb-host 在同一台计算机上(localhost),并且 db-namedb-user、和 db-password 全部 magento

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-email=admin@admin.com \
--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
TIP
您可以使用自定义管理员URI --backend-frontname 选项。 但是,Adobe建议忽略此选项,并允许安装命令自动生成随机URI。 黑客或恶意软件更难利用随机URI。 安装完成后,控制台中会显示URI。
TIP
有关CLI安装选项的完整说明,请参见 从命令行安装应用程序.

命令摘要

要显示完整的命令列表,请输入:

bin/magento list

要获取特定命令的帮助,请输入:

bin/magento help <command>

例如:

bin/magento help setup:install
bin/magento help cache:enable

下表总结了可用的命令。 命令仅以摘要形式显示。 有关命令的详细信息,请单击“命令”列中的链接。

命令
描述
先决条件
magento setup:install
安装应用程序
magento setup:uninstall
删除应用程序。
已安装应用程序
magento setup:upgrade
更新应用程序。
部署配置
magento maintenance:{enable/disable}
启用或禁用维护模式(在维护模式下,只有免费IP地址才能访问管理员或店面)。
已安装应用程序
magento setup:config:set
创建或更新部署配置。
magento module:{enable/disable}
启用或禁用模块。
magento setup:store-config:set
设置店面相关选项,如基本URL、语言、时区。
部署配置
magento setup:db-schema:upgrade
更新数据库模式。
部署配置
magento setup:db-data:upgrade
更新数据库数据。
部署配置
magento setup:db:status
检查数据库是否使用代码保持最新。
部署配置
magento admin:user:create
创建管理员用户。
您可以为以下内容创建用户:

部署配置

至少启用 Magento_UserMagento_Authorization 模块

数据库(最简单的方法是使用 bin/magento setup:upgrade)
magento list
列出所有可用命令。
magento help
提供指定命令的帮助。

常用参数

以下参数对所有命令都是通用的。 这些命令可以在安装应用程序之前或之后运行:

长版本
简短版本
含义
--help
-h
获取任何命令的帮助。 例如, ./magento help setup:install./magento help setup:config:set.
--quiet
-q
安静模式;无输出。
--no-interaction
-n
无交互式问题。
--verbose=1,2,3
-v, -vv, -vvv
详细级别。 例如, --verbose=3-vvv 显示调试详细程度,这是最详细的输出。 默认为 --verbose=1-v.
--version
-V
显示此应用程序版本
--ansi
不适用
强制ANSI输出
--no-ansi
不适用
禁用ANSI输出
NOTE
恭喜!您已完成快速安装。 需要更多高级帮助? 查看 高级安装 指南。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995