如何在本地用 XAMPP 安装和配置 Magento 2

Magento 2 是一个非常强大的电子商务平台，但其服务器要求较为复杂，尤其是需要通过 Composer（是一个 PHP 软件包管理系统，） 进行安装，这在许多平台上并非默认配置。如果想在本地搭建一个开发和测试环境，可以使用 XAMPP，这是一款免费开源的跨平台 Web 服务器解决方案。

本地运行 Magento 2 的好处

在本地安装 Magento 2 有许多优点，包括：

1. 节省成本：无需购买专用的服务器。
2. 离线开发：可在无网络连接的情况下对网站进行开发和测试。
3. 安全测试：测试新功能或扩展时，不会影响生产环境。
4. 定制开发：可以放心进行各种自定义而不会导致实际站点崩溃。
5. 性能更快：由于没有网络延迟，本地环境的响应速度通常优于远程服务器。
6. 安全性：防止未经授权的访问和黑客攻击。
7. 轻松备份和恢复：可以快速备份和恢复本地站点，减少风险。

Magento 2 的本地安装前置要求

在安装 Magento 2 之前，需要确保以下组件和系统配置满足要求：

• Apache/NGINX 版本 2.2 或 2.4
• PHP 版本 7.4.x 或 8.1.x
• MySQL/MariaDB 版本 5.6.x、5.7.x 或 Maria DB
• Elasticsearch 7.6.x 或更高版本

安装并设置 XAMPP

在本地安装 Magento 2 的方法.

步骤：1 下载 XAMPP 服务器

前往 Apache Friends 并下载 XAMPP 服务器。

Magento 强烈建议为 M2.4.5 安装 XAMPP 和 PHP 8.1.x 版本。此外，可以安装 Magento 2.4 和 PHP 7.3，但没有经测试或推荐。

步骤：2 安装 XAMPP

下载 XAMPP 后，双击该文件将其安装到你的电脑上。

单击下一步按钮。

保留图中的默认选择。单击下一步按钮。

选择安装文件夹。默认位置是C:\xampp ，但建议根据自己的方便选择C:\驱动器以外的目录，例如D:\或E:\ 。

如果需要更改，请单击浏览图标更改XAMPP程序的目标位置，然后单击下一步按钮进入下一步。

单击下一步按钮。

单击下一步按钮。

等待安装向导在你的电脑上安装 XAMPP。

安装完成后，会看到选项“是否要立即启动控制面板？ ”。保持选中状态。单击“完成”退出安装并进入XAMPP 控制面板。

步骤：3 配置PHP

在XAMPP 控制面板中，单击Apache行上的配置按钮，然后单击PHP (php.ini)。

在php.ini文件中，找到以下行并删除每行前的分号 ：

;extension=intl

;extension=soap

;extension=sockets

;extension=sodium

;extension=xsl

;extension=gd

将memory_limit扩大到4G：

memory_limit=4G

完成后，保存并关闭文件。然后，单击 Apache 和 MySQL 两行上的“开始”按钮来启动它们。这个步骤完成后不要退出 XAMPP，只需让它运行即可。

步骤：4 配置 Hosts 文件

访问目录C:\Windows\System32\drivers\etc\hosts。

在最后一行添加以下行：

127.0.0.1 www.localhost.com

打开XAMPP 控制面板并启动Apache和MySQL应用程序。

在 phpMyAdmin 中创建数据库

访问 URL http://localhost/phpmyadmin，创建数据库。输入数据库名称（例如，Magento2）并单击创建。

单击下一步按钮创建数据库。

数据库创建成功。

注意：记住要创建的数据库的名称，因为后面需要在上安装 Magento。

安装 Magento 的 Composer

Magento 的最新版本，开源 2.4.0 及以上版本，与 Composer 2 兼容。所以，要安装 Composer 2 才能下载最新版本的 Magento 2。

最好的方法是下载并运行Composer-Setup.exe。这会安装最新版本并设置从任意目录“调用”Composer 的路径。

单击下一步按钮并浏览XAMPP文件夹中的PHP路径。

可以选择输入代理 URL。

单击“安装”按钮进行最后一步。

单击下一步按钮。

单击完成按钮。

启动命令提示符并运行 Composer 命令以验证它是否已安装且没有任何问题。

使用 Composer 下载 Magento

接下来，cd 到C:\xampp\htdocs并使用 Composer 运行以下命令来下载特定的 Magento 2 版本。

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

Magento 开源

composer create-project --repository-url=https://repo.magento.com/magento/project-community-edition:2.4.5

Adobe Commerce（企业版）

composer create-project --repository-url=https://repo.magento.com/magento/project-enterprise-edition:2.4.5

通过上述命令，可以指定 Magento 的具体版本（2.0、2.1、2.2.1、2.2.2、2.2.3、2.2.4、2.2.5、2.2.6、2.3、2.4）。如果没有，就跳过版本并直接运行下面这行命令：

