安装部署

本文档将指导您完成 MineShop 的安装和部署。

📥 获取代码

方式一：Git 克隆

git clone https://github.com/since-leoo/mine-shop.git
cd mine-shop
composer install

⚙️ 环境配置

1. 复制环境配置文件

cp .env.example .env

2. 编辑 .env 文件

3. 创建数据库

CREATE DATABASE mineshop 
CHARACTER SET utf8mb4 
COLLATE utf8mb4_unicode_ci;

🗄️ 数据库初始化

运行迁移

# 执行数据库迁移
php bin/hyperf.php migrate

# 填充初始数据
php bin/hyperf.php db:seed

同步地区数据

# 同步四级地区库
php bin/hyperf.php mall:sync-regions

🔌 安装插件

导出中心插件

php bin/hyperf.php plugin:install since/export-center

微信插件

php bin/hyperf.php plugin:install since/wechat

🚀 启动服务

开发环境

# 启动后端服务
php bin/hyperf.php start

# 或使用热重载（推荐开发时使用）
php bin/hyperf.php server:watch

生产环境

# 使用 Supervisor 管理进程
supervisorctl start mineshop

🖥️ 前端部署

安装依赖

cd web
npm install
# 或
yarn install

开发模式

npm run dev

生产构建

npm run build

✅ 验证安装

检查后端服务

# 访问健康检查接口
curl http://127.0.0.1:9501

检查前端

访问 http://localhost:5173（开发模式）或配置的域名。

默认账号

• 用户名: admin
• 密码: 123456

安全提示

首次登录后请立即修改默认密码！

🔧 常见问题

Swoole 扩展未安装

# 检查 Swoole
php --ri swoole

# 如果未安装，使用 pecl 安装
pecl install swoole

端口被占用

# 查看端口占用
lsof -i :9501

# 修改 .env 中的端口
HTTP_PORT=9502

数据库连接失败

1. 检查 MySQL 服务是否启动
2. 检查 .env 中的数据库配置
3. 确认数据库用户权限

Redis 连接失败

1. 检查 Redis 服务是否启动
2. 检查 .env 中的 Redis 配置
3. 如有密码，确认 REDIS_AUTH 配置正确

📚 下一步

• 配置说明 - 详细的配置项说明
• Docker 部署 - 使用 Docker 部署
• 生产环境部署 - 生产环境最佳实践