本页内容

  • 先决条件
  • 安装 LEMP 环境
  • 设置 MariaDB root 密码
  • 为 Bagiosto 创建新数据库和用户
  • 安装 Composer 工具
  • 使用 Composer 安装 Bagisto eCommerce
  • 配置 Nginx Web 服务器
  • 验证 Bagisto eCommerce
  • 结论

Bagisto 是一款免费开源的 eCommerce 软件,采用 Laravel PHP 框架编写,并使用 Vue.js —— 一个渐进式 JavaScript 框架。Bagisto 是一个精心定制的电商系统,能让你快速搭建自己的在线商店。它快速、响应式、前端美观且易于使用。Bagisto 是一个电商框架,为不同类型的语言提供多种区域设置,支持多种货币、多种商店主题,还提供多商店库存系统这一功能。

在本教程中,我们将向你展示如何在 Debian 11 Bullseye 上安装 Bagisto eCommerce。我们将使用 PHP-FPM、Nginx Web 服务器和 MariaDB 数据库。

先决条件

  • 最新版本的 Debian 11 Bullseye。
  • 一个拥有 root/sudo 权限的用户。
  • 一个指向你服务器 IP 地址的域名。

安装 LEMP 环境

首先,你将在 Debian 服务器上安装 LEMP 环境。当前版本的 Bagisto eCommerce 要求 PHP 7.4 或更高版本、MariaDB 10.2.17 或更高版本,以及 Nginx Web 服务器。

在开始安装软件包之前,使用以下命令更新你的软件仓库。

sudo apt update

现在使用下面的 apt 命令安装 PHP-FPM、Nginx Web 服务器和 MariaDB 数据库。

sudo apt install nginx-full mariadb-server php-fpm php-cli php-common php-zip php-mysql php-gd php-intl php-curl php-imap php-mbstring php-xml php-json libpcre3 git unzip -y

所有软件包安装完成后,使用 nano 编辑器编辑 PHP 配置文件 ' php.ini '。

sudo nano /etc/php/7.4/fpm/php.ini
sudo nano /etc/php/7.4/cli/php.ini

现在根据你的当前环境修改以下选项。

memory_limit = 512M
max_execution_time = 360
date.timezone = America/Toronto

接下来,重启 PHP-FPM 服务以应用新配置。

sudo systemctl restart php7.4-fpm

至此你已完成基础 LEMP 环境的安装,它将用于 Bagisto eCommerce。

设置 MariaDB root 密码

在 Debian 服务器上安装好 LAMP 环境后,你将为 MariaDB 数据库设置 root 密码。设置 MariaDB root 密码的推荐方式是使用命令行工具 ' mysql_secure_installation '。

运行下面的 ' mysql_secure_installation ' 命令。

mysql_secure_installation

现在系统会询问你几个问题:

  • 按 ENTER 键设置 MariaDB 的 root 密码。
  • 输入 ' Y ' 以使用 ' unix_socket_authentication ' 方法切换 root 用户的认证方式。
  • 输入 ' Y ' 设置 MariaDB root 密码,然后输入密码并重复确认。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

  • 输入 ' Y ' 删除 MariaDB 匿名用户。
  • 输入 ' Y ' 禁用 root 用户的远程登录。
  • 再次输入 ' Y ' 删除默认数据库 ' test ' 及其上的所有权限。
  • 输入 ' Y ' 重新加载所有表的权限以应用新更改。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

至此你已完成 MariaDB 数据库的基础安全部署。

为 Bagiosto 创建新数据库和用户

配置好 MariaDB 数据库后,现在你将为 Bagisto eCommerce 创建一个新的数据库和用户。你需要登录到 MariaDB shell 来创建新的数据库和用户。

使用以下命令以 'root' 用户身份登录 MariaDB shell。

mysql -u root -p

现在运行以下查询,创建新的数据库 ' basgisto ' 和用户 ' bagistouser ',密码为 ' BagistoPassword '。

CREATE DATABASE bagisto;
CREATE USER bagistouser@localhost IDENTIFIED BY 'BagistoPassword';

接下来,允许数据库用户 ' bagistouser ' 访问并写入数据库 ' bagisto ',然后重新加载所有表的权限。这是为了让 MariaDB 权限的新更改生效。

GRANT ALL ON bagisto.* TO bagistouser@localhost WITH GRANT OPTION;
FLUSH PRIVILEGES;

现在输入 ' exit ' 退出 MariaDB Shell。至此你已为 Bagisto 安装创建了新的数据库和用户。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

安装 Composer 工具

在这一步,你将在 Debian 系统上安装 Composer。安装 Bagisto eCommerce 需要用到 Composer。

运行下面的 ' php ' 命令下载 Composer 的安装脚本。此命令还会校验安装脚本。请确保屏幕上出现 'Installer verified ' 消息。

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '906a84df04cea2aa72f40b5f787e49f22d4c2f19492ac310e8cba5b96ac8b64115ac402c8cd292b8a03482574915d1a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

现在,运行安装脚本 ' composer-setup.php ' 来安装 Composer,然后删除脚本 ' composer-setup.php '。

php composer-setup.php
php -r "unlink('composer-setup.php');"

安装脚本会下载二进制文件 ' composer.phar '。将 ' composer.phar' 移动并重命名为 ' /usr/local/bin/composer '。

sudo mv composer.phar /usr/local/bin/composer

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

要验证 Composer 安装,运行下面的 ' composer ' 命令。

sudo -u www-data composer --version

你将看到如下截图所示的 Composer 版本输出。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

现在你已在服务器上安装好 Composer,可以开始使用 Composer 安装 Bagisto eCommerce 了。

使用 Composer 安装 Bagisto eCommerce

