# laravel-shop-1

**Repository Path**: rainseasion/laravel-shop-1

## Basic Information

- **Project Name**: laravel-shop-1
- **Description**: 基于 Laravel 一步一步构建一套电商系统。使用 Laravel-Admin 快速构建管理后台、支付宝和微信支付的回调通知处理、Laravel 项目中对异常的处理、购物车设计、商品 SKU 数据结构设计、通过延迟队列自动关闭订单、MySQL 事务处理、库存增减的正确姿势、无限级分类、Elasticsearch、分面搜索、代码部署、负载均衡、压力测试、接口性能优化、随机拒绝等电商开发相关的高级技术概念。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 2
- **Created**: 2020-12-11
- **Last Updated**: 2025-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 涂呀网商城
- 产品名称：Laravel Shop
- 项目代码：laravel-shop
- 官方网址：https://github.com/buqiu/laravel-shop

>laravel-shop 基于 Laravel7.x 一步一步构建一套电商系统。使用 Laravel-Admin 快速构建管理后台、支付宝和微信支付的回调通知处理、Laravel 项目中对异常的处理、购物车设计、商品 SKU 数据结构设计、通过延迟队列自动关闭订单、MySQL 事务处理、库存增减的正确姿势。

## 功能

![_big](https://github.com/buqiu/laravel-shop/blob/master/doc/%E6%B6%82%E5%91%80%E5%95%86%E5%9F%8E%E5%8A%9F%E8%83%BD%E5%9B%BE02.png)


## 项目功能点

- 用户中心；
- 收货地址；
- 电商管理后台；
- 权限管理；
- 商品管理；
- 商品 SKU；
- 购物车模块；
- 订单模块；
- 支付模块（支付宝支付、微信支付）；
- 商品评价；
- 商品收藏；
- 订单退款流程；
- 优惠券模块；
- 商品类目
- 众筹
- 分期付款
- 商品检索
- 秒杀
- 电商安全须知；
- 数据备份。

## 运行环境要求

- Nginx 1.15+
- PHP 7.2+
- MySQL 8.0+
- Redis 5.0+

## 开发环境部署/安装

本项目代码使用 PHP 框架 [Laravel 7.x](https://laravel.com/docs/7.x) 开发，本地开发环境使用 [Laravel Homestead](https://laravel.com/docs/7.x/homestead) 。

下文将在假定读者已经安装好了 Homestead 的情况下进行说明。如果您还未安装 Homestead，可以参照 Homestead 安装与设置 进行安装配置。

### 基础安装

#### 1. 克隆源代码

克隆 `larabbs` 源代码到本地：

    > git clone https://github.com/buqiu/laravel-shop.git

#### 2. 配置本地的 Homestead 环境

1). 运行以下命令编辑 Homestead.yaml 文件：

```shell script
homestead edit
```

2). 加入对应修改，如下所示：

```
folders:
    - map: ~/my-path/laravel-shop/ # 你本地的项目目录地址
      to: /home/vagrant/laravel-shop

sites:
    - map: shop.test
      to: /home/vagrant/laravel-shop/public

databases:
    - laravel-shop
```

3). 应用修改

修改完成后保存，然后执行以下命令应用配置信息修改：

```shell script
homestead provision
```

随后请运行 `homestead reload` 进行重启。

#### 3. 安装扩展包依赖

```shell script
composer install
```

#### 4. 生成配置文件

```
cp .env.example .env
```

你可以根据情况修改 `.env` 文件里的内容，如数据库连接、缓存、邮件设置等。

```
APP_NAME="Laravel Shop"
.
.
.
APP_URL=http://shop.test
.
.
.
DB_DATABASE=laravel-shop
DB_USERNAME=homestead
DB_PASSWORD=secret
.
.
.
QUEUE_CONNECTION=redis
.
.
.
MAIL_DRIVER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025
```

#### 5. 生成秘钥

```shell script
php artisan key:generate
```

#### 6. 创建软链

接下来我们需要在 `public` 目录下创建一个连到 `storage/app/public` 目录下的软链接：

```shell script
php artisan storage:link
```

#### 7. 初始化

- 执行数据库迁移

```shell script
php artisan migrate
```

- 执行 Elasticsearch 迁移

```shell script
php artisan es:migrate
```

- 导入管理后台数据

```shell script
php artisan db:seed --class=AdminTablesSeeder
```

- 创建后台用户

```shell script
php artisan admin:create-user
```

- 生成假数据

```shell script
php artisan db:seed
php artisan db:seed --class=DDRProductsSeeder
```

- 同步商品数据到 Elasticsearch 

```shell script
php artisan es:sync-products
```

#### 8. 配置 hosts 文件

    echo "192.168.10.10   shop.test" | sudo tee -a /etc/hosts

### 前端框架安装

1). 安装 node.js

直接去官网 [https://nodejs.org/en/](https://nodejs.org/en/) 下载安装最新版本。

2). 安装 Yarn

请按照最新版本的 Yarn —— http://yarnpkg.cn/zh-Hans/docs/install

3). 安装 Laravel Mix

```shell
yarn install
```

4). 编译前端内容

```shell
// 运行所有 Mix 任务...
npm run dev

// 运行所有 Mix 任务并缩小输出..
npm run production
```

5). 监控修改并自动编译

```shell
npm run watch

// 在某些环境中，当文件更改时，Webpack 不会更新。如果系统出现这种情况，请考虑使用 watch-poll 命令：
npm run watch-poll
```

### 链接入口

* 首页地址：http://shop.test/
* 管理后台：http://shop.test/admin

管理员账号密码如下:

```
username: admin
password: admin
```

至此, 安装完成 ^_^。

## 自定义 Artisan 命令

| 命令行名字 | 说明 | Cron | 代码调用 |
| --- | --- | --- | --- |
| cron:calculate-installment-fine |	计算分期付款逾期费 | 每天凌晨 00:00 执行 | 无 |
| cron:finish-crowdfunding | 结束众筹 | 每分钟执行一次 | 无 |
| es:migrate |	Elasticsearch 索引结构迁 | 无 | ProjectIndex::rebuild 创建索引  |
| es:sync-products | 将商品数据同步到 Elasticsearch | 无 | 无 |
## 队列清单

| 名称 | 说明 | 调用时机 |
| --- | --- | --- |
| OrderPaid.php | 订单支付 | 订单支付（修改商品数、订单支付成功发邮件、支付成功后更新众筹进度） |
| OrderReviewd.php | 订单评论 | 订单评论（修改商品评价数） |