手动搭建Magento电子商务网站

Magento是一款开源电商网站框架,其丰富的模块化架构体系及拓展功能可为大中型站点提供解决方案。Magento使用PHP开发,支持版本范围从PHP 5.6到PHP 7.1,并使用MySQL存储数据。本教程主要介绍如何在CentOS 7操作系统的ECS实例上搭建Magento电子商务网站。

前提条件

  • 已注册阿里云账号。如还未注册,请先完成账号注册

  • 已完成实名认证。如还未认证,请先完成实名认证

  • 已在ECS实例安全组的入方向加规则并放行端口80和3306。具体操作,请参见添加安全组规则

    说明

    大多数客户端位于局域网中,IP地址是经过转换的,因此ipconfigifconfig命令返回的IP不一定是客户端的真实公网IP地址。若后续客户端无法访问Magento网站,请重新确认其公网IP地址。

    规则方向

    授权策略

    协议类型

    端口范围

    授权类型

    授权对象

    入方向

    允许

    HTTP(80)

    80/80

    IPv4地址段访问

    所有要访问Magento站点的客户端公网IP地址,多个地址之间用逗号隔开。

    允许所有客户端访问时,授权对象为0.0.0.0/0。

    入方向

    允许

    MySQL(3306)

    3306/3306

    IPv4地址段访问

    所有要访问MySQL数据库服务的客户端公网IP地址,多个地址之间用逗号隔开。

    允许所有客户端访问时,授权对象为0.0.0.0/0。

背景信息

本教程使用的ECS实例硬件配置如下:

  • 实例规格:ecs.c6.large

  • 操作系统:公共镜像CentOS 7.2 64位

  • CPU:2 vCPU

  • 内存:4 GiB

    说明

    搭建Magento服务器,所选实例规格内存不能小于2GiB。

  • 网络类型:VPC

  • IP地址:公网IP

示例步骤使用以下软件版本:

  • Apache:2.4.6

  • MySQL:5.7

  • PHP:7.0

  • Composer:1.8.5

  • Magento:2.1

当您使用不同软件版本时,可能需要根据实际情况调整命令和参数配置。

操作流程

在阿里云ECS实例上搭建Magento电子商务网站的操作流程如下:

