DSSHOP 安裝

基于docker安裝（推薦）

以下安裝的前提是已安裝好了docker 如本地已有l(wèi)aradock環(huán)境或是其它docker環(huán)境，請(qǐng)自行修改?docker-compose.yml?的端口號(hào)

進(jìn)入項(xiàng)目根目錄

git clone https://gitee.com/dswjcms/dsshop.git
cd dsshop
# 安裝環(huán)境
docker-compose up -d
# 安裝后端
docker-compose exec php bash
composer install
cp .env.docker .env
# 如有修改過(guò)docker-compose.yml，如數(shù)據(jù)庫(kù)密碼，請(qǐng)自行修改.env文件
php artisan migrate
# 加載demo數(shù)據(jù)(demo和pure二選一)
php artisan generate:sql
# 加載純凈數(shù)據(jù)
# php artisan generate:sql pure
php artisan storage:link
# 生成APP_KEY
php artisan key:generate
# 生成oauth文件
php artisan passport:keys
# 創(chuàng)建密碼授權(quán)管理端
php artisan passport:client --password
# 選擇`admins`
# 修改.env，添加OAuth認(rèn)證信息
PASSPORT_CLIENT_ID="生成的Client ID"
PASSPORT_CLIENT_SECRET="生成的 Client secret"
# 創(chuàng)建密碼授權(quán)客戶端
php artisan passport:client --password
# 選擇`users`
# 修改.env，添加OAuth認(rèn)證信息
PASSPORT_WEB_ID="生成的Client ID"
PASSPORT_WEB_SECRET="生成的 Client secret"
# 給storage777權(quán)限
chmod -R 777 storage/

# 開(kāi)啟隊(duì)列和定時(shí)任務(wù)(用到了再開(kāi)啟，以下非必須操作)
# 修改/docker/supervisor/conf.d目錄下的dsshop-scheduler.conf.example(定時(shí)任務(wù))和dsshop-worker.conf.example(隊(duì)列)
# 一般不需要修改，直接將這兩個(gè)文件名的.example去除
# 進(jìn)入php容器
docker-compose exec php bash
# 更新supervisor
supervisorctl update
#查看所有進(jìn)程的狀態(tài)
supervisorctl status


# 搭建后臺(tái)
#進(jìn)入admin/vue2/element-admin-v3目錄
#不要在linux下執(zhí)行，會(huì)報(bào)錯(cuò)，推薦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主機(jī)的局域網(wǎng)IP

npm run dev
# 默認(rèn)后臺(tái)賬號(hào)、密碼
admin
admin

# 搭建H5
cd ../client/uni-app/mix-mall
npm install 
# HBuilder X導(dǎo)入client/uni-app/mix-mall目錄
# client/uni-app/mix-mall/utils/config.js修改服務(wù)器地址
# 修改`BaseURL`為API訪問(wèn)地址
# `secret`有個(gè)默認(rèn)密鑰，如需自定義，只需在`.env`中配置`PROJECT_KEY`
# HBuilder X可以通過(guò)瀏覽器、微信小程序運(yùn)行項(xiàng)目，也可以直接發(fā)布項(xiàng)目，但需要配置賬號(hào)，具體請(qǐng)參考HBuilder X

基于Laradock安裝

下載Laradock倉(cāng)庫(kù)

git clone https://github.com/laradock/laradock.git

下載image并生成container啟動(dòng), 這一步最好換成國(guó)內(nèi)源，需要一些時(shí)間安裝

cd laradock
# 修改.env文件
APP_CODE_PATH_HOST=../
cd nginx  //在這個(gè)目錄里修改Nginx配置
docker-compose up -d nginx php-fpm mysql redis

docker ps  //查看安裝結(jié)果，注意Nginx端口映射

進(jìn)入container(后續(xù)操作會(huì)用到)

docker-compose exec workspace bash  //Linux or Macos
docker exec -it {workspace-container-id} bash  //windows

安裝DSSHOP管理端(后臺(tái)代碼)

在Laradock同級(jí)目錄下面

git clone https://github.com/dspurl/dsshop.git
docker exec -it laradock_workspace_1 bash  //進(jìn)入container
cd dsshop/api
composer install
# 修改.env.dev為.env
# 添加數(shù)據(jù)庫(kù)信息
DB_CONNECTION=mysql
DB_HOST= mysql //填127.0.0.1會(huì)報(bào)找不到IP
DB_PORT=3306
DB_DATABASE=表名
DB_USERNAME=用戶名
DB_PASSWORD=密碼

#配置redis(需要事先裝redis服務(wù)端)
REDIS_HOST=redis //填127.0.0.1會(huì)報(bào)找不到IP
REDIS_PASSWORD=null
REDIS_PORT=6379
REDIS_DB=1
REDIS_CACHE_DB=1

