本地安装

推荐使用 Composer 来管理 Adobe Commerce 和 Magento Open Source 组件及其依赖关系。用 Composer 来获取 Adobe Commerce 和 Magento Open Source 元包，具有以下优势：

• 重复使用第三方库
• 减少扩展冲突和兼容性问题
• 遵守 PHP-Framework Interoperability Group（FIG）标准
• 用其他组件重新包装 Magento Open Source 源码
• 在生产环境中使用 Adobe Commerce 或 Magento 开源软件

为 Magento Open Source 做贡献的开发者应该使用基于 git 的安装方法。

前提条件

开始之前，你必须做以下事情：

• 认真查看系统要求中针对不同软件的版本要求。
• 安装 Composer 软件。
• 获取 Adobe Commerce 和 Magento Open Source Composer 资源库的认证密钥。参考 获取 Magento 认证密钥 章节

以 root（管理员） 身份登录

如果不是用 root 登录的，需要通过 su 切换到 root 账户

su -s /bin/bash -c <要执行的命令>

如果 root 用户不能登录的情况下，执行 sudo -u root <command>

为了能够在任何目录都能够执行 magento 命令，可以将 <app_root>/bin 目录添加到 PATH 中，不同的系统可能语法不同，在 CentOS 中的配置如下，其他系统可以参考各自系统的配置。

export PATH=$PATH:/var/www/html/magento2/bin

其中 /var/www/html/magento2 指的是 magento 的安装目录，根据自己的实际情况调整即可。

当然，你可以可以选择不设置 PATH, 需要使用 magento 命令的时候直接切换到 Magento 的安装目录（这里是 /var/www/html/magento2/）下的 /bin 目录，然后执行 magento 命令。

正式安装

• 以 root 的用户登录服务器
• 切换到对应的 web server 配置的目录下，比如 apache 或者 nginx 配置的网站根目录是 /var/www/html 就切换到对应的目录下，根据实际情况切换到自己的目录下即可。
• 通过 Composer 安装 Adobe Commerce 或者 Magento Open Source

Magento Open Source 安装命令

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

Adobe Commerce 安装命令

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

当出现提示时，输入你的认证密钥。公钥和私钥是在你的 Commerce Marketplace 上创建和配置的。

如果你遇到错误，如 Could not find package... 或 o matching package found，请确保你的命令中没有错别字。如果还有错误，你可能没有被授权下载 Adobe Commerce。请联系 Adobe Commerce 支持部门寻求帮助。

例子 - 安装次要版本

次要版本包含新功能、质量修正和安全修正。使用 Composer 来指定一个次要版本。例如，指定Adobe Commerce 2.4.5元包：

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

例子 - 安装补丁版本

质量补丁主要包含功能和安全方面的修复。然而，它们有时也可能包含新的、向后兼容的功能。使用Composer来下载一个质量补丁。例如，指定Adobe Commerce 2.4.5元包：

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

例子 - 安装安全补丁版本

安全补丁只包含安全修复。它们是为了使升级过程更快、更容易。

安全补丁使用 Composer 的命名规则 2.4.5-px。使用 Composer 来指定一个补丁。例如，要下载 Adobe Commerce 2.4.5-p1 元包：

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

设置文件权限

在安装 Adobe Commerce 或 Magento Open Source 之前，必须为 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 或 Magento Open Source。

这个例子假设安装目录名为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 选项来定制管理URI。但是建议省略这个选项，让安装命令自动生成一个随机 URI。一个随机的 URI 对于黑客或恶意软件来说更难被利用。安装完成后，URI 会显示在你的控制台。

magento 命令汇总

要显示完整的命令列表，请输入：

bin/magento list

要获得某个特定命令的帮助，请输入：

bin/magento help <command>

例如 bin/magento help setup:install 、bin/magento help cache:enable