步骤一:安装并配置Apache

  1. 安装Apache。

    1. 运行以下命令安装Apache。

      yum install httpd -y
    2. 运行以下命令查看Apache是否安装成功。

      httpd -v

      返回结果如下图所示,表示安装成功。magento_1

  2. 配置Apache。

    1. 运行以下命令打开Apache配置文件。

      vim /etc/httpd/conf/httpd.conf
    2. Include conf.modules.d/*.conf的下一行,添加LoadModule rewrite_module modules/mod_rewrite.so。具体步骤如下:

      1. 移动光标到Include conf.modules.d/*.conf下一行的行首。

      2. 按下i键进入编辑模式。

      3. 输入LoadModule rewrite_module modules/mod_rewrite.so

      添加后的内容,如下图所示。local_module

    3. 将下列内容中的AllowOverride None更改为AllowOverride All

      # AllowOverride controls what directives may be placed in .htaccess files.
      # It can be "All", "None", or any combination of the keywords:
      # Options FileInfo AuthConfig Limit
      #
      #在行首添加#注释掉本行内容
      #AllowOverride None
      
      #添加下列内容
      AllowOverride All

      修改后的内容,如下图所示。allowoverride_all

    4. 按下Esc键后,输入:wq并回车以保存并关闭配置文件。

  3. 运行以下命令启动Apache服务。

    systemctl start httpd
  4. 运行以下命令添加Apache服务开机自启动。

    systemctl enable httpd

步骤二:安装并配置MySQL

  1. 安装MySQL。

    1. 运行以下命令添加MySQL YUM源。

      rpm -Uvh https://dev.mysql.com/get/mysql57-community-release-el7-8.noarch.rpm
    2. 运行以下命令安装MySQL。

      yum -y install mysql-community-server --nogpgcheck
  2. 运行以下命令启动MySQL服务。

    systemctl start mysqld
  3. 运行以下命令设置MySQL服务开机自启动。

    systemctl enable mysqld
  4. 配置MySQL。

    1. 运行以下命令查看/var/log/mysqld.log文件,获取并记录root用户的初始密码。

      grep 'temporary password' /var/log/mysqld.log

      命令的返回结果如下:

      2016-12-13T14:57:47.535748Z 1 [Note] A temporary password is generated for root@localhost: p0/G28g>lsHD
      说明

      下一步重置root用户密码时,会使用该初始密码。

    2. 运行下列命令配置MySQL的安全性。

      mysql_secure_installation

      安全性的配置包含以下五个方面:

      1. 设置root账号密码。

        Enter password for user root: #输入上一步中获取的root用户密码
        The 'validate_password' plugin is installed on the server.
        The subsequent steps will run with the existing configuration of the plugin.
        Using existing password for root.
        Estimated strength of the password: 100 
        Change the password for root ? ((Press y|Y for Yes, any other key for No) : Y #是否更改root用户密码,输入Y
        New password: #输入密码,长度为8至30个字符,必须同时包含大小写英文字母、数字和特殊符号。特殊符号可以是()` ~!@#$%^&*-+=|{}[]:;‘<>,.?/
        Re-enter new password: #再次输入密码
        Estimated strength of the password: 100 
        Do you wish to continue with the password provided?(Press y|Y for Yes, any other key for No) : Y
      2. 输入Y删除匿名用户账号。

        By default, a MySQL installation has an anonymous user, allowing anyone to log into MySQL without having to have a user account created for them. This is intended only for testing, and to make the installation go a bit smoother. You should remove them before moving into a production environment.
        Remove anonymous users? (Press y|Y for Yes, any other key for No) : Y  #是否删除匿名用户,输入Y
        Success.
      3. 输入Y禁止root账号远程登录。

        Disallow root login remotely? (Press y|Y for Yes, any other key for No) : Y #禁止root远程登录,输入Y
        Success.
      4. 输入Y删除test库以及对test库的访问权限。

        Remove test database and access to it? (Press y|Y for Yes, any other key for No) : Y #是否删除test库和对它的访问权限,输入Y
        - Dropping test database...
        Success.
      5. 输入Y重新加载授权表。

        Reload privilege tables now? (Press y|Y for Yes, any other key for No) : Y #是否重新加载授权表,输入Y
        Success.
        All done!

      更多详情,请参见MySQL文档

步骤三:安装并配置PHP

  1. 安装PHP。

    1. 运行以下命令添加ius源。

      yum install \
      https://repo.ius.io/ius-release-el7.rpm \
      https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
    2. 运行以下命令添加Webtatic源。

      rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm
    3. 运行以下命令安装PHP7及所需扩展。

      yum -y install php70w php70w-pdo php70w-mysqlnd php70w-opcache php70w-xml php70w-gd php70w-mcrypt php70w-devel php70w-intl php70w-mbstring php70w-bcmath php70w-json php70w-iconv
    4. 运行以下命令查看PHP版本。

      php -v

      返回结果如下所示,说明PHP安装成功。

      PHP 7.0.33 (cli) (built: Dec  6 2018 22:30:44) ( NTS )
      Copyright (c) 1997-2017 The PHP Group
      Zend Engine v3.0.0, Copyright (c) 1998-2017 Zend Technologies
          with Zend OPcache v7.0.33, Copyright (c) 1999-2017, by Zend Technologies                        
  2. 配置PHP。

    1. 运行以下命令打开PHP配置文件。

      vim /etc/php.ini
    2. 移动光标至最后一行的行尾。具体操作步骤如下:

      1. 输入:$并回车,光标将移动至文件最后一行。

      2. 按下$移动光标至行尾。

    3. 按下i键进入编辑模式。

    4. 在文件最后添加关于内存限制和时区的配置。

      ; 允许为PHP脚本分配的最大内存值。您可根据实际情况增加或减少内存限制
      memory_limit = 1024M
      ; 设置时区为上海
      date.timezone = Asia/Shanghai

      添加后如下图所示。magento_2

    5. 按下Esc键后,输入:wq并回车以保存并关闭文件。

    6. 重启Apache服务。

      systemctl restart httpd

步骤四:创建Magento数据库

  1. 运行以下命令使用root用户和密码登录MySQL。

    mysql -u root -p
  2. 运行以下命令创建magento数据库。

    mysql> CREATE DATABASE magento; #根据实际情况将magento替换为您需要创建的数据库名称
  3. 依次运行以下命令为magento数据库创建用户。

    mysql> GRANT ALL ON magento.* TO <YourUser>@localhost IDENTIFIED BY '<YourPass>'; #替换<YourUser>和<YourPass>为您需要创建的账号和密码
    mysql> FLUSH PRIVILEGES;

    例如,创建账号为magentoUser、密码为magentoUser1@3的用户,运行的命令为:

    mysql> GRANT ALL ON magento.* TO magentoUser@localhost IDENTIFIED BY 'magentoUser1@3';
    mysql> FLUSH PRIVILEGES;
  4. 输入exit并回车以退出MySQL。

  5. 可选:验证新建的Magento数据库和用户是否可用。具体步骤如下:

    1. 运行以下命令使用新建账号和密码登录MySQL。

      mysql -u <YourUser> -p   #替换<YourUser>为您创建的账号
    2. 运行以下命令查看新建的magento数据库。

      mysql> show databases;
      +--------------------+
      | Database           |
      +--------------------+
      | information_schema |
      | magento            |
      +--------------------+
      2 rows in set (0.00 sec)
    3. 运行以下命令并回车以退出MySQL。

      mysql> exit

步骤五:安装并配置Composer

Composer是PHP的一个依赖管理工具。Composer允许您声明项目所依赖的代码库,并帮您在项目中安装依赖的代码库。

  1. 运行以下命令安装Composer。

    curl -sS https://getcomposer.org/installer | php
  2. 运行以下命令配置Composer全局使用。

    mv /root/composer.phar /usr/bin/composer
  3. 运行命令composer -v查看Composer版本。

    返回结果如下,表示Composer安装成功。

      / ____/___  ____ ___  ____  ____  ________  _____
     / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
    / /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
    \____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                        /_/
    Composer version 1.8.5 2019-04-09 17:46:47
                            
    说明

    因最新版Composer与Magento暂不兼容,所以您需要安装与Magento兼容的Composer版本。您可以使用以下命令来让最新版Composer转换至兼容版本,例例如Composer 1.8.5版本。

    composer self-update 1.8.5

步骤六:安装配置Magento

您可以使用不同的方法安装Magento,可以选择是否安装示例数据。

  • 如果安装Magento仅用于测试,您可以选择安装示例数据。

  • 如果安装Magento用于生产环境,建议您安装全新的Magento,从头开始配置。

本教程介绍使用Git下载Magento,并使用Composer安装Magento的操作步骤。

  1. 下载Magento。

    1. 运行以下命令安装Git。

      yum -y install git
    2. 进入Web服务器的默认根目录。

      cd /var/www/html/
    3. 下载Magento。

      git clone https://github.com/magento/magento2.git
  2. 可选:运行以下命令将Magento切换到稳定版本。

    cd magento2 &&  git checkout tags/2.1.0 -b 2.1.0

    命令执行后的结果如下:

    Switched to a new branch '2.1.0'
    说明

    默认情况下,Git下载安装的Magento是最新的开发版本。如果您在生产环境中使用,建议切换到稳定版本,否则未来将无法升级安装。

  3. 运行以下命令将安装文件移到Web服务器根目录下。

    shopt -s dotglob nullglob && mv /var/www/html/magento2/* /var/www/html/ && cd ..
    说明

    运行此命令后,您可以通过https://<ECS实例公网IP地址>访问您的Magento站点。否则,您只能通过https://<ECS实例公网IP地址>/magento2访问。

  4. 依次运行下列命令为Magento文件设置适当的权限。

    chown -R :apache /var/www/html
    find /var/www/html -type f -print0 | xargs -r0 chmod 640
    find /var/www/html -type d -print0 | xargs -r0 chmod 750
    chmod -R g+w /var/www/html/{pub,var}
    chmod -R g+w /var/www/html/{app/etc,vendor}
    chmod 750 /var/www/html/bin/magento
  5. 运行命令composer install安装Magento。

步骤七:配置Magento客户端

  1. 打开浏览器。

  2. 在浏览器地址栏中,输入http://<ECS实例公网IP地址>

    出现如下图所示页面,表示Magento安装成功。magento_3

  3. 单击Agree and Setup Magento开始配置Magento。具体步骤如下:

    1. 准备性检查。

      1. 单击Start Readiness Check

      2. 检查完成后,单击Next

      magento-check

    2. 添加数据库。

      1. 输入之前创建的数据库用户的账号和密码。本教程中创建的示例用户账号为magentoUser、密码为magentoUser1@3

      2. 输入之前创建的数据库的名字。本教程中创建的示例数据库名字为magento

      3. 单击Next

      config-db

    3. 填写Web访问设置,并单击Next

      config-web

    4. 填写定制商店,并单击Next

    5. 填写管理员账号信息,并单击Next

    6. 单击Install Now进行安装。

出现如下图所示界面,表示Magento配置完成。magento_4

步骤八:添加cron作业

完成以下操作,添加cron作业:

  1. 运行crontab -u apache -e设置cron运行调度工作。

  2. 按下i键进入编辑模式。

  3. 输入下列配置信息。

    */10 * * * * php -c /etc /var/www/html/bin/magento cron:run
    */10 * * * * php -c /etc /var/www/html/update/cron.php
    */10 * * * * php -c /etc /var/www/html/bin/magento setup:cron:run
  4. 按下Esc键后,输入:wq并回车以保存并退出。

