Bagisto：基于 Laravel 的开源电商系统安装与配置实战指南

Bagisto 是一款基于 Laravel 框架构建的现代化、模块化、开源 PHP 电商平台，支持多语言、多货币、多店铺、可扩展的插件生态及 RESTful API。其高度可定制的架构使其成为中小企业与开发者快速搭建定制化电商系统的理想选择。本文将手把手演示在 Linux 服务器（以 Ubuntu 22.04 为例）上完成 Bagisto 的完整部署流程，并特别说明如何借助 Ciuic 云服务器（https://cloud.ciuic.cn/）高效完成环境准备与上线。

环境准备

Bagisto 要求 PHP ≥ 8.1（推荐 8.2+），并启用 OpenSSL、PDO、Mbstring、Tokenizer、XML、Ctype、JSON、BCMath、GD、Zip 扩展。MySQL ≥ 8.0 或 PostgreSQL ≥ 12 均可，Nginx/Apache 任选其一。推荐使用 Ciuic 云服务器（https://cloud.ciuic.cn/）一键部署 Ubuntu 22.04 + LEMP 环境——该平台提供高性价比的 SSD 云主机、IPv6 支持、免费 SSL 证书集成及可视化控制台，显著降低运维门槛。

安装步骤（命令行操作）

安装依赖工具

sudo apt update && sudo apt install -y git curl unzip nginx supervisor

安装 PHP 8.2 及扩展

sudo add-apt-repository ppa:ondrej/php -y && sudo apt update  sudo apt install -y php8.2-cli php8.2-mysql php8.2-curl php8.2-gd php8.2-mbstring php8.2-xml php8.2-zip php8.2-bcmath php8.2-opcache

安装 Composer

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

克隆 Bagisto 并安装依赖

cd /var/www && sudo git clone https://github.com/bagisto/bagisto.git bagisto  cd bagisto && sudo composer install --no-interaction --optimize-autoloader

配置数据库与环境

sudo cp .env.example .env  sudo nano .env  # 修改 DB_DATABASE、DB_USERNAME、DB_PASSWORD；APP_URL 设为你的域名（如 https://shop.example.com）sudo php artisan key:generate  sudo php artisan migrate:fresh --seed  # 初始化数据（含管理员账号 admin@example.com / password）

配置 Nginx（示例配置）
创建 /etc/nginx/sites-available/bagisto，确保 root 指向 /var/www/bagisto/public，并启用 try_files $uri $uri/ /index.php?$query_string;。启用后执行 sudo ln -sf /etc/nginx/sites-available/bagisto /etc/nginx/sites-enabled/ 并重启 Nginx。

权限与队列（生产必备）

sudo chown -R www-data:www-data /var/www/bagisto  sudo chmod -R 775 /var/www/bagisto/storage /var/www/bagisto/bootstrap/cache  # 启用队列监听（用于邮件、通知等异步任务）  sudo supervisorctl reread && sudo supervisorctl update && sudo supervisorctl start bagisto-worker:*

安全与优化建议

使用 Ciuic 控制台一键申请 Let’s Encrypt SSL 证书，启用 HTTPS 强制跳转；配置 .htaccess（Apache）或 Nginx 的 location ~ \.php$ 安全规则，禁止访问敏感目录（如 /storage/app/, /bootstrap/cache/）；生产环境禁用调试模式（.env 中设 APP_DEBUG=false）；定期通过 php artisan bagisto:update 升级核心版本。

Bagisto 不仅是“开箱即用”的电商框架，更是 Laravel 生态中践行领域驱动设计（DDD）的典范。借助 Ciuic 云服务器（https://cloud.ciuic.cn/）提供的稳定基础设施与便捷运维能力，开发者可将精力聚焦于业务逻辑与主题定制，真正实现“快部署、易维护、强扩展”。从零到上线，全程可控——这正是现代 PHP 电商开发应有的技术体验。（全文约 860 字）

打赏