快速入门

Magento是一款开源电商网站框架，其丰富的模块化架构体系及拓展功能可为大中型站点提供解决方案。

准备

部署 Magento 应用镜像完成之后，需完成如下的准备工作：

1. 在云控制台获取您的 服务器公网IP地址
2. 在云控制台安全组中，确保 Inbound（入）规则 下的 TCP:80 端口已经开启

安装向导

Tip

magento 2.4 版本后官方不再支持 WEB 向导模式安装仅支持命令安装，应用镜像默认将 magento 安装配置好。

如需使用外部数据库（如云厂商提供的云数据库或者自建其他远程数据库），请参考以下操作：

1. 删除初始化安装生成的 magento 配置文件

   rm -rf /var/www/magento/app/env.php
   

2. 进入 magento 目录

   cd /var/www/magento
   

3. 修改并执行以下命令

   bin/magento setup:install \
   --base-url=http://www.xxx.com/ \     # 网站Url
   --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                     # 使用伪静态
   

管理/配置指南

magento 配置 Redis 缓存

Tip

应用镜像已配置本地 Redis 缓存，使用远程 Redis 或者 云服务商提供的 Redis,参考命令修改主机地址、端口、密码、数据库名等信息

以下操作命令请在 /var/www/magento 目录中执行

1. 配置后端使用 Redis 缓存

   bin/magento setup:config:set \
   --cache-backend=redis \
   --cache-backend-redis-server=127.0.0.1 \          # redis 主机地址
   --cache-backend-redis-port=6379  \                # redis 主机端口（可选）
   --cache-backend-redis-db=0 \                      # redis 数据库编号,建议默认缓存数据库编号分配给 0
   --cache-backend-redis-password=redis_password \   # redis 密码（可选）
   

2. 配置页面使用 Redis 缓存

   bin/magento setup:config:set \
   --page-cache=redis \
   --page-cache-redis-server=127.0.0.1 \            # redis 主机地址
   --page-cache-redis-port=6379  \                  # redis 主机端口（可选）
   --page-cache-redis-db=1 \                        # redis 数据库编号,建议页面缓存数据库编号分配给 1
   --page-cache-redis-password=redis_password \     # redis 密码（可选）
   

3. 配置会话存储(session storage)使用 Redis

   bin/magento setup:config:set \
   --session-save=redis \
   --session-save-redis-host=127.0.0.1 \            # redis 主机地址
   --session-save-redis-port=6379  \                # redis 主机端口（可选）
   --session-save-redis-db=2    \                   # redis 数据库编号,建议会话存储缓存数据库编号分配给 2
   --session-save-redis-password=redis_password \   # redis 密码（可选）
   --session-save-redis-log-level=4                 # 会话日志级别
   

详细请参考:

Use Redis for the Magento page and default cache

Use Redis for session storage

配置 STMP 邮箱

1. 安装 SMTP 扩展

   cd /var/www/magento/ 
   composer require mageplaza/module-smtp
   php bin/magento setup:upgrade
   php bin/magento setup:static-content:deploy
   

2. 启用 STMP：登录到 Magento 管理面板，转到 Mageplaza > SMTP > Configuration > General Configuration 配置 "Enable Mageplaza SMTP" 为 YES
3. 配置 SMTP：在常规配置区域，向下滚动找到 "SMTP Configuration Options"

详细参考: SMTP Configuration Options

重置 Magento 管理员密码

执行下面命令修改原有或新增管理员用户

cd /var/www/magento/;
bin/magento admin:user:create \
--admin-user="admin" \
--admin-password="new_password" \
--admin-email="admin@admin.com" \
--admin-firstname="Admin" \
--admin-lastname="Admin"

关闭 TwoFactor Auth（双因素认证）

Tip

镜像应用默认关闭 TwoFactor Auth，若有需要开启，将下面命令中的disable 修改为 enable

cd /var/www/magento/

bin/magento module:disable Magento_TwoFactorAuth

配置域名

1. 前置条件：完成域名解析
2. Apache 域名绑定
3. 登录 Magento 后台,STORES -> Configuration -> Web,修改 Base URL 以及 Secure Base URL (未配置HTTPS也需要修改)

开启生产模式（优化）

Magento 有三种部署模式：Default、Developer 和 Production 模式。速度最快的是 Production 模式，Default、Develope 模式用于调试不建议使用在生产环境中。

• Default – Default 是默认启动的模式，单服务器部署 magento 无需修改，但未对生产进行优化
• Developer – Developer 模式为开发模式，开发人员使用
• Production – Production 模式用于生产部署也是最安全和速度最快的模式，但是一些设置以及页面改动无法操作。

建议在 Default 模式下修改配置以及部署调试，商城上线时建议修改为 Production 模式

以下操作命令请在 /var/www/magento 目录中执行

# 查看当前模式
sudo -u apache bin/magento deploy:mode:show   

# 修改为 production 模式
sudo -u apache bin/magento deploy:mode:set production 

# 修改为 default 模式
sudo -u apache bin/magento deploy:mode:set default   

# 修改为 developer 模式
sudo -u apache bin/magento deploy:mode:set developer 

升级 Magento

Tip

升级 Magento 前需提前做好备份工作（建议直接给云服务器做个快照）

以下操作命令请在 /var/www/magento 目录中执行

1. 切换至维护模式,以防止在升级过程中写入数据

   bin/magento maintenance:enable
   

2. 停止 magento 计划任务

   bin/magento cron:remove
   

3. 备份现在的 composer.json 文件

   cp composer.json composer.json.bak
   

4. 列出可用版本

   composer show magento/product-community-edition 2.4.* --available | grep -m 1 versions
   

5. 升级 magento 实例, 将 <version> 替换需要升级的版本号

   composer require-commerce magento/product-community-edition=<version> --no-update
   

6. 更新依赖项

   composer update
   

7. 清除 var/ 和 generated/ 等缓存目录

   rm -rf var/cache/*
   rm -rf var/page_cache/*
   rm -rf generated/code/*
   

8. 更新数据库数据

   bin/magento setup:upgrade
   

9. 禁用维护模式

   bin/magento maintenance:disable
   

参数

Magento 应用中使用了以下核心组件搭建

• Apache
• PHP
• MySQL
• phpMyAdmin
• Redis
• Elasticsearch

路径

Magento 安装目录： /var/www/magento

Magento 配置文件：/var/www/magento/app/env.php

端口

端口号	用途	必要性
80	HTTP 服务端口	必选
443	HTTPS 服务端口	可选
3306	MySQL 数据库端口	可选
6379	redis 端口	可选
9200、9300	Elasticsearch	可选