快速启动内部部署
本页上的说明介绍了如何在上安装Adobe Commerce 自托管 基础架构。 有关升级现有安装的指导,请参阅 升级指南.
Adobe用途 Composer 管理Adobe Commerce组件及其依赖项。 使用Composer获取Adobe Commercemetapackage具有以下优势:
- 重用第三方库,而无需将它们与源代码捆绑在一起
- 通过使用基于组件的架构和强大的依赖关系管理,减少扩展冲突和兼容性问题
- 遵守 PHP-Framework互操作性组(FIG) 标准
- 使用其他组件重新打包Magento Open Source
- 在生产环境中使用Adobe Commerce软件
先决条件
在继续之前,必须执行以下操作:
以文件系统所有者的身份登录
在中了解所有权、权限和文件系统所有者 所有权和权限主题概述.
切换到文件系统所有者:
-
以具有写入文件系统权限的用户身份登录或切换到应用程序服务器。
如果使用bash shell,则可以使用以下语法切换到文件系统所有者并同时输入命令:
code language-bash su <file system owner> -s /bin/bash -c <command>
如果文件系统所有者不允许登录,您可以执行以下操作:
code language-bash sudo -u <file system owner> <command>
-
要从任何目录运行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的比喻,请执行以下操作:
-
以以下身份登录到您的应用程序服务器,或切换到 文件系统所有者.
-
转到Web服务器docroot目录或您已配置为虚拟主机docroot的目录。
-
使用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。
此示例假定安装目录名为 magento2ee
, db-host
在同一台计算机上(localhost
),并且 db-name
, db-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
--backend-frontname
选项。 但是,Adobe建议忽略此选项,并允许安装命令自动生成随机URI。 黑客或恶意软件更难利用随机URI。 安装完成后,控制台中会显示URI。命令摘要
要显示完整的命令列表,请输入:
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}
magento setup:config:set
magento module:{enable/disable}
magento setup:store-config:set
magento setup:db-schema:upgrade
magento setup:db-data:upgrade
magento setup:db:status
magento admin:user:create
部署配置
至少启用
Magento_User
和 Magento_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
--no-ansi