本页内容
- 先决条件
- 安装 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 密码,然后输入密码并重复确认。

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

至此你已完成 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 安装创建了新的数据库和用户。

安装 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;"

现在,运行安装脚本 ' 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

要验证 Composer 安装,运行下面的 ' composer ' 命令。
sudo -u www-data composer --version
你将看到如下截图所示的 Composer 版本输出。

现在你已在服务器上安装好 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
下载过程完成后,你将看到以下输出。

接下来,切换到 '/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 ' 进行确认。

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

安装过程完成后,你将获得 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 配置,现在可以通过你的域名访问了。

验证 Bagisto eCommerce
要验证 Bagisto eCommerce 安装,请打开 Web 浏览器,在地址栏中输入你安装的域名。
https://www.example.io/
你将看到如下的 Bagisto eCommerce 默认主页。

接下来,打开一个新标签页,访问你 Bagisto eCommerce 安装的管理页面。
https://www.example.io/admin
输入 Bagisto 默认用户 ' admin ' 和密码 ' admin123 ',然后点击 ' Sign In '。

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

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