# 安装
# 常用开发工具
- window10系统
- Laravel Homestead(免费) (opens new window) 为了快速搭建window10下的linux+laravel环境（当然你也可以用phpStudy，这里使用linux虚拟机，为的是熟悉linux的命令行，你可以使用xshell像连接服务器的方式连接本地的linux服务器）
- Laradock(免费) (opens new window) 基于docker容器的laravel集成环境，强烈推荐使用，可以减少因环境部署产生的诸多问题！！！
- phpStorm编辑器 (opens new window)(收费)下载后，需要安装插件（laravel相关插件 (opens new window)、VUE相关插件 (opens new window)）
- Windows PowerShell(window10自带的shell工具，在需要使用的目录，shift+右击就可以找到)
- Xshell+Xftp连接linux服务器工具 (opens new window)
- HBuilder x 用来开发小程序端 (opens new window)
- Postman api接口测试工具 (opens new window)
- Google Chrome (opens new window)
# 环境搭建
# 基于docker安装
推荐有技术能力的使用该方法
以下安装的前提是已安装好了docker
如本地已有laradock环境或是其它docker环境，请自行修改docker-compose.yml的端口号
# 进入项目根目录
git clone https://gitee.com/dswjcms/dsshop.git
cd dsshop
# 安装环境
docker-compose up -d
# 安装后端
docker-compose exec php bash
composer install
cp .env.docker .env
# 如有修改过docker-compose.yml，如数据库密码，请自行修改.env文件
php artisan migrate
# 加载demo数据(demo和pure二选一)
php artisan generate:sql
# 加载纯净数据
# php artisan generate:sql pure
php artisan storage:link
# 生成APP_KEY
php artisan key:generate
# 生成oauth文件
php artisan passport:keys
# 创建密码授权管理端
php artisan passport:client --password
# 选择`admins`
# 修改.env，添加OAuth认证信息
PASSPORT_CLIENT_ID="生成的Client ID"
PASSPORT_CLIENT_SECRET="生成的 Client secret"
# 创建密码授权客户端
php artisan passport:client --password
# 选择`users`
# 修改.env，添加OAuth认证信息
PASSPORT_WEB_ID="生成的Client ID"
PASSPORT_WEB_SECRET="生成的 Client secret"
# 给storage777权限
chmod -R 777 storage/
# 开启队列和定时任务(用到了再开启，以下非必须操作)
# 修改/docker/supervisor/conf.d目录下的dsshop-scheduler.conf.example(定时任务)和dsshop-worker.conf.example(队列)
# 一般不需要修改，直接将这两个文件名的.example去除
# 进入php容器
docker-compose exec php bash
# 更新supervisor
supervisorctl update
#查看所有进程的状态
supervisorctl status
# 搭建后台
#进入admin/vue2/element-admin-v3目录
#不要在linux下执行，会报错，推荐windows
npm install
#admin/config/dev.env.js or prod.env.js修改自己的api地址
BASE_API: '"http://172.27.16.1/api/v1/admin/"', //172.27.16.1是window主机的局域网IP
npm run dev
# 默认后台账号、密码
admin
admin
# 搭建H5
cd ../client/uni-app/mix-mall
npm install
# HBuilder X导入client/uni-app/mix-mall目录
# client/uni-app/mix-mall/utils/config.js修改服务器地址
# 修改`BaseURL`为API访问地址
# `secret`有个默认密钥，如需自定义，只需在`.env`中配置`PROJECT_KEY`
# HBuilder X可以通过浏览器、微信小程序运行项目，也可以直接发布项目，但需要配置账号，具体请参考HBuilder X
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
# 傻瓜式安装
4分钟搭建dsshop
如不想碰到错误，请严格按照以下步骤和要求执行，以下方法已真机验证
安装包在环境满足的前提下，可不用写一行代码，即可搭建完整个项目
优点：搭建方便，无需懂代码，全程引导安装；缺点：项目压缩编译
缺点：环境不满足将无法正常执行，所以请严格参考以下测试环境执行，以免发生错误
# 前期准备
- 一台服务器
- mysql =5.7
- php >= 7.4
- node= 14.18.3
- php开启以下扩展
curl、pdo、openssl、redis - 以下目录具备读写权限(777权限)
api/storage/framework/、api/storage/logs/、api/bootstrap/cache/
# 安装步骤
# 手动下载安装
- 下载dsshop发行版，下载方式如下图
- 将项目解压，得到dsshop目录，将dsshop目录移动到网站根目录（一般为www）
- 配置nginx（自行百度自己用的集成环境如何修改nginx）参考：https://learnku.com/docs/laravel/7.x/deployment/7452
- 通过浏览器访问http://dsshop.test/install（请根据自己实际域名替换掉http://dsshop.test）
- 填写必要信息后，即可完成安装
# 命令行安装
git clone https://github.com/dspurl/dsshop
cd dsshop
# 配置nginx参考手动下载安装
# 运行安装引导
访问：http://dsshop.test/install
# 填写必要信息后，即可完成安装
1
2
3
4
5
6
2
3
4
5
6
# 搭建小程序
小程序可以直接用小程序开发工具打开dsshop/api/public/mp-weixin
- 用微信开发者工具打开小程序，然后上传，进行发布就可以了
# 搭建网站
网站位于dsshop/api/public/web
- 进入网站目录，执行以下命令
npm install
npm start
# 访问网站
http://dsshop.test:3002
1
2
3
4
2
3
4
# 基于宝塔安装(已暂停维护)
# 基于Laradock安装(已暂停维护)
# 安装Laradock (opens new window)
window 安装docker.exe
下载Laradock仓库
git clone https://github.com/laradock/laradock.git
1
下载image并生成container启动, 这一步最好换成国内源，需要一些时间安装
cd laradock
# 修改.env文件
APP_CODE_PATH_HOST=../
cd nginx //在这个目录里修改Nginx配置
docker-compose up -d nginx php-fpm mysql redis
1
2
3
4
5
2
3
4
5
https://hub-mirror.c.163.com
docker ps //查看安装结果，注意Nginx端口映射
1
进入container(后续操作会用到)
docker-compose exec workspace bash //Linux or Macos
docker exec -it {workspace-container-id} bash //windows
1
2
2
# 安装DSSHOP管理端(后台代码)
在Laradock同级目录下面
git clone https://github.com/dspurl/dsshop.git
docker exec -it laradock_workspace_1 bash //进入container
cd dsshop/api
composer install
# 修改.env.dev为.env
# 添加数据库信息
DB_CONNECTION=mysql
DB_HOST= mysql //填127.0.0.1会报找不到IP
DB_PORT=3306
DB_DATABASE=表名
DB_USERNAME=用户名
DB_PASSWORD=密码
#配置redis(需要事先装redis服务端)
REDIS_HOST=redis //填127.0.0.1会报找不到IP
REDIS_PASSWORD=null
REDIS_PORT=6379
REDIS_DB=1
REDIS_CACHE_DB=1
php artisan migrate
# 加载demo数据(demo和pure二选一)
php artisan generate:sql
# 加载纯净数据
# php artisan generate:sql pure
php artisan storage:link
# 生成APP_KEY
php artisan key:generate
# 生成oauth文件
php artisan passport:keys
# 创建密码授权管理端
php artisan passport:client --password
# 选择`admins`
#修改.env，添加OAuth认证信息
PASSPORT_CLIENT_ID="生成的Client ID"
PASSPORT_CLIENT_SECRET="生成的 Client secret"
# 创建密码授权客户端
php artisan passport:client --password
# 选择`users`
#修改.env，添加OAuth认证信息
PASSPORT_WEB_ID="生成的Client ID"
PASSPORT_WEB_SECRET="生成的 Client secret"
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
修改windows的hosts文件
127.0.0.1 dsshop.test
1
然后访问浏览器访问dsshop.test:端口，看是否能够访问Laravel /路径
//laradock/nginx配置了一个88端口映射指向dsshop/api/public 目录
server {
listen 88;
listen [::]:80;
server_name laravel.test;
root /var/www/dsshop/api/public;
····
1
2
3
4
5
6
7
2
3
4
5
6
7
# 安装DSSHOP管理端(前端代码)
cd ../admin/vue2/element-admin-v3
#不要在linux下执行，会报错，推荐windows
npm install
#admin/config/dev.env.js or prod.env.js修改自己的api地址
BASE_API: '"http://172.27.16.1/api/v1/admin/"', //172.27.16.1是window主机的局域网IP
npm run dev
npm run build:prod //对应 prod.env.js
# 默认后台账号、密码
admin
admin
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
# 小程序代码本地展示
cd ../client/uni-app/mix-mall
npm install
# HBuilder X导入client/uni-app/mix-mall目录
# client/uni-app/mix-mall/utils/config.js修改服务器地址
# 修改`BaseURL`为API访问地址
# `secret`有个默认密钥，如需自定义，只需在`.env`中配置`PROJECT_KEY`
# HBuilder X可以通过浏览器、微信小程序运行项目，也可以直接发布项目，但需要配置账号，具体请参考HBuilder X
1
2
3
4
5
6
7
2
3
4
5
6
7
# 运行小程序
需要安装sass的插件，然后HBuilder会自动开启微信开发工具，代码会转为微信小程序的代码
# uni-app介绍
https://uniapp.dcloud.io/quickstart (opens new window)
# 网站代码本地展示
cd ../client/nuxt-web/mi
cp .env.prod .env //修改配置信息
APP_ENV=local // 修改APP_ENV为local
npm install
npm run dev
1
2
3
4
5
2
3
4
5
# 基于Homestead安装(已暂停维护)
参考：Laravel Homestead (opens new window)
# DSSHOP使用
git clone https://github.com/dspurl/dsshop.git
1
# DSSHOP后端代码部署
- 进入api目录
- 安装composer (opens new window) 建议切换到中国镜像，不然下载会比较慢
- 安装dsshop依赖包
cd ./api
composer install
# 修改.env.dev为.env
# 添加数据库信息
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=表名
DB_USERNAME=用户名
DB_PASSWORD=密码
#配置redis(需要事先装redis服务端)
REDIS_HOST=127.0.0.1
REDIS_PASSWORD='密码'
REDIS_PORT='端口'
REDIS_DB=1
REDIS_CACHE_DB=1
php artisan migrate
# 加载demo数据(demo和pure二选一)
php artisan generate:sql
# 加载纯净数据
# php artisan generate:sql pure
php artisan storage:link
# 生成APP_KEY
php artisan key:generate
# 生成oauth文件
php artisan passport:keys
# 创建密码授权管理端
php artisan passport:client --password
# 选择`admins`
#修改.env，添加OAuth认证信息
PASSPORT_CLIENT_ID="生成的Client ID"
PASSPORT_CLIENT_SECRET="生成的 Client secret"
# 创建密码授权客户端
php artisan passport:client --password
# 选择`users`
#修改.env，添加OAuth认证信息
PASSPORT_WEB_ID="生成的Client ID"
PASSPORT_WEB_SECRET="生成的 Client secret"
# 需要安装PhpRedis
# 参考：https://github.com/dspurl/dsshop/pull/84
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
- 访问项目对应的域名，如果正常显示页面，说明搭建成功了
# DSSHOP前端代码部署(后台)
cd ../admin/vue2/element-admin-v3
#不要在linux下执行，会报错，推荐windows
npm install
#admin/config/dev.env.js修改自己的api地址
BASE_API: '"http://dsshop.com/api/v1/admin/"',
npm run dev
1
2
3
4
5
6
7
2
3
4
5
6
7
- 浏览器默认会打开，然后登录进去，能正常访问各各页面，说明后台和后端已经搭建成功
# 默认后台账号、密码
admin
admin
1
2
3
2
3
# DSSHOP前端代码部署
# H5端、小程序端
cd ../client/uni-app/mix-mall
npm install
# HBuilder X导入client/uni-app/mix-mall目录
# client/uni-app/mix-mall/utils/config.js修改服务器地址
# 修改`BaseURL`为API访问地址
# `secret`有个默认密钥，如需自定义，只需在`.env`中配置`PROJECT_KEY`
# HBuilder X可以通过浏览器、微信小程序运行项目，也可以直接发布项目，但需要配置账号，具体请参考HBuilder X
1
2
3
4
5
6
7
2
3
4
5
6
7
# 网站
网站采用nuxt框架，本地测试和其它vue项目一样
cd ../client/nuxt-web/mi
cp .env.prod .env //修改配置信息
APP_ENV=local // 修改APP_ENV为local
npm install
npm run dev
1
2
3
4
5
2
3
4
5
介绍 →