在这一步,你将通过 Composer 手动安装 Bagisto eCommerce。

在 ' /var/www/ ' 目录下创建新目录 ' .cache ' 和 '.config ',并将这两个目录的所有权改为 ' www-data '。它们将用于存放 Composer 的缓存和配置。

mkdir -p /var/www/{.cache,.config}
sudo chown -R www-data:www-data /var/www/{.cache,.config}

接下来,创建 '/var/www/project' 目录并将所有权改为 ' www-data '。你将在此目录中安装 Bagisto eCommerce。

mkdir -p /var/www/project; sudo chown -R www-data:www-data /var/www/project

将当前工作目录切换到 '/var/www/project',然后运行下面的 Composer 命令,下载并安装 Bagisto 源代码及所有额外的 PHP 依赖。

cd /var/www/project
sudo -u www-data composer create-project bagisto/bagisto

下载过程完成后,你将看到以下输出。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

接下来,切换到 '/var/www/project/bagisto ' 目录,使用 nano 编辑器编辑 ' .env' 文件。

cd /var/www/project/bagisto
sudo nano .env

将 ' APP_NAME ' 的值改为你自己的信息,并将 ' APP_ENV ' 改为 ' production '。

APP_NAME=Bagisto
APP_ENV=production

将 'APP_DEBUG ' 改为 ' false ',并在 ' APP_URL ' 中填入你的安装 URL。

APP_DEBUG=false
APP_URL=https://www.example.io

按如下方式填写 Bagisto 安装的详细数据库信息。

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=bagisto
DB_USERNAME=bagistouser
DB_PASSWORD=BagistoPassword
DB_PREFIX=

保存配置并退出。

现在,使用以下命令安装 Bagisto eCommerce。

sudo -u www-data php artisan bagisto:install

系统会要求你确认运行安装命令。输入 ' yes ' 进行确认。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

输入 ' yes ' 以在生产环境中部署 Bagisto eCommerce。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

安装过程完成后,你将获得 Bagisto 安装的默认管理员用户和密码。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

最后,你可以运行以下命令,确保 Bagisto 安装目录 ' /var/www/project/bagisto ' 的所有权归属于 ' www-data '。

sudo chown -R www-data:www-data /var/www/project/bagisto

至此你已完成 Bagisto eCommerce 的安装。继续下一步配置 Nginx Web 服务器。

配置 Nginx Web 服务器

在这一步,你将为 Bagisto eCommerce 创建一个新的 Nginx server block。Nginx Web 服务器是处理电商等复杂 CMS 的最佳方案之一,因为它轻量且快速。

使用 nano 编辑器创建新的 server block 配置文件 ' bagisto '。

sudo nano /etc/nginx/sites-available/bagisto

复制并粘贴以下配置。请务必将 URL 和 SSL 证书路径改为你自己的。

server {
    listen 80;
    server_name example.io;
    return 302 https://$server_name$request_uri;
}
server {
  listen 443 ssl http2;
    server_name  example.io;
    root   /var/www/bagisto/public;
    index  index.php;
  ssl_certificate /etc/letsencrypt/live/example.io/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/example.io/privkey.pem;
  ssl_protocols TLSv1.2;
  ssl_prefer_server_ciphers on;
  ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384;
  ssl_ecdh_curve secp384r1; # Requires nginx >= 1.1.0
  ssl_session_timeout  10m;
  ssl_session_cache shared:SSL:10m;
  ssl_session_tickets off; # Requires nginx >= 1.5.9
  # ssl_stapling on; # Requires nginx >= 1.3.7
  # ssl_stapling_verify on; # Requires nginx => 1.3.7
  resolver 8.8.8.8 8.8.4.4 valid=300s;
  resolver_timeout 5s;
  add_header X-Frame-Options DENY;
  add_header X-Content-Type-Options nosniff;
  add_header X-XSS-Protection "1; mode=block";
    access_log /var/log/nginx/example.com.access.log;
    error_log /var/log/nginx/example.com.error.log;
    client_max_body_size 100M;
    autoindex off;
    location / {
    try_files $uri /index.php$is_args$args;
      }
    location ~ \.php$ {
         include snippets/fastcgi-php.conf;
         fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
         include fastcgi_params;
         fastcgi_intercept_errors on;
    }
}

保存配置文件并退出。

接下来,使用以下命令启用 ' bagisto ' server block,然后校验 Nginx 配置。

sudo ln -s /etc/nginx/sites-available/bagisto /etc/nginx/sites-enabled/
sudo nginx -t

如果没有出现错误,你将看到类似 ' Syntax OK ' 的输出消息。

最后,重启 Nginx 服务以应用新的虚拟主机配置。

sudo systemctl restart nginx

至此你已完成 Bagisto eCommerce 的 Nginx 配置,现在可以通过你的域名访问了。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

验证 Bagisto eCommerce

要验证 Bagisto eCommerce 安装,请打开 Web 浏览器,在地址栏中输入你安装的域名。

https://www.example.io/

你将看到如下的 Bagisto eCommerce 默认主页。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

接下来,打开一个新标签页,访问你 Bagisto eCommerce 安装的管理页面。

https://www.example.io/admin

输入 Bagisto 默认用户 ' admin ' 和密码 ' admin123 ',然后点击 ' Sign In '。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

随后你将看到 Bagisto eCommerce 的管理后台仪表盘。

在 Debian 11 上安装部署 Bagisto 电商系统完整教程

结论

恭喜!你现在已经在 Debian 11 Bullseye 系统上,使用 PHP-FPM、Nginx 和 MariaDB 安装好了 Bagisto eCommerce。现在你可以开始为你的 Bagisto eCommerce 添加商品并设置支付插件了。