Magento上使用cron作业的更多详情,请参见Magento官方文档

常见问题

输入http://<ECS实例公网IP地址>/admin登录Magento后台,如果界面提示“One or more indexers are invalid. Make sure your Magento cron job is running.”的错误信息,请参考以下步骤解决问题。123

  1. 远程连接Magento服务器。具体操作,请参见ECS远程连接方式概述

  2. 运行以下命令,将PHP的安装路径建立软连接至/usr/sbin/php目录下。

    ln -s /usr/local/php/bin/php /usr/sbin/php
  3. 运行以下命令,刷新索引。

    cd /var/www/html
    php bin/magento indexer:reindex

    回显信息类似如下所示,表示索引已刷新成功。

    [root@iZbp1h2mquu8nb0jz99**** wwwroot]# php bin/magento indexer:reindex
    Design Config Grid index has been rebuilt successfully in 00:00:00
    Customer Grid index has been rebuilt successfully in 00:00:00
    Category Products index has been rebuilt successfully in 00:00:00
    Product Categories index has been rebuilt successfully in 00:00:00
    Product Price index has been rebuilt successfully in 00:00:00
    Product EAV index has been rebuilt successfully in 00:00:00
    Stock index has been rebuilt successfully in 00:00:00
    Catalog Rule Product index has been rebuilt successfully in 00:00:00
    Catalog Product Rule index has been rebuilt successfully in 00:00:00
    Catalog Search index has been rebuilt successfully in 00:00:00
  4. 刷新页面后,单击Cache Managementdaad

  5. 选中状态为INVALIDATEDCache Types,并单击Submit456当出现类似如下返回信息时,表示问题已经解决。455

后续步骤

  • 访问http://<ECS实例公网IP地址>可以看到如下图所示的默认主页。luma

  • 访问http://<ECS实例公网IP地址>/admin,输入您在安装过程中设置的用户名和密码,成功登录管理面板后可看到如下界面。dashboard