php artisan migrate
# 加載demo數(shù)據(jù)(demo和pure二選一)
php artisan generate:sql
# 加載純凈數(shù)據(jù)
# php artisan generate:sql pure
php artisan storage:link
# 生成APP_KEY
php artisan key:generate
# 生成oauth文件
php artisan passport:keys
# 創(chuàng)建密碼授權(quán)管理端
php artisan passport:client --password
# 選擇`admins`
#修改.env，添加OAuth認(rèn)證信息
PASSPORT_CLIENT_ID="生成的Client ID"
PASSPORT_CLIENT_SECRET="生成的 Client secret"
# 創(chuàng)建密碼授權(quán)客戶端
php artisan passport:client --password
# 選擇`users`
#修改.env，添加OAuth認(rèn)證信息
PASSPORT_WEB_ID="生成的Client ID"
PASSPORT_WEB_SECRET="生成的 Client secret"

修改windows的hosts文件

127.0.0.1 dsshop.test

然后訪問(wèn)瀏覽器訪問(wèn)dsshop.test:端口，看是否能夠訪問(wèn)Laravel /路徑

//laradock/nginx配置了一個(gè)88端口映射指向dsshop/api/public 目錄
server {
    listen 88;
    listen [::]:80;
    server_name laravel.test;
    root /var/www/dsshop/api/public;
    ····

安裝DSSHOP管理端(前端代碼)

cd ../admin/vue2/element-admin-v3
#不要在linux下執(zhí)行，會(huì)報(bào)錯(cuò)，推薦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主機(jī)的局域網(wǎng)IP

npm run dev  

npm run build:prod  //對(duì)應(yīng) prod.env.js
# 默認(rèn)后臺(tái)賬號(hào)、密碼
admin
admin

小程序代碼本地展示

cd ../client/uni-app/mix-mall
npm install 
# HBuilder X導(dǎo)入client/uni-app/mix-mall目錄
# client/uni-app/mix-mall/utils/config.js修改服務(wù)器地址
# 修改`BaseURL`為API訪問(wèn)地址
# `secret`有個(gè)默認(rèn)密鑰，如需自定義，只需在`.env`中配置`PROJECT_KEY`
# HBuilder X可以通過(guò)瀏覽器、微信小程序運(yùn)行項(xiàng)目，也可以直接發(fā)布項(xiàng)目，但需要配置賬號(hào)，具體請(qǐng)參考HBuilder X

運(yùn)行小程序

需要安裝?sass?的插件，然后HBuilder會(huì)自動(dòng)開(kāi)啟微信開(kāi)發(fā)工具，代碼會(huì)轉(zhuǎn)為微信小程序的代碼

網(wǎng)站代碼本地展示

cd ../client/nuxt-web/mi
cp .env.prod .env   //修改配置信息
APP_ENV=local   // 修改APP_ENV為local
npm install
npm run dev

傻瓜式安裝（從2.1.0開(kāi)始不再支持）

• 5步快速搭建屬于自己的DSSHOP商城，功能參考項(xiàng)目演示，適用線上直接部署
• 如不想碰到錯(cuò)誤，請(qǐng)嚴(yán)格按照以下步驟和要求執(zhí)行，以下方法已真機(jī)驗(yàn)證
• 安裝包在環(huán)境滿足的前提下，可不用寫一行代碼，即可搭建完整個(gè)項(xiàng)目
• 優(yōu)點(diǎn)：搭建方便，無(wú)需懂代碼，全程引導(dǎo)安裝；缺點(diǎn)：項(xiàng)目壓縮編譯，二開(kāi)不友好（可通過(guò)下載install得到二開(kāi)支持）

前期準(zhǔn)備

• 一臺(tái)linux服務(wù)器(laradock最佳，非laradock請(qǐng)?jiān)诎惭b時(shí)的mysql和redis服務(wù)器填寫127.0.0.1)
• php >= 7.4
• mysql >=5.7
• php開(kāi)啟以下擴(kuò)展?curl?、?pdo?、?openssl?、?redis?
• 以下目錄具備讀寫權(quán)限(777權(quán)限)?storage/framework/?、?storage/logs/?、?bootstrap/cache/?

安裝步驟

1、下載dsshop發(fā)行版，下載方式如下圖，也可以下載guide分支的代碼

2、將項(xiàng)目解壓，得到dsshop目錄，將dsshop目錄下的api目錄下所有文件移動(dòng)到網(wǎng)站根目錄（一般為www）

3、通過(guò)瀏覽器訪問(wèn)http://dsshop.test/install（請(qǐng)根據(jù)自己實(shí)際域名替換掉http://dsshop.test）
4、根據(jù)以下5步完成項(xiàng)目安裝