接下来，输入你的 Magento 身份验证密钥。公钥和私钥在Magento 市场帐户中创建和配置。找到到页面右上角的帐户名称并选择我的个人资料。

接下来，单击“市场”选项卡中的访问密钥。

单击“创建新访问密钥”，输入密钥的具体名称（例如接收密钥的开发者名称），单击“确定”。

复制用户名中的公钥和密码中的私钥来安装 Magento。

编写器需要一段时间来下载并安装所有必要的模块。都完成后，就可以看到以下这些内容：

给 Magento 2 安装 Elasticsearch

Elasticsearch 是 Magento 2.4.X 版本推荐的扩展。

下载 Elasticsearch 7.6.0：https://www.elastic.co/downloads/past-releases/elasticsearch-7-6-0（Magento 2.4.x 仅在 Elasticsearch 7.6.x 中测试过。可以自行决定使用其他 7.x 版本，但建议使用经过测试的 Elasticsearch 版本。）

解压刚刚下载的 .zip 文件。在终端窗口中，进入解压的目录并运行以下命令：

.\bin\elasticsearch.bat

还可以检查端口 9200上 Elasticsearch 的可用性。在浏览器中输入local:9200，会获得已安装的 Elasticsearch 扩展的详细信息。

{"name" : "DESKTOP-Jyoti","cluster_name" : "elasticsearch","cluster_uuid" : "ONNrUlTWQCSoigYBy6WF9g","version" : {"number" : "7.9.3","build_flavor" : "default","build_type" : "zip","build_hash" : "c41E4fgiueQSoiytrBW","build_date" : "2023-02-02T09:51:41.449Z","build_snapshot" : false,"lucene_version" : "8.7.0","minimum_wire_compatibility_version" : "6.8.3","minimum_index_compatibility_version" : "6.8.3"},"tagline" : "You Know, for Search"}

用命令安装Magento 2

打开命令提示符窗口。接下来，进入 Magento 目录并执行以下命令：

php bin/magento setup:install --base-url="http://localhost/magento2/" --db-host="localhost" --db-name="dbmagento241" --db-user="root" --admin-firstname="admin" --admin-lastname="admin" --admin-email="user@example.com" --admin-user="admin" --admin-password="admin123" --language="en_US" --currency="USD" --timezone="America/Chicago" --use-rewrites="1" --backend-frontname="admin" --search-engine=elasticsearch7 --elasticsearch-host="localhost" --elasticsearch-port=9200

请注意：根据路径分配基本 URL，记下管理员用户名和密码，并且不要用 Elasticsearch 端口。

替换这些值：

• –base-url： magento 2 安装文件夹
• –db-name ：创建数据库时的数据库名称
• –db-password：数据库密码
• –db-user：具有完全权限的数据库用户。一般用默认的 root 用户。
• –db-password：数据库用户的密码。如果用“root”数据库用户，将其留空
• –admin-firstname：管理员名字
• –admin-lastname：管理员姓氏
• –admin-email：管理员电子邮件地址
• –admin-user：用来登录管理面板的用户名
• –admin-password：用于登录管理面板的密码
• –language：在管理面板和店面中使用的语言。使用语言代码，如 en_US。
• –admin-email:将其更改为网站的邮件
• –currency：设置店面使用的默认货币。输入 php bin/magento info:currency:list 获取受支持的货币列表及其代码
• –timezone：更改所在的时区。（如北京时间等）
• –url-rewrites：设置为 1 以启用 Web 服务器重写。这将有助于提高网站排名。
• –backend-frontname：设置网站管理 URL。省略此参数会导致 Magento 管理路径随机生成 URL（例如 admin_jkhgdfq）
• –search-engine：设置要用于此 Magento 安装的 Elasticsearch 版本。默认值为 elasticsearch7
• –elasticsearch-host： Elasticsearch 运行的主机名或 IP 地址。默认为 localhost
• –elasticsearch-port： Elasticsearch 监听的端口号。默认为 9200

其他值是可选的，可以稍后更改它们。

现在，一切顺利的话，Composer 2 将开始安装 Magento 2。这个过程会持续 10 分钟左右。

耐心等待即可，因为安装所有实例和设置 Magento 2.4.5 所需的模块需要一些时间。

安装后，得到这些：

运行命令

现在，需要运行以下命令。

php bin/magento indexer:reindexphp bin/magento setup:upgradephp bin/magento setup:static-content:deploy -fphp bin/magento cache:flush

现在点击 URL（通常是localhost/magento2/pub/）或者在安装过程中为 base-url 设置的基本 URL。

对于管理员：用http://localhost/magento2/pub/admin访问管理后台网址。

总结

通过本文的步骤，可以轻松在本地搭建一个 Magento 2 环境，为开发和测试提供支持。希望这篇教程能帮助您成功安装和运行 Magento 2，如果遇到问题，可以随时在交流社区留言寻求帮助！