如果需要使用微信小程序，請(qǐng)?jiān)陧?xiàng)目配置頁(yè)中開(kāi)啟小程序配置，并將小程序配置信息填入（請(qǐng)確保配置信息的正確性，也可以安裝后，通過(guò).env文件修改），不然第7步將無(wú)法正常使用小程序
配置信息只有在首次項(xiàng)目安裝時(shí)，可通過(guò)表單形式填寫，安裝完后，請(qǐng)通過(guò)根目錄下的.env文件進(jìn)行修改

5、訪問(wèn)h5和后臺(tái)，看是否正常訪問(wèn)，如果可以，恭喜你安裝成功了
6、最后將根目錄下的install目錄移除，記住一定要移除掉?。?！
7、小程序的使用：當(dāng)安裝成功后，請(qǐng)將根目錄的mp-weixin目錄下載到本地，通過(guò)“微信開(kāi)放者工具”導(dǎo)入該目錄

基于Homestead安裝

DSSHOP使用

• 下載dsshop

git clone https://github.com/dspurl/dsshop.git

DSSHOP后端代碼部署

• 進(jìn)入api目錄
• 安裝composer (opens new window)建議切換到中國(guó)鏡像，不然下載會(huì)比較慢
• 安裝dsshop依賴包

cd ./api
composer install
# 修改.env.dev為.env
# 添加數(shù)據(jù)庫(kù)信息
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=表名
DB_USERNAME=用戶名
DB_PASSWORD=密碼

#配置redis(需要事先裝redis服務(wù)端)
REDIS_HOST=127.0.0.1
REDIS_PASSWORD='密碼'
REDIS_PORT='端口'
REDIS_DB=1
REDIS_CACHE_DB=1

php artisan migrate
# 加載demo數(shù)據(jù)(demo和pure二選一)
php artisan generate:sql
# 加載純凈數(shù)據(jù)
# php artisan generate:sql pure
php artisan storage:link
# 生成APP_KEY
php artisan key:generate
# 生成oauth文件
php artisan passport:keys
# 創(chuàng)建密碼授權(quán)管理端
php artisan passport:client --password
# 選擇`admins`
#修改.env，添加OAuth認(rèn)證信息
PASSPORT_CLIENT_ID="生成的Client ID"
PASSPORT_CLIENT_SECRET="生成的 Client secret"
# 創(chuàng)建密碼授權(quán)客戶端
php artisan passport:client --password
# 選擇`users`
#修改.env，添加OAuth認(rèn)證信息
PASSPORT_WEB_ID="生成的Client ID"
PASSPORT_WEB_SECRET="生成的 Client secret"
# 需要安裝PhpRedis
# 參考：https://github.com/dspurl/dsshop/pull/84

• 訪問(wèn)項(xiàng)目對(duì)應(yīng)的域名，如果正常顯示頁(yè)面，說(shuō)明搭建成功了

DSSHOP前端代碼部署(后臺(tái))

cd ../admin/vue2/element-admin-v3
#不要在linux下執(zhí)行，會(huì)報(bào)錯(cuò)，推薦windows
npm install 
#admin/config/dev.env.js修改自己的api地址
BASE_API: '"http://dsshop.com/api/v1/admin/"',

npm run dev

瀏覽器默認(rèn)會(huì)打開(kāi)，然后登錄進(jìn)去，能正常訪問(wèn)各各頁(yè)面，說(shuō)明后臺(tái)和后端已經(jīng)搭建成功

# 默認(rèn)后臺(tái)賬號(hào)、密碼
admin
admin

DSSHOP前端代碼部署

H5端、小程序端

先安裝nodejs和HBuilder x 用來(lái)開(kāi)發(fā)小程序端

cd ../client/uni-app/mix-mall
npm install 
# HBuilder X導(dǎo)入client/uni-app/mix-mall目錄
# client/uni-app/mix-mall/utils/config.js修改服務(wù)器地址
# 修改`BaseURL`為API訪問(wèn)地址
# `secret`有個(gè)默認(rèn)密鑰，如需自定義，只需在`.env`中配置`PROJECT_KEY`
# HBuilder X可以通過(guò)瀏覽器、微信小程序運(yùn)行項(xiàng)目，也可以直接發(fā)布項(xiàng)目，但需要配置賬號(hào)，具體請(qǐng)參考HBuilder X

網(wǎng)站

網(wǎng)站采用nuxt框架，本地測(cè)試和其它vue項(xiàng)目一樣

cd ../client/nuxt-web/mi
cp .env.prod .env   //修改配置信息
APP_ENV=local   // 修改APP_ENV為local
npm install
